Amazon DSP: Most-used fields
The table below gives information about most-used fields that you can import from Amazon DSP. 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.
Advertiser NameDimension
The name of the advertiser associated with the advertising campaign.
Advertiser countryDimension
The country where the advertiser is based.
AudienceDimension
The name of the audience segment targeted or reached by the campaign.
ChannelDimension
The type of inventory or environment where the campaign ran, such as real-time bidding exchanges or Amazon-owned sites.
Combined product sales EURMetric
Sales (in Euros) for purchases on and off Amazon, attributed to an ad view or click.
Combined product sales GBPMetric
Sales (in British Pounds) for purchases on and off Amazon, attributed to an ad view or click.
Combined product sales USDMetric
Sales (in US Dollars) for purchases on and off Amazon, attributed to an ad view or click.
Creative Length SizeDimension
The dimensions or size of the creative asset.
DateDimension
The specific date for which the report data is aggregated.
End DateDimension
The end date of the reporting interval for which the data is collected.
New-to-brand product sales AUDMetric
The sales generated from new-to-brand customers for featured products, denominated in Australian Dollars (AUD).
New-to-brand product sales GBPMetric
The total sales (in British Pounds) of promoted products purchased for the first time over a one-year lookback window by customers on Amazon.
NewToBrandECPPMetric
The effective cost per purchase for new-to-brand customers.
PlatformDimension
The device or software environment (e.g., operating system, browser, application) where the ad was served.
ROASMetric
Return on Ad Spend (ROAS), measuring the revenue generated for every dollar spent on advertising.
Report TypeDimension
The type of report generated, such as Campaign, Inventory, Audience, Products, Technology, Geography, or Brand Suitability, defining the scope of the collected data.
Sales BRLMetric
The sales value generated, denominated in Brazilian Real (BRL).
Sales CADMetric
Total sales (in Canadian Dollars) of promoted ASINs purchased by customers on Amazon after delivering an ad.
Sales GBPMetric
The sales value generated, denominated in Great British Pounds (GBP).
Start DateDimension
The start date of the reporting interval for which the data is collected.
TargetingDimension
The targeting settings applied to the campaign, such as audience segments or content categories.
Total DSP CostMetric
The total financial cost incurred for all advertising activities within the Amazon DSP.
Total new-to-brand product sales AUDMetric
The total sales generated from new-to-brand customers for all featured products, denominated in Australian Dollars (AUD).
Total new-to-brand product sales GBPMetric
The total sales (in British Pounds) of promoted and brand halo products purchased for the first time over a one-year lookback window by customers on Amazon.
Total sales GBPMetric
The total sales value generated, denominated in Great British Pounds (GBP).
Year MonthMetric
The year and month for which the data is aggregated.
ad_invalid_impressionsMetric
The number of invalid impressions for a specific ad, identified by Amazon's traffic detection systems.
ad_invalid_spendMetric
This field represents the advertising spend associated with invalid or fraudulent ad traffic, such as non-human interactions, at the individual ad (creative) level.
ad_nameDimension
The name of the individual creative or ad.
ad_statusDimension
The current operational status of the individual ad (e.g., active, paused, archived).
ad_valid_impressionsMetric
The number of valid impressions for a specific ad, excluding those identified as invalid by Amazon's traffic detection systems.
ad_valid_spendMetric
The total cost incurred for the advertisement, excluding any invalid spend.
addToCartMetric
The number of times a product was added to a shopping cart.
addToCartBrandHaloMetric
The number of add-to-cart events influenced by the campaign, including brand halo effects (products related to the advertised brand).
addToCartBrandHaloClicksMetric
The number of clicks influenced by the campaign that resulted in add-to-cart events, including brand halo effects.
addToCartBrandHaloViewsMetric
The number of views influenced by the campaign that resulted in add-to-cart events, including brand halo effects.
addToCartClicksMetric
The number of clicks that resulted in a product being added to a shopping cart.
addToCartRateMetric
The rate at which products are added to a shopping cart after an ad interaction.
addToCartViewsMetric
The number of ad views that resulted in a product being added to a shopping cart.
addToListMetric
The number of times a product was added to a wishlist or other list.
addToListBrandHaloMetric
The number of 'add to list' events influenced by the campaign, including brand halo effects.
addToListBrandHaloClicksMetric
The number of clicks influenced by the campaign that resulted in 'add to list' events, including brand halo effects.
addToListBrandHaloViewsMetric
The number of views influenced by the campaign that resulted in 'add to list' events, including brand halo effects.
addToListClicksMetric
The number of clicks that resulted in a product being added to a list.
addToListRateMetric
The rate at which products are added to a list after an ad interaction.
addToListViewsMetric
The number of ad views that resulted in a product being added to a list.
addToShoppingCartMetric
The number of times a product was added to a shopping cart.
addToShoppingCartCPAMetric
The cost per action for products added to the shopping cart.
addToShoppingCartCVRMetric
The conversion rate for products added to the shopping cart.
addToShoppingCartClicksMetric
The number of clicks that resulted in a product being added to a shopping cart.
addToShoppingCartValueAverageMetric
The average monetary value of products added to a shopping cart.
addToShoppingCartValueSumMetric
The total monetary value of products added to a shopping cart.
addToShoppingCartViewsMetric
The number of ad views that resulted in a product being added to a shopping cart.
addToWatchlistMetric
The number of times an item was added to a watchlist.
addToWatchlistClicksMetric
The number of clicks that resulted in an item being added to a watchlist.
addToWatchlistRateMetric
The rate at which items are added to a watchlist after an ad interaction.
addToWatchlistViewsMetric
The number of ad views that resulted in an item being added to a watchlist.
adset_invalid_impressionsMetric
The number of invalid impressions recorded for the ad group (also known as line item).
adset_invalid_spendMetric
This field represents the advertising spend associated with invalid or fraudulent traffic at the ad set (line item) level.
adset_nameDimension
The name of the ad group (also known as line item) under which ads are organized.
adset_statusDimension
The current operational status of the ad group (also known as line item), indicating if it is active, paused, or archived.
adset_valid_impressionsMetric
The number of legitimate impressions delivered for the ad group (also known as line item), excluding any invalid impressions.
adset_valid_spendMetric
The amount of spend attributed to legitimate ad activity for the ad group (also known as line item), excluding any invalid spend.
advertiserCountryDimension
The country where the advertiser is located.
advertiserIdDimension
Unique identifier for the advertiser.
advertiserNameDimension
The name of the advertiser.
advertiserTimezoneDimension
The timezone of the advertiser's account.
advertiser_idDimension
A unique identifier assigned to an advertiser.
agencyFeeMetric
Fees charged by the agency managing the advertising campaigns.
alexaSkillEnableMetric
The total number of times an Alexa Skill was enabled or activated.
alexaSkillEnableClicksMetric
The number of clicks that resulted in an Alexa Skill being enabled.
alexaSkillEnableRateMetric
The rate at which Alexa Skills are enabled after an ad interaction.
alexaSkillEnableViewsMetric
The number of ad views that resulted in an Alexa Skill being enabled.
amazonDSPAudienceFeeMetric
Fees related to using audience segments within Amazon DSP.
amazonDSPConsoleFeeMetric
Fees associated with using the Amazon DSP console.
amazonStandardIdDimension
Amazon Standard Identification Number (ASIN) for products.
appStoreFirstOpensMetric
The number of first-time mobile app opens attributed to an ad view or click.
appStoreFirstOpensClicksMetric
The number of first-time mobile app opens from an app store attributed to ad click-throughs.
appStoreFirstOpensRateMetric
The number of first-time mobile app opens from an app store relative to the number of ad impressions.
appStoreFirstOpensViewsMetric
The number of first-time mobile app opens from an app store attributed to ad impressions.
appStoreFirstSessionHoursMetric
The total hours of first-time usage of a mobile app attributed to an ad.
appStoreFirstSessionHoursClicksMetric
The total hours of first-time usage of a mobile app attributed to ad clicks.
appStoreFirstSessionHoursViewsMetric
The total hours of first-time usage of a mobile app attributed to ad views.
appStoreOpensMetric
The number of mobile app opens attributed to an ad view or click.
appStoreOpensClicksMetric
The number of mobile app opens attributed to an ad click-through.
appStoreOpensRateMetric
The rate at which mobile applications are opened after an ad interaction.
appStoreOpensViewsMetric
The number of mobile app opens attributed to an ad impression.
appStoreUsageHoursMetric
The total hours of usage of a mobile app attributed to an ad.
appStoreUsageHoursClicksMetric
The total hours of usage of a mobile app attributed to ad clicks.
appStoreUsageHoursViewsMetric
The total hours of usage of a mobile app attributed to ad views.
appSubscriptionCostDimension
The total cost incurred for application subscriptions attributed to advertising activities.
appSubscriptionFreeTrialCostDimension
The cost associated with free trial application subscriptions attributed to advertising activities.
appSubscriptionSignUpMetric
The total number of application subscription sign-ups attributed to an ad interaction.
appSubscriptionSignUpClicksMetric
The number of application subscription sign-up conversions attributed to an ad click.
appSubscriptionSignUpFreeTrialMetric
The total number of free trial application subscription sign-ups attributed to an ad interaction.
appSubscriptionSignUpFreeTrialClicksMetric
The number of free trial app subscriptions that occurred after a click on an ad.
appSubscriptionSignUpFreeTrialRateMetric
The rate at which users sign up for free trial application subscriptions after an ad interaction.
appSubscriptionSignUpFreeTrialViewsMetric
The number of free trial app subscriptions that occurred after viewing an ad (attributed to ad impressions).
appSubscriptionSignUpPaidMetric
The total number of paid application subscription sign-ups attributed to an ad interaction.
appSubscriptionSignUpPaidClicksMetric
The number of paid app subscriptions that occurred after a click on an ad.
appSubscriptionSignUpPaidCostDimension
The cost associated with paid application subscriptions attributed to advertising activities.
appSubscriptionSignUpPaidRateMetric
The rate at which users sign up for paid application subscriptions after an ad interaction.
appSubscriptionSignUpPaidViewsMetric
The number of paid app subscriptions that occurred after viewing an ad (attributed to ad impressions).
appSubscriptionSignUpRateMetric
The rate at which users sign up for application subscriptions after an ad interaction.
appSubscriptionSignUpViewsMetric
The number of application subscription sign-up conversions attributed to an ad view.
applicationDimension
Metrics related to application-specific events or conversions.
applicationCPADimension
The cost per action for application-related events.
applicationCVRMetric
The conversion rate for application-related events.
applicationClicksMetric
The number of clicks that resulted in an application-related event.
applicationValueAverageDimension
The average monetary value attributed to each 'application' conversion event driven by the campaign.
applicationValueSumMetric
The total monetary value attributed to all 'application' conversion events driven by the campaign.
applicationViewsMetric
The number of ad views that resulted in an application-related event.
asinDimension
The Amazon Standard Identification Number (ASIN) which uniquely identifies a product in the Amazon catalog.
asinConversionTypeDimension
The type of conversion attributed to an ASIN.
audioAdCompanionBannerClicksMetric
The number of clicks on companion banners displayed with audio ads.
audioAdCompanionBannerViewsMetric
The number of views of companion banners displayed with audio ads.
audioAdCompletionRateMetric
The number of audio ad completions relative to the number of audio ad starts.
audioAdCompletionsMetric
The number of times an audio advertisement was played to 100% completion.
audioAdFirstQuartileMetric
The number of times an audio advertisement was played to at least 25% of its total length.
audioAdMidpointMetric
The number of times an audio advertisement was played to at least 50% of its total length.
audioAdMuteMetric
The number of times an audio ad was muted.
audioAdPauseMetric
The number of times an audio ad was paused.
audioAdProgressionMetric
The progression event for an audio ad (e.g., 25%, 50%, 75% played).
audioAdResumeMetric
The number of times an audio ad was resumed after being paused.
audioAdRewindMetric
The number of times an audio ad was rewound.
audioAdSkipMetric
The number of times an audio ad was skipped.
audioAdStartMetric
The number of times an audio advertisement began playing.
audioAdThirdQuartileMetric
The number of times an audio advertisement was played to at least 75% of its total length.
audioAdUnmuteMetric
The number of times an audio ad was unmuted.
audioAdViewsMetric
The number of times an audio advertisement was viewed or played.
averageCostPerClickToApplyDimension
The average cost incurred for each successful "click to apply" event attributed to an advertisement.
averageCostPerKindleDetailPageViewDimension
The average cost incurred to acquire a Kindle product detail page view attributed to an advertisement.
brandNameDimension
The name of the brand associated with the product or campaign.
brandSearchRateMetric
The rate at which brand-related searches occur after an ad interaction.
brandSearchesMetric
The number of searches for the brand following an ad interaction.
brandSearchesClicksMetric
The number of clicks that led to brand-related searches.
brandSearchesViewsMetric
The number of ad views that led to brand-related searches.
browserDimension
The web browser used by customers to view the ad.
browserNameDimension
The web browser used by customers to view the ad.
browserVersionMetric
The specific version of the web browser used by customers to view the ad.
campaign_invalid_impressionsMetric
The number of invalid impressions for a specific campaign, identified by Amazon's traffic detection systems.
campaign_invalid_spendMetric
This field represents the advertising spend associated with invalid or fraudulent traffic, such as non-human impressions or clicks, at the campaign level.
campaign_nameDimension
The name of the advertising campaign.
campaign_statusDimension
The current operational status of the advertising campaign (e.g., active, paused, archived).
campaign_valid_impressionsMetric
The number of valid impressions for a specific campaign, excluding those identified as invalid by Amazon's traffic detection systems.
campaign_valid_spendMetric
The total cost incurred for the advertising campaign, excluding any invalid spend.
checkoutMetric
The total number of checkout completions attributed to an ad.
checkoutCPAMetric
The average cost to acquire a Checkout conversion.
checkoutCVRMetric
The number of Checkout conversions relative to the number of ad impressions.
checkoutClicksMetric
The number of Checkout conversions attributed to an ad click-through.
checkoutValueAverageDimension
The average monetary value of all completed checkouts attributed to advertising campaigns.
checkoutValueSumMetric
The total monetary value of all completed checkouts attributed to advertising campaigns.
checkoutViewsMetric
The number of Checkout conversions attributed to an ad impression.
cityMetric
The city where the ad was displayed.
clickThroughRateMetric
The percentage of impressions that resulted in a click (CTR).
clickThroughsDimension
The total number of times users clicked on an advertisement and were directed to a landing page or destination.
clickToApplyMetric
The total number of times users clicked on an ad to submit an application.
clickToApplyBrandHaloDimension
The total number of application submissions influenced by the campaign, including brand halo effects (events related to the advertised brand, not just the advertised product).
clickToApplyBrandHaloClicksDimension
The number of clicks influenced by the campaign that resulted in an application submission, including brand halo effects.
clickToApplyBrandHaloViewsDimension
The number of ad views influenced by the campaign that resulted in an application submission, including brand halo effects.
clickToApplyClicksMetric
The number of clicks that resulted in an application being submitted.
clickToApplyConversionRateMetric
The rate at which users submit an application after interacting with an ad.
clickToApplyViewsMetric
The number of views that resulted in an application being submitted.
clicksMetric
The total number of clicks on the advertisement.
clickthroughsDimension
A click on an ad that directs the user to a destination outside of the creative.
combinedECPPMetric
The combined effective cost per purchase across multiple product lines or campaigns.
combinedERPMMetric
Effective (average) revenue for sales on and off Amazon generated per thousand impressions.
combinedProductSalesMetric
Sales for purchases on and off Amazon, attributed to an ad view or click.
combinedPurchaseRateMetric
Rate of attributed purchase events on and off Amazon, relative to ad impressions.
combinedPurchasesMetric
The total number of purchases, combining both on-Amazon and off-Amazon purchases.
combinedPurchasesClicksMetric
The total number of purchases (on-Amazon and off-Amazon) attributed to clicks.
combinedPurchasesViewsMetric
The total number of purchases (on-Amazon and off-Amazon) attributed to views.
combinedROASMetric
Return on advertising spend for products sold on and off Amazon, measured as ad-attributed sales per local currency unit of ad spend.
combinedUnitsSoldMetric
Units of product sold on and off Amazon, attributed to an ad view or click.
contactMetric
The total number of contact events (e.g., reaching out to customer service) attributed to an ad.
contactCPAMetric
The average cost to acquire a Contact conversion.
contactCVRMetric
The number of Contact conversions relative to the number of ad impressions.
contactClicksMetric
The number of Contact conversions attributed to an ad click-through.
contactValueAverageDimension
The average monetary value attributed to each 'contact' conversion event (e.g., form submission, call) driven by the campaign.
contactValueSumMetric
The total monetary value attributed to all 'contact' conversion events driven by the campaign.
contactViewsMetric
The number of Contact conversions attributed to an ad impression.
conversionSourceAttributionTypeDimension
Indicates whether the attribution method for a conversion source is owned by Amazon or a third party.
conversionSourceNameDimension
The name of the conversion source (e.g., Amazon or a third party).
conversionSourceOwnerDimension
Indicates whether the conversion source is Amazon or an Amazon partner.
conversionSourceScaledDimension
Indicates whether the conversion data has been scaled from a smaller sample to represent a broader market measurement.
conversionTypeDimension
The type or category of conversion event (e.g., purchase, add-to-cart, sign-up).
costMetric
The total cost incurred for the campaign or ad activity.
countryDimension
The country where the ad was displayed.
creativeAdIdDimension
Unique identifier for the creative within the ad.
creativeIDDimension
Unique identifier for the creative asset.
creativeIdDimension
Unique identifier for the creative asset.
creativeLanguageDimension
The language used in the advertisement's creative content.
creativeNameDimension
The name of the creative asset.
creativeSizeDimension
The dimensions or size of the creative asset.
creativeTypeDimension
The type of creative used (e.g., image, video).
dateDimension
The specific date for which the data is reported.
dealDimension
Information related to the private marketplace deal.
dealIDDimension
Unique identifier for the private marketplace deal.
dealIdMetric
The unique identifier for a private deal or guaranteed deal package used for inventory targeting.
dealTypeDimension
The classification of the advertising deal (e.g., programmatic guaranteed, private marketplace).
designatedMarketAreaCodeDimension
The code for the Designated Market Area (DMA) where the ad was displayed.
designatedMarketAreaNameDimension
The name of the Designated Market Area (DMA) where the ad was displayed.
detailPageViewBrandHaloMetric
The number of detail page views influenced by the campaign, including brand halo effects.
detailPageViewBrandHaloClicksMetric
The number of clicks influenced by the campaign that led to detail page views, including brand halo effects.
detailPageViewBrandHaloViewsMetric
The number of views influenced by the campaign that led to detail page views, including brand halo effects.
detailPageViewClicksMetric
The number of clicks that led to a product detail page view.
detailPageViewRateMetric
The rate at which users view a detail page after an ad interaction.
detailPageViewViewsMetric
The number of ad views that led to a product detail page view.
detailPageViewsMetric
The total number of product detail page views.
deviceDimension
The type of device used by the customer (e.g., desktop, mobile, tablet).
deviceNameDimension
The type or name of the device (e.g., mobile, desktop, tablet) on which the advertisement was displayed.
dmaCodeDimension
The unique code for a Designated Market Area (DMA), used for geographic targeting and reporting.
dmaNameDimension
The name of the Designated Market Area (DMA), used for geographic targeting and reporting.
downloadedVideoPlayRateMetric
The rate at which downloaded videos are played.
downloadedVideoPlaysMetric
The number of times a downloaded video was played.
downloadedVideoPlaysClicksMetric
The number of clicks that resulted in a downloaded video play.
downloadedVideoPlaysViewsMetric
The number of ad views that resulted in a downloaded video play.
eCPAddToCartMetric
The effective cost per add to cart.
eCPAddToListMetric
The effective cost per add to list.
eCPAddToWatchlistMetric
The effective cost per add to watchlist.
eCPAlexaSkillEnableDimension
The effective cost-per-action for an Alexa Skill enablement, representing the average cost incurred to achieve one Alexa Skill enablement.
eCPAppStoreFirstOpensDimension
The average cost to acquire a first-time mobile app open from an app store.
eCPAppStoreOpensDimension
The effective cost per mobile app open.
eCPAudioAdCompletionDimension
The average cost to acquire an audio ad completion.
eCPBrandSearchMetric
The effective cost per brand search.
eCPCMetric
The effective cost per click.
eCPDetailPageViewMetric
The effective cost per detail page view.
eCPDownloadedVideoPlaysDimension
The effective cost per downloaded video play.
eCPFreeTrialSubscriptionSignupDimension
The effective cost per free trial subscription signup.
eCPMMetric
The effective cost per mille (thousand impressions).
eCPPMetric
The effective cost per purchase.
eCPPaidSubscriptionSignupDimension
The effective cost per paid subscription signup.
eCPPlayTrailerDimension
The effective cost per trailer play.
eCPProductReviewPageVisitMetric
The effective cost per product review page visit.
eCPRentalDimension
The effective cost per rental.
eCPSkillInvocationDimension
The effective cost-per-action for a Skill Invocation, representing the average cost incurred to achieve one invocation of an Alexa Skill.
eCPSubscribeAndSaveMetric
The effective cost per Subscribe & Save enrollment.
eCPSubscriptionSignupDimension
The average cost to acquire a Subscribe & Save subscription.
eCPVideoAdCompletionMetric
The effective cost per video ad completion.
eCPVideoDownloadDimension
The effective cost per video download.
eCPVideoStreamDimension
The effective cost per video stream.
eCPnewSubscribeAndSaveMetric
The average cost to acquire a Subscribe & Save subscription.
eRPMMetric
The effective revenue per mille (thousand impressions).
effectiveCostPerSkillInvocationDimension
The effective cost-per-action for an Alexa Skill invocation, representing the average cost incurred to achieve one invocation of an Alexa Skill.
einkDetailPageViewDimension
The total number of e-ink device product detail page views attributed to an ad interaction.
einkDetailPageViewClicksDimension
The number of clicks on an ad that resulted in a product detail page view on an e-ink device.
einkDetailPageViewViewsDimension
The number of ad views that resulted in a product detail page view on an e-ink device.
entityIdDimension
Unique identifier for an entity within Amazon DSP, such as an account or advertiser.
environmentNameDimension
The environment (e.g., web or app) from which the bid request originated.
environmentTypeDimension
The type of environment where the ad was shown (e.g., app, web).
event_nameDimension
The name of a specific event related to ad interaction or conversion.
eventsMetric
The total number of specific events recorded.
featuredASINDimension
The Amazon Standard Identification Number (ASIN) of a featured product.
featuredAsinMetric
The Amazon Standard Identification Number (ASIN) of a product that is prominently featured in the advertisement.
freeTrialSubscriptionSignupClicksMetric
The number of free trial subscriptions for sponsored products that occurred after a click on an ad.
freeTrialSubscriptionSignupRateMetric
The rate at which users sign up for free trial subscriptions after an ad interaction.
freeTrialSubscriptionSignupViewsMetric
The number of free trial subscriptions for sponsored products that occurred after viewing an ad (attributed to ad impressions).
freeTrialSubscriptionSignupsMetric
The number of sign-ups for free trial subscriptions, indicating user interest and initial engagement with an offering. This is often tracked as a conversion event.
frequencyAverageMetric
The average number of times an individual user was exposed to an advertisement.
grossClickThroughsMetric
The total number of clicks on an ad, without any filtering or invalidation.
grossImpressionsMetric
The total number of times an ad was displayed, without any filtering or invalidation.
householdFrequencyAverageMetric
The average number of times an advertisement was delivered to a household.
householdReachMetric
The total number of unique households that were exposed to an advertisement.
impressionFrequencyAverageMetric
The average number of times an advertisement's impressions were delivered to a unique user.
impressionsMetric
The total number of times an ad was displayed.
interactiveImpressionsMetric
Impressions on interactive ad creatives.
intervalEndDimension
The end date of the reporting interval.
intervalStartDimension
The start date of the reporting interval.
invalidClickThroughRateMetric
The rate of invalid click-throughs.
invalidClickThroughsMetric
The number of click-throughs identified as invalid by Amazon's traffic detection systems.
invalidImpressionRateMetric
The rate of invalid impressions.
invalidImpressionsMetric
The number of impressions identified as invalid by Amazon's traffic detection systems.
kindleDetailPageViewMetric
The total number of Kindle product detail page views attributed to an ad interaction.
kindleDetailPageViewClicksMetric
The number of Kindle product detail page view conversions attributed to ad click-throughs.
kindleDetailPageViewRateMetric
The rate of Kindle product detail page views relative to ad impressions or clicks.
kindleDetailPageViewViewsMetric
The number of Kindle product detail page view conversions attributed to ad impressions.
leadMetric
The total number of leads generated (e.g., form submissions, inquiries) attributed to an ad.
leadCPAMetric
The average cost to acquire a Lead conversion.
leadCVRMetric
The number of Lead conversions relative to the number of ad impressions.
leadClicksMetric
The number of Lead conversions attributed to an ad click-through.
leadValueAverageDimension
The average monetary value attributed to each lead generated from advertising campaigns.
leadValueSumMetric
The total value of leads generated.
leadViewsMetric
The number of Lead conversions attributed to an ad impression.
lineItemApprovalStatusMetric
The current status of an Amazon DSP line item within the approval workflow, indicating whether it is approved, pending review, or rejected. A line item is a component of an ad campaign that defines specific targeting, budget, and creative settings.
lineItemBudgetMetric
The budget allocated to a specific line item.
lineItemBudgetCapDimension
The maximum budget allocated to a line item.
lineItemDeliveryRateMetric
The rate at which the line item is spending money relative to its allocated budget and progress within its current flight.
lineItemEndDateDimension
The end date of the line item's activity.
lineItemExternalIdDimension
An external identifier for the line item.
lineItemIdDimension
Unique identifier for the line item.
lineItemLanguageTargetingMetric
The language used for targeting within a specific line item.
lineItemNameDimension
The name of the line item.
lineItemStartDateDimension
The start date of the line item's activity.
lineItemStatusMetric
The current status of a line item within an advertising campaign (e.g., active, paused).
lineItemTypeDimension
The type or category of the line item.
managerAccountIdDimension
The unique identifier for a manager account, which is used to access reporting data for linked Amazon DSP advertiser accounts.
managerAccountNameDimension
The name of the manager account in Amazon Ads.
marketplaceDimension
The Amazon marketplace (e.g., amazon.com, amazon.co.uk) where the ads were displayed.
masterClicksMetric
The total number of click-throughs generated by an advertising campaign.
masterImpressionsMetric
The total number of times an ad was displayed to users.
maxExpectedLatencyHoursMetric
The maximum anticipated delay, expressed in hours, for the processing and availability of data within Amazon DSP reports. This field is a default metric included in DSP reports.
measurableImpressionsMetric
The number of impressions that were measurable according to industry standards.
measurableRateMetric
The rate at which impressions were measurable.
mobileAppFirstStartCPADimension
The average cost to acquire a Mobile app first start conversion.
mobileAppFirstStartCVRMetric
The number of Mobile app first start conversions relative to the number of ad impressions.
mobileAppFirstStartClicksMetric
The number of clicks that resulted in the first start of a mobile application.
mobileAppFirstStartViewsMetric
The number of ad views that resulted in the first start of a mobile application.
mobileAppFirstStartsMetric
The number of first-time starts of a mobile application.
newSubscribeAndSaveMetric
The number of new Subscribe & Save enrollments.
newSubscribeAndSaveBrandHaloMetric
The number of new Subscribe & Save enrollments influenced by the campaign, including brand halo effects.
newSubscribeAndSaveBrandHaloClicksMetric
The number of clicks influenced by the campaign that resulted in new Subscribe & Save enrollments, including brand halo effects.
newSubscribeAndSaveBrandHaloViewsMetric
The number of views influenced by the campaign that resulted in new Subscribe & Save enrollments, including brand halo effects.
newSubscribeAndSaveClicksMetric
The number of clicks that resulted in new Subscribe & Save enrollments.
newSubscribeAndSaveRateMetric
The rate at which new Subscribe & Save enrollments occur after an ad interaction.
newSubscribeAndSaveViewsMetric
The number of ad views that resulted in new Subscribe & Save enrollments.
newToBrandDetailPageViewClicksMetric
The number of detail page view clicks by new-to-brand customers attributed to an ad.
newToBrandDetailPageViewRateMetric
The number of detail page view conversions for promoted products by new-to-brand customers relative to the number of ad impressions.
newToBrandDetailPageViewViewsMetric
The number of detail page view impressions by new-to-brand customers attributed to an ad.
newToBrandDetailPageViewsMetric
The number of product detail page views from customers identified as new-to-brand.
newToBrandECPDetailPageViewMetric
The average cost to acquire a detail page view conversion for new-to-brand customers for promoted products.
newToBrandERPMMetric
The estimated revenue per mille (thousand impressions) from purchases attributed to new-to-brand customers.
newToBrandProductSalesMetric
Total sales generated from purchases made by customers new to the brand within a defined lookback window.
newToBrandProductSales14dMetric
The sales generated from new-to-brand customers for featured products within a 14-day attribution window.
newToBrandPurchasePercentageBrandHaloMetric
The percentage of new-to-brand purchases influenced by the campaign, including brand halo effects.
newToBrandPurchaseRateMetric
The rate at which new-to-brand customers make a purchase after interacting with an ad.
newToBrandPurchasesMetric
The total number of purchases made by customers new to the brand.
newToBrandPurchasesBrandHaloMetric
The number of new-to-brand purchases influenced by the campaign, including brand halo effects.
newToBrandPurchasesBrandHaloClicksMetric
The number of clicks from new-to-brand customers influenced by the campaign that resulted in purchases, including brand halo effects.
newToBrandPurchasesBrandHaloViewsMetric
The number of views from new-to-brand customers influenced by the campaign that resulted in purchases, including brand halo effects.
newToBrandPurchasesClicksMetric
The number of purchases by new-to-brand customers attributed to clicks on an ad.
newToBrandPurchasesPercentageMetric
The percentage of total purchases that are new-to-brand.
newToBrandPurchasesViewsMetric
The number of purchases by new-to-brand customers attributed to views of an ad.
newToBrandROASMetric
The return on ad spend (ROAS) specifically from new-to-brand customer purchases.
newToBrandSalesBrandHaloDimension
Sales generated from customers new to the brand, attributed to the overall brand halo effect of the campaign.
newToBrandUnitsSoldMetric
The number of units sold to customers new to the brand.
newToBrandUnitsSoldBrandHaloDimension
Units of brand halo products purchased by new-to-brand shoppers, attributed to an ad view or click.
offAmazonCPAMetric
Cost per acquisition (CPA) for conversions that occur off Amazon.
offAmazonCVRMetric
Conversion rate for off-Amazon events.
offAmazonClicksMetric
The number of clicks on ads that lead to off-Amazon destinations.
offAmazonConversionsMetric
The total number of conversions that occurred off Amazon.
offAmazonECPPMetric
Effective Cost Per Purchase (ECPP) for products purchased off Amazon, indicating the cost efficiency of driving external purchases.
offAmazonERPMMetric
Effective (average) revenue for sales included in off-Amazon purchases generated per thousand impressions.
offAmazonProductSalesMetric
Sales generated from products purchased on third-party sites, attributed to an ad view or click.
offAmazonPurchaseRateMetric
The rate of purchases occurring off Amazon after an ad interaction.
offAmazonPurchasesMetric
The total number of purchases that occurred off Amazon.
offAmazonPurchasesClicksMetric
The number of off-Amazon purchases attributed to clicks.
offAmazonPurchasesViewsMetric
The number of off-Amazon purchases attributed to views.
offAmazonROASMetric
Return on advertising spend for products included in off-Amazon purchase events, measured as ad-attributed sales per local currency unit of ad spend.
offAmazonUnitsSoldMetric
Units of product sold off Amazon, attributed to an ad view or click.
offAmazonViewsMetric
Total number of views for advertised products or content occurring off Amazon properties.
omnichannelMetricsFeeMetric
Fees associated with omnichannel advertising metrics.
onTargetImpressionCostMetric
The cost associated with delivering impressions to the target audience.
operatingSystemDimension
The operating system used by the customer when viewing the ad.
operatingSystemNameDimension
The operating system used by customers to view the ad.
orderBudgetMetric
The total budget allocated for the order.
orderCurrencyDimension
The currency in which the order budget and costs are reported.
orderEndDateDimension
The end date of the advertising order.
orderExternalIdDimension
An external identifier for the advertising order.
orderIdDimension
A unique identifier for the advertising order.
orderNameDimension
The name of the advertising order.
orderStartDateDimension
The start date of the advertising order.
otherMetric
Metrics related to 'other' conversion events not explicitly defined.
otherCPAMetric
The average cost to acquire an 'Other' conversion, referring to general conversion events not specified by other metrics.
otherCVRMetric
The number of 'Other' conversions relative to the number of ad impressions, referring to general conversion events not specified by other metrics.
otherClicksMetric
The number of clicks attributed to 'other' conversion events.
otherViewsMetric
The number of Other conversions attributed to an ad impression.
pageViewCPAMetric
The average cost to acquire a Page view conversion.
pageViewCVRMetric
The number of Page view conversions relative to the number of ad impressions.
pageViewClicksMetric
The number of clicks on an ad that resulted in a page view.
pageViewViewsMetric
The number of Page view conversions attributed to an ad impression.
pageViewsMetric
The total number of page views attributed to an ad.
paidSubscriptionSignupClicksMetric
The number of paid subscriptions for sponsored products that occurred after a click on an ad.
paidSubscriptionSignupRateMetric
The rate at which users sign up for paid subscriptions after an ad interaction.
paidSubscriptionSignupViewsMetric
The number of paid subscriptions for sponsored products that occurred after viewing an ad (attributed to ad impressions).
paidSubscriptionSignupsMetric
The number of sign-ups for paid subscriptions, reflecting successful conversions and revenue generation. This is often tracked as a conversion event.
parentASINDimension
The Amazon Standard Identification Number (ASIN) for the parent product, representing a product family.
parentAsinMetric
The Amazon Standard Identification Number (ASIN) of the parent product in a product family.
placementDimension
The specific location or position where an advertisement was displayed within a website or app.
placementSizeDimension
The dimensions of the ad placement in pixels.
playTrailerRateMetric
The rate at which users play a video trailer after an ad interaction.
playTrailersMetric
The total number of times a video trailer was played.
playTrailersClicksMetric
The number of video trailer plays attributed to clicks.
playTrailersViewsMetric
The number of video trailer plays attributed to views.
postalCodeDimension
The postal code associated with the ad impression location.
productCategoryDimension
The category to which a product belongs, used for filtering or grouping product-related data. Relevant for 'PRODUCTS' report type.
productGroupDimension
A defined group of products, often used for organizing and targeting specific sets of products within campaigns. Relevant for 'PRODUCTS' report type.
productNameDimension
The commercial name of the product being advertised or analyzed. Relevant for 'PRODUCTS' report type.
productReviewPageViewBrandHaloMetric
The number of product review page views influenced by the campaign, including brand halo effects.
productReviewPageViewBrandHaloClicksMetric
The number of clicks influenced by the campaign that led to product review page views, including brand halo effects.
productReviewPageViewBrandHaloViewsMetric
The number of views influenced by the campaign that led to product review page views, including brand halo effects.
productReviewPageVisitRateMetric
The rate at which users visit a product review page after an ad interaction.
productReviewPageVisitsMetric
The total number of visits to a product review page.
productReviewPageVisitsClicksMetric
The number of product review page visits attributed to clicks.
productReviewPageVisitsViewsMetric
The number of product review page visits attributed to views.
productSubCategoryMetric
A more specific classification within a broader product category, used for detailed product analysis. Relevant for 'PRODUCTS' report type.
proposalIdDimension
The identifier for the advertising proposal.
purchaseRateMetric
The rate at which users make a purchase after interacting with an ad.
purchasesMetric
Number of ad-attributed purchases of promoted products (ASINs). Excludes brand halo purchases.
purchasesBrandHaloMetric
The number of purchases influenced by the campaign, including brand halo effects.
purchasesBrandHaloClicksMetric
The number of clicks influenced by the campaign that resulted in purchases, including brand halo effects.
purchasesBrandHaloViewsMetric
The number of views influenced by the campaign that resulted in purchases, including brand halo effects.
purchasesClicksMetric
The number of purchases attributed to clicks on an ad.
purchasesClicksRateMetric
The rate of purchases attributed specifically to clicks on an advertisement.
purchasesViewsMetric
The number of purchases attributed to views of an ad.
reachMetric
The number of unique users who were exposed to the ad.
regionDimension
The geographic region associated with the ad impression.
rentalRateMetric
The rate at which users rent content after interacting with an ad.
rentalsMetric
The total number of content rentals attributed to an ad.
rentalsClicksMetric
The number of content rentals attributed to clicks on an ad.
rentalsViewsMetric
The number of content rentals attributed to views of an ad.
reportDateDimension
The date for which the report data is aggregated.
reportGranularityDimension
The level of detail at which report data is aggregated (e.g., daily or summary).
salesMetric
The total sales generated from products attributed to an ad.
salesBrandHaloDimension
Sales influenced by the campaign, including brand halo effects (sales of products related to the advertised brand, not just the advertised product).
salesClicksMetric
Total sales generated from ad clicks, including both on-Amazon and off-Amazon sales.
salesPromotedDimension
The total sales generated by the promoted campaigns or products within the reporting period. This metric represents the revenue attributed to advertising efforts on the Amazon DSP, collected as part of report columns.
salesPromotedClicksMetric
The total number of purchases (on-Amazon and off-Amazon) attributed to clicks on promoted products.
searchMetric
The number of searches performed on Amazon after an ad interaction.
searchCPAMetric
The average cost to acquire a Search conversion.
searchCVRMetric
The number of Search conversions relative to the number of ad impressions.
searchClicksMetric
The number of searches on Amazon attributed to clicks on an ad.
searchViewsMetric
The number of searches on Amazon attributed to views of an ad.
segmentDimension
An audience segment targeted by the ad.
segmentClassCodeDimension
A classification code for the audience segment.
segmentIdMetric
A unique identifier for the audience segment.
segmentMarketplaceIdMetric
Identifier for the marketplace associated with an audience segment.
segmentNameMetric
The name of the audience segment.
segmentSourceMetric
The source of the audience segment data.
segmentTypeMetric
The type of audience segment used for targeting.
signUpMetric
The total number of sign-ups attributed to an ad.
signUpCPAMetric
Cost per acquisition (CPA) for sign-ups.
signUpCVRMetric
Conversion rate for sign-ups.
signUpClicksMetric
The number of sign-ups attributed to clicks on an ad.
signUpViewsMetric
The number of sign-ups attributed to views of an ad.
siteDimension
The website or application where the advertisement was displayed.
siteNameDimension
The name of the website or app where the ad was displayed.
spendMetric
The total cost incurred for the advertising activities.
subscribeMetric
The total number of subscriptions attributed to an ad.
subscribeCPAMetric
Cost per acquisition (CPA) for subscriptions.
subscribeCVRMetric
Conversion rate for subscriptions.
subscribeClicksMetric
The number of subscriptions attributed to clicks on an ad.
subscribeViewsMetric
The number of subscriptions attributed to views of an ad.
subscriptionSignupClicksMetric
The number of new Subscribe & Save subscriptions attributed to ad click-throughs.
subscriptionSignupRateMetric
The number of Subscribe & Save subscriptions relative to the number of ad impressions.
subscriptionSignupViewsMetric
The number of new Subscribe & Save subscriptions attributed to ad impressions.
subscriptionSignupsMetric
The total number of subscriptions attributed to an ad.
supplyCostMetric
The cost associated with the ad inventory (supply) for displaying ads.
supplySourceDimension
The origin of the advertising inventory, such as a specific publisher, exchange, or Amazon-owned property.
supplySourceNameDimension
The name of the supply source (publisher or exchange) where the ad was displayed.
targetDemographicMetric
The demographic segment targeted by the advertising campaign.
targetingMethodDimension
The method used to target audiences in the ad campaign (e.g., demographic, interest-based).
totalAddToCartMetric
The total number of times products were added to a shopping cart across all campaigns/line items.
totalAddToCartClicksMetric
The total number of add-to-cart events attributed to clicks.
totalAddToCartRateMetric
The total rate at which products were added to a shopping cart.
totalAddToCartViewsMetric
The total number of add-to-cart events attributed to views.
totalAddToListMetric
The total number of times products were added to a wishlist or other list.
totalAddToListClicksMetric
The total number of add-to-list events attributed to clicks.
totalAddToListRateMetric
The total rate at which products were added to a list.
totalAddToListViewsMetric
The total number of add-to-list events attributed to views.
totalCostMetric
The total cost incurred for the advertising activities.
totalDetailPageViewMetric
The total number of product detail page views.
totalDetailPageViewClicksMetric
The total number of detail page views attributed to clicks.
totalDetailPageViewRateMetric
The total rate of product detail page views.
totalDetailPageViewViewsMetric
The total number of detail page views attributed to views.
totalECPAddToCartMetric
Total Effective Cost Per Add to Cart, representing the cost efficiency of actions leading to products being added to shopping carts.
totalECPAddToListMetric
Total Effective Cost Per Add to List, representing the cost efficiency of actions leading to products being added to wish lists or other saved lists.
totalECPDetailPageViewMetric
Total Effective Cost Per Detail Page View, indicating the cost efficiency of driving users to product detail pages.
totalECPPMetric
Total Effective Cost Per Purchase (ECPP), representing the overall cost efficiency of driving purchases.
totalECPProductReviewPageVisitMetric
Total Effective Cost Per Product Review Page Visit, measuring the cost efficiency of driving users to product review pages.
totalECPSubscribeAndSaveMetric
Total Effective Cost Per Subscribe & Save, indicating the cost efficiency of driving Subscribe & Save subscriptions.
totalERPMMetric
The total estimated revenue per mille (thousand impressions).
totalFeeMetric
The total amount of fees incurred for advertising activities.
totalNewToBrandDPVClicksMetric
The total number of detail page view clicks by new-to-brand customers (including promoted and brand halo products) attributed to an ad.
totalNewToBrandDPVRateMetric
The total rate of product detail page views by new-to-brand customers.
totalNewToBrandDPVViewsMetric
The total number of detail page view impressions by new-to-brand customers (including promoted and brand halo products) attributed to an ad.
totalNewToBrandDPVsMetric
The total number of detail page views by new-to-brand customers.
totalNewToBrandECPDetailPageViewMetric
The average cost to acquire a total new-to-brand detail page view conversion.
totalNewToBrandECPPMetric
Total Effective Cost Per Purchase (ECPP) for new-to-brand customers, representing the cost efficiency of acquiring new customers.
totalNewToBrandERPMMetric
The total estimated revenue per mille (thousand impressions) from new-to-brand customers.
totalNewToBrandProductSales14dMetric
The total sales generated from new-to-brand customers for all featured products within a 14-day attribution window.
totalNewToBrandPurchaseRateMetric
The total rate of purchases by new-to-brand customers.
totalNewToBrandPurchasesMetric
The total number of purchases by new-to-brand customers.
totalNewToBrandPurchasesClicksMetric
The total number of new-to-brand purchases attributed to clicks.
totalNewToBrandPurchasesPercentageMetric
The total percentage of purchases that are new-to-brand.
totalNewToBrandPurchasesViewsMetric
The total number of new-to-brand purchases attributed to views.
totalNewToBrandROASMetric
The total return on ad spend (ROAS) from new-to-brand customer purchases.
totalNewToBrandSalesMetric
The total sales generated from purchases made by customers new to the brand.
totalNewToBrandUnitsSoldMetric
The total number of units sold to customers new to the brand.
totalProductReviewPageVisitRateMetric
The total rate at which users visit a product review page.
totalProductReviewPageVisitsMetric
The total number of visits to product review pages.
totalProductReviewPageVisitsClicksMetric
The total number of product review page visits attributed to clicks.
totalProductReviewPageVisitsViewsMetric
The total number of product review page visits attributed to views.
totalPurchaseRateMetric
The total rate at which users make a purchase after interacting with an ad.
totalPurchasesMetric
Number of ad-attributed purchases of promoted products plus brand halo products, meaning other products from the same brand that were not directly promoted.
totalPurchases14dMetric
The total number of purchases attributed to the ad campaign within a 14-day attribution window.
totalPurchasesClicksMetric
The total number of purchases attributed to clicks on an ad.
totalPurchasesClicks14dMetric
The total number of clicks that resulted in a purchase within a 14-day attribution window.
totalPurchasesViewsMetric
The total number of purchases attributed to views of an ad.
totalPurchasesViews14dMetric
The total number of views that led to a purchase within a 14-day attribution window.
totalROASMetric
The total return on ad spend (ROAS) across all sales.
totalSalesMetric
The total sales generated from products attributed to an ad.
totalSubscribeAndSaveMetric
The total number of Subscribe & Save enrollments.
totalSubscribeAndSaveClicksMetric
The total number of Subscribe & Save enrollments attributed to clicks.
totalSubscribeAndSaveRateMetric
The total rate of Subscribe & Save enrollments.
totalSubscribeAndSaveViewsMetric
The total number of Subscribe & Save enrollments attributed to views.
totalUnitsSoldMetric
The total number of units sold attributed to an ad.
unitsSoldMetric
The number of units sold attributed to an ad.
unitsSoldBrandHaloDimension
The total quantity of brand halo products purchased by customers on Amazon after delivering an ad.
unitsSoldClicksMetric
The number of clicks that led to the sale of units within a campaign.
unitsSoldPromotedClicksMetric
The quantity of promoted products sold, attributed to ad click-throughs.
videoAdClicksMetric
The total number of clicks on a video ad.
videoAdCompleteMetric
The number of times a video ad was played to 100% completion.
videoAdCompletionRateMetric
The rate at which video ads are played to 100% completion.
videoAdCreativeViewsMetric
The number of times a video ad creative was viewed.
videoAdEndStateClicksMetric
Number of clicks that occur at the end state of a video advertisement, corresponding to 'Video end click-through conversions'.
videoAdFirstQuartileMetric
The number of times a video ad played to at least 25% completion.
videoAdImpressionsMetric
The total number of impressions for a video ad.
videoAdMidpointMetric
The number of times a video ad played to at least 50% completion.
videoAdMuteMetric
The number of times a video ad was muted.
videoAdPauseMetric
The number of times a video ad was paused.
videoAdReplaysMetric
The number of times a video ad was replayed.
videoAdResumeMetric
The number of times a video ad was resumed after being paused.
videoAdSkipBacksMetric
The number of times a user skipped backward in a video ad.
videoAdSkipForwardsMetric
The number of times a user skipped forward in a video ad.
videoAdStartMetric
The number of times a video ad was started.
videoAdThirdQuartileMetric
The number of times a video ad played to at least 75% completion.
videoAdUnmuteMetric
The number of times a video ad was unmuted.
videoCompleteMetric
The number of times a video advertisement was played to 100% completion.
videoDownloadRateMetric
The rate at which videos are downloaded after an ad interaction.
videoDownloadsMetric
The total number of video downloads attributed to an ad.
videoDownloadsClicksMetric
The number of video downloads attributed to clicks.
videoDownloadsViewsMetric
The number of video downloads attributed to views.
videoFirstQuartileMetric
The number of times a video advertisement was played to at least 25% of its total length.
videoMidpointMetric
The number of times a video advertisement was played to at least 50% of its total length.
videoStreamsMetric
The total number of video streams attributed to an ad.
videoStreamsClicksMetric
The number of video streams attributed to clicks.
videoStreamsRateMetric
The rate at which videos are streamed after an ad interaction.
videoStreamsViewsMetric
The number of video streams attributed to views.
videoThirdQuartileMetric
The number of times a video advertisement was played to at least 75% of its total length.
viewabilityRateMetric
The percentage of ad impressions that were considered viewable according to industry standards.
viewableImpressionsMetric
The total number of ad impressions that were considered viewable.