Amazon Advertising: Most-used fields

Amazon Advertising: Most-used fields#

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

API name

Adverity UI name

Description

Use in Adverity

ROAS

ROAS

Return on Ad Spend, calculated by dividing the total sales generated by the advertising spend invested on the campaign. It’s represented as a multiplier.

metric

Report date

Report date

The date for which the report data is generated.

dimension

acosClicks14d

acosClicks14d

Advertising Cost of Sale (ACOS) calculated based on sales occurring within 14 days of an ad click.

metric

acosClicks7d

acosClicks7d

Advertising Cost of Sale (ACOS) calculated based on sales occurring within 7 days of an ad click.

metric

adGroupBid

adGroupId

The bid amount set for the ad group.

metric

adGroupCreationDate

adGroupCreationDate

metric

adGroupCreationDateISO

adGroupCreationDateISO

dimension

adGroupDefaultBid

adGroupDefaultBid

The default bid amount configured for the ad group.

metric

adGroupLastUpdatedDate

adGroupLastUpdatedDate

metric

adGroupLastUpdatedDateISO

adGroupLastUpdatedDateISO

dimension

adGroupName

adGroupName

The name of the ad group.

dimension

adGroupServingStatus

adGroupServingStatus

The serving status of the ad group, indicating whether it is eligible to serve ads.

dimension

adGroupState

adGroupState

The current state of the ad group, such as enabled, paused, or archived.

dimension

adGroupSuggestedBid

adGroupSuggestedBid

The suggested bid amount for the ad group.

dimension

adId

adId

Unique numerical ID of the ad.

metric

adKeywordStatus

adKeywordStatus

The status of the keyword within the ad group.

dimension

adStatus

adStatus

The current status of the ad (e.g., enabled, paused, archived).

dimension

ad_group_id

ad_group_id

The unique identifier for the ad group.

dimension

ad_type

ad_type

The type of ad, such as Sponsored Products (SP), Sponsored Brands (SB), or Sponsored Display (SD).

dimension

addToCart

addToCart

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

metric

addToCartClicks

addToCartClicks

The number of times a product was added to a shopping cart after an ad click.

metric

addToCartRate

addToCartRate

The rate at which products were added to a shopping cart after an ad interaction.

dimension

addToCartViews

addToCartViews

The number of times a product was added to a shopping cart after an ad view.

metric

addToList

addToList

The number of times products were added to a wish list or other lists after an ad interaction.

metric

advertisedAsin

advertisedAsin

The ASIN of the product that was advertised.

dimension

advertisedSku

advertisedSku

The SKU being advertised.

dimension

advertiserId

advertiserId

A unique identifier for the advertiser.

metric

advertiserName

advertiserName

The name of the advertiser.

dimension

applicableBudgetRuleId

applicableBudgetRuleId

The ID associated with the active budget rule for Sponsored Brands campaigns.

dimension

applicableBudgetRuleName

applicableBudgetRuleName

The name associated with the active budget rule for Sponsored Brands campaigns.

dimension

asin

asin

The ASIN associated with an advertised product.

dimension

asinBrandHalo

asinBrandHalo

Data related to sales or conversions of other products within the same brand as the advertised ASIN, attributed to advertising.

dimension

asins

asins

A list of Amazon Standard Identification Numbers (ASINs) associated with the advertised products.

dimension

assets.{NUM}.assetId

assets.{NUM}.assetId

The unique identifier for a specific creative asset.

dimension

assets.{NUM}.mediaType

assets.{NUM}.mediaType

The type of media for the creative asset (e.g., image, video).

dimension

assets.{NUM}.name

assets.{NUM}.name

The name given to the creative asset.

dimension

assets.{NUM}.url

assets.{NUM}.url

The URL where the creative asset is stored.

dimension

attributedAddToCartClicks14d

attributedAddToCartClicks14d

The number of times shoppers added a product to their cart within 14 days of an ad click, attributed to an ad view or click.

metric

attributedBrandedSearches14d

attributedBrandedSearches14d

The number of searches that included the name of your brand occurring within 14 days of an ad click.

metric

attributedConversions14d

attributedConversions14d

Number of attributed conversion events occurring within 14 days of an ad click. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view.

metric

attributedConversions14dSameSKU

attributedConversions14dSameSKU

Number of attributed conversion events occurring within 14 days of ad click where the purchased SKU was the same as the SKU advertised. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view.

metric

attributedConversions1d

attributedConversions1d

The number of attributed conversion events occurring within 1 day of an ad click. For Sponsored Brands, this applies to conversions occurring within 1 day of an ad click or view.

metric

attributedConversions1dSameSKU

attributedConversions1dSameSKU

The number of attributed conversion events occurring within 1 day of an ad click where the purchased SKU was the same as the advertised SKU. For Sponsored Brands, this also applies to ad views.

metric

attributedConversions30d

attributedConversions30d

The number of attributed conversion events occurring within 30 days of an ad click. For Sponsored Brands, this applies to conversions occurring within 30 days of an ad click or view.

metric

attributedConversions30dSameSKU

attributedConversions30dSameSKU

The number of attributed conversion events occurring within 30 days of an ad click where the purchased SKU was the same as the advertised SKU. For Sponsored Brands, this also applies to ad views.

metric

attributedConversions7d

attributedConversions7d

The number of attributed conversion events occurring within 7 days of an ad click. For Sponsored Brands, this applies to conversions occurring within 7 days of an ad click or view.

metric

attributedConversions7dSameSKU

attributedConversions7dSameSKU

The number of attributed conversion events occurring within 7 days of an ad click where the purchased SKU was the same as the advertised SKU. For Sponsored Brands, this also applies to ad views.

metric

attributedDPV14d

attributedDPV14d

The total number of attributed detail page views occurring within 14 days of an ad click. For Sponsored Display vCPM campaigns, this also includes views.

dimension

attributedDetailPageView14d

attributedDetailPageView14d

The total number of attributed detail page views occurring within 14 days of an ad click.

metric

attributedDetailPageViewsClicks14d

attributedDetailPageViewsClicks14d

The number of attributed detail page view conversions occurring within 14 days of ad click.

metric

attributedOrderRateNewToBrand14d

attributedOrderRateNewToBrand14d

The number of new-to-brand orders relative to the number of clicks. New-to-brand order rate = new-to-brand orders / clicks. Not available for book vendors.

metric

attributedOrdersNewToBrand14d

attributedOrdersNewToBrand14d

The number of first-time orders for brand products over a one-year lookback window, attributed to an ad occurring within 14 days of an ad click. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view.

metric

attributedOrdersNewToBrandPercentage14d

attributedOrdersNewToBrandPercentage14d

The percentage of total orders that are new-to-brand orders. Not available for book vendors. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view.

metric

attributedPurchases14d

attributedPurchases14d

The total number of purchases occurring within 14 days of an ad interaction, attributed to an ad click or view.

metric

attributedSales14d

attributedSales14d

Total value of sales occurring within 14 days of an ad click. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view.

metric

attributedSales14dOtherSKU

attributedSales14dOtherSKU

Total value of sales occurring within 14 days of an ad click where the purchased SKU was different from the SKU advertised.

metric

attributedSales14dSameSKU

attributedSales14dSameSKU

Total value of sales occurring within 14 days of ad click where the purchased SKU was the same as the SKU advertised. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view.

metric

attributedSales1d

attributedSales1d

Total value of sales occurring within 24 hours of an ad click.

metric

attributedSales1dOtherSKU

attributedSales1dOtherSKU

The total sales amount (in local currency) from attributed purchases of products other than the advertised SKU, occurring within 1 day of an ad interaction.

metric

attributedSales1dSameSKU

attributedSales1dSameSKU

The total sales amount (in local currency) from attributed purchases occurring within 1 day of an ad interaction, where the purchased SKU was the same as the advertised SKU.

metric

attributedSales30d

attributedSales30d

Total value of sales occurring within 30 days of an ad click.

metric

attributedSales30dOtherSKU

attributedSales30dOtherSKU

The total sales amount (in local currency) from attributed purchases of products other than the advertised SKU, occurring within 30 days of an ad interaction.

metric

attributedSales30dSameSKU

attributedSales30dSameSKU

The total sales amount (in local currency) from attributed purchases occurring within 30 days of an ad interaction, where the purchased SKU was the same as the advertised SKU.

metric

attributedSales7d

attributedSales7d

Total value of sales occurring within seven days of an ad click.

metric

attributedSales7dOtherSKU

attributedSales7dOtherSKU

The total sales amount (in local currency) from attributed purchases of products other than the advertised SKU, occurring within 7 days of an ad interaction.

metric

attributedSales7dSameSKU

attributedSales7dSameSKU

The total sales amount (in local currency) from attributed purchases occurring within 7 days of an ad interaction, where the purchased SKU was the same as the advertised SKU.

metric

attributedSalesNewToBrand14d

attributedSalesNewToBrand14d

Total value of new-to-brand sales occurring within 14 days of an ad click. Not available for book vendors. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view.

metric

attributedSalesNewToBrandPercentage14d

attributedSalesNewToBrandPercentage14d

Percentage of total sales made up of new-to-brand purchases. Not available for book vendors. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view.

metric

attributedSalesSameSku14d

attributedSalesSameSku14d

Sales attributed to the same SKU (stock keeping unit) within a 14-day attribution window.

metric

attributedSalesSameSku1d

attributedSalesSameSku1d

Total value of sales occurring within 24 hours of ad click where the purchased SKU was the same as the SKU advertised.

metric

attributedSalesSameSku30d

attributedSalesSameSku30d

Total value of sales occurring within 30 days of ad click where the purchased SKU was the same as the SKU advertised.

metric

attributedSalesSameSku7d

attributedSalesSameSku7d

Total value of sales occurring within seven days of ad click where the purchased SKU was the same as the SKU advertised.

metric

attributedUnitsOrdered14d

attributedUnitsOrdered14d

Total number of units ordered within 14 days of an ad click.

metric

attributedUnitsOrdered14dOtherSKU

attributedUnitsOrdered14dOtherSKU

Total number of units ordered within 14 days of an ad click where the purchased SKU was different from the SKU advertised.

metric

attributedUnitsOrdered14dSameSKU

attributedUnitsOrdered14dSameSKU

The total number of units ordered within 14 days of an ad click where the purchased SKU was the same as the advertised SKU. For Sponsored Brands, this also applies to ad views.

metric

attributedUnitsOrdered1d

attributedUnitsOrdered1d

Total number of units ordered within 24 hours of an ad click.

metric

attributedUnitsOrdered1dOtherSKU

attributedUnitsOrdered1dOtherSKU

The total number of units ordered from products other than the advertised SKU, occurring within 1 day of an ad click. Also known as a “brand halo” conversion.

metric

attributedUnitsOrdered1dSameSKU

attributedUnitsOrdered1dSameSKU

The total number of units ordered within 1 day of an ad click where the purchased SKU was the same as the advertised SKU.

metric

attributedUnitsOrdered30d

attributedUnitsOrdered30d

Total number of units ordered within 30 days of an ad click.

metric

attributedUnitsOrdered30dOtherSKU

attributedUnitsOrdered30dOtherSKU

The total number of units ordered from products other than the advertised SKU, occurring within 30 days of an ad click.

metric

attributedUnitsOrdered30dSameSKU

attributedUnitsOrdered30dSameSKU

The total number of units ordered within 30 days of an ad click where the purchased SKU was the same as the advertised SKU.

metric

attributedUnitsOrdered7d

attributedUnitsOrdered7d

Total number of units ordered within 7 days of an ad click.

metric

attributedUnitsOrdered7dOtherSKU

attributedUnitsOrdered7dOtherSKU

The total number of units ordered from products other than the advertised SKU, occurring within 7 days of an ad click.

metric

attributedUnitsOrdered7dSameSKU

attributedUnitsOrdered7dSameSKU

The total number of units ordered within 7 days of an ad click where the purchased SKU was the same as the advertised SKU.

metric

attributedUnitsOrderedNewToBrand14d

attributedUnitsOrderedNewToBrand14d

Total number of attributed units ordered as part of new-to-brand sales occurring within 14 days of an ad click. Not available for book vendors. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view.

metric

attributedUnitsOrderedNewToBrandPercentage14d

attributedUnitsOrderedNewToBrandPercentage14d

Percentage of total attributed units ordered within 14 days of an ad click that are part of a new-to-brand purchase. Not available for book vendors. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view.

metric

attributedUnitsSold14d

attributedUnitsSold14d

Number of attributed units sold within 14 days of click on an ad. This is also referred to as unitsSold14d.

dimension

attributionType

attributionType

The model used to attribute conversions to advertising interactions, such as “last touch” or “first touch”.

dimension

bid

bid

The bid amount for the ad or keyword.

dimension

bidOptimization

bidOptimization

Bid optimization for Sponsored Display ad groups. For vCPM campaigns, the value is always ‘reach’. For CPC campaigns, value is either ‘clicks’ or ‘conversions’.

dimension

bidRecommendations.closeMatch.lowBid.suggestedBid

bidRecommendations.closeMatch.lowBid.suggestedBid

The low-end suggested bid for close-match targeting, recommended by Amazon to optimize ad performance.

metric

bidRecommendations.substitutes.lowBid.suggestedBid

bidRecommendations.substitutes.lowBid.suggestedBid

The suggested bid for a substitute product at the lower end of the bid range within bid recommendations.

metric

bidRecommendations.substitutes.medianBid.suggestedBid

bidRecommendations.substitutes.medianBid.suggestedBid

The suggested bid for a substitute product at the median of the bid range within bid recommendations.

metric

brandEntityId

brandEntityId

A unique identifier for the brand associated with the advertising activities.

dimension

brandName

brandName

The name of the brand associated with the product or campaign.

dimension

brandedSearches

brandedSearches

The number of searches for the brand associated with the advertised products.

metric

brandedSearchesClicks

brandedSearchesClicks

The number of clicks on ads that originated from branded searches.

metric

brandedSearchesViews

brandedSearchesViews

The number of searches that included the brand name, attributed to an ad view.

metric

campaignAdFormat

campaignAdFormat

The format of the ad creative used in the campaign.

dimension

campaignApplicableBudgetRuleId

campaignApplicableBudgetRuleId

The ID associated with the active budget rule for Sponsored Brands campaigns. This is also referred to as applicableBudgetRuleId.

dimension

campaignApplicableBudgetRuleName

campaignApplicableBudgetRuleName

The name associated with the active budget rule for Sponsored Brands campaigns. This is also referred to as applicableBudgetRuleName.

dimension

campaignBidMultiplier

campaignBidMultiplier

A factor used to adjust bids for specific targeting attributes or placements within a campaign.

dimension

campaignBidOptimization

campaignBidOptimization

The strategy used to optimize bids within the campaign to achieve specific performance goals.

dimension

campaignBiddingAdjustmentsPredicate

campaignBiddingAdjustmentsPredicate

dimension

campaignBiddingBidOptimization

campaignBiddingBidOptimization

Details about the bid optimization strategy applied to the campaign.

dimension

campaignBiddingStrategy

campaignBiddingStrategy

The bidding strategy employed for the campaign (e.g., dynamic bids - down only, fixed bids).

dimension

campaignBudget

campaignBudget

Total budget allocated to the campaign.

metric

campaignBudgetAmount

campaignBudgetAmount

The monetary amount allocated as the budget for the campaign.

metric

campaignBudgetBudget

campaignBudgetBudget

The total budget allocated to the campaign. This is also referred to as campaignBudget.

metric

campaignBudgetCurrencyCode

campaignBudgetCurrencyCode

The currency code for the campaign budget (e.g., USD, EUR).

dimension

campaignBudgetType

campaignBudgetType

The type of budget allocated to the campaign, either ‘daily’ or ‘lifetime’.

dimension

campaignCreationDate

campaignCreationDate

metric

campaignCreationDateISO

campaignCreationDateISO

dimension

campaignCreativeAsins

campaignCreativeAsins

dimension

campaignCreativeBrandLogoAssetID

campaignCreativeBrandLogoAssetID

The asset ID of the brand logo used in the campaign’s creative.

dimension

campaignCreativeBrandLogoUrl

campaignCreativeBrandLogoUrl

The URL of the brand logo used in the campaign’s creative.

dimension

campaignCreativeBrandName

campaignCreativeBrandName

dimension

campaignCreativeHeadline

campaignCreativeHeadline

The headline text displayed in the campaign’s creative.

dimension

campaignCreativeShouldOptimizeAsins

campaignCreativeShouldOptimizeAsins

dimension

campaignCreativeType

campaignCreativeType

The type of creative asset used in the campaign.

dimension

campaignCreativeVideoAssetIds

campaignCreativeVideoAssetIds

The asset IDs for video creatives used in the campaign.

dimension

campaignCreativeVideoMediaIds

campaignCreativeVideoMediaIds

The media IDs for video assets used in the campaign’s creative.

dimension

campaignDailyBudget

campaignDailyBudget

The maximum amount of money allocated to be spent on the campaign per day.

dimension

campaignDynamicBiddingPlacementBiddingPercentage

campaignDynamicBiddingPlacementBiddingPercentage

The percentage adjustment applied to bids for specific placements when dynamic bidding is enabled for the campaign.

metric

campaignDynamicBiddingPlacementBiddingPlacement

campaignDynamicBiddingPlacementBiddingPlacement

The specific ad placement for which dynamic bidding adjustments are applied.

dimension

campaignDynamicBiddingStrategy

campaignDynamicBiddingStrategy

The dynamic bidding strategy configured for the campaign (e.g., up and down, down only).

dimension

campaignEndDate

campaignEndDate

metric

campaignEndDateISO

campaignEndDateISO

dimension

campaignExtendedDataServingStatus

campaignExtendedDataServingStatus

dimension

campaignLandingPagePageType

campaignLandingPagePageType

The type of landing page used for the campaign (e.g., product detail page, Brand Store).

dimension

campaignLandingPageUrl

campaignLandingPageUrl

The URL of the landing page where users are directed after clicking on an ad.

dimension

campaignLastUpdatedDate

campaignLastUpdatedDate

metric

campaignLastUpdatedDateISO

campaignLastUpdatedDateISO

dimension

campaignName

campaignName

The name of the advertising campaign.

dimension

campaignPremiumBidAdjustment

campaignPremiumBidAdjustment

An additional percentage increase applied to bids for premium placements or targeting.

dimension

campaignPriceTypeCode

campaignPriceTypeCode

The pricing type code for the campaign (e.g., CPC for cost-per-click, CPM for cost-per-thousand impressions).

dimension

campaignRuleBasedBudget

campaignRuleBasedBudget

The value of the rule-based budget for Sponsored Brands campaigns.

dimension

campaignRuleBasedBudgetAmount

campaignRuleBasedBudgetAmount

The monetary amount of the rule-based budget for Sponsored Brands campaigns. This is also referred to as campaignRuleBasedBudget.

dimension

campaignServingStatus

campaignServingStatus

The serving status of the campaign, indicating whether it is eligible to serve ads.

dimension

campaignStartDate

campaignStartDate

metric

campaignStartDateISO

campaignStartDateISO

dimension

campaignState

campaignState

The current state of the campaign (e.g., enabled, paused, archived). This is also referred to as campaignStatus.

dimension

campaignStatus

campaignStatus

The current operational status or state of the campaign (e.g., enabled, paused, archived).

dimension

campaignTactic

campaignTactic

The specific targeting tactic used in a Sponsored Display campaign (e.g., product targeting, audience targeting).

dimension

campaignTargetingType

campaignTargetingType

The broad category of targeting used in the campaign (e.g., keyword targeting, product targeting, audience targeting).

dimension

campaignType

campaignType

The type of advertising campaign (e.g., Sponsored Products, Sponsored Brands, Sponsored Display).

dimension

campaign_state

campaign_state

The current status or state of the campaign (e.g., enabled, paused, archived).

dimension

clickThroughRate

clickThroughRate

The percentage of impressions that resulted in a click (clicks / impressions).

metric

clicks

clicks

Total number of ad clicks.

metric

conversions

conversions

The total number of conversion events, such as purchases, attributed to ad interactions.

metric

conversionsBrandHalo

conversionsBrandHalo

The total number of conversions attributed to brand halo effects from advertising.

metric

conversionsBrandHaloClicks

conversionsBrandHaloClicks

For Sponsored Display vCPM campaigns, the total number of attributed conversion events occurring within 14 days of an ad click where the purchased SKU was different from the SKU advertised.

metric

cost

cost

Total cost of ad clicks.

metric

costPerClick

costPerClick

The average cost incurred for each click on an ad (cost / clicks).

metric

costType

costType

Determines how the campaign will bid and charge, such as ‘vCPM’ (cost per thousand viewable impressions) or ‘CPC’ (cost per click). Only relevant for Sponsored Display campaigns.

dimension

country_code

country_code

The two-letter country code (e.g., US, GB) relevant to the advertising data.

dimension

cumulativeReach

cumulativeReach

Total number of unique users exposed to an ad from either a campaign, ad group, or product ad over the lifetime of the campaign or the past six months, whichever is shorter.

metric

currency

currency

The currency code associated with the campaign.

dimension

date

date

The specific date for which the advertising data is reported.

dimension

day

day

The specific day for which the data is reported.

dimension

detailPageViewClicks

detailPageViewClicks

The number of clicks that led to a detail page view.

metric

detailPageViews

detailPageViews

The total number of times product detail pages were viewed after an ad interaction.

metric

detailPageViewsClicks

detailPageViewsClicks

The total number of product detail page views that resulted from clicks on an ad.

metric

dpv14d

dpv14d

Number of attributed detail page views occurring within 14 days of click on an ad. This is a vendor-only field.

metric

endDate

endDate

The end date of the reporting period, in YYYYMMDD format.

dimension

entityId

entityId

A unique identifier for the entity (e.g., campaign, ad group, advertiser) that the data refers to.

dimension

impressions

impressions

Total number of ad impressions.

metric

impressionsFrequencyAverage

impressionsFrequencyAverage

Average number of times unique users were exposed to an ad over the lifetime of the campaign.

metric

impressionsViews

impressionsViews

The total number of impressions or views an ad received.

metric

interactiveImpressions

interactiveImpressions

The number of impressions where users interacted with the ad creative.

metric

intervalEnd

intervalEnd

The end of the reporting interval.

dimension

intervalStart

intervalStart

The start of the reporting interval.

dimension

keyword

keyword

The keyword or phrase used in targeting. This is also referred to as keywordText.

dimension

keywordBid

keywordBid

The advertiser-set bid value for a keyword.

metric

keywordMatchType

keywordMatchType

The type of matching for the keyword or phrase used in the bid, such as broad, phrase, or exact. This is also referred to as matchType.

dimension

keywordState

keywordState

The current state of the keyword (e.g., enabled, paused, archived).

dimension

keywordStatus

keywordStatus

The status of the keyword.

dimension

keywordText

keywordText

Text of the keyword or phrase.

dimension

keywordType

campaignId

Unique numerical ID of a campaign.

metric

leadFormOpens

leadFormOpens

metric

leads

leads

The number of leads generated from ad interactions.

metric

linkOuts

linkOuts

The number of clicks that directed users to a destination outside of Amazon.

metric

marketplace

marketplace

The Amazon marketplace where the advertising activity occurred (e.g., US, UK, DE).

dimension

matchType

matchType

Type of matching for the keyword or phrase used in bid. Must be one of: broad, phrase, or exact.

dimension

newToBrandDetailPageViewClicks

newToBrandDetailPageViewClicks

The number of detail page views from shoppers new to the brand, attributed to an ad click. A shopper is considered new if they haven’t viewed a detail page for the brand in the past 365 days.

dimension

newToBrandDetailPageViewViews

newToBrandDetailPageViewViews

The number of detail page views from shoppers new to the brand, attributed to an ad view. A shopper is considered new if they haven’t viewed a detail page for the brand in the past 365 days.

dimension

newToBrandDetailPageViews

newToBrandDetailPageViews

The total number of detail page views from shoppers new to the brand, attributed to an ad interaction (click or view).

dimension

newToBrandPurchases

newToBrandPurchases

The total number of purchases made by new-to-brand customers.

metric

newToBrandPurchases14d

newToBrandPurchases14d

The total number of purchases made by new-to-brand customers within a 14-day attribution window.

metric

newToBrandPurchasesClicks

newToBrandPurchasesClicks

The number of purchases made by new-to-brand customers that resulted from ad clicks.

metric

newToBrandPurchasesPercentage14d

newToBrandPurchasesPercentage14d

The percentage of purchases attributed to new-to-brand customers within a 14-day attribution window.

metric

newToBrandSales

newToBrandSales

The total sales generated from new-to-brand customers.

metric

newToBrandSales14d

newToBrandSales14d

Total value of new-to-brand sales occurring within 14 days of an ad click. This is also referred to as attributedSalesNewToBrand14d.

metric

newToBrandSalesClicks

newToBrandSalesClicks

The sales generated from new-to-brand customers that resulted from ad clicks.

metric

newToBrandSalesPercentage14d

newToBrandSalesPercentage14d

The percentage of total sales made up of new-to-brand purchases within 14 days of an ad interaction. This is also referred to as attributedSalesNewToBrandPercentage14d.

metric

newToBrandUnitsSold

newToBrandUnitsSold

The total number of units sold to new-to-brand customers.

metric

newToBrandUnitsSold14d

newToBrandUnitsSold14d

The total number of units sold to new-to-brand customers within a 14-day attribution window.

metric

newToBrandUnitsSoldClicks

newToBrandUnitsSoldClicks

The number of units sold to new-to-brand customers that resulted from ad clicks.

metric

newToBrandUnitsSoldPercentage14d

newToBrandUnitsSoldPercentage14d

The percentage of total attributed units ordered within 14 days of an ad click that are part of a new-to-brand purchase.

metric

orders14d

orders14d

The number of orders occurring within 14 days, attributed to an ad click or view.

metric

ordersClicks14d

ordersClicks14d

The total number of orders attributed to clicks within a 14-day attribution window.

metric

periodicity

periodicity

The reporting period or frequency for the data (e.g., daily, summary).

dimension

placementClassification

placementClassification

The classification of where the ad was placed (e.g., top of search, rest of search, product page).

dimension

portfolioId

portfolioId

A unique identifier for the portfolio.

metric

portfolioName

portfolioName

The name of the portfolio to which the campaign or advertising entity belongs.

dimension

productAdsAdId

productAdsAdId

Unique numerical ID of the product ad.

dimension

productAdsAsin

productAdsAsin

The ASIN of the product being advertised in the product ad.

dimension

productAdsCreationDate

productAdsCreationDate

metric

productAdsCreationDateISO

productAdsCreationDateISO

dimension

productAdsLastUpdatedDate

productAdsLastUpdatedDate

metric

productAdsLastUpdatedDateISO

productAdsLastUpdatedDateISO

dimension

productAdsServingStatus

productAdsServingStatus

The serving status of the product ad, indicating whether it is eligible to serve.

dimension

productAdsSku

productAdsSku

The Seller SKU (Stock Keeping Unit) of the advertised product.

dimension

productAdsState

productAdsState

The current state of the product ad, such as enabled, paused, or archived.

dimension

productAsin

productAsin

The Amazon Standard Identification Number (ASIN) of a product.

dimension

productCategory

productCategory

The product category of the advertised item.

dimension

productConversionType

productConversionType

dimension

productGroup

productGroup

dimension

productName

productName

The name of the advertised product.

dimension

productSubcategory

productSubcategory

dimension

profileBrandName

profileBrandName

dimension

profileCountryCode

profileCountryCode

dimension

profileId

profileId

A unique identifier for the advertising profile.

metric

profileName

profileName

The name associated with an advertiser’s profile.

dimension

promotedAsin

promotedAsin

The Amazon Standard Identification Number (ASIN) of the promoted product.

dimension

promotedSku

promotedSku

The Seller SKU (Stock Keeping Unit) of the promoted product.

dimension

publisher

publisher

The source of the traffic or ad impression, particularly relevant for Amazon Attribution API that measures non-Amazon media performance (e.g., Google, Facebook).

dimension

purchasedAsin

purchasedAsin

The ASIN (Amazon Standard Identification Number) of the product purchased following an ad interaction.

dimension

purchases

purchases

The total number of purchases attributed to advertising.

metric

purchases14d

purchases14d

The total number of purchases attributed to advertising within a 14-day attribution window.

metric

purchases1d

purchases1d

The total number of purchases attributed to advertising within a 1-day attribution window.

metric

purchases30d

purchases30d

The total number of purchases attributed to advertising within a 30-day attribution window.

metric

purchases7d

purchases7d

The total number of purchases attributed to advertising within a 7-day attribution window.

metric

purchasesClicks

purchasesClicks

The total number of purchases attributed to ad clicks.

metric

purchasesOtherSku14d

purchasesOtherSku14d

The total number of purchases of products other than the advertised SKU, occurring within 14 days of an ad interaction. This often refers to “brand halo” conversions.

metric

purchasesOtherSku1d

purchasesOtherSku1d

The total number of purchases of products other than the advertised SKU, occurring within 1 day of an ad interaction.

metric

purchasesOtherSku30d

purchasesOtherSku30d

The total number of purchases of products other than the advertised SKU, occurring within 30 days of an ad interaction.

metric

purchasesOtherSku7d

purchasesOtherSku7d

The total number of purchases of products other than the advertised SKU, occurring within 7 days of an ad interaction.

metric

purchasesPromotedClicks

purchasesPromotedClicks

The number of purchases attributed to clicks on promoted ads.

metric

purchasesSameSku14d

purchasesSameSku14d

The number of purchases of the same SKU as the advertised product, attributed to advertising within a 14-day attribution window.

metric

purchasesSameSku1d

purchasesSameSku1d

The number of purchases of the same SKU as the advertised product, attributed to advertising within a 1-day attribution window.

metric

purchasesSameSku30d

purchasesSameSku30d

The number of purchases of the same SKU as the advertised product, attributed to advertising within a 30-day attribution window.

metric

purchasesSameSku7d

purchasesSameSku7d

The number of purchases of the same SKU as the advertised product, attributed to advertising within a 7-day attribution window.

metric

report_id

report_id

The unique identifier for an asynchronously generated report.

dimension

roasClicks14d

roasClicks14d

Return on Advertising Spend (ROAS) calculated based on sales occurring within 14 days of an ad click.

metric

roasClicks7d

roasClicks7d

Return on Advertising Spend (ROAS) calculated based on sales occurring within 7 days of an ad click.

metric

sales

sales

The total sales generated from advertising.

metric

sales14d

sales14d

Total value of sales occurring within 14 days of click on an ad.

metric

sales1d

sales1d

The sales generated from advertising within a 1-day attribution window.

metric

sales30d

sales30d

Total value of sales occurring within 30 days of an ad interaction.

metric

sales7d

sales7d

The sales generated from advertising within a 7-day attribution window.

metric

salesBrandHalo

salesBrandHalo

The total sales generated from brand halo effects attributed to advertising.

metric

salesBrandHaloClicks

salesBrandHaloClicks

The sales generated from brand halo effects that resulted from ad clicks.

metric

salesClicks

salesClicks

The sales generated that resulted from ad clicks.

metric

salesClicks14d

salesClicks14d

The total sales revenue attributed to clicks within a 14-day attribution window.

metric

salesOtherSku14d

salesOtherSku14d

The total sales amount (in local currency) from purchases of products other than the advertised SKU, occurring within 14 days of an ad interaction. This reflects sales attributed to brand halo.

metric

salesOtherSku1d

salesOtherSku1d

The total sales amount (in local currency) from purchases of products other than the advertised SKU, occurring within 1 day of an ad interaction.

metric

salesOtherSku30d

salesOtherSku30d

The total sales amount (in local currency) from purchases of products other than the advertised SKU, occurring within 30 days of an ad interaction.

metric

salesOtherSku7d

salesOtherSku7d

The sales generated from advertising for SKUs other than the advertised product, within a 7-day attribution window.

metric

salesPromoted

salesPromoted

The total sales generated by promoted products.

metric

salesPromotedClicks

salesPromotedClicks

The sales generated from clicks on promoted ads.

metric

searchTerm

searchTerm

The search term used by the customer.

dimension

searchTermImpressionRank

searchTermImpressionRank

Account-level ad-attributed impression rank for search terms.

metric

searchTermImpressionShare

searchTermImpressionShare

Account-level ad-attributed impression share for search terms.

metric

sku

sku

The Stock Keeping Unit (SKU) used by the seller to identify a specific product variation.

dimension

spend

spend

The total cost of advertising, equivalent to ‘cost’.

metric

startDate

startDate

The start date of the reporting period, in YYYYMMDD format.

dimension

storeName

storeName

The name of the Brand Store associated with the campaign or advertiser.

dimension

suggestedBid.bidRecId

suggestedBid.bidRecId

The unique identifier for a specific bid recommendation.

dimension

suggestedBid.rangeEnd

suggestedBid.rangeEnd

The upper boundary of the suggested bid range.

dimension

suggestedBid.rangeStart

suggestedBid.rangeStart

The lower boundary of the suggested bid range.

dimension

suggestedBid.suggested

suggestedBid.suggested

The specific suggested bid value.

dimension

targetBid

targetBid

The target bid amount set for a specific keyword or product target.

dimension

targeting

targeting

Information related to the targeting strategy and clauses used in advertising campaigns.

dimension

targetingExpression

targetingExpression

A string representation of the expression object used in the targeting clause.

dimension

targetingId

targetingId

The identifier of the targeting expression.

metric

targetingText

targetingText

The text used in the targeting expression.

dimension

targetingType

targetingType

The type of targeting used in the expression.

dimension

topOfSearchImpressionShare

topOfSearchImpressionShare

The percentage of top-of-search impressions earned out of all eligible top-of-search impressions for a given date range.

metric

totalCost

totalCost

The total cost incurred for the advertising campaign or entity.

metric

unitsSold

unitsSold

The total number of units sold attributed to advertising.

metric

unitsSold14d

unitsSold14d

Number of attributed units sold within 14 days of click on an ad. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view.

dimension

unitsSoldBrandHalo

unitsSoldBrandHalo

The total number of units sold due to brand halo effects attributed to advertising.

metric

unitsSoldBrandHaloClicks

unitsSoldBrandHaloClicks

The number of units sold due to brand halo effects that resulted from ad clicks.

metric

unitsSoldClicks

unitsSoldClicks

The total number of units sold that are attributed to ad clicks.

metric

unitsSoldClicks14d

unitsSoldClicks14d

The number of units sold that resulted from ad clicks, attributed within a 14-day attribution window.

metric

unitsSoldClicks1d

unitsSoldClicks1d

The number of units sold that resulted from ad clicks, attributed within a 1-day attribution window.

metric

unitsSoldClicks30d

unitsSoldClicks30d

The number of units sold that resulted from ad clicks, attributed within a 30-day attribution window.

metric

unitsSoldClicks7d

unitsSoldClicks7d

The number of units sold that resulted from ad clicks, attributed within a 7-day attribution window.

metric

unitsSoldOtherSku14d

unitsSoldOtherSku14d

The total number of units ordered from products other than the advertised SKU, occurring within 14 days of an ad click. This includes brand halo units.

metric

unitsSoldOtherSku1d

unitsSoldOtherSku1d

The total number of units ordered from products other than the advertised SKU, occurring within 1 day of an ad click.

metric

unitsSoldOtherSku30d

unitsSoldOtherSku30d

The total number of units ordered from products other than the advertised SKU, occurring within 30 days of an ad click.

metric

unitsSoldOtherSku7d

unitsSoldOtherSku7d

The number of units sold for SKUs other than the advertised product, attributed within a 7-day attribution window.

metric

unitsSoldSameSku14d

unitsSoldSameSku14d

The number of units sold for the same SKU as the advertised product, attributed to advertising within a 14-day attribution window.

metric

unitsSoldSameSku1d

unitsSoldSameSku1d

The number of units sold for the same SKU as the advertised product, attributed to advertising within a 1-day attribution window.

metric

unitsSoldSameSku30d

unitsSoldSameSku30d

The number of units sold for the same SKU as the advertised product, attributed to advertising within a 30-day attribution window.

metric

unitsSoldSameSku7d

unitsSoldSameSku7d

The number of units sold for the same SKU as the advertised product, attributed to advertising within a 7-day attribution window.

metric

video5SecondViews

video5SecondViews

The number of impressions where the customer watched the complete video or 5 seconds (whichever is shorter). This is a Sponsored Brands video-only metric.

metric

videoCompleteViews

videoCompleteViews

The number of impressions where the video was viewed to 100%.

metric

videoFirstQuartileViews

videoFirstQuartileViews

The number of impressions where the video was viewed to 25%.

metric

videoMidpointViews

videoMidpointViews

The number of impressions where the video was viewed to 50%.

metric

videoThirdQuartileViews

videoThirdQuartileViews

The number of impressions where the video was viewed to 75%.

metric

videoUnmutes

videoUnmutes

The number of impressions where a customer unmuted the video.

metric

viewAttributedBrandedSearches14d

viewAttributedBrandedSearches14d

For Sponsored Display vCPM campaigns, the total number of searches that included the name of your brand occurring within 14 days of an ad view. For CPC campaigns, this value is equal to attributedBrandedSearches14d (which is click-based).

dimension

viewAttributedConversions14d

viewAttributedConversions14d

For Sponsored Display vCPM campaigns, the total number of attributed conversion events occurring within 14 days of an ad click or view. For CPC campaigns, this value is equal to attributedConversions14d.

metric

viewAttributedDetailPageView14d

viewAttributedDetailPageView14d

For Sponsored Display vCPM campaigns, the total number of attributed detail page views occurring within 14 days of an ad click or view. For CPC campaigns, this value is equal to attributedDetailPageView14d.

metric

viewAttributedOrdersNewToBrand14d

viewAttributedOrdersNewToBrand14d

For Sponsored Display vCPM campaigns, the total number of attributed new-to-brand orders occurring within 14 days of an ad click or view.

metric

viewAttributedSales14d

viewAttributedSales14d

For Sponsored Display vCPM campaigns, the total attributed sales amount occurring within 14 days of an ad click or view. For CPC campaigns, this value is equal to attributedSales14d.

metric

viewAttributedSalesNewToBrand14d

viewAttributedSalesNewToBrand14d

For Sponsored Display vCPM campaigns, the total attributed sales amount from new-to-brand purchases occurring within 14 days of an ad click or view.

metric

viewAttributedUnitsOrdered14d

viewAttributedUnitsOrdered14d

For Sponsored Display vCPM campaigns, the total number of attributed units ordered occurring within 14 days of an ad click or view.

metric

viewAttributedUnitsOrderedNewToBrand14d

viewAttributedUnitsOrderedNewToBrand14d

Total number of attributed units ordered as part of new-to-brand sales occurring within 14 days of an ad click. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view.

metric

viewClickThroughRate

viewClickThroughRate

Click-through rate for views (clicks divided by views). This is also referred to as vctr.

dimension

viewImpressions

viewImpressions

The number of viewable impressions served for display or video ads.

dimension

viewabilityRate

viewabilityRate

The percentage of impressions that were viewable according to industry standards.

metric

viewableImpressions

viewableImpressions

Number of impressions that met the Media Ratings Council (MRC) viewability standard.

metric