Google Merchant Center: Most-used fields#
The table below gives information about most-used fields that you can import from Google Merchant Center. 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 to which metrics or product information apply, typically used in reporting to filter or segment data. |
dimension |
accountId |
accountId |
A unique identifier for a Google Merchant Center account. |
metric |
accountName |
accountName |
The name of a Google Merchant Center account. |
dimension |
base64EncodedName |
base64EncodedName |
A base64 encoded unique identifier for a product, used in API calls where URLs might have problematic characters. |
dimension |
contentLanguage |
contentLanguage |
The language of the product content, indicating the target audience’s language. |
dimension |
customAttributes.0.name |
customAttributes.0.name |
The name of a custom attribute defined by the merchant for additional product information. |
dimension |
customAttributes.0.value |
customAttributes.0.value |
The value of a custom attribute defined by the merchant. |
dimension |
customAttributes.1.name |
customAttributes.1.name |
The name of a custom attribute defined by the merchant for additional product information. |
dimension |
customAttributes.1.value |
customAttributes.1.value |
The value of a custom attribute defined by the merchant. |
metric |
customAttributes.2.name |
customAttributes.2.name |
The name of a custom attribute defined by the merchant for additional product information. |
dimension |
customAttributes.2.value |
customAttributes.2.value |
The value of a custom attribute defined by the merchant. |
metric |
customAttributes.3.name |
customAttributes.3.name |
The name of a custom attribute defined by the merchant for additional product information. |
dimension |
customAttributes.3.value |
customAttributes.3.value |
The value of a custom attribute defined by the merchant. |
dimension |
customAttributes.4.name |
customAttributes.4.name |
The name of a custom attribute defined by the merchant for additional product information. |
dimension |
customAttributes.4.value |
customAttributes.4.value |
The value of a custom attribute defined by the merchant. |
metric |
customAttributes.5.name |
customAttributes.5.name |
The name of a custom attribute defined by the merchant for additional product information. |
dimension |
customAttributes.5.value |
customAttributes.5.value |
The value of a custom attribute defined by the merchant. |
metric |
customAttributes.6.name |
customAttributes.6.name |
The name of a custom attribute defined by the merchant for additional product information. |
dimension |
customAttributes.6.value |
customAttributes.6.value |
The value of a custom attribute defined by the merchant. |
metric |
customAttributes.7.name |
customAttributes.7.name |
The name of a custom attribute defined by the merchant for additional product information. |
dimension |
customAttributes.7.value |
customAttributes.7.value |
The value of a custom attribute defined by the merchant. |
metric |
dataSource |
dataSource |
The source from which product data is submitted to Merchant Center, such as an API or a feed file. |
dimension |
feedLabel |
feedLabel |
A label associated with a product feed, often used to specify target country or language. |
dimension |
legacyLocal |
legacyLocal |
dimension |
|
name |
name |
The unique identifier of the product within the Merchant Center API, typically in a formatted string. |
dimension |
offerId |
offerId |
The unique identifier of a specific product offer, typically equivalent to an SKU. |
dimension |
productAttributes.additionalImageLinks.0 |
productAttributes.additionalImageLinks.0 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.additionalImageLinks.1 |
productAttributes.additionalImageLinks.1 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.additionalImageLinks.10 |
productAttributes.additionalImageLinks.10 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.additionalImageLinks.11 |
productAttributes.additionalImageLinks.11 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.additionalImageLinks.12 |
productAttributes.additionalImageLinks.12 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.additionalImageLinks.13 |
productAttributes.additionalImageLinks.13 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.additionalImageLinks.2 |
productAttributes.additionalImageLinks.2 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.additionalImageLinks.3 |
productAttributes.additionalImageLinks.3 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.additionalImageLinks.4 |
productAttributes.additionalImageLinks.4 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.additionalImageLinks.5 |
productAttributes.additionalImageLinks.5 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.additionalImageLinks.6 |
productAttributes.additionalImageLinks.6 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.additionalImageLinks.7 |
productAttributes.additionalImageLinks.7 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.additionalImageLinks.8 |
productAttributes.additionalImageLinks.8 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.additionalImageLinks.9 |
productAttributes.additionalImageLinks.9 |
An additional URL for an image of the product, beyond the main product image. |
dimension |
productAttributes.ageGroup |
productAttributes.ageGroup |
The target age group for the product, such as ‘newborn’, ‘infant’, ‘toddler’, ‘kids’, ‘adult’. |
metric |
productAttributes.availability |
productAttributes.availability |
The current stock status of the product, e.g., ‘in stock’, ‘out of stock’, ‘preorder’, or ‘backorder’. |
metric |
productAttributes.brand |
productAttributes.brand |
The brand or manufacturer name of the product. |
dimension |
productAttributes.color |
productAttributes.color |
The color of the product. |
dimension |
productAttributes.condition |
productAttributes.condition |
The condition of the product, e.g., ‘new’, ‘refurbished’, or ‘used’. |
metric |
productAttributes.costOfGoodsSold.amountMicros |
productAttributes.costOfGoodsSold.amountMicros |
The cost of goods sold for the product in micros (millionths of the currency unit). |
metric |
productAttributes.costOfGoodsSold.currencyCode |
productAttributes.costOfGoodsSold.currencyCode |
The currency code for the cost of goods sold. |
dimension |
productAttributes.customLabel0 |
productAttributes.customLabel0 |
A custom label for organizing products for advertising campaigns or internal use. |
dimension |
productAttributes.customLabel1 |
productAttributes.customLabel1 |
A custom label for organizing products for advertising campaigns or internal use. |
dimension |
productAttributes.customLabel2 |
productAttributes.customLabel2 |
A custom label for organizing products for advertising campaigns or internal use. |
dimension |
productAttributes.customLabel3 |
productAttributes.customLabel3 |
A custom label for organizing products for advertising campaigns or internal use. |
dimension |
productAttributes.customLabel4 |
productAttributes.customLabel4 |
A custom label for organizing products for advertising campaigns or internal use. |
dimension |
productAttributes.description |
productAttributes.description |
A detailed text description of the product. |
dimension |
productAttributes.excludedDestinations.0 |
productAttributes.excludedDestinations.0 |
A destination (e.g., ‘Shopping ads’, ‘Free listings’) where the product should not be shown. |
metric |
productAttributes.excludedDestinations.1 |
productAttributes.excludedDestinations.1 |
A destination (e.g., ‘Shopping ads’, ‘Free listings’) where the product should not be shown. |
metric |
productAttributes.gender |
productAttributes.gender |
The gender that the product is intended for. |
metric |
productAttributes.googleProductCategory |
productAttributes.googleProductCategory |
The Google’s standardized category for the product, based on Google’s product taxonomy. |
dimension |
productAttributes.gtins |
productAttributes.gtins |
Global Trade Item Numbers (GTINs) for the product, such as UPC, EAN, or ISBN. |
dimension |
productAttributes.identifierExists |
productAttributes.identifierExists |
Indicates whether unique product identifiers (like GTIN, MPN, or brand) exist for the product. |
dimension |
productAttributes.imageLink |
productAttributes.imageLink |
The URL of the main image for the product. |
dimension |
productAttributes.itemGroupId |
productAttributes.itemGroupId |
An ID used to group different variants of the same product (e.g., different sizes or colors of a shirt). |
dimension |
productAttributes.link |
productAttributes.link |
The URL of the product’s landing page on the merchant’s website. |
dimension |
productAttributes.material |
productAttributes.material |
The primary material or fabric composition of the product. |
dimension |
productAttributes.mpn |
productAttributes.mpn |
The Manufacturer Part Number (MPN) for the product. |
dimension |
productAttributes.price.amountMicros |
productAttributes.price.amountMicros |
The current price of the product in micros (millionths of the currency unit). |
metric |
productAttributes.price.currencyCode |
productAttributes.price.currencyCode |
The currency code for the product’s price. |
dimension |
productAttributes.productDetails.0.attributeName |
productAttributes.productDetails.0.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.0.attributeValue |
productAttributes.productDetails.0.attributeValue |
The value of a detailed product attribute. |
metric |
productAttributes.productDetails.0.sectionName |
productAttributes.productDetails.0.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.1.attributeName |
productAttributes.productDetails.1.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.1.attributeValue |
productAttributes.productDetails.1.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.1.sectionName |
productAttributes.productDetails.1.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.10.attributeName |
productAttributes.productDetails.10.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.10.attributeValue |
productAttributes.productDetails.10.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.10.sectionName |
productAttributes.productDetails.10.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.11.attributeName |
productAttributes.productDetails.11.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.11.attributeValue |
productAttributes.productDetails.11.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.11.sectionName |
productAttributes.productDetails.11.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.12.attributeName |
productAttributes.productDetails.12.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.12.attributeValue |
productAttributes.productDetails.12.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.12.sectionName |
productAttributes.productDetails.12.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.13.attributeName |
productAttributes.productDetails.13.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.13.attributeValue |
productAttributes.productDetails.13.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.13.sectionName |
productAttributes.productDetails.13.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.14.attributeName |
productAttributes.productDetails.14.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.14.attributeValue |
productAttributes.productDetails.14.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.14.sectionName |
productAttributes.productDetails.14.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.15.attributeName |
productAttributes.productDetails.15.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.15.attributeValue |
productAttributes.productDetails.15.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.15.sectionName |
productAttributes.productDetails.15.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.2.attributeName |
productAttributes.productDetails.2.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.2.attributeValue |
productAttributes.productDetails.2.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.2.sectionName |
productAttributes.productDetails.2.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.3.attributeName |
productAttributes.productDetails.3.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.3.attributeValue |
productAttributes.productDetails.3.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.3.sectionName |
productAttributes.productDetails.3.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.4.attributeName |
productAttributes.productDetails.4.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.4.attributeValue |
productAttributes.productDetails.4.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.4.sectionName |
productAttributes.productDetails.4.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.5.attributeName |
productAttributes.productDetails.5.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.5.attributeValue |
productAttributes.productDetails.5.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.5.sectionName |
productAttributes.productDetails.5.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.6.attributeName |
productAttributes.productDetails.6.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.6.attributeValue |
productAttributes.productDetails.6.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.6.sectionName |
productAttributes.productDetails.6.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.7.attributeName |
productAttributes.productDetails.7.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.7.attributeValue |
productAttributes.productDetails.7.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.7.sectionName |
productAttributes.productDetails.7.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.8.attributeName |
productAttributes.productDetails.8.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.8.attributeValue |
productAttributes.productDetails.8.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.8.sectionName |
productAttributes.productDetails.8.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productDetails.9.attributeName |
productAttributes.productDetails.9.attributeName |
The name of a detailed product attribute, providing specific technical or descriptive information. |
dimension |
productAttributes.productDetails.9.attributeValue |
productAttributes.productDetails.9.attributeValue |
The value of a detailed product attribute. |
dimension |
productAttributes.productDetails.9.sectionName |
productAttributes.productDetails.9.sectionName |
The section name for a group of detailed product attributes. |
dimension |
productAttributes.productHighlights.0 |
productAttributes.productHighlights.0 |
A key selling point or prominent feature of the product. |
dimension |
productAttributes.productHighlights.1 |
productAttributes.productHighlights.1 |
A key selling point or prominent feature of the product. |
dimension |
productAttributes.productHighlights.2 |
productAttributes.productHighlights.2 |
A key selling point or prominent feature of the product. |
dimension |
productAttributes.productHighlights.3 |
productAttributes.productHighlights.3 |
A key selling point or prominent feature of the product. |
dimension |
productAttributes.productHighlights.4 |
productAttributes.productHighlights.4 |
A key selling point or prominent feature of the product. |
dimension |
productAttributes.productHighlights.5 |
productAttributes.productHighlights.5 |
A key selling point or prominent feature of the product. |
dimension |
productAttributes.productHighlights.6 |
productAttributes.productHighlights.6 |
A key selling point or prominent feature of the product. |
dimension |
productAttributes.productHighlights.7 |
productAttributes.productHighlights.7 |
A key selling point or prominent feature of the product. |
dimension |
productAttributes.productHighlights.8 |
productAttributes.productHighlights.8 |
A key selling point or prominent feature of the product. |
dimension |
productAttributes.productHighlights.9 |
productAttributes.productHighlights.9 |
A key selling point or prominent feature of the product. |
dimension |
productAttributes.productTypes.0 |
productAttributes.productTypes.0 |
A product type from the merchant’s own categorization, used to organize inventory. |
dimension |
productAttributes.promotionIds.0 |
productAttributes.promotionIds.0 |
The unique ID of a promotion associated with the product. |
dimension |
productAttributes.salePrice.amountMicros |
productAttributes.salePrice.amountMicros |
The advertised sale price of the product in micros (millionths of the currency unit). |
metric |
productAttributes.salePrice.currencyCode |
productAttributes.salePrice.currencyCode |
The currency code for the product’s sale price. |
dimension |
productAttributes.shipping |
productAttributes.shipping |
Shipping information for the product, including details like shipping costs or labels. |
dimension |
productAttributes.shippingWeight.unit |
productAttributes.shippingWeight.unit |
The unit of measurement for the product’s shipping weight (e.g., ‘kg’, ‘lb’). |
dimension |
productAttributes.shippingWeight.value |
productAttributes.shippingWeight.value |
The numerical value of the product’s shipping weight. |
metric |
productAttributes.size |
productAttributes.size |
The size of the product. |
dimension |
productAttributes.title |
productAttributes.title |
The main title or name of the product. |
dimension |
productAttributes.unitPricingBaseMeasure.unit |
productAttributes.unitPricingBaseMeasure.unit |
The unit of the denominator for the product’s unit price (e.g., ‘oz’, ‘ml’). |
dimension |
productAttributes.unitPricingBaseMeasure.value |
productAttributes.unitPricingBaseMeasure.value |
The value of the denominator for the product’s unit price. |
metric |
productAttributes.unitPricingMeasure.unit |
productAttributes.unitPricingMeasure.unit |
The unit of the product’s unit price measure (e.g., ‘oz’, ‘ml’). |
dimension |
productAttributes.unitPricingMeasure.value |
productAttributes.unitPricingMeasure.value |
The value of the product’s unit price measure. |
metric |
productStatus.creationDate |
productStatus.creationDate |
The date when the product was first created in Merchant Center. |
dimension |
productStatus.destinationStatuses |
productStatus.destinationStatuses |
The status of the product across various Google destinations (e.g., Shopping ads, Free listings). |
dimension |
productStatus.googleExpirationDate |
productStatus.googleExpirationDate |
The date when the product is scheduled to expire on Google surfaces. |
dimension |
productStatus.itemLevelIssues |
productStatus.itemLevelIssues |
A list of specific issues or policy violations detected for the product. |
dimension |
productStatus.lastUpdateDate |
productStatus.lastUpdateDate |
The date when the product’s information was last updated in Merchant Center. |
dimension |