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.
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.