Catalog Data
Catalog updates
BigCommerce updates the catalog data in your GCP account every 6 hours.
Category is a required field. A product not assigned to a category will not be included in the data sent to Google. If you have products that are not assigned to categories and those products are sometimes purchased, you will see error logs in your GCP console stating that the user event included a product that is not in your catalog, and it may impact model performance. You can leave this as is as long as you don’t want the product assigned to a category and you don’t want that product to be included in product recommendations. If you want the product to be included in product recommendations, a category must be assigned to the product. Note that the category does not have to be visible on the storefront for it to be included.
Catalog
The following table contains the product information sent to Google's Vertex AI resource (opens in a new tab), pulled from BigCommerce's V3 Catalog API:
| BigCommerce field | Google field | Description | Type | Example |
|---|---|---|---|---|
id | id | ID of the product. | integer | 1 |
name | name | A unique product name. | string | Smith Journal 13 |
categories[] | categories[] | An array of strings for the categories that include this product. Each string has the full category path. | array[string] | ["Household > Furniture > Couch", "Clothing > Designer > Pants"] |
description | description | The product description. | string | |
is_visible | attributes.visibility | Visibility of the product. | string | visible not_visible |
availability | availability | This is currently always set to “IN_STOCK,” regardless of the actual stock levels. In the future, we’ll enhance this to reflect your actual stock availability. | string | available |
price | priceInfo.price | The price of the product. The price should include or exclude tax, based on the store settings. | number | 0.1 |
cost_price | priceInfo.cost | The cost price of the product. | number | 0.1 |
retail_price | priceInfo.originalPrice | The retail cost of the product. | number | 0.1 |
custom_url.url | uri | Product URL on the storefront. | string | https://{yourdomain.com}/smith-journal-13 |