Google Content for Shopping: Most-used fields
The table below gives information about most-used fields that you can import from Google Content for Shopping. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
DateDimension
The date when the product data was collected by the platform.
additionalImageLinks.{NUM}Dimension
Additional URLs of images for the product.
adsGroupingDimension
Used to group items in an arbitrary way for advertising campaigns. This field is primarily intended for use with Cost Per Acquisition (CPA%) bidding strategies.
adsLabels.{NUM}Dimension
Custom labels for advertising campaigns, similar in function to adsGrouping, but specifically for Cost Per Click (CPC) bidding strategies. Each label represents a distinct attribute.
ageGroupDimension
The target age group for the item, e.g., 'newborn', 'infant', 'toddler', 'kids', 'adult'.
availabilityDimension
The current availability status of the product, e.g., 'in stock', 'out of stock', 'preorder'.
availabilityDateDimension
The date when the product becomes available for purchase.
brandDimension
The brand name of the product.
canonicalLinkDimension
The URL for the canonical version of your item's landing page.
channelDimension
The channel through which the product is sold, e.g., 'online' or 'local'.
colorDimension
The color of the product.
conditionDimension
The condition or state of the product, e.g., 'new', 'refurbished', 'used'.
contentLanguageDimension
The two-letter ISO 639-1 language code for the content.
creationDateDimension
The date and time when the product was created, in ISO 8601 format.
customAttributes.{NUM}.nameDimension
The name of a custom attribute defined by the merchant.
customAttributes.{NUM}.valueDimension
The value associated with a custom attribute defined by the merchant.
customLabel0Dimension
A custom label (0-4) used for grouping items in Shopping campaigns.
customLabel1Dimension
A custom label (0-4) used for grouping items in Shopping campaigns.
customLabel2Dimension
A custom label (0-4) used for grouping items in Shopping campaigns.
customLabel3Dimension
A custom label (0-4) used for grouping items in Shopping campaigns.
customLabel4Dimension
A custom label (0-4) used for grouping items in Shopping campaigns.
descriptionDimension
The detailed description of the product.
destinationStatuses.{NUM}.approvedCountries.{NUM}Dimension
A list of country codes (ISO 3166-1 alpha-2) where the product offer is approved for a specific destination.
destinationStatuses.{NUM}.channelDimension
The channel of the destination, e.g., 'online' or 'local'.
destinationStatuses.{NUM}.destinationDimension
The name of the destination where the product is (or will be) listed, e.g., 'Shopping ads'.
destinationStatuses.{NUM}.disapprovedCountries.{NUM}Dimension
A list of country codes (ISO 3166-1 alpha-2) where the product offer is disapproved for a specific destination.
destinationStatuses.{NUM}.pendingCountries.{NUM}Dimension
A list of country codes (ISO 3166-1 alpha-2) where the product offer is pending approval for a specific destination.
excludedDestinations.{NUM}Dimension
A list of destinations where the product should not be shown.
feedLabelDimension
The label associated with the product's feed.
genderDimension
The target gender for the item, e.g., 'male', 'female', 'unisex'.
googleExpirationDateDimension
The date when the product listing will expire in Google Shopping, in ISO 8601 format.
googleProductCategoryDimension
Google's category for the item, based on the Google product taxonomy.
gtinDimension
The Global Trade Item Number (GTIN) for the product (e.g., UPC, EAN, ISBN).
idMetric
The REST ID of the product. This is a unique identifier for the product.
identifierExistsDimension
Indicates whether a global trade item number (GTIN), manufacturer part number (MPN), or brand exists for the item.
imageLinkDimension
The URL of the main image for the product.
installment.amount.currencyDimension
The currency of the installment amount, in ISO 4217 format.
installment.amount.valueMetric
The numerical amount of each installment payment.
installment.monthsMetric
The number of months over which the installment payments are made.
isBundleDimension
Indicates whether the item is a merchant-defined bundle, which is a custom grouping of different products sold by a merchant for a single price.
itemGroupIdDimension
A shared identifier for a group of product variants, like different sizes or colors of the same product.
itemLevelIssues.{NUM}.applicableCountries.{NUM}Dimension
The countries where a specific item-level issue applies to the product.
itemLevelIssues.{NUM}.attributeNameDimension
The name of the attribute affected by an item-level issue.
itemLevelIssues.{NUM}.codeDimension
The error code for a specific item-level issue.
itemLevelIssues.{NUM}.descriptionDimension
A description of the item-level issue.
itemLevelIssues.{NUM}.destinationDimension
The destination where the item-level issue applies.
itemLevelIssues.{NUM}.detailDimension
Additional details about the item-level issue.
itemLevelIssues.{NUM}.documentationDimension
A link to documentation or help related to the item-level issue.
itemLevelIssues.{NUM}.resolutionDimension
Information on how to resolve the item-level issue.
itemLevelIssues.{NUM}.servabilityDimension
The servability status of the item due to the issue.
kindDimension
Identifies the type of resource. For a product status, its value is `content#productStatus`. For a product, its value is `content#product`.
lastUpdateDateDimension
The date and time when the product information was last updated, in ISO 8601 format.
linkDimension
The URL that links directly to the product's page on the merchant's website.
materialDimension
The material(s) from which the product is made.
merchant_idDimension
The ID of the Merchant Center account from which the product data was retrieved.
merchant_nameDimension
The name of the Merchant Center account from which the product data was retrieved.
mpnDimension
The Manufacturer Part Number (MPN) of the product.
offerIdDimension
The unique merchant-defined identifier for the product offer.
price.currencyDimension
The currency of the product's price, in ISO 4217 format.
price.valueMetric
The numerical value of the product's price.
productHighlights.{NUM}Dimension
Short bulleted lists of the most relevant highlights of a product, providing quick-to-scan information for shoppers.
productIdMetric
The REST ID of the product for which status is reported.
productTypes.{NUM}Dimension
The merchant-specific product type or category.
promotionIds.{NUM}Dimension
The unique identifier for an active promotion associated with the product.
salePrice.currencyDimension
The currency of the product's sale price, in ISO 4217 format.
salePrice.valueMetric
The numerical value of the product's sale price.
sellOnGoogleQuantityMetric
The available quantity of the product that can be sold directly on Google platforms. This field is supported only for online products.
shipping.{NUM}.countryDimension
The country code (ISO 3166-1 alpha-2) for a specific shipping service.
shipping.{NUM}.price.currencyDimension
The currency of the shipping price, in ISO 4217 format.
shipping.{NUM}.price.valueMetric
The numerical value of the shipping price.
shippingWeight.unitDimension
The unit of weight for the product's shipping weight, such as 'kg' or 'lb'.
shippingWeight.valueDimension
The numerical value of the product's shipping weight.
sizeSystemDimension
The system in which the size is specified (e.g., US, EU).
sizes.{NUM}Dimension
The size of the item.
sourceDimension
Indicates how the product offer was created, such as via 'api', 'crawl', or 'feed'.
subscriptionCost.amount.currencyDimension
The currency of the subscription cost, in ISO 4217 format.
subscriptionCost.amount.valueMetric
The numerical amount of the subscription payment per period.
subscriptionCost.periodDimension
The duration of a single subscription period, such as 'month' or 'year'.
subscriptionCost.periodLengthMetric
The number of subscription periods (months or years) that the buyer must pay.
targetCountryDimension
The target country for which the product information is provided.
titleDimension
The title of the product.