Skip to content
Book a demo

Connect documentation

All documentation
Documentation

Amazon Advertising Unified (Beta): Most-used fields

The table below gives information about most-used fields that you can import from Amazon Advertising Unified (Beta). 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
Ad IDMetric

A unique identifier for the advertisement.

Ad group IDMetric

A unique identifier for the ad group.

Ad group end dateDimension

The calendar date on which the ad group is scheduled to end.

Ad group nameDimension

The name of the ad group.

Ad group start dateDimension

The calendar date on which the ad group is scheduled to begin.

Ad nameDimension

The name of the advertisement.

Ad productDimension

The Amazon Advertising product associated with the advertisement (e.g., Sponsored Products, Sponsored Brands, Sponsored Display).

Add to cartMetric

The total number of times products were added to a shopping cart after an ad interaction.

Add to cart (new to brand)Metric

The number of add-to-cart events generated by shoppers who are identified as new to the brand.

Add to cart (promoted)Metric

The number of times promoted products were added to a shopping cart after an ad interaction.

Add to listMetric

The number of times products were added to a wishlist or similar list after an ad interaction.

Add to shopping cart (off-Amazon)Metric

The number of times products were added to a shopping cart from interactions originating off Amazon.

Advertised product IDDimension

A unique identifier for the product being advertised.

Advertised product SKUDimension

The Stock Keeping Unit (SKU) for the product being advertised.

Advertised product brandDimension

The brand associated with the product that was featured or promoted in the advertisement.

Advertised product categoryDimension

The category of the product that was featured or promoted in the advertisement.

Advertised product groupDimension

The group classification for the product that was featured or promoted in the advertisement.

Advertised product marketplaceDimension

The Amazon marketplace where the product was advertised (e.g., US, UK, DE).

Advertised product nameDimension

The name of the product that was featured or promoted in the advertisement.

Advertised product parent IDDimension

The unique identifier of the parent product for the advertised product, useful for understanding product variations.

Advertised product subcategoryDimension

The subcategory of the product that was featured or promoted in the advertisement.

Advertiser account IDDimension

A unique identifier for the advertiser's account.

Advertiser account nameDimension

The name of the advertiser's account.

Budget currencyDimension

The currency in which the budget amounts are specified.

Campaign IDDimension

A unique identifier for the campaign.

Campaign countryDimension

The country where the advertising campaign is geographically targeted or running.

Campaign currency codeDimension

The currency code (e.g., USD, EUR) used for the campaign's budget and reporting.

Campaign end dateDimension

The calendar date on which the campaign is scheduled to end.

Campaign nameDimension

The name of the campaign.

Campaign start dateDimension

The calendar date on which the campaign is scheduled to begin.

ClicksMetric

The number of times an advertisement was clicked.

Complete listens (audio ad)Metric

The number of times an audio advertisement was listened to completely.

Complete views (video ad)Metric

The number of times a video advertisement was viewed completely.

Conversions (off-Amazon)Metric

The total number of conversion events that occurred outside of Amazon.

Conversions from clicks (off-Amazon)Metric

The number of off-Amazon conversion events attributed to clicks on an advertisement.

Conversions from views (off-Amazon)Metric

The number of off-Amazon conversion events attributed to views of an advertisement.

CountryDimension

The country associated with the advertising activity.

Country codeDimension

The two-letter country code (e.g., US, UK) associated with the advertising activity.

DateDimension

The date of the ad interaction, which is used for reporting conversion metrics.

Day of monthDimension

The specific day of the month when an ad interaction or conversion event occurred.

Detail page viewsMetric

The number of times product detail pages were viewed.

Detail page views (halo)Metric

The number of detail page views for products that are highly relevant to the campaign but not directly promoted, referred to as 'halo' products.

Detail page views (promoted)Metric

The number of times product detail pages were viewed for promoted products.

First quartile (audio ad)Metric

The number of times an audio advertisement was played through at least its first 25%.

First quartile (video ad)Metric

The number of times a video advertisement was played through at least its first 25%.

ImpressionsMetric

The total number of times an advertisement was displayed.

Midpoint (audio ad)Metric

The number of times an audio advertisement was played through at least its midpoint (50%).

Midpoint (video ad)Metric

The number of times a video advertisement was played through at least its midpoint (50%).

Mutes (audio ad)Metric

The number of times an audio advertisement was muted by a user.

Mutes (video ad)Metric

The number of times a video advertisement was muted by a user.

Page views (off-Amazon)Metric

The total number of page views occurring on websites or applications outside of Amazon, attributed to an advertisement.

Pauses (video ad)Metric
Portfolio IDDimension

The unique identifier for the portfolio, which is a collection of campaigns.

Portfolio nameDimension

The name of the portfolio as defined by the advertiser.

PurchasesMetric

The total number of purchases made after an ad interaction, including both promoted and halo conversions.

Purchases (halo)Metric

The total number of attributed purchases of highly relevant (non-promoted) products, referred to as 'halo' products.

Purchases (new to brand)Metric

The number of purchases made by customers identified as new to the brand after an ad interaction.

Purchases (new to brand, halo)Metric

The total number of attributed purchases of highly relevant (non-promoted) products by shoppers who are new to the brand.

Purchases (new to brand, promoted)Metric

The number of purchases made by customers new to the brand, specifically from promoted products, after an ad interaction.

Purchases (off-Amazon)Metric

The total number of purchases that occurred on properties outside of Amazon, attributed to an advertisement.

Purchases (promoted)Metric

The number of purchases made for promoted products after an ad interaction.

Purchases from clicksMetric

The number of purchases attributed to clicks on an advertisement.

Purchases from clicks (new to brand)Metric

The number of purchases made by customers new to the brand, attributed to clicks on an advertisement.

Purchases from clicks (new to brand, promoted)Metric

The number of purchases made by customers new to the brand for promoted products, attributed to clicks on an advertisement.

Purchases from clicks (promoted)Metric

The number of purchases made for promoted products, attributed to clicks on an advertisement.

Purchases from viewsMetric

The number of purchases attributed to views of an advertisement.

Purchases from views (promoted)Metric

The number of purchases made for promoted products, attributed to views of an advertisement.

Report dateDimension

The specific date for which the report data is generated or represents.

SalesMetric

The total monetary value of sales generated from advertising activities.

Sales (halo)Metric

The total sales value attributed to products that are highly relevant to the campaign but not directly promoted, referred to as 'halo' products.

Sales (new to brand)Metric

The monetary value of sales generated from customers new to the brand.

Sales (new to brand, halo)Metric

The total sales value attributed to highly relevant (non-promoted) products purchased by shoppers who are new to the brand.

Sales (new to brand, promoted)Metric

The monetary value of sales generated from customers new to the brand through promoted ads.

Sales (off-Amazon)Metric

The monetary value of sales generated from off-Amazon sources.

Sales (promoted)Metric

The monetary value of sales generated from promoted ads.

Sales from clicksMetric

The monetary value of sales attributed to clicks on an advertisement.

Sales from clicks (new to brand)Metric

The monetary value of sales generated from customers new to the brand, attributed to ad clicks.

Sales from clicks (new to brand, promoted)Metric

The monetary value of sales generated from customers new to the brand through promoted ads, attributed to ad clicks.

Sales from clicks (off-Amazon)Metric

The monetary value of sales from off-Amazon sources attributed to ad clicks.

Sales from clicks (promoted)Metric

The monetary value of sales from promoted ads attributed to ad clicks.

Sales from views (off-Amazon)Metric

The monetary value of sales from off-Amazon sources attributed to ad views.

Starts (audio ad)Metric

The number of times an audio advertisement began playing.

Starts (video ad)Metric

The number of times a video advertisement began playing.

Supply costMetric

The cost incurred for the advertising supply (e.g., ad placements).

Third quartile (audio ad)Metric

The number of times an audio advertisement was played through at least its third 75%.

Third quartile (video ad)Metric

The number of times a video advertisement was played through at least its third 75%.

Total costMetric

The total cost of the advertising campaign, encompassing all expenses.

Units soldMetric

The total number of units of products sold after an ad interaction.

Units sold (halo)Metric

The total number of units sold for products that are highly relevant to the campaign but not directly promoted, referred to as 'halo' products.

Units sold (new to brand)Metric

The number of units sold to customers identified as new to the brand after an ad interaction.

Units sold (new to brand, halo)Metric

The total number of units sold for highly relevant (non-promoted) products by shoppers who are new to the brand.

Units sold (new to brand, promoted)Metric

The number of units of promoted products sold to customers new to the brand after an ad interaction.

Units sold (off-Amazon)Metric

The number of units sold from interactions originating off Amazon.

Units sold (promoted)Metric

The number of units of promoted products sold after an ad interaction.

Units sold from clicksMetric

The number of units sold attributed to clicks on an advertisement.

Units sold from clicks (new to brand)Metric

The number of units sold to customers new to the brand, attributed to clicks on an advertisement.

Units sold from clicks (new to brand, promoted)Metric

The number of units of promoted products sold to customers new to the brand, attributed to clicks on an advertisement.

Units sold from clicks (off-Amazon)Metric

The number of units sold from off-Amazon sources, attributed to clicks on an advertisement.

Units sold from clicks (promoted)Metric

The number of units of promoted products sold, attributed to clicks on an advertisement.

Units sold from views (off-Amazon)Metric

The number of units sold from off-Amazon sources, attributed to views of an advertisement.

Unmutes (audio ad)Metric

The number of times an audio advertisement was unmuted by a user.

Unmutes (video ad)Metric

The number of times a video advertisement was unmuted by a user.

Viewable impressionsMetric

The number of impressions that were considered viewable according to industry standards.

YearDimension

The calendar year in which the advertising activity occurred.