Google Merchant Center: Most-used fields

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.

FieldAdverity UI nameType
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.

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.

id Metric

A unique identifier for the product resource in the API.

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.link Dimension

The URL of the product's landing page on the merchant's website.

productAttributes.title Dimension

The main title or name of the product.

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.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).

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.

title Dimension

The name or title of the product as displayed to customers.