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.
Date Dimension
The date when the product data was collected by the platform.
additionalImageLinks.{NUM} Dimension
Additional URLs of images for the product.
adsRedirect Dimension
An override URL for the item when shown in Product Ads.
adult Dimension
Indicates if the product is targeted towards adults.
ageGroup Dimension
The target age group for the item, e.g., 'newborn', 'infant', 'toddler', 'kids', 'adult'.
availability Dimension
The current availability status of the product, e.g., 'in stock', 'out of stock', 'preorder'.
availabilityDate Dimension
The date when the product becomes available for purchase.
brand Dimension
The brand name of the product.
canonicalLink Dimension
The URL for the canonical version of your item's landing page.
certifications.{NUM}.certificationAuthority Dimension
The authority that issued the product certification. This field is part of the product certification information, often used for compliance with regulations like EU energy efficiency labeling.
certifications.{NUM}.certificationCode Metric
A unique code or identifier associated with the product certification. This field is part of the product certification information, often used for compliance with regulations like EU energy efficiency labeling.
certifications.{NUM}.certificationName Dimension
The name of the product certification, for example, for energy efficiency labeling of products. This field is part of the product certification information, often used for compliance with regulations like EU energy efficiency labeling using databases such as EU EPREL.
channel Dimension
The channel through which the product is sold, e.g., 'online' or 'local'.
color Dimension
The color of the product.
condition Dimension
The condition or state of the product, e.g., 'new', 'refurbished', 'used'.
contentLanguage Dimension
The two-letter ISO 639-1 language code for the content.
creationDate Dimension
The date and time when the product was created, in ISO 8601 format.
customAttributes.{NUM}.groupValues.{NUM}.name Dimension
The name of a custom (merchant-provided) attribute within a group of values.
customAttributes.{NUM}.groupValues.{NUM}.value Dimension
The value of a custom (merchant-provided) attribute within a group of values.
customAttributes.{NUM}.name Dimension
The name of a custom attribute defined by the merchant.
customAttributes.{NUM}.value Dimension
The value associated with a custom attribute defined by the merchant.
customLabel0 Dimension
A custom label (0-4) used for grouping items in Shopping campaigns.
customLabel1 Dimension
A custom label (0-4) used for grouping items in Shopping campaigns.
customLabel2 Dimension
A custom label (0-4) used for grouping items in Shopping campaigns.
customLabel3 Dimension
A custom label (0-4) used for grouping items in Shopping campaigns.
customLabel4 Dimension
A custom label (0-4) used for grouping items in Shopping campaigns.
description Dimension
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}.channel Dimension
The channel of the destination, e.g., 'online' or 'local'.
destinationStatuses.{NUM}.destination Dimension
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.
displayAdsLink Dimension
The URL that directly links to the product's landing page, specifically used for dynamic remarketing campaigns.
excludedDestinations.{NUM} Dimension
A list of destinations where the product should not be shown.
expirationDate Dimension
The date when the product listing will expire in Google Shopping, formatted in ISO 8601.
feedLabel Dimension
The label associated with the product's feed.
gender Dimension
The target gender for the item, e.g., 'male', 'female', 'unisex'.
googleExpirationDate Dimension
The date when the product listing will expire in Google Shopping, in ISO 8601 format.
googleProductCategory Dimension
Google's category for the item, based on the Google product taxonomy.
gtin Dimension
The Global Trade Item Number (GTIN) for the product (e.g., UPC, EAN, ISBN).
id Metric
The REST ID of the product. This is a unique identifier for the product.
identifierExists Dimension
Indicates whether a global trade item number (GTIN), manufacturer part number (MPN), or brand exists for the item.
imageLink Dimension
The URL of the main image for the product.
installment.amount.currency Dimension
The currency of the installment amount, in ISO 4217 format.
installment.amount.value Metric
The numerical amount of each installment payment.
installment.months Metric
The number of months over which the installment payments are made.
isBundle Dimension
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.
itemGroupId Dimension
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}.attributeName Dimension
The name of the attribute affected by an item-level issue.
itemLevelIssues.{NUM}.code Dimension
The error code for a specific item-level issue.
itemLevelIssues.{NUM}.description Dimension
A description of the item-level issue.
itemLevelIssues.{NUM}.destination Dimension
The destination where the item-level issue applies.
itemLevelIssues.{NUM}.detail Dimension
Additional details about the item-level issue.
itemLevelIssues.{NUM}.documentation Dimension
A link to documentation or help related to the item-level issue.
itemLevelIssues.{NUM}.resolution Dimension
Information on how to resolve the item-level issue.
itemLevelIssues.{NUM}.servability Dimension
The servability status of the item due to the issue.
kind Dimension
Identifies the type of resource. For a product status, its value is `content#productStatus`. For a product, its value is `content#product`.
lastUpdateDate Dimension
The date and time when the product information was last updated, in ISO 8601 format.
link Dimension
The URL that links directly to the product's page on the merchant's website.
material Dimension
The material(s) from which the product is made.
merchant_id Dimension
The ID of the Merchant Center account from which the product data was retrieved.
merchant_name Dimension
The name of the Merchant Center account from which the product data was retrieved.
mpn Dimension
The Manufacturer Part Number (MPN) of the product.
multipack Metric
The number of identical products in a merchant-defined multipack.
offerId Dimension
The unique merchant-defined identifier for the product offer.
price.currency Dimension
The currency of the product's price, in ISO 4217 format.
price.value Metric
The numerical value of the product's price.
productHeight.unit Dimension
The unit of measurement for the product's height (e.g., 'cm', 'in').
productHeight.value Metric
The numerical value of the product's height.
productHighlights.{NUM} Dimension
Short bulleted lists of the most relevant highlights of a product, providing quick-to-scan information for shoppers.
productId Metric
The REST ID of the product for which status is reported.
productLength.unit Dimension
The unit of measurement for the product's length (e.g., 'cm', 'in').
productLength.value Metric
The numerical value of the product's length.
productTypes.{NUM} Dimension
The merchant-specific product type or category.
productWeight.unit Dimension
The unit of measurement for the product's weight (e.g., 'kg', 'lb').
productWeight.value Metric
The numerical value of the product's weight.
productWidth.unit Dimension
The unit of measurement for the product's width (e.g., 'cm', 'in').
productWidth.value Metric
The numerical value of the product's width.
promotionIds.{NUM} Dimension
The unique identifier for an active promotion associated with the product.
salePrice.currency Dimension
The currency of the product's sale price, in ISO 4217 format.
salePrice.value Metric
The numerical value of the product's sale price.
shipping.{NUM}.country Dimension
The country code (ISO 3166-1 alpha-2) for a specific shipping service.
shipping.{NUM}.maxHandlingTime Metric
The maximum number of business days required to handle the product before shipping.
shipping.{NUM}.maxTransitTime Metric
The maximum number of business days for the product to be in transit.
shipping.{NUM}.minHandlingTime Metric
The minimum number of business days required to handle the product before shipping.
shipping.{NUM}.minTransitTime Metric
The minimum number of business days for the product to be in transit.
shipping.{NUM}.price.currency Dimension
The currency of the shipping price, in ISO 4217 format.
shipping.{NUM}.price.value Metric
The numerical value of the shipping price.
shipping.{NUM}.service Dimension
The shipping service used for the product (e.g., "Standard Shipping", "Expedited").
shippingLabel Dimension
A label used to group products for account-level shipping rules.
shippingWeight.unit Dimension
The unit of weight for the product's shipping weight, such as 'kg' or 'lb'.
shippingWeight.value Dimension
The numerical value of the product's shipping weight.
sizeSystem Dimension
The system in which the size is specified (e.g., US, EU).
sizeType Dimension
The cut or type of the item's size (e.g., 'regular', 'petite').
sizes.{NUM} Dimension
The size of the item.
source Dimension
Indicates how the product offer was created, such as via 'api', 'crawl', or 'feed'.
subscriptionCost.amount.currency Dimension
The currency of the subscription cost, in ISO 4217 format.
subscriptionCost.amount.value Metric
The numerical amount of the subscription payment per period.
subscriptionCost.period Dimension
The duration of a single subscription period, such as 'month' or 'year'.
subscriptionCost.periodLength Metric
The number of subscription periods (months or years) that the buyer must pay.
targetCountry Dimension
The target country for which the product information is provided.
title Dimension
The title of the product.
unitPricingMeasure.unit Dimension
The unit of the measure for the item's unit pricing (e.g., 'g', 'ml', 'sheet').
unitPricingMeasure.value Metric
The value of the measure for the item's unit pricing.