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.

API name	Adverity UI name	Description	Use in Adverity
Date	Date	The date when the product data was collected by the platform.	dimension
additionalImageLinks.{NUM}	additionalImageLinks.{NUM}	Additional URLs of images for the product.	dimension
adsGrouping	adsGrouping	A custom grouping for items in Product Ads, allowing arbitrary grouping.	dimension
adsLabels.{NUM}	adsLabels.{NUM}	Labels used for grouping items in Product Ads, specifically for CPC campaigns.	dimension
adsRedirect	adsRedirect	An override URL for the item when shown in Product Ads.	dimension
adult	adult	Indicates if the product is targeted towards adults.	dimension
adwordsGrouping	adwordsGrouping	Used to group items in an arbitrary way, primarily for CPA% campaigns. Its use is otherwise discouraged.	dimension
adwordsLabels.{NUM}	adwordsLabels.{NUM}	A custom label for products, used to group products within Google Ads campaigns for bidding and reporting.	dimension
adwordsRedirect	adwordsRedirect	Allows advertisers to override the item URL when the product is displayed within Product Ads.	dimension
ageGroup	ageGroup	The target age group for the item, e.g., ‘newborn’, ‘infant’, ‘toddler’, ‘kids’, ‘adult’.	dimension
availability	availability	The current availability status of the product, e.g., ‘in stock’, ‘out of stock’, ‘preorder’.	dimension
availabilityDate	availabilityDate	The date when a pre-ordered product becomes available for delivery, in ISO 8601 format.	dimension
brand	brand	The brand name of the product.	dimension
canonicalLink	canonicalLink	The URL for the canonical version of the product’s landing page.	dimension
certifications.{NUM}.certificationAuthority	certifications.{NUM}.certificationAuthority	The authority that issued the product certification.	dimension
certifications.{NUM}.certificationCode	certifications.{NUM}.certificationCode	The code or number associated with the product certification.	metric
certifications.{NUM}.certificationName	certifications.{NUM}.certificationName	The name of the product certification.	dimension
channel	channel	The channel through which the product is sold, e.g., ‘online’ or ‘local’.	dimension
color	color	The color of the product.	dimension
condition	condition	The condition or state of the product, e.g., ‘new’, ‘refurbished’, ‘used’.	dimension
contentLanguage	contentLanguage	The two-letter ISO 639-1 language code for the content.	dimension
costOfGoodsSold.currency	costOfGoodsSold.currency	The currency of the cost of goods sold, in ISO 4217 format.	dimension
costOfGoodsSold.value	costOfGoodsSold.value	The numerical value of the cost of goods sold.	metric
creationDate	creationDate	The date and time when the product was created, in ISO 8601 format.	dimension
customAttributes.{NUM}.groupValues.{NUM}.name	customAttributes.{NUM}.groupValues.{NUM}.name	The name of a specific value within a grouped custom attribute for the product.	dimension
customAttributes.{NUM}.groupValues.{NUM}.value	customAttributes.{NUM}.groupValues.{NUM}.value	The actual value of a specific item within a grouped custom attribute for the product.	dimension
customAttributes.{NUM}.name	customAttributes.{NUM}.name	The name of a custom attribute defined by the merchant.	dimension
customAttributes.{NUM}.type	customAttributes.{NUM}.type	The type of a custom attribute associated with the product. Custom attributes allow for additional, merchant-defined product information.	dimension
customAttributes.{NUM}.value	customAttributes.{NUM}.value	The value associated with a custom attribute defined by the merchant.	dimension
customLabel0	customLabel0	A custom label (0-4) used for grouping items in Shopping campaigns.	dimension
customLabel1	customLabel1	A custom label (0-4) used for grouping items in Shopping campaigns.	dimension
customLabel2	customLabel2	A custom label (0-4) used for grouping items in Shopping campaigns.	dimension
customLabel3	customLabel3	A custom label (0-4) used for grouping items in Shopping campaigns.	dimension
customLabel4	customLabel4	A custom label (0-4) used for grouping items in Shopping campaigns.	dimension
description	description	The detailed description of the product.	dimension
destinationStatuses.{NUM}.approvalPending	destinationStatuses.{NUM}.approvalPending	Indicates whether the product’s approval for a specific destination is currently pending review.	dimension
destinationStatuses.{NUM}.approvalStatus	destinationStatuses.{NUM}.approvalStatus	The approval status of the product for a given shopping destination (e.g., “approved”, “disapproved”).	dimension
destinationStatuses.{NUM}.approvedCountries.{NUM}	destinationStatuses.{NUM}.approvedCountries.{NUM}	A list of country codes (ISO 3166-1 alpha-2) where the product offer is approved for a specific destination.	dimension
destinationStatuses.{NUM}.channel	destinationStatuses.{NUM}.channel	The channel of the destination, e.g., ‘online’ or ‘local’.	dimension
destinationStatuses.{NUM}.destination	destinationStatuses.{NUM}.destination	The name of the destination where the product is (or will be) listed, e.g., ‘Shopping ads’.	dimension
destinationStatuses.{NUM}.disapprovedCountries.{NUM}	destinationStatuses.{NUM}.disapprovedCountries.{NUM}	A list of country codes (ISO 3166-1 alpha-2) where the product offer is disapproved for a specific destination.	dimension
destinationStatuses.{NUM}.intention	destinationStatuses.{NUM}.intention	The merchant’s intention for the product in a specific destination, such as whether it should be listed or excluded.	dimension
destinationStatuses.{NUM}.pendingCountries.{NUM}	destinationStatuses.{NUM}.pendingCountries.{NUM}	A list of country codes (ISO 3166-1 alpha-2) where the product offer is pending approval for a specific destination.	dimension
destinationStatuses.{NUM}.status	destinationStatuses.{NUM}.status	(Deprecated) The approval status of the product in the target country for a specific destination.	dimension
destinations.{NUM}.destinationName	destinations.{NUM}.destinationName	The name of a Google Shopping destination where the product is intended to be listed or targeted.	dimension
destinations.{NUM}.intention	destinations.{NUM}.intention	The merchant’s intended status for the product within a particular Google Shopping destination.	dimension
disclosureDate	disclosureDate	The date and time when an offer becomes visible in search results across Google’s YouTube surfaces, in ISO 8601 format.	dimension
displayAdsId	displayAdsId	An identifier used for the item in dynamic remarketing campaigns.	dimension
displayAdsLink	displayAdsLink	The URL for the product’s landing page specifically for dynamic remarketing campaigns.	dimension
displayAdsTitle	displayAdsTitle	The title of the item used for dynamic remarketing campaigns.	dimension
displayAdsValue	displayAdsValue	The offer margin for dynamic remarketing campaigns.	metric
energyEfficiencyClass	energyEfficiencyClass	The energy efficiency class of the product, as defined by the EU directive 2010/30/EU.	dimension
excludedDestinations.{NUM}	excludedDestinations.{NUM}	A list of destinations where the product should not be shown.	dimension
expirationDate	expirationDate	The date on which the product item expires, as specified upon insertion, in ISO 8601 format.	dimension
feedLabel	feedLabel	The label associated with the product’s feed.	dimension
freeShippingThreshold.{NUM}.country	freeShippingThreshold.{NUM}.country	The country code (ISO 3166-1 alpha-2) for which the free shipping threshold applies.	dimension
freeShippingThreshold.{NUM}.priceThreshold.currency	freeShippingThreshold.{NUM}.priceThreshold.currency	The currency of the price threshold for free shipping, in ISO 4217 format.	dimension
freeShippingThreshold.{NUM}.priceThreshold.value	freeShippingThreshold.{NUM}.priceThreshold.value	The numerical value of the price threshold for free shipping.	metric
gender	gender	The target gender for the item, e.g., ‘male’, ‘female’, ‘unisex’.	dimension
googleExpirationDate	googleExpirationDate	The date when the product listing will expire in Google Shopping, in ISO 8601 format.	dimension
googleProductCategory	googleProductCategory	Google’s category for the item, based on the Google product taxonomy.	dimension
gtin	gtin	The Global Trade Item Number (GTIN) for the product (e.g., UPC, EAN, ISBN).	metric
id	id	The REST ID of the product. This is a unique identifier for the product.	dimension
identifierExists	identifierExists	Indicates whether a global trade item number (GTIN), manufacturer part number (MPN), or brand exists for the item.	dimension
imageLink	imageLink	The URL of the main image for the product.	dimension
includedDestinations.{NUM}	includedDestinations.{NUM}	A collection of Google Shopping destinations where the product is explicitly configured to be included.	dimension
includedDestinations.{NUM}.destinationName	includedDestinations.{NUM}.destinationName	The name of a Google Shopping destination where the product is explicitly included.	dimension
includedDestinations.{NUM}.intention	includedDestinations.{NUM}.intention	The merchant’s intended status for the product within an explicitly included Google Shopping destination.	dimension
installment.amount.currency	installment.amount.currency	The currency of the installment amount, in ISO 4217 format.	dimension
installment.amount.value	installment.amount.value	The numerical value of the installment amount.	metric
installment.months	installment.months	The number of months for the installment payment plan.	metric
isBundle	isBundle	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.	dimension
itemGroupId	itemGroupId	A shared identifier for a group of product variants, like different sizes or colors of the same product.	dimension
itemLevelIssues.{NUM}.applicableCountries.{NUM}	itemLevelIssues.{NUM}.applicableCountries.{NUM}	The countries where a specific item-level issue applies to the product.	dimension
itemLevelIssues.{NUM}.attributeName	itemLevelIssues.{NUM}.attributeName	The name of the attribute affected by an item-level issue.	dimension
itemLevelIssues.{NUM}.code	itemLevelIssues.{NUM}.code	The error code for a specific item-level issue.	dimension
itemLevelIssues.{NUM}.description	itemLevelIssues.{NUM}.description	A description of the item-level issue.	dimension
itemLevelIssues.{NUM}.destination	itemLevelIssues.{NUM}.destination	The destination where the item-level issue applies.	dimension
itemLevelIssues.{NUM}.detail	itemLevelIssues.{NUM}.detail	Additional details about the item-level issue.	dimension
itemLevelIssues.{NUM}.documentation	itemLevelIssues.{NUM}.documentation	A link to documentation or help related to the item-level issue.	dimension
itemLevelIssues.{NUM}.resolution	itemLevelIssues.{NUM}.resolution	Information on how to resolve the item-level issue.	dimension
itemLevelIssues.{NUM}.servability	itemLevelIssues.{NUM}.servability	The servability status of the item due to the issue.	dimension
kind	kind	Identifies the type of resource. For a product status, its value is content#productStatus. For a product, its value is content#product.	dimension
lastUpdateDate	lastUpdateDate	The date and time when the product information was last updated, in ISO 8601 format.	dimension
lifestyleImageLinks.{NUM}	lifestyleImageLinks.{NUM}	Additional URLs of lifestyle images for the product, showcasing it in a real-world context.	dimension
link	link	The URL that links directly to the product’s page on the merchant’s website.	dimension
linkTemplate	linkTemplate	A template for the URL that directly links to the product’s landing page on the merchant’s website.	dimension
loyaltyProgram.price.currency	loyaltyProgram.price.currency	The currency of the loyalty program price, in ISO 4217 format.	dimension
loyaltyProgram.price.value	loyaltyProgram.price.value	The numerical value of the loyalty program price.	metric
loyaltyPrograms.{NUM}.price.currency	loyaltyPrograms.{NUM}.price.currency	The currency of the loyalty program price for a specific tier, in ISO 4217 format.	dimension
loyaltyPrograms.{NUM}.price.value	loyaltyPrograms.{NUM}.price.value	The numerical value of the loyalty program price for a specific tier.	metric
material	material	The material(s) from which the product is made.	dimension
maxEnergyEfficiencyClass	maxEnergyEfficiencyClass	The energy efficiency class of the product as defined in EU directive 2010/30/EU.	dimension
maxHandlingTime	maxHandlingTime	The maximum number of business days required to handle the product before shipping.	metric
merchant_id	merchant_id	The ID of the Merchant Center account from which the product data was retrieved.	dimension
merchant_name	merchant_name	The name of the Merchant Center account from which the product data was retrieved.	dimension
minEnergyEfficiencyClass	minEnergyEfficiencyClass	The energy efficiency class of the product as defined in EU directive 2010/30/EU.	dimension
minHandlingTime	minHandlingTime	The minimum number of business days required to handle the product before shipping.	metric
mobileLink	mobileLink	The URL for the mobile-optimized landing page of the product.	dimension
mobileLinkTemplate	mobileLinkTemplate	A template for the URL that directly links to the product’s mobile-optimized landing page on the merchant’s website.	dimension
mpn	mpn	The Manufacturer Part Number (MPN) of the product.	dimension
multipack	multipack	The number of identical products contained within a merchant-defined multipack.	metric
offerId	offerId	The unique merchant-defined identifier for the product offer.	dimension
pattern	pattern	The pattern or design of the item, such as ‘polka dots’ or ‘striped’.	dimension
pickupMethod	pickupMethod	The pickup option available for the item. Acceptable values include “buy”, “reserve”, “ship to store”, or “not supported”.	dimension
pickupSla	pickupSla	The timeline for item store pickup. Acceptable values include “same day”, “next day”, “2-day”, “3-day”, “4-day”, “5-day”, “6-day”, “7-day”, or “multi-week”.	dimension
price.currency	price.currency	The currency of the product’s price, in ISO 4217 format.	dimension
price.value	price.value	The numerical value of the product’s price.	metric
productDetails.{NUM}.attributeName	productDetails.{NUM}.attributeName	The name of a specific technical specification or product detail.	dimension
productDetails.{NUM}.attributeValue	productDetails.{NUM}.attributeValue	The value associated with a specific technical specification or product detail.	dimension
productDetails.{NUM}.sectionName	productDetails.{NUM}.sectionName	The section name for a group of related technical specifications or product details.	dimension
productHeight.unit	productHeight.unit	The unit of measurement for the product’s height.	dimension
productHeight.value	productHeight.value	The numerical value of the product’s height.	metric
productHighlights.{NUM}	productHighlights.{NUM}	A key selling point or feature of the product, presented as a highlight.	dimension
productId	productId	The REST ID of the product for which status is reported.	dimension
productLength.unit	productLength.unit	The unit of measurement for the product’s length.	dimension
productLength.value	productLength.value	The numerical value of the product’s length.	metric
productType	productType	A categorization of the product that is specific to the merchant. This helps organize products internally.	dimension
productTypes.{NUM}	productTypes.{NUM}	The merchant-specific product type or category.	dimension
productWeight.unit	productWeight.unit	The unit of measurement for the product’s weight.	dimension
productWeight.value	productWeight.value	The numerical value of the product’s weight.	metric
productWidth.unit	productWidth.unit	The unit of measurement for the product’s width.	dimension
productWidth.value	productWidth.value	The numerical value of the product’s width.	metric
promotionIds.{NUM}	promotionIds.{NUM}	The unique identifier for an active promotion associated with the product.	dimension
salePrice.currency	salePrice.currency	The currency of the product’s sale price, in ISO 4217 format.	dimension
salePrice.value	salePrice.value	The numerical value of the product’s sale price.	metric
salePriceEffectiveDate	salePriceEffectiveDate	The date range during which the sale price is effective.	dimension
sellOnGoogleQuantity	sellOnGoogleQuantity	The quantity of the product available for sale directly on Google platforms.	metric
shipping.{NUM}.country	shipping.{NUM}.country	The country code (ISO 3166-1 alpha-2) for a specific shipping service.	dimension
shipping.{NUM}.locationGroupName	shipping.{NUM}.locationGroupName	The name of the location group to which specific shipping settings apply for the product.	metric
shipping.{NUM}.maxHandlingTime	shipping.{NUM}.maxHandlingTime	The maximum number of business days required to handle the product before shipping.	metric
shipping.{NUM}.maxTransitTime	shipping.{NUM}.maxTransitTime	The maximum number of business days for the product to be in transit.	metric
shipping.{NUM}.minHandlingTime	shipping.{NUM}.minHandlingTime	The minimum number of business days required to handle the product before shipping.	metric
shipping.{NUM}.minTransitTime	shipping.{NUM}.minTransitTime	The minimum number of business days for the product to be in transit.	metric
shipping.{NUM}.price.currency	shipping.{NUM}.price.currency	The currency of the shipping price, in ISO 4217 format.	dimension
shipping.{NUM}.price.value	shipping.{NUM}.price.value	The numerical value of the shipping price.	metric
shipping.{NUM}.service	shipping.{NUM}.service	The shipping service used for the product (e.g., “Standard Shipping”, “Expedited”).	dimension
shippingLabel	shippingLabel	A label used to group products for account-level shipping rules.	dimension
shippingWeight.unit	shippingWeight.unit	The unit of measurement for the shipping weight of the product.	dimension
shippingWeight.value	shippingWeight.value	The numerical value of the shipping weight of the product.	metric
shoppingAdsExcludedCountries.{NUM}	shoppingAdsExcludedCountries.{NUM}	A list of country codes (ISO 3166-1 alpha-2) where the product offer is excluded from Shopping Ads.	dimension
sizeSystem	sizeSystem	The sizing system used for the product, e.g., ‘US’, ‘EU’, ‘UK’.	dimension
sizeType	sizeType	The type of cut for the item, e.g., ‘petite’, ‘plus’, ‘maternity’.	dimension
sizes.{NUM}	sizes.{NUM}	The size of the item.	dimension
source	source	Indicates how the product offer was created, such as via ‘api’, ‘crawl’, or ‘feed’.	dimension
structuredDescription.content	structuredDescription.content	The content of the structured description for the product.	dimension
subscriptionCost.amount.currency	subscriptionCost.amount.currency	The currency of the subscription cost, in ISO 4217 format.	dimension
subscriptionCost.amount.value	subscriptionCost.amount.value	The numerical value of the subscription cost.	metric
subscriptionCost.period	subscriptionCost.period	The billing period for the subscription cost (e.g., ‘day’, ‘week’, ‘month’, ‘year’).	dimension
subscriptionCost.periodLength	subscriptionCost.periodLength	The number of periods for the subscription cost.	metric
targetCountry	targetCountry	The target country for which the product information is provided.	dimension
taxes.{NUM}.rate	taxes.{NUM}.rate	The tax rate applicable to the product for a specific region.	metric
title	title	The title of the product.	dimension
transitTimeLabel	transitTimeLabel	The transit time label associated with the product, used to group products within account-level transit time tables.	dimension
unitPricingBaseMeasure.unit	unitPricingBaseMeasure.unit	The unit of the reference price for the item’s unit pricing (e.g., ‘g’, ‘ml’, ‘sheet’).	dimension
unitPricingBaseMeasure.value	unitPricingBaseMeasure.value	The value of the reference price for the item’s unit pricing.	metric
unitPricingMeasure.unit	unitPricingMeasure.unit	The unit of the measure for the item’s unit pricing (e.g., ‘g’, ‘ml’, ‘sheet’).	dimension
unitPricingMeasure.value	unitPricingMeasure.value	The value of the measure for the item’s unit pricing.	metric