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.
Date Dimension
Represents a specific date for which report data is available, often used to filter or segment performance queries within a defined date range.
accountId Dimension
A unique identifier for a Google Merchant Center account.
accountName Dimension
The name of a Google Merchant Center account.
availability Dimension
Indicates the current stock status of the product (e.g., in stock, out of stock, preorder). This is a frequently updated product attribute.
base64EncodedName Dimension
An output-only field containing the unpadded base64url encoded name of the processed product, used for API methods that require the product name to be encoded.
benchmarkPrice.amountMicros Metric
The price amount in micros, where one million micros is equivalent to one unit of the currency (e.g., 1,000,000 micros equals 1 USD).
benchmarkPrice.currencyCode Dimension
The three-letter ISO 4217 currency code for the benchmark price.
brand Dimension
The brand of the product. This attribute can be used for reporting and segmentation.
clicks Metric
The number of times users have interacted with a product listing by clicking on it. This is a performance metric available in reports.
condition Dimension
The condition of the product at the time of sale, such as 'new', 'refurbished', or 'used'.
contentLanguage Dimension
The two-letter ISO 639-1 language code associated with the product content, indicating the language of the product data.
conversions Metric
The number of conversions attributed to the product listings. This is a performance metric available in reports.
dataSource Dimension
The source from which product data is submitted to Merchant Center, such as an API or a feed file.
feedLabel Dimension
A label associated with a product feed, often used to specify target country or language.
id Metric
A unique identifier for the product resource in the API.
impressions Metric
The number of times a product listing has been displayed to users. This is a performance metric available in reports.
name Dimension
The unique identifier for a product, often represented as a resource name in the format `accounts/{account}/productInputs/{productinput}` or `accounts/{account}/products/{product}`.
offerId Dimension
The unique merchant-defined identifier for the product offer.
price.amountMicros Metric
The price of the product in micros (one millionth of the currency unit). For example, 1 USD is 1,000,000 micros.
price.currencyCode Dimension
The ISO 4217 currency code for the product's price (e.g., 'USD', 'EUR').
productAttributes.additionalImageLinks.{NUM} Dimension
Additional URLs for images of the product, providing more visual context beyond the primary image.
productAttributes.adult Dimension
Indicates whether the product contains adult content, such as nudity or sexually suggestive material.
productAttributes.ageGroup Metric
The target age group for the product, such as 'newborn', 'infant', 'toddler', 'kids', 'adult'.
productAttributes.availability Metric
The current stock status of the product, e.g., 'in stock', 'out of stock', 'preorder', or 'backorder'.
productAttributes.brand Dimension
The brand or manufacturer name of the product.
productAttributes.color Dimension
The color of the product.
productAttributes.condition Metric
The condition of the product, e.g., 'new', 'refurbished', or 'used'.
productAttributes.customLabel0 Dimension
A custom label for organizing products for advertising campaigns or internal use.
productAttributes.customLabel1 Dimension
A custom label for organizing products for advertising campaigns or internal use.
productAttributes.customLabel2 Dimension
A custom label for organizing products for advertising campaigns or internal use.
productAttributes.customLabel3 Dimension
A custom label for organizing products for advertising campaigns or internal use.
productAttributes.customLabel4 Dimension
A custom label for organizing products for advertising campaigns or internal use.
productAttributes.description Dimension
A detailed text description of the product.
productAttributes.gender Metric
The gender that the product is intended for.
productAttributes.gtins Dimension
Global Trade Item Numbers (GTINs) for the product, such as UPC, EAN, or ISBN.
productAttributes.imageLink Dimension
The URL of the main image for the product.
productAttributes.itemGroupId Dimension
An ID used to group different variants of the same product (e.g., different sizes or colors of a shirt).
productAttributes.link Dimension
The URL of the product's landing page on the merchant's website.
productAttributes.mpn Dimension
The Manufacturer Part Number (MPN) for the product.
productAttributes.price.amountMicros Metric
The current price of the product in micros (millionths of the currency unit).
productAttributes.price.currencyCode Dimension
The currency code for the product's price.
productAttributes.productTypes.{NUM} Dimension
A merchant-defined categorization of the product. Product types are organized in a hierarchy with multiple levels.
productAttributes.salePrice.amountMicros Metric
The advertised sale price of the product in micros (millionths of the currency unit).
productAttributes.salePrice.currencyCode Dimension
The currency code for the product's sale price.
productAttributes.shipping Dimension
Shipping information for the product, including details like shipping costs or labels.
productAttributes.size Dimension
The size of the product.
productAttributes.title Dimension
The main title or name of the product.
productStatus.creationDate Dimension
The date when the product was first created in Merchant Center.
productStatus.destinationStatuses Dimension
The status of the product across various Google destinations (e.g., Shopping ads, Free listings).
productStatus.destinationStatuses.{NUM}.approvedCountries Dimension
A list of country codes (ISO 3166-1 alpha-2) where the product is approved for a specific destination (e.g., Shopping Ads, Free Listings).
productStatus.destinationStatuses.{NUM}.disapprovedCountries Dimension
A list of country codes (ISO 3166-1 alpha-2) where the product is disapproved for a specific destination (e.g., Shopping Ads, Free Listings).
productStatus.destinationStatuses.{NUM}.pendingCountries Dimension
A list of country codes (ISO 3166-1 alpha-2) where the product's status is pending for a specific destination (e.g., Shopping Ads, Free Listings).
productStatus.destinationStatuses.{NUM}.reportingContext Metric
The context in which the product's destination status is reported, indicating where the product appears across Google surfaces (e.g., SHOPPING_ADS, FREE_LISTINGS).
productStatus.googleExpirationDate Dimension
The date when the product is scheduled to expire on Google surfaces.
productStatus.itemLevelIssues Dimension
A list of specific issues or policy violations detected for the product.
productStatus.itemLevelIssues.{NUM}.applicableCountries Dimension
A list of country codes (ISO 3166-1 alpha-2) where a specific item-level issue applies to the product.
productStatus.itemLevelIssues.{NUM}.attribute Dimension
The product attribute that is related to the item-level issue.
productStatus.itemLevelIssues.{NUM}.code Dimension
The specific error or warning code for an item-level issue affecting the product.
productStatus.itemLevelIssues.{NUM}.description Dimension
A human-readable description of an item-level issue affecting the product.
productStatus.itemLevelIssues.{NUM}.detail Dimension
Additional details or context regarding an item-level issue affecting the product.
productStatus.itemLevelIssues.{NUM}.documentation Dimension
A URL linking to documentation that provides more information about the item-level issue.
productStatus.itemLevelIssues.{NUM}.reportingContext Metric
The context in which an item-level issue is reported, indicating the Google surface where the issue was detected (e.g., SHOPPING_ADS, FREE_LISTINGS).
productStatus.itemLevelIssues.{NUM}.resolution Dimension
Recommended steps or actions to resolve an item-level issue affecting the product.
productStatus.itemLevelIssues.{NUM}.severity Metric
The severity level of the item-level issue (e.g., critical, warning).
productStatus.lastUpdateDate Dimension
The date when the product's information was last updated in Merchant Center.
reportCategoryId Metric
The Google product taxonomy category ID that applies to a specific report or product benchmark.
reportCountryCode Dimension
The CLDR (Common Locale Data Repository) territory code representing the country relevant to the report data, such as product statuses or competitive benchmarks.
reportDate Dimension
The specific date for which the report data is generated, typically in the merchant's timezone.
reportGranularity Dimension
The level of detail or aggregation at which the report data is provided, such as daily, weekly, or monthly granularity, for various report segments.
title Dimension
The name or title of the product as displayed to customers.