Skip to content
Book a demo

Connect documentation

All documentation
Documentation

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.

FieldAdverity UI nameType
CountryDimension

This field represents the country where the advertising activity took place or where the ad was displayed. It can be provided as the country name or its ISO code.

Report dateDimension

The specific date for which the performance report data is generated.

acosClicks14dMetric

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

acosClicks7dMetric

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

adGroupBidMetric

The bid amount set for the ad group.

adGroupCreationDateMetric

The date when the ad group was created.

adGroupCreationDateISODimension

The date when the ad group was created, formatted according to ISO 8601 standard.

adGroupDefaultBidMetric

The default bid set for the ad group.

adGroupIdDimension

A unique identifier for an ad group, which organizes a collection of ads with shared targeting and bids within a campaign.

adGroupLastUpdatedDateMetric

The date when the ad group was last updated.

adGroupLastUpdatedDateISODimension

The ISO formatted date when the ad group was last updated.

adGroupNameDimension

The name of the ad group.

adGroupServingStatusDimension

The serving status of the ad group (e.g., delivering, paused, archived).

adGroupStateDimension

The state of the ad group (e.g., enabled, paused, archived).

adIdDimension

Unique numerical ID of the ad.

adKeywordStatusDimension

The status of the keyword within the ad group.

adStatusDimension

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

addToCartMetric

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

addToCartClicksMetric

The total number of clicks on 'Add to Cart' buttons.

addToCartViewsMetric

The number of times shoppers added a brand's products to their cart, specifically attributed to an ad view.

addToListMetric

Indicates the operation to associate or disassociate records with an audience within the Amazon Ads Data Provider API. This is used for managing audience records by adding or removing them.

advertisedAsinDimension

The ASIN of the product that was advertised.

advertisedSkuDimension

The SKU being advertised.

advertiserNameDimension

The name of the advertiser.

applicableBudgetRuleIdDimension

The identifier of the budget rule applied to the campaign or ad group.

applicableBudgetRuleNameDimension

The name of the budget rule applied to the campaign or ad group.

asinDimension

The ASIN associated with an advertised product.

asinBrandHaloDimension

Represents a product that was purchased after an ad click but has a different SKU/ASIN than what was advertised. It is available in Sponsored Display Purchased Product reports.

asinsDimension

Amazon Standard Identification Numbers (ASINs) related to the ad campaign, used as a dimension for reporting or for targeting.

assets.{NUM}.assetIdDimension

A unique identifier assigned to a creative asset, such as an image or video, used within Amazon Advertising campaigns.

assets.{NUM}.mediaTypeDimension

The type of media for the creative asset, such as an image or video, used in advertising campaigns.

assets.{NUM}.nameDimension

The name given to the creative asset for organizational and identification purposes within the advertising platform.

assets.{NUM}.urlDimension

The URL where the creative asset is stored and can be accessed or retrieved.

attributedAddToCartClicks14dMetric

The number of add-to-cart clicks attributed to ads within a 14-day attribution window.

attributedBrandedSearches14dMetric

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

attributedConversions14dMetric

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.

attributedConversions14dSameSKUMetric

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.

attributedConversions1dMetric

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.

attributedConversions1dSameSKUMetric

The number of conversions for the same SKU attributed to ads within a 1-day attribution window.

attributedConversions30dMetric

The total number of conversions attributed to ads within a 30-day attribution window.

attributedConversions30dSameSKUMetric

The number of conversions for the same SKU attributed to ads within a 30-day attribution window.

attributedConversions7dMetric

The total number of conversions attributed to ads within a 7-day attribution window.

attributedConversions7dSameSKUMetric

The number of conversions for the same SKU attributed to ads within a 7-day attribution window.

attributedDPV14dDimension

Detail Page Views attributed to ads within a 14-day attribution window.

attributedDetailPageViewsClicks14dMetric

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

attributedOrderRateNewToBrand14dMetric

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.

attributedOrdersNewToBrand14dMetric

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.

attributedOrdersNewToBrandPercentage14dMetric

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.

attributedPurchases14dMetric

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

attributedSales14dMetric

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.

attributedSales14dOtherSKUMetric

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

attributedSales14dSameSKUMetric

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.

attributedSales1dMetric

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

attributedSales1dOtherSKUMetric

Sales of other SKUs attributed to ads within a 1-day attribution window.

attributedSales1dSameSKUMetric

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.

attributedSales30dMetric

Total sales attributed to ads within a 30-day attribution window.

attributedSales30dOtherSKUMetric

Sales of other SKUs attributed to ads within a 30-day attribution window.

attributedSales30dSameSKUMetric

Sales of the same SKU attributed to ads within a 30-day attribution window.

attributedSales7dMetric

Total sales attributed to ads within a 7-day attribution window.

attributedSales7dOtherSKUMetric

Sales of other SKUs attributed to ads within a 7-day attribution window.

attributedSales7dSameSKUMetric

Sales of the same SKU attributed to ads within a 7-day attribution window.

attributedSalesNewToBrand14dMetric

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.

attributedSalesNewToBrandPercentage14dMetric

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.

attributedSalesSameSku14dMetric

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

attributedSalesSameSku1dMetric

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

attributedSalesSameSku30dMetric

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

attributedSalesSameSku7dMetric

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

attributedUnitsOrdered14dMetric

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

attributedUnitsOrdered14dOtherSKUMetric

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

attributedUnitsOrdered14dSameSKUMetric

The number of units ordered for the same SKU attributed to ads within a 14-day attribution window.

attributedUnitsOrdered1dMetric

The number of units ordered within a 1-day attribution window after an ad interaction.

attributedUnitsOrdered1dOtherSKUMetric

The number of units ordered for other SKUs attributed to ads within a 1-day attribution window.

attributedUnitsOrdered1dSameSKUMetric

The number of units ordered for the same SKU attributed to ads within a 1-day attribution window.

attributedUnitsOrdered30dMetric

The number of units ordered within a 30-day attribution window after an ad interaction.

attributedUnitsOrdered30dOtherSKUMetric

The number of units ordered for other SKUs attributed to ads within a 30-day attribution window.

attributedUnitsOrdered30dSameSKUMetric

The number of units ordered for the same SKU attributed to ads within a 30-day attribution window.

attributedUnitsOrdered7dMetric

The number of units ordered within a 7-day attribution window after an ad interaction.

attributedUnitsOrdered7dOtherSKUMetric

The number of units ordered for other SKUs attributed to ads within a 7-day attribution window.

attributedUnitsOrdered7dSameSKUMetric

The number of units ordered for the same SKU attributed to ads within a 7-day attribution window.

attributedUnitsOrderedNewToBrand14dMetric

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.

attributedUnitsOrderedNewToBrandPercentage14dMetric

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.

attributedUnitsSold14dDimension

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

attributionTypeDimension

The model used to attribute conversions to ad interactions.

bidMetric

The current bid amount set for a keyword, product, or ad group.

bidOptimizationDimension

The strategy used to optimize bids for campaigns or ad groups.

bidRecommendations.closeMatch.highBid.suggestedBidMetric

The recommended high bid for ads that closely match the specified targeting value.

bidRecommendations.closeMatch.lowBid.suggestedBidMetric

The suggested bid value representing the lower end of the recommended bid range for a 'close match' targeting strategy. These recommendations are provided to help advertisers optimize their campaigns for performance metrics such as impressions, clicks, or conversions.

bidRecommendations.closeMatch.medianBid.suggestedBidMetric

The recommended median bid for ads that closely match the specified targeting value.

bidRecommendations.complements.highBid.suggestedBidMetric

The recommended high bid for displaying ads alongside complementary products.

bidRecommendations.complements.lowBid.suggestedBidMetric

The recommended low bid for displaying ads alongside complementary products.

bidRecommendations.complements.medianBid.suggestedBidMetric

The recommended median bid for displaying ads alongside complementary products.

bidRecommendations.impactMetrics.clicks.highBid.lowerDimension

The lower bound of the estimated weekly clicks if the high suggested bid is adopted.

bidRecommendations.impactMetrics.clicks.highBid.upperDimension

The upper bound of the estimated weekly clicks if the high suggested bid is adopted.

bidRecommendations.impactMetrics.clicks.lowBid.lowerDimension

The lower bound of the estimated weekly clicks if the low suggested bid is adopted.

bidRecommendations.impactMetrics.clicks.lowBid.upperDimension

The upper bound of the estimated weekly clicks if the low suggested bid is adopted.

bidRecommendations.impactMetrics.clicks.medianBid.lowerDimension

The lower bound of the estimated weekly clicks if the median suggested bid is adopted.

bidRecommendations.impactMetrics.clicks.medianBid.upperDimension

The upper bound of the estimated weekly clicks if the median suggested bid is adopted.

bidRecommendations.impactMetrics.orders.highBid.lowerDimension

The lower bound of the estimated weekly purchase orders if the high suggested bid is adopted.

bidRecommendations.impactMetrics.orders.highBid.upperDimension

The upper bound of the estimated weekly purchase orders if the high suggested bid is adopted.

bidRecommendations.impactMetrics.orders.lowBid.lowerDimension

The lower bound of the estimated weekly purchase orders if the low suggested bid is adopted.

bidRecommendations.impactMetrics.orders.lowBid.upperDimension

The upper bound of the estimated weekly purchase orders if the low suggested bid is adopted.

bidRecommendations.impactMetrics.orders.medianBid.lowerDimension

The lower bound of the estimated weekly purchase orders if the median suggested bid is adopted.

bidRecommendations.impactMetrics.orders.medianBid.upperDimension

The upper bound of the estimated weekly purchase orders if the median suggested bid is adopted.

bidRecommendations.keywordBroadMatch.highBid.suggestedBidMetric

The recommended high bid for keyword broad match targeting, which broadly matches ads with search queries.

bidRecommendations.keywordBroadMatch.lowBid.suggestedBidMetric

The recommended low bid for keyword broad match targeting, which broadly matches ads with search queries.

bidRecommendations.keywordBroadMatch.medianBid.suggestedBidMetric

The recommended median bid for keyword broad match targeting, which broadly matches ads with search queries.

bidRecommendations.keywordExactMatch.highBid.suggestedBidMetric

The recommended high bid for keyword exact match targeting, which exactly matches ads with search queries.

bidRecommendations.keywordExactMatch.lowBid.suggestedBidMetric

The recommended low bid for keyword exact match targeting, which exactly matches ads with search queries.

bidRecommendations.keywordExactMatch.medianBid.suggestedBidMetric

The recommended median bid for keyword exact match targeting, which exactly matches ads with search queries.

bidRecommendations.keywordPhraseMatch.highBid.suggestedBidMetric

The recommended high bid for keyword phrase match targeting, which matches ads with search phrases.

bidRecommendations.keywordPhraseMatch.lowBid.suggestedBidMetric

The recommended low bid for keyword phrase match targeting, which matches ads with search phrases.

bidRecommendations.keywordPhraseMatch.medianBid.suggestedBidMetric

The recommended median bid for keyword phrase match targeting, which matches ads with search phrases.

bidRecommendations.looseMatch.highBid.suggestedBidMetric

The recommended high bid for ads that broadly match the specified targeting value.

bidRecommendations.looseMatch.lowBid.suggestedBidMetric

The recommended low bid for ads that broadly match the specified targeting value.

bidRecommendations.looseMatch.medianBid.suggestedBidMetric

The recommended median bid for ads that broadly match the specified targeting value.

bidRecommendations.substitutes.highBid.suggestedBidMetric

The recommended high bid for displaying ads alongside substitutable products.

bidRecommendations.substitutes.lowBid.suggestedBidMetric

This field represents a suggested low bid for a substitute target in a bid recommendation. Substitute targets are alternative keywords or products that are still relevant to the campaign, and this bid helps advertisers optimize spending for these alternative targeting options. The recommendation is based on historical bid data.

bidRecommendations.substitutes.medianBid.suggestedBidMetric

This field represents a suggested median bid for a substitute target in a bid recommendation. Substitute targets are alternative keywords or products that are still relevant to the campaign, and this median bid provides a mid-range suggestion to help advertisers optimize their bidding strategy for these alternatives.

brandDimension

The brand associated with the advertising campaign or the advertised products. This is often used in the context of Sponsored Brands campaigns and Brand Stores.

brandEntityIdDimension

The identifier for the brand entity.

brand_nameDimension

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

brandedSearchesMetric

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

brandedSearchesClicksMetric

The number of clicks on ads that occurred after customers performed searches including the brand's name.

brandedSearchesViewsMetric

The number of searches that included the name of a brand, attributed to an ad view, occurring within a specified attribution window.

campaignApplicableBudgetRuleIdDimension

The identifier of the budget rule applied to the campaign.

campaignApplicableBudgetRuleNameDimension

The name of the budget rule applied to the campaign.

campaignBiddingBidOptimizationDimension

The bid optimization strategy applied to the campaign's bidding.

campaignBiddingStrategyDimension

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

campaignBrandEntityIdDimension

The unique identifier for the brand associated with the advertising campaign. This ID allows for consistent brand identification across various Amazon marketplaces and ad products.

campaignBudgetMetric

Total budget allocated to the campaign.

campaignBudgetAmountMetric

The monetary amount allocated as the budget for the campaign.

campaignBudgetBudgetMetric

The total budget allocated to the campaign.

campaignBudgetBudgetTypeDimension

The type of budget applied to a campaign (e.g., daily budget, lifetime budget).

campaignBudgetCurrencyCodeDimension

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

campaignBudgetTypeDimension

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

campaignCreationDateMetric

The date when the campaign was created.

campaignCreationDateISODimension

The ISO formatted date when the campaign was created.

campaignCreativeAsinsDimension

A list of Amazon Standard Identification Numbers (ASINs) associated with the campaign's creative assets. These ASINs are often used for generating keyword or product recommendations.

campaignCreativeBrandLogoAssetIDDimension

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

campaignCreativeBrandLogoUrlDimension

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

campaignCreativeBrandNameDimension

The brand name featured in the campaign's creative elements, such as text or images.

campaignCreativeHeadlineDimension

The headline text of the campaign's creative.

campaignCreativeTypeDimension

The type of creative used in the campaign (e.g., image, video, custom).

campaignCreativeVideoAssetIdsDimension

A list of asset IDs for videos used in the campaign creative.

campaignDynamicBiddingPlacementBiddingPercentageMetric

The percentage adjustment for bids based on ad placement in dynamic bidding campaigns.

campaignDynamicBiddingPlacementBiddingPlacementDimension

The specific placement to which a dynamic bidding percentage adjustment is applied.

campaignDynamicBiddingStrategyDimension

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

campaignEndDateDimension

The scheduled end date for the campaign.

campaignEndDateISODimension

The scheduled end date for the campaign, formatted according to ISO 8601 standard.

campaignExtendedDataServingStatusDimension

The serving status of a campaign, indicating its current state (e.g., active, paused, archived) as part of extended campaign data available through the API.

campaignIdDimension

A unique identifier for an advertising campaign, which serves as the top-level container for ad groups and ads, defining budget and overall strategy.

campaignLandingPagePageTypeDimension

The type of page the campaign's landing page is (e.g., product detail page, Store page).

campaignLandingPageUrlDimension

The URL of the landing page for the campaign.

campaignLastUpdatedDateMetric

The date when the campaign was last updated.

campaignLastUpdatedDateISODimension

The ISO formatted date when the campaign was last updated.

campaignNameDimension

The name of the advertising campaign.

campaignPremiumBidAdjustmentDimension

Indicates whether premium bid adjustments are enabled for a campaign, allowing for increased bids in competitive placements.

campaignRuleBasedBudgetDimension

Indicates if the campaign budget is managed by a rule.

campaignRuleBasedBudgetAmountDimension

The budget amount set by a rule for the campaign.

campaignServingStatusDimension

The serving status of the campaign (e.g., delivering, paused, archived).

campaignStartDateDimension

The scheduled start date for the campaign.

campaignStartDateISODimension

The scheduled start date for the campaign, formatted according to ISO 8601 standard.

campaignStateDimension

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

campaignStatusDimension

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

campaignTacticDimension

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

campaignTargetingTypeDimension

The type of targeting strategy employed by the campaign, such as contextual targeting or audience targeting.

campaignTypeDimension

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

categoryDimension

The product category.

clickThroughRateMetric

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

clicksMetric

Total number of ad clicks.

conversionsBrandHaloMetric

The number of conversion events for products of the same brand as the promoted products (brand halo), excluding the promoted products themselves.

conversionsBrandHaloClicksMetric

The number of conversion events for products of the same brand as the promoted products (brand halo), specifically attributed to ad clicks, excluding the promoted products themselves.

costMetric

Total cost of ad clicks.

costPerClickMetric

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

costTypeDimension

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.

cumulativeReachMetric

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.

currencyDimension

The currency code associated with the campaign.

dateDimension

The specific date for which the advertising data is reported.

detailPageViewsMetric

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

detailPageViewsClicksMetric

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

dpv14dMetric

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

entityIdDimension

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

impressionsMetric

Total number of ad impressions.

impressionsFrequencyAverageMetric

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

impressionsViewsMetric

The total number of impressions or views an ad received.

keywordDimension

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

keywordBidDimension

The advertiser-set bid value for a keyword.

keywordIdDimension

A unique identifier for a specific keyword targeted in an advertising campaign to match customer searches.

keywordMatchTypeDimension

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.

keywordStateDimension

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

keywordStatusDimension

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

keywordTextDimension

Text of the keyword or phrase.

keywordTypeDimension

Unique numerical ID of a campaign.

leadFormOpensMetric

The number of times a lead generation form associated with an ad was opened by users.

leadsMetric

The number of leads generated from ad interactions.

linkOutsMetric

The number of clicks that directed users from the Amazon platform to an external website or landing page.

marketDimension

The specific Amazon marketplace (e.g., US, UK, DE) where advertising campaigns are active. This identifies the geographical region and Amazon domain where ad performance data originates.

market_codeDimension

This field identifies the Amazon marketplace associated with the advertising activity. Marketplace IDs are unique identifiers tied to specific countries/locales, used for targeting API requests to the correct regional endpoint.

matchTypeDimension

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

media_costMetric

The total cost or spend incurred for the advertising, representing the financial investment in media placements.

newToBrandDetailPageViewClicksMetric

The number of attributed detail page view conversions occurring within 14 days of an ad click from shoppers who have not previously viewed a detail page with an ASIN of the same brand.

newToBrandDetailPageViewViewsMetric

The number of new detail page views from shoppers who have not previously viewed a detail page with an ASIN of the same brand, specifically attributed to an ad view.

newToBrandDetailPageViewsMetric

The number of new detail page views from shoppers who have not previously viewed a detail page in the past 365 days with an ASIN of the same brand, attributed to advertising.

newToBrandPurchasesMetric

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

newToBrandPurchases14dMetric

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

newToBrandPurchasesClicksMetric

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

newToBrandPurchasesPercentage14dMetric

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

newToBrandSalesMetric

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

newToBrandSales14dMetric

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

newToBrandSalesClicksMetric

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

newToBrandSalesPercentage14dMetric

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.

newToBrandUnitsSoldMetric

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

newToBrandUnitsSold14dMetric

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

newToBrandUnitsSoldClicksMetric

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

newToBrandUnitsSoldPercentage14dMetric

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

orders14dMetric

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

otherAsinDimension

An Amazon Standard Identification Number (ASIN) that was purchased as a result of an ad, but was not the specific ASIN advertised.

placementDimension

The location where the ad is displayed on the page (e.g., top of search, product page).

placementClassificationDimension

A dimension that categorizes the page location where an ad appeared, helping to understand ad visibility and performance across different placements.

portfolioIdDimension

A unique identifier for the portfolio.

portfolioNameDimension

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

productAdsAdIdDimension

Unique numerical ID of the product ad.

productAdsAsinDimension

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

productAdsCreationDateMetric

The date when the product ad was created.

productAdsCreationDateISODimension

The ISO formatted date when the product ad was created.

productAdsLastUpdatedDateMetric

The date when the product ad was last updated.

productAdsLastUpdatedDateISODimension

The ISO formatted date when the product ad was last updated.

productAdsServingStatusDimension

The serving status of the product ad (e.g., delivering, paused, archived).

productAdsStateDimension

The state of the product ad (e.g., enabled, paused, archived).

productCategoryDimension

The product category of the advertised item.

productNameDimension

The name of the advertised product.

profileBrandNameDimension

The registered brand name associated with the advertiser's profile. This is used to identify the brand data for an advertiser ID.

profileCountryCodeDimension

The country code associated with the Amazon Advertising profile, indicating the marketplace (e.g., US, UK, DE) where the advertising activities are managed.

profileIdDimension

A unique identifier for the advertising profile.

promotedAsinDimension

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

promotedSkuDimension

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

purchasedAsinDimension

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

purchasesMetric

The total number of purchases attributed to advertising.

purchases14dMetric

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

purchases1dMetric

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

purchases30dMetric

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

purchases7dMetric

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

purchasesClicksMetric

The total number of purchases attributed to ad clicks.

purchasesOtherSku7dMetric

The total number of purchases of SKUs different from the advertised product, attributed to an ad click within a 7-day attribution window.

purchasesPromotedClicksMetric

The number of purchases attributed to clicks on promoted ads.

purchasesSameSku14dMetric

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

purchasesSameSku1dMetric

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

purchasesSameSku30dMetric

The number of purchases of the same SKU within a 30-day attribution window.

purchasesSameSku7dMetric

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

queryDimension

The customer search term that triggered an advertisement, or a keyword used for targeting within an advertising campaign. This data is available in search term reports.

roasClicks14dMetric

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

roasClicks7dMetric

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

salesMetric

The total sales generated from advertising.

sales14dMetric

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

sales1dMetric

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

sales30dMetric

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

sales7dMetric

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

salesBrandHaloMetric

The total sales revenue attributed to a brand's overall advertising efforts, including both directly attributed sales and the broader impact on sales across the brand's products on Amazon.

salesBrandHaloClicksMetric

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

salesClicksMetric

The sales generated that resulted from ad clicks.

salesOtherSku14dMetric

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.

salesOtherSku7dMetric

Sales generated from other SKUs within a 7-day attribution window following an ad interaction.

salesPromotedMetric

Total value of sales occurring within 14 days of ad click or view where the purchased SKU was the same as the SKU advertised. This metric is equivalent to attributedSales14dSameSKU.

salesPromotedClicksMetric

The number of clicks on an ad that resulted in sales. This metric helps measure the direct impact of ad interactions on product purchases.

searchTermDimension

The search term used by the customer.

searchTermImpressionRankDimension

The account-level ad-attributed impression rank for specific search terms.

searchTermImpressionShareDimension

The account-level ad-attributed impression share for specific search terms, indicating the percentage of impressions received out of eligible impressions.

spendMetric

The total cost of advertising, equivalent to 'cost'.

storeIdDimension

The unique identifier for an Amazon store associated with an advertiser.

storeNameDimension

The name of the brand's Store.

suggestedBid.bidRecIdDimension

A unique identifier for a specific bid recommendation.

suggestedBid.rangeEndMetric

The upper boundary of a suggested bid range provided for a keyword or target.

suggestedBid.rangeStartMetric

The lower boundary of a suggested bid range provided for a keyword or target.

suggestedBid.suggestedDimension

The specific recommended bid value for a keyword or target.

targetBidDimension

The bid amount set for a specific target.

targetingDimension

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

targetingExpressionDimension

The expression defining the targeting criteria for an ad.

targetingIdDimension

The identifier for a specific targeting rule or entity.

targetingTextDimension

The text description of the targeting criteria.

targetingTypeDimension

The type of targeting used in the expression.

topOfSearchImpressionShareMetric

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

unitsSoldMetric

The total number of units sold attributed to advertising.

unitsSold14dMetric

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.

unitsSoldBrandHaloMetric

The total number of units sold for products of the same brand as the promoted products (brand halo), excluding the promoted products themselves.

unitsSoldBrandHaloClicksMetric

The number of units sold for products of the same brand as the promoted products (brand halo), attributed to ad clicks, excluding the promoted products themselves.

unitsSoldClicksMetric

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

unitsSoldClicks14dMetric

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

unitsSoldClicks1dMetric

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

unitsSoldClicks30dMetric

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

unitsSoldClicks7dMetric

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

unitsSoldOtherSku14dMetric

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.

unitsSoldOtherSku7dMetric

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

unitsSoldSameSku14dMetric

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

unitsSoldSameSku1dMetric

The number of units sold for the same SKU within a 1-day attribution window.

unitsSoldSameSku30dMetric

The number of units sold for the same SKU within a 30-day attribution window.

unitsSoldSameSku7dMetric

The number of units sold for the same SKU within a 7-day attribution window.

vctrMetric

The Viewable Click-Through Rate (vCTR), calculated as the number of clicks on an ad divided by the number of viewable impressions.

video5SecondViewRateMetric

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

video5SecondViewsMetric

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.

videoCompleteViewsMetric

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

videoFirstQuartileViewsMetric

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

videoMidpointViewsMetric

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

videoThirdQuartileViewsMetric

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

videoUnmutesMetric

The number of impressions where a customer unmuted the video.

viewClickThroughRateMetric

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

viewabilityRateMetric

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

viewableImpressionsMetric

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

vtrMetric

The View-Through Rate, calculated as the number of views divided by the total number of impressions for an ad.