Skip to content
Book a demo

Connect documentation

All documentation
Documentation

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
DateDimension

Represents a specific date for which report data is available, often used to filter or segment performance queries within a defined date range.

accountIdDimension

A unique identifier for a Google Merchant Center account.

accountNameDimension

The unique identifier for a Google Merchant Center account. This ID is used to specify which Merchant Center account to retrieve product data or reports for.

benchmarkPrice.amountMicrosMetric

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

The three-letter ISO 4217 currency code for the benchmark price.

brandDimension

The brand of the product. This attribute can be used for reporting and segmentation.

idMetric

A unique identifier for the product resource in the API.

nameDimension

The unique identifier for a product, often represented as a resource name in the format `accounts/{account}/productInputs/{productinput}` or `accounts/{account}/products/{product}`.

offerIdDimension

The unique merchant-defined identifier for the product offer.

price.amountMicrosMetric

The price of the product in micros (one millionth of the currency unit). For example, 1 USD is 1,000,000 micros.

price.currencyCodeDimension

The ISO 4217 currency code for the product's price (e.g., 'USD', 'EUR').

productAttributes.linkDimension

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

productAttributes.titleDimension

The main title or name of the product.

productStatus.destinationStatuses.{NUM}.approvedCountriesDimension

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}.disapprovedCountriesDimension

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}.pendingCountriesDimension

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}.reportingContextMetric

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}.applicableCountriesDimension

A list of country codes (ISO 3166-1 alpha-2) where a specific item-level issue applies to the product.

productStatus.itemLevelIssues.{NUM}.attributeDimension

The product attribute that is related to the item-level issue.

productStatus.itemLevelIssues.{NUM}.codeDimension

The specific error or warning code for an item-level issue affecting the product.

productStatus.itemLevelIssues.{NUM}.descriptionDimension

A human-readable description of an item-level issue affecting the product.

productStatus.itemLevelIssues.{NUM}.detailDimension

Additional details or context regarding an item-level issue affecting the product.

productStatus.itemLevelIssues.{NUM}.documentationDimension

A URL linking to documentation that provides more information about the item-level issue.

productStatus.itemLevelIssues.{NUM}.reportingContextMetric

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}.resolutionDimension

Recommended steps or actions to resolve an item-level issue affecting the product.

productStatus.itemLevelIssues.{NUM}.severityMetric

The severity level of the item-level issue (e.g., critical, warning).

reportCountryCodeDimension

The CLDR (Common Locale Data Repository) territory code representing the country relevant to the report data, such as product statuses or competitive benchmarks.

titleDimension

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