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
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
brand	brand	The brand name of the product.	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
creationDate	creationDate	The date and time when the product was created, in ISO 8601 format.	dimension
customAttributes.{NUM}.name	customAttributes.{NUM}.name	The name of a custom attribute defined by the merchant.	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}.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}.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
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
feedLabel	feedLabel	The label associated with the product’s feed.	dimension
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).	dimension
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
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
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
material	material	The material(s) from which the product is made.	dimension
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
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
offerId	offerId	The unique merchant-defined identifier for the product offer.	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
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
productTypes.{NUM}	productTypes.{NUM}	The merchant-specific product type or category.	dimension
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
shipping.{NUM}.country	shipping.{NUM}.country	The country code (ISO 3166-1 alpha-2) for a specific shipping service.	dimension
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
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
targetCountry	targetCountry	The target country for which the product information is provided.	dimension
title	title	The title of the product.	dimension
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