Data reference

Introduction

Amazon DSP is Amazon’s demand-side platform for programmatic display, video, audio, and over-the-top advertising across Amazon properties (for example, IMDb, Twitch, and Fire TV) and third-party publishers. The connector integrates with the DSP Reports v3 API through an asynchronous request, poll, and download pipeline to surface advertiser, order, line item, and creative performance, with a wide set of viewability, video, conversion, and cost metrics. As a marketing connector, metrics, breakdowns, and currencies are standardized so widgets can aggregate across sources without additional configuration. To connect this data source, see How to connect Amazon DSP to Adriel.

Data refresh strategy

Architecture data

Architecture covers advertisers, orders, line items, and creatives. It refreshes twice daily, at 9:00 PM UTC and 9:00 AM UTC.

Reports data

Reports include daily performance for advertiser, order, line item, and creative. Cache-only. Report data comes from cached daily performance snapshots. Dashboard values are composed from the last snapshot, so the most recent few hours of activity are not yet reflected, and metrics based on uniqueness (such as reach) can be overvalued across date ranges longer than one day. Initial fill. On data source creation, the cache fills with 89 days of historical data at the advertiser, order, line item, and creative levels. Refresh schedule. Reports refresh at 7:00 PM UTC, syncing the last 7 days for order, line item, and creative. Data is considered reliable within the cache sync window. Older data may be incomplete or inaccurate due to legacy caching behavior.

Architecture levels

Advertiser → Order → Line item → Creative

Date range limits

Breakdown	Max range
Daily	93 days
Weekly	1 year
Monthly	2 years

Metrics

How to read the columnsData type uses Adriel’s vocabulary — Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean. API Key in code style like impressions is the literal Amazon DSP API field; italic marks a value Adriel computes or derives on its side rather than a single API field. Currency values are reported in each advertiser’s configured currency.

Campaign Attributes

Metric	Description	Data type	API Key
Ad Account Name	Advertiser account name in Amazon DSP.	Text	Adriel-side
Ad Name	Ad name in Amazon DSP.	Text	Adriel-side
Ad Set Name	Ad group name in Amazon DSP.	Text	Adriel-side
Ad Spend	Total amount spent on media, fees, and technology costs.	Currency	`totalCost`
Bid Cap	Bid cap configured for the entity.	Currency	Adriel-side
Bid Strategy	Bid strategy or delivery method used by the entity.	Text	Adriel-side
Budget	Budget configuration reported for the entity.	Text	Adriel-side
Campaign Name	Campaign name in Amazon DSP.	Text	Adriel-side
Channel Type	Subtype reported for the advertising channel.	Text	Adriel-side
Creative Type	Creative format or type reported by Amazon DSP.	Text	Adriel-side
Creative URL	Creative asset information reported for the ad.	Text	Adriel-side
Daily Budget	Daily budget amount configured for the entity.	Currency	Adriel-side
Ends	End date when the entity stops being eligible to run.	Date	Adriel-side
Is Active	Whether the campaign, ad set, or ad is currently active.	Text	Adriel-side
Landing URL	Landing page URLs used by the ad.	Text	Adriel-side
Lifetime Budget	Lifetime budget amount configured for the entity.	Currency	Adriel-side
Objective	Campaign objective or type assigned in Amazon DSP.	Text	Adriel-side
Starts	Start date when the entity becomes eligible to run.	Date	Adriel-side
Status	Delivery status reported by Amazon DSP for the entity.	Text	Adriel-side
Status Text	A human-readable label for the current delivery status.	Text	Adriel-side
UTM Campaign	UTM campaign values associated with the ad destination URL.	Text	Adriel-side
UTM Content	UTM content values associated with the ad destination URL.	Text	Adriel-side
UTM Medium	UTM medium values associated with the ad destination URL.	Text	Adriel-side
UTM Source	UTM source values associated with the ad destination URL.	Text	Adriel-side
UTM Term	UTM term values associated with the ad destination URL.	Text	Adriel-side

Campaign Structure

Metric	Description	Data type	API Key
Ad Account ID	Amazon DSP advertiser account identifier.	Text	`advertiserId`
Ad ID	Amazon DSP ad identifier.	Text	`creativeAdId`
Ad Set ID	Amazon DSP ad group identifier.	Text	`lineItemId`
Campaign ID	Amazon DSP campaign identifier.	Text	`orderId`
Channel	Sub-channel classifications reported for the entity.	Text	Adriel-side
Keyword ID	Amazon DSP keyword identifier.	Text	Adriel-side
Keyword Name	Keyword name associated with the record.	Text	Adriel-side

Click Performance

Metric	Description	Data type	API Key
Clicks (All)	Number of ad click-throughs.	Number	`clicks`
CPC	Cost per click.	Currency	Adriel-computed
CPM	Cost per thousand impressions.	Currency	Adriel-computed
CTR	Click-through rate.	Percentage	Adriel-computed
Impressions	Number of times the ad was displayed.	Number	`impressions`
Link Clicks	Number of ad click-throughs.	Number	`clicks`
Reach	Number of audience members reached by the ad.	Number	`reach`

Computed Metrics

These are calculated by Adriel from other metrics; they have no single underlying Amazon DSP field.

Metric	Description	Data type	API Key
Frequency	Impressions divided by reach.	Number	Adriel-computed
ROAS	Return on ad spend — conversion value divided by spend.	Percentage	Adriel-computed
Video Played To 100% (%)	Plays reaching 100% completion as a share of total plays.	Percentage	Adriel-computed
Video Played To 25% (%)	Plays reaching 25% completion as a share of total plays.	Percentage	Adriel-computed
Video Played To 50% (%)	Plays reaching 50% completion as a share of total plays.	Percentage	Adriel-computed
Video Played To 75% (%)	Plays reaching 75% completion as a share of total plays.	Percentage	Adriel-computed
View Rate	Video views as a share of impressions.	Percentage	Adriel-computed

Conversion Performance

Metric	Description	Data type	API Key
All Conversions	Total number of attributed conversions.	Number	Adriel-derived
Conversion Goal	Conversion goal configured for the campaign or report.	Text	Adriel-side
Conversion Value	Attributed conversion value reported for the ad.	Currency	Adriel-derived
Conversions	Total number of attributed conversions.	Number	Adriel-derived
Result Indicator	Indicator Amazon DSP returns for the reporting result or entity state.	Text	Adriel-side
Results	Result summary object reported for the entity.	Text	Adriel-side
Revenue	Revenue attributed to tracked conversion events.	Currency	Adriel-derived

Conversion events use a fixed 14-day attribution window. Every conversion metric is attributed over Amazon DSP’s 14-day window; there is no API-level support for shorter or longer windows (Amazon DSP reporting docs). Any conversion events tracked in the connected DSP account — including brand store engagement events — are imported automatically and appear only when the underlying event is active in the account. For each imported event, Amazon DSP also derives CPA, conversion rate (CVR), and ROAS.

Creative Attributes

Metric	Description	Data type	API Key
Creative Image	Hash value for the creative image asset.	Text	Adriel-side

Engagement

Metric	Description	Data type	API Key
Engagement	Number of times users interacted with the ad.	Number	Adriel-derived
Post Comments	Number of post comments attributed to the ad.	Number	Adriel-derived
Post Engagement	Number of post engagements attributed to the ad.	Number	Adriel-derived
Post Reactions	Number of post reactions attributed to the ad.	Number	Adriel-derived
Post Saves	Number of post saves attributed to the ad.	Number	Adriel-derived
Post Shares	Number of post shares attributed to the ad.	Number	Adriel-derived
Video Impressions	Number of times a video ad was served.	Number	Adriel-derived

Video Performance

Metric	Description	Data type	API Key
15s Video Plays	Number of video views that reached at least 15 seconds.	Number	Adriel-derived
2s Video Plays	Number of video views that reached at least 2 seconds.	Number	Adriel-derived
30s Video Plays	Number of video views that reached at least 30 seconds.	Number	Adriel-derived
3s Video Plays	Number of video views that reached at least 3 seconds.	Number	Adriel-derived
6s Video Plays	Number of video views that reached at least 6 seconds.	Number	Adriel-derived
ThruPlays	Number of through plays attributed to the video ad.	Number	Adriel-derived
Video Play	Number of times a video ad was started.	Number	`videoAdStart`
Video Played To 100% (Views)	Number of times a video ad played to completion.	Number	`videoAdComplete`
Video Played To 25% (Views)	Number of times at least 25% of a video ad played.	Number	`videoAdFirstQuartile`
Video Played To 50% (Views)	Number of times at least 50% of a video ad played.	Number	`videoAdMidpoint`
Video Played To 75% (Views)	Number of times at least 75% of a video ad played.	Number	`videoAdThirdQuartile`
Views	Number of video views attributed to the ad.	Number	Adriel-derived

Amazon DSP-specific

These metrics exist only for Amazon DSP and aren’t part of any cross-connector category. Every group above is a standard category shared with other connectors.

Metric	Description	Data type	API Key
Ad Spend	Total amount spent on media, fees, and technology costs.	Currency	Adriel-side
Agency Fee	Service fee set in Amazon DSP and subtracted from budget.	Currency	`agencyFee`
Amazon DSP Audience Fee	Audience fee charged by Amazon DSP.	Currency	`amazonDSPAudienceFee`
Amazon DSP Console Fee	Console fee charged by Amazon DSP.	Currency	`amazonDSPConsoleFee`
Brand Halo Detail Page View	Brand-halo (same-brand products not directly advertised) detail page views on the ASIN / parent-ASIN breakdown.	Number	`detailPageViewBrandHalo`
Brand Halo Detail Page View Clicks	Brand-halo (same-brand products not directly advertised) detail page views attributed to an ad click on the ASIN / parent-ASIN breakdown.	Number	`detailPageViewBrandHaloClicks`
Brand Halo Detail Page View Views	Brand-halo (same-brand products not directly advertised) detail page views attributed to an ad view on the ASIN / parent-ASIN breakdown.	Number	`detailPageViewBrandHaloViews`
Brand Halo New To Brand Product Sales	Brand-halo (same-brand products not directly advertised) new-to-brand product sales on the ASIN / parent-ASIN breakdown.	Currency	`newToBrandSalesBrandHalo`
Brand Halo New To Brand Units Sold	Brand-halo (same-brand products not directly advertised) new-to-brand units sold on the ASIN / parent-ASIN breakdown.	Number	`newToBrandUnitsSoldBrandHalo`
Brand Halo Product Review Page Visits	Brand-halo (same-brand products not directly advertised) product review page visits on the ASIN / parent-ASIN breakdown.	Number	`productReviewPageViewBrandHalo`
Brand Halo Product Review Page Visits Clicks	Brand-halo (same-brand products not directly advertised) product review page visits attributed to an ad click on the ASIN / parent-ASIN breakdown.	Number	`productReviewPageViewBrandHaloClicks`
Brand Halo Product Review Page Visits Views	Brand-halo (same-brand products not directly advertised) product review page visits attributed to an ad view on the ASIN / parent-ASIN breakdown.	Number	`productReviewPageViewBrandHaloViews`
Brand Halo Sales	Brand-halo (same-brand products not directly advertised) product sales on the ASIN / parent-ASIN breakdown.	Currency	`salesBrandHalo`
Brand Halo Units Sold	Brand-halo (same-brand products not directly advertised) units sold on the ASIN / parent-ASIN breakdown.	Number	`unitsSoldBrandHalo`
Brand Name	Brand of the ASIN. Populated on the ASIN / parent-ASIN breakdown.	Text	`brandName`
Branded Searches	Number of brand searches attributed to the ad.	Number	`brandSearches`
Branded Searches - ClickThrough Conversions	Number of brand searches attributed to ad clicks.	Number	`brandSearchesClicks`
Branded Searches - ViewThrough Conversions	Number of brand searches attributed to ad views.	Number	`brandSearchesViews`
Combined Product Sales	Combined attributed product sales reported by Amazon DSP.	Currency	`combinedProductSales`
Combined Units Sold	Combined number of units sold attributed to the ad.	Number	`combinedUnitsSold`
Conversions: Add To Cart	Number of add-to-cart conversions attributed to the ad.	Number	`addToCart`
Conversions: Add To Cart - ClickThrough Conversions	Number of add to cart clicks attributed to ad clicks.	Number	`addToCartClicks`
Conversions: Add To Cart - ViewThrough Conversions	Number of add to cart views attributed to ad views.	Number	`addToCartViews`
Conversions: Add To Cart Brand Halo	Brand-halo (same-brand products not directly advertised) add-to-cart events on the ASIN / parent-ASIN breakdown.	Number	`addToCartBrandHalo`
Conversions: Add To Cart Brand Halo Clicks	Brand-halo (same-brand products not directly advertised) add-to-cart events attributed to an ad click on the ASIN / parent-ASIN breakdown.	Number	`addToCartBrandHaloClicks`
Conversions: Add To Cart Brand Halo Views	Brand-halo (same-brand products not directly advertised) add-to-cart events attributed to an ad view on the ASIN / parent-ASIN breakdown.	Number	`addToCartBrandHaloViews`
Conversions: Add To List	Number of add-to-list conversions attributed to the ad.	Number	`addToList`
Conversions: Add To List - ClickThrough Conversions	Number of add to list clicks attributed to ad clicks.	Number	`addToListClicks`
Conversions: Add To List - ViewThrough Conversions	Number of add to list views attributed to ad views.	Number	`addToListViews`
Conversions: Add To List Brand Halo	Brand-halo (same-brand products not directly advertised) add-to-list events on the ASIN / parent-ASIN breakdown.	Number	`addToListBrandHalo`
Conversions: Add To List Brand Halo Clicks	Brand-halo (same-brand products not directly advertised) add-to-list events attributed to an ad click on the ASIN / parent-ASIN breakdown.	Number	`addToListBrandHaloClicks`
Conversions: Add To List Brand Halo Views	Brand-halo (same-brand products not directly advertised) add-to-list events attributed to an ad view on the ASIN / parent-ASIN breakdown.	Number	`addToListBrandHaloViews`
Conversions: Combined Purchases	Number of combined purchase events attributed to the ad.	Number	`combinedPurchases`
Conversions: Combined Purchases - ClickThrough Conversions	Number of combined purchases clicks attributed to ad clicks.	Number	`combinedPurchasesClicks`
Conversions: Combined Purchases - ViewThrough Conversions	Number of combined purchases views attributed to ad views.	Number	`combinedPurchasesViews`
Conversions: New Subscribe And Save	Number of new Subscribe & Save subscriptions to the promoted product attributed to the ad.	Number	`newSubscribeAndSave`
Conversions: New Subscribe And Save - ClickThrough Conversions	Number of new Subscribe & Save subscriptions to the promoted product attributed to an ad click.	Number	`newSubscribeAndSaveClicks`
Conversions: New Subscribe And Save - ViewThrough Conversions	Number of new Subscribe & Save subscriptions to the promoted product attributed to an ad view.	Number	`newSubscribeAndSaveViews`
Conversions: New Subscribe And Save Brand Halo	Brand-halo (same-brand products not directly advertised) new Subscribe & Save subscriptions on the ASIN / parent-ASIN breakdown.	Number	`newSubscribeAndSaveBrandHalo`
Conversions: New Subscribe And Save Brand Halo Clicks	Brand-halo (same-brand products not directly advertised) new Subscribe & Save subscriptions attributed to an ad click on the ASIN / parent-ASIN breakdown.	Number	`newSubscribeAndSaveBrandHaloClicks`
Conversions: New Subscribe And Save Brand Halo Views	Brand-halo (same-brand products not directly advertised) new Subscribe & Save subscriptions attributed to an ad view on the ASIN / parent-ASIN breakdown.	Number	`newSubscribeAndSaveBrandHaloViews`
Conversions: New To Brand Purchases Brand Halo	Brand-halo (same-brand products not directly advertised) new-to-brand purchases on the ASIN / parent-ASIN breakdown.	Number	`newToBrandPurchasesBrandHalo`
Conversions: New To Brand Purchases Brand Halo Clicks	Brand-halo (same-brand products not directly advertised) new-to-brand purchases attributed to an ad click on the ASIN / parent-ASIN breakdown.	Number	`newToBrandPurchasesBrandHaloClicks`
Conversions: New To Brand Purchases Brand Halo Views	Brand-halo (same-brand products not directly advertised) new-to-brand purchases attributed to an ad view on the ASIN / parent-ASIN breakdown.	Number	`newToBrandPurchasesBrandHaloViews`
Conversions: New-To-Brand Purchases	Number of new-to-brand purchase events attributed to the ad.	Number	`newToBrandPurchases`
Conversions: New-To-Brand Purchases - ClickThrough Conversions	Number of new to brand purchases clicks attributed to ad clicks.	Number	`newToBrandPurchasesClicks`
Conversions: New-To-Brand Purchases - ViewThrough Conversions	Number of new to brand purchases views attributed to ad views.	Number	`newToBrandPurchasesViews`
Conversions: Off Amazon Conversions	Total off-Amazon conversions (formerly “pixel” conversions) attributed to the ad. Populated only when the advertiser tracks off-Amazon events via the Amazon Ad Tag, the Conversions API or a Mobile Measurement Partner.	Number	`offAmazonConversions`
Conversions: Off Amazon Purchases	Number of off-Amazon purchases attributed to the ad.	Number	`offAmazonPurchases`
Conversions: Off Amazon Purchases - ClickThrough Conversions	Number of off-Amazon purchases attributed to an ad click.	Number	`offAmazonPurchasesClicks`
Conversions: Off Amazon Purchases - ViewThrough Conversions	Number of off-Amazon purchases attributed to an ad view.	Number	`offAmazonPurchasesViews`
Conversions: Purchases	Number of purchase events attributed to the ad.	Number	`purchases`
Conversions: Purchases - ClickThrough Conversions	Number of purchases clicks attributed to ad clicks.	Number	`purchasesClicks`
Conversions: Purchases - ViewThrough Conversions	Number of purchases views attributed to ad views.	Number	`purchasesViews`
Conversions: Purchases Brand Halo	Brand-halo (same-brand products not directly advertised) purchases on the ASIN / parent-ASIN breakdown.	Number	`purchasesBrandHalo`
Conversions: Purchases Brand Halo Clicks	Brand-halo (same-brand products not directly advertised) purchases attributed to an ad click on the ASIN / parent-ASIN breakdown.	Number	`purchasesBrandHaloClicks`
Conversions: Purchases Brand Halo Views	Brand-halo (same-brand products not directly advertised) purchases attributed to an ad view on the ASIN / parent-ASIN breakdown.	Number	`purchasesBrandHaloViews`
Conversions: Total Add To Cart	Number of total add-to-cart conversions attributed to the ad.	Number	`totalAddToCart`
Conversions: Total Add To Cart - ClickThrough Conversions	Number of total add to cart clicks attributed to ad clicks.	Number	`totalAddToCartClicks`
Conversions: Total Add To Cart - ViewThrough Conversions	Number of total add to cart views attributed to ad views.	Number	`totalAddToCartViews`
Conversions: Total Add To List	Number of total add-to-list conversions attributed to the ad.	Number	`totalAddToList`
Conversions: Total Add To List - ClickThrough Conversions	Number of total add to list clicks attributed to ad clicks.	Number	`totalAddToListClicks`
Conversions: Total Add To List - ViewThrough Conversions	Number of total add to list views attributed to ad views.	Number	`totalAddToListViews`
Conversions: Total New-To-Brand Purchases	Number of total new-to-brand purchase events attributed to the ad.	Number	`totalNewToBrandPurchases`
Conversions: Total New-To-Brand Purchases - ClickThrough Conversions	Number of total new to brand purchases clicks attributed to ad clicks.	Number	`totalNewToBrandPurchasesClicks`
Conversions: Total New-To-Brand Purchases - ViewThrough Conversions	Number of total new to brand purchases views attributed to ad views.	Number	`totalNewToBrandPurchasesViews`
Conversions: Total Purchases	Number of total purchase events attributed to the ad.	Number	`totalPurchases`
Conversions: Total Purchases - ClickThrough Conversions	Number of total purchases clicks attributed to ad clicks.	Number	`totalPurchasesClicks`
Conversions: Total Purchases - ViewThrough Conversions	Number of total purchases views attributed to ad views.	Number	`totalPurchasesViews`
Conversions: Total Subscribe And Save	Total Subscribe & Save subscriptions attributed to the ad, including the promoted product and other products from the same brands.	Number	`totalSubscribeAndSave`
Conversions: Total Subscribe And Save - ClickThrough Conversions	Total Subscribe & Save subscriptions attributed to an ad click, including the promoted product and other products from the same brands.	Number	`totalSubscribeAndSaveClicks`
Conversions: Total Subscribe And Save - ViewThrough Conversions	Total Subscribe & Save subscriptions attributed to an ad view, including the promoted product and other products from the same brands.	Number	`totalSubscribeAndSaveViews`
CPA: Add To Cart	Average cost per add-to-cart conversions.	Currency	Adriel-computed
CPA: Add To Cart - ClickThrough Conversions	Average cost per add to cart clicks.	Currency	Adriel-computed
CPA: Add To Cart - ViewThrough Conversions	Average cost per add to cart views.	Currency	Adriel-computed
CPA: Add To List	Average cost per add-to-list conversions.	Currency	Adriel-computed
CPA: Add To List - ClickThrough Conversions	Average cost per add to list clicks.	Currency	Adriel-computed
CPA: Add To List - ViewThrough Conversions	Average cost per add to list views.	Currency	Adriel-computed
CPA: Combined Purchases	Average cost per combined purchase events.	Currency	Adriel-computed
CPA: Combined Purchases - ClickThrough Conversions	Average cost per combined purchases clicks.	Currency	Adriel-computed
CPA: Combined Purchases - ViewThrough Conversions	Average cost per combined purchases views.	Currency	Adriel-computed
CPA: New Subscribe And Save	Average cost per new Subscribe & Save subscription.	Currency	Adriel-computed
CPA: New Subscribe And Save - ClickThrough Conversions	Average cost per new Subscribe & Save subscription attributed to ad clicks.	Currency	Adriel-computed
CPA: New Subscribe And Save - ViewThrough Conversions	Average cost per new Subscribe & Save subscription attributed to ad views.	Currency	Adriel-computed
CPA: New-To-Brand Purchases	Average cost per new-to-brand purchase events.	Currency	Adriel-computed
CPA: New-To-Brand Purchases - ClickThrough Conversions	Average cost per new to brand purchases clicks.	Currency	Adriel-computed
CPA: New-To-Brand Purchases - ViewThrough Conversions	Average cost per new to brand purchases views.	Currency	Adriel-computed
CPA: Off Amazon Conversions	Average cost per off-Amazon conversion.	Currency	Adriel-computed
CPA: Off Amazon Purchases	Average cost per off-Amazon purchase.	Currency	Adriel-computed
CPA: Off Amazon Purchases - ClickThrough Conversions	Average cost per off-Amazon purchase attributed to ad clicks.	Currency	Adriel-computed
CPA: Off Amazon Purchases - ViewThrough Conversions	Average cost per off-Amazon purchase attributed to ad views.	Currency	Adriel-computed
CPA: Purchases	Average cost per purchase events.	Currency	Adriel-computed
CPA: Purchases - ClickThrough Conversions	Average cost per purchases clicks.	Currency	Adriel-computed
CPA: Purchases - ViewThrough Conversions	Average cost per purchases views.	Currency	Adriel-computed
CPA: Total Add To Cart	Average cost per total add-to-cart conversions.	Currency	Adriel-computed
CPA: Total Add To Cart - ClickThrough Conversions	Average cost per total add to cart clicks.	Currency	Adriel-computed
CPA: Total Add To Cart - ViewThrough Conversions	Average cost per total add to cart views.	Currency	Adriel-computed
CPA: Total Add To List	Average cost per total add-to-list conversions.	Currency	Adriel-computed
CPA: Total Add To List - ClickThrough Conversions	Average cost per total add to list clicks.	Currency	Adriel-computed
CPA: Total Add To List - ViewThrough Conversions	Average cost per total add to list views.	Currency	Adriel-computed
CPA: Total New-To-Brand Purchases	Average cost per total new-to-brand purchase events.	Currency	Adriel-computed
CPA: Total New-To-Brand Purchases - ClickThrough Conversions	Average cost per total new to brand purchases clicks.	Currency	Adriel-computed
CPA: Total New-To-Brand Purchases - ViewThrough Conversions	Average cost per total new to brand purchases views.	Currency	Adriel-computed
CPA: Total Purchases	Average cost per total purchase events.	Currency	Adriel-computed
CPA: Total Purchases - ClickThrough Conversions	Average cost per total purchases clicks.	Currency	Adriel-computed
CPA: Total Purchases - ViewThrough Conversions	Average cost per total purchases views.	Currency	Adriel-computed
CPA: Total Subscribe And Save	Average cost per total Subscribe & Save subscription.	Currency	Adriel-computed
CPA: Total Subscribe And Save - ClickThrough Conversions	Average cost per total Subscribe & Save subscription attributed to ad clicks.	Currency	Adriel-computed
CPA: Total Subscribe And Save - ViewThrough Conversions	Average cost per total Subscribe & Save subscription attributed to ad views.	Currency	Adriel-computed
CVR: Add To Cart	Conversion rate for add-to-cart conversions.	Percentage	Adriel-computed
CVR: Add To Cart - ClickThrough Conversions	Conversion rate for add to cart clicks.	Percentage	Adriel-computed
CVR: Add To Cart - ViewThrough Conversions	Conversion rate for add to cart views.	Percentage	Adriel-computed
CVR: Add To List	Conversion rate for add-to-list conversions.	Percentage	Adriel-computed
CVR: Add To List - ClickThrough Conversions	Conversion rate for add to list clicks.	Percentage	Adriel-computed
CVR: Add To List - ViewThrough Conversions	Conversion rate for add to list views.	Percentage	Adriel-computed
CVR: Combined Purchases	Conversion rate for combined purchase events.	Percentage	Adriel-computed
CVR: Combined Purchases - ClickThrough Conversions	Conversion rate for combined purchases clicks.	Percentage	Adriel-computed
CVR: Combined Purchases - ViewThrough Conversions	Conversion rate for combined purchases views.	Percentage	Adriel-computed
CVR: New Subscribe And Save	Conversion rate for new Subscribe & Save subscriptions.	Percentage	Adriel-computed
CVR: New Subscribe And Save - ClickThrough Conversions	Conversion rate for new Subscribe & Save subscriptions attributed to ad clicks.	Percentage	Adriel-computed
CVR: New Subscribe And Save - ViewThrough Conversions	Conversion rate for new Subscribe & Save subscriptions attributed to ad views.	Percentage	Adriel-computed
CVR: New-To-Brand Purchases	Conversion rate for new-to-brand purchase events.	Percentage	Adriel-computed
CVR: New-To-Brand Purchases - ClickThrough Conversions	Conversion rate for new to brand purchases clicks.	Percentage	Adriel-computed
CVR: New-To-Brand Purchases - ViewThrough Conversions	Conversion rate for new to brand purchases views.	Percentage	Adriel-computed
CVR: Off Amazon Conversions	Conversion rate for off-Amazon conversions.	Percentage	Adriel-computed
CVR: Off Amazon Purchases	Conversion rate for off-Amazon purchases.	Percentage	Adriel-computed
CVR: Off Amazon Purchases - ClickThrough Conversions	Conversion rate for off-Amazon purchases attributed to ad clicks.	Percentage	Adriel-computed
CVR: Off Amazon Purchases - ViewThrough Conversions	Conversion rate for off-Amazon purchases attributed to ad views.	Percentage	Adriel-computed
CVR: Purchases	Conversion rate for purchase events.	Percentage	Adriel-computed
CVR: Purchases - ClickThrough Conversions	Conversion rate for purchases clicks.	Percentage	Adriel-computed
CVR: Purchases - ViewThrough Conversions	Conversion rate for purchases views.	Percentage	Adriel-computed
CVR: Total Add To Cart	Conversion rate for total add-to-cart conversions.	Percentage	Adriel-computed
CVR: Total Add To Cart - ClickThrough Conversions	Conversion rate for total add to cart clicks.	Percentage	Adriel-computed
CVR: Total Add To Cart - ViewThrough Conversions	Conversion rate for total add to cart views.	Percentage	Adriel-computed
CVR: Total Add To List	Conversion rate for total add-to-list conversions.	Percentage	Adriel-computed
CVR: Total Add To List - ClickThrough Conversions	Conversion rate for total add to list clicks.	Percentage	Adriel-computed
CVR: Total Add To List - ViewThrough Conversions	Conversion rate for total add to list views.	Percentage	Adriel-computed
CVR: Total New-To-Brand Purchases	Conversion rate for total new-to-brand purchase events.	Percentage	Adriel-computed
CVR: Total New-To-Brand Purchases - ClickThrough Conversions	Conversion rate for total new to brand purchases clicks.	Percentage	Adriel-computed
CVR: Total New-To-Brand Purchases - ViewThrough Conversions	Conversion rate for total new to brand purchases views.	Percentage	Adriel-computed
CVR: Total Purchases	Conversion rate for total purchase events.	Percentage	Adriel-computed
CVR: Total Purchases - ClickThrough Conversions	Conversion rate for total purchases clicks.	Percentage	Adriel-computed
CVR: Total Purchases - ViewThrough Conversions	Conversion rate for total purchases views.	Percentage	Adriel-computed
CVR: Total Subscribe And Save	Conversion rate for total Subscribe & Save subscriptions.	Percentage	Adriel-computed
CVR: Total Subscribe And Save - ClickThrough Conversions	Conversion rate for total Subscribe & Save subscriptions attributed to ad clicks.	Percentage	Adriel-computed
CVR: Total Subscribe And Save - ViewThrough Conversions	Conversion rate for total Subscribe & Save subscriptions attributed to ad views.	Percentage	Adriel-computed
Detail Page View - ClickThrough Conversions	Number of detail page views attributed to ad clicks.	Number	`detailPageViewClicks`
Detail Page View - ViewThrough Conversions	Number of detail page views attributed to ad views.	Number	`detailPageViewViews`
Detail Page Views	Number of views of the advertised product detail pages on Amazon.	Number	`detailPageViews`
Gross Click Throughs	Gross click-through count before invalid traffic filtering.	Number	`grossClickThroughs`
Gross Impressions	Gross impression count before invalid traffic filtering.	Number	`grossImpressions`
Household Reach	Number of unique households reached by the ad.	Number	`householdReach`
Interval End	Report interval end date determined by the requested reporting range.	Text	`intervalEnd`
Interval Start	Report interval start date determined by the requested reporting range.	Text	`intervalStart`
Invalid Click Throughs	Click-throughs identified as invalid traffic.	Number	`invalidClickThroughs`
Invalid Impressions	Impressions identified as invalid traffic.	Number	`invalidImpressions`
Long Term Sales	Long-term attributed sales reported by Amazon DSP.	Currency	`longTermSales`
Measurable Impressions	Impressions that were eligible to be measured for viewability.	Number	`measurableImpressions`
New To Brand Purchase Rate	New-to-brand purchases as a share of purchases, promoted products.	Percentage	Adriel-computed
New To Brand Sales Rate	New-to-brand product sales as a share of product sales, promoted products.	Percentage	Adriel-computed
New-To-Brand Detail Page View - ClickThrough Conversions	New-to-brand detail page views attributed to ad clicks.	Number	`newToBrandDetailPageViewClicks`
New-To-Brand Detail Page View - ViewThrough Conversions	New-to-brand detail page views attributed to ad views.	Number	`newToBrandDetailPageViewViews`
New-To-Brand Detail Page Views	New-to-brand detail page views attributed to the ad.	Number	`newToBrandDetailPageViews`
New-To-Brand Product Sales	Attributed sales from shoppers who are new to the brand.	Currency	`newToBrandProductSales`
New-To-Brand Units Sold	Units sold from shoppers who are new to the brand.	Number	`newToBrandUnitsSold`
Off Amazon - ClickThrough Conversions	Number of clicks to destinations outside Amazon properties.	Number	`offAmazonClicks`
Off Amazon - ViewThrough Conversions	Number of view-through events associated with off-Amazon conversion tracking.	Number	`offAmazonViews`
Off Amazon Product Sales	Sales revenue from off-Amazon purchases attributed to the ad.	Currency	`offAmazonProductSales`
Off Amazon Units Sold	Units sold from off-Amazon purchases attributed to the ad.	Number	`offAmazonUnitsSold`
Page View - ClickThrough Conversions	Number of page view conversions attributed to ad clicks.	Number	`pageViewClicks`
Page Views	Number of page view conversions attributed to the ad.	Number	`pageViews`
Parent ASIN	Parent ASIN of the advertised child ASIN. Populated on the ASIN breakdown.	Text	`parentAsin`
Product Name	Product title for the ASIN, from Amazon’s product catalog. Populated on the ASIN / parent-ASIN breakdown.	Text	`productName`
Product Review Page Visits	Number of views of the advertised product review pages on Amazon.	Number	`productReviewPageVisits`
Product Review Page Visits - ClickThrough Conversions	Number of product review page views attributed to ad clicks.	Number	`productReviewPageVisitsClicks`
Product Review Page Visits - ViewThrough Conversions	Number of product review page views attributed to ad views.	Number	`productReviewPageVisitsViews`
Sales	Sales of promoted products attributed after an Amazon ad click.	Currency	`sales`
Supply Cost	Total cost associated with media supply.	Currency	`supplyCost`
Total Cost	Total amount spent on media, fees, and technology costs.	Currency	`totalCost`
Total Detail Page View	Total detail page views reported by Amazon DSP, including brand-halo totals when available.	Number	`totalDetailPageView`
Total Detail Page View - ClickThrough Conversions	Total detail page views attributed to ad clicks, including brand-halo totals when available.	Number	`totalDetailPageViewClicks`
Total Detail Page View - ViewThrough Conversions	Total detail page views attributed to ad views, including brand-halo totals when available.	Number	`totalDetailPageViewViews`
Total Fee	Total fees charged by Amazon DSP and related technologies.	Currency	`totalFee`
Total New To Brand Purchase Rate	New-to-brand purchases as a share of purchases, promoted plus brand halo.	Percentage	Adriel-computed
Total New To Brand Sales Rate	New-to-brand product sales as a share of product sales, promoted plus brand halo.	Percentage	Adriel-computed
Total New-To-Brand DPV - ClickThrough Conversions	Total new-to-brand detail page views attributed to ad clicks.	Number	`totalNewToBrandDPVClicks`
Total New-To-Brand DPV - ViewThrough Conversions	Total new-to-brand detail page views attributed to ad views.	Number	`totalNewToBrandDPVViews`
Total New-To-Brand DPVs	Total new-to-brand detail page views attributed to the ad.	Number	`totalNewToBrandDPVs`
Total New-To-Brand Sales	Total attributed sales from shoppers who are new to the brand.	Currency	`totalNewToBrandSales`
Total New-To-Brand Units Sold	Total units sold from shoppers who are new to the brand.	Number	`totalNewToBrandUnitsSold`
Total Product Review Page Visits	Total product review page views attributed to the ad, including brand-halo totals when available.	Number	`totalProductReviewPageVisits`
Total Product Review Page Visits - ClickThrough Conversions	Total product review page views attributed to ad clicks, including brand-halo totals when available.	Number	`totalProductReviewPageVisitsClicks`
Total Product Review Page Visits - ViewThrough Conversions	Total product review page views attributed to ad views, including brand-halo totals when available.	Number	`totalProductReviewPageVisitsViews`
Total Sales	Total attributed sales for promoted and same-brand products.	Currency	`totalSales`
Total Units Sold	Total units sold attributed to the ad, including same-brand products when Amazon DSP reports brand-halo totals.	Number	`totalUnitsSold`
Units Sold	Total quantity of promoted products purchased after exposure to the ad.	Number	`unitsSold`
Video Ad Completions	Number of times a video ad played to completion.	Number	`videoAdComplete`
Video Ad First Quartile	Number of times at least 25% of a video ad played.	Number	`videoAdFirstQuartile`
Video Ad Impressions	Number of times a video ad was served.	Number	`videoAdImpressions`
Video Ad Midpoint	Number of times at least 50% of a video ad played.	Number	`videoAdMidpoint`
Video Ad Mute	Number of times a user muted the video ad.	Number	`videoAdMute`
Video Ad Pause	Number of times a user paused the video ad.	Number	`videoAdPause`
Video Ad Resume	Number of times a user resumed the video ad.	Number	`videoAdResume`
Video Ad Start	Number of times a video ad was started.	Number	`videoAdStart`
Video Ad Third Quartile	Number of times at least 75% of a video ad played.	Number	`videoAdThirdQuartile`
Viewable Impressions	Impressions that met Amazon DSP viewability requirements.	Number	`viewableImpressions`

Breakdowns

Campaign Structure

Breakdown	Description	API Key
Ad	Amazon DSP ad or creative.	`creativeAdId`
Ad Account	Amazon DSP advertiser account.	`advertiserId`
Ad Name	Amazon DSP ad name.	Adriel-side
Ad Set	Amazon DSP ad group or line item.	`lineItemId`
Ad Set Name	Amazon DSP ad group or line item name.	Adriel-side
Campaign	Amazon DSP campaign.	`orderId`
Campaign Name	Amazon DSP campaign name.	Adriel-side
Channel	Primary advertising channel.	Adriel-side
Objective	Campaign objective or type assigned in Amazon DSP.	Adriel-side
Platform	Sub-channel classification for the reported data.	Adriel-side
Status	Delivery status reported by Amazon DSP for the entity.	Adriel-side

Creatives

Breakdown	Description	API Key
Ad Copy	Word extracted from creative text content.	Adriel-side
Color Clustering	Clustered color family detected in the creative.	Adriel-side
Creative Image	Hash value for the creative image asset.	Adriel-side
Emoji Analysis	Emoji classification detected in the creative.	Adriel-side

Date

Amazon DSP returns daily records; all time-grouping breakdowns are Adriel-side aggregations of the same underlying daily data.

Breakdown	Description	API Key
Auto Time Breakdown	Automatically selected time grouping for the reported data.	Adriel-side
Daily Breakdown	Calendar day of the reported data.	Adriel-side
Monthly Breakdown	Calendar month of the reported data.	Adriel-side
Quarterly Breakdown	Calendar quarter of the reported data.	Adriel-side
Week Date Breakdown	The date representing each reporting week.	Adriel-side
Week Number Breakdown(W#)	Week number of the year for the reported data.	Adriel-side
Weekly Breakdown (Start: Mon)	Calendar week of the reported data, starting Monday.	Adriel-side
Weekly Breakdown (Start: Sun)	Calendar week of the reported data, starting Sunday.	Adriel-side
Yearly Breakdown	Calendar year of the reported data.	Adriel-side

Others

Breakdown	Description	API Key
No Grouping	Synthetic breakdown that represents all data without an additional split.	Adriel-side

Amazon DSP-specific

These breakdowns exist only for Amazon DSP and aren’t part of any cross-connector category. Every group above is a standard category shared with other connectors.

Breakdown	Description	API Key
ASIN	Advertised child ASIN. Amazon DSP reports conversions, sales and units by ASIN at the advertiser (account) level only — not per campaign, and spend, ROAS and CPA are not attributable to individual ASINs. The plain conversion metrics count promoted-ASIN activity; the matching Total metrics also include brand-halo activity on other products from the same brand.	Adriel-side
Creative Description	Creative description reported for the ad asset.	Adriel-side
Creative Headline	Creative title reported for the ad asset.	Adriel-side
Parent ASIN	Parent ASIN (the listing that groups a product’s variations). Same limitations as the ASIN breakdown: advertiser-level, conversions / sales / units only. Plain metrics count promoted-ASIN activity; the matching Total metrics also include brand-halo activity.	Adriel-side

Limitations

Fixed 14-day attribution window — every conversion metric uses Amazon DSP’s 14-day window. Comparisons with platforms that use a different default (for example, Meta’s 7-day click) will show differences that come solely from the attribution-window mismatch.
ASIN restatement within 28 days — if ASINs are added to or removed from a campaign after it starts, Amazon restates conversion attribution using the current ASIN set. Restatement applies retroactively and appears in reports within 28 days, so older periods can change from one refresh to the next (Amazon Ads data timing and restatement).
ROAS is computed, not native — Amazon DSP exposes spend and sales but not native ROAS fields, so ROAS (including new-to-brand and combined variants) is computed downstream. Native CTR and ROAS fields, along with advertiserId, advertiserName, date, entityId, intervalEnd, and intervalStart, are excluded from the request set because including them triggers DSP API errors.
Cache-only delivery — reports are served from scheduled snapshots, not on-demand pulls, so the most recent few hours of activity are not yet reflected. Reach across long date ranges can be overvalued, as with any cache-only connector.
Post-refresh adjustments — Amazon may adjust data after the initial refresh: invalid-traffic removal for up to 72 hours, order cancellations and payment declines within 72 hours, and reach and frequency figures may be recomputed (Amazon Ads data timing and restatement).

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Metrics

Campaign Attributes

Campaign Structure

Click Performance

Computed Metrics

Conversion Performance

Creative Attributes

Engagement

Video Performance

Amazon DSP-specific

Breakdowns

Campaign Structure

Creatives

Date

Others

Amazon DSP-specific

Limitations

API references

See also

​Introduction

​Data refresh strategy

​Architecture data

​Reports data

​Architecture levels

​Date range limits

​Metrics

​Campaign Attributes

​Campaign Structure

​Click Performance

​Computed Metrics

​Conversion Performance

​Creative Attributes

​Engagement

​Video Performance

​Amazon DSP-specific

​Breakdowns

​Campaign Structure

​Creatives

​Date

​Others

​Amazon DSP-specific

​Limitations

​API references

​See also

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Metrics

Campaign Attributes

Campaign Structure

Click Performance

Computed Metrics

Conversion Performance

Creative Attributes

Engagement

Video Performance

Amazon DSP-specific

Breakdowns

Campaign Structure

Creatives

Date

Others

Amazon DSP-specific

Limitations

API references

See also