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.

FieldAdverity UI nameType
acosClicks14d Metric

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

acosClicks7d Metric

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

adGroupBid Metric

The bid amount set for the ad group.

adGroupCreationDate Metric

The date when the ad group was created.

adGroupCreationDateISO Dimension

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

adGroupDefaultBid Metric

The default bid set for the ad group.

adGroupId Dimension

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

adGroupLastUpdatedDate Metric

The date when the ad group was last updated.

adGroupLastUpdatedDateISO Dimension

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

adGroupName Dimension

The name of the ad group.

adGroupServingStatus Dimension

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

adGroupState Dimension

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

adId Dimension

Unique numerical ID of the ad.

adKeywordStatus Dimension

The status of the keyword within the ad group.

adStatus Dimension

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

addToCart Metric

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

addToCartClicks Metric

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

addToCartRate Metric

The rate at which shoppers add products to their cart after viewing an ad, calculated by dividing the number of add-to-cart events by impressions. This metric is available for Sponsored Brands and Sponsored Display campaigns, as well as DSP campaigns.

addToCartViews Metric

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

addToList Metric
advertisedAsin Dimension

The ASIN of the product that was advertised.

advertisedSku Dimension

The SKU being advertised.

advertiserName Dimension

The name of the advertiser.

applicableBudgetRuleId Dimension

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

applicableBudgetRuleName Dimension

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

asin Dimension

The ASIN associated with an advertised product.

asinBrandHalo Dimension

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.

assets.{NUM}.assetId Dimension

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

assets.{NUM}.mediaType Dimension

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

assets.{NUM}.name Dimension

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

assets.{NUM}.url Dimension

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

attributedAddToCartClicks14d Metric

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

attributedBrandedSearches14d Metric

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

attributedConversions14d Metric

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.

attributedConversions14dSameSKU Metric

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.

attributedConversions1d Metric

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.

attributedConversions1dSameSKU Metric

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

attributedConversions30d Metric

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

attributedConversions30dSameSKU Metric

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

attributedConversions7d Metric

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

attributedConversions7dSameSKU Metric

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

attributedDPV14d Dimension

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

attributedDetailPageViewsClicks14d Metric

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

attributedOrderRateNewToBrand14d Metric

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.

attributedOrdersNewToBrand14d Metric

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.

attributedOrdersNewToBrandPercentage14d Metric

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.

attributedPurchases14d Metric

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

attributedSales14d Metric

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.

attributedSales14dOtherSKU Metric

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

attributedSales14dSameSKU Metric

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.

attributedSales1d Metric

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

attributedSales1dOtherSKU Metric

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

attributedSales1dSameSKU Metric

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.

attributedSales30d Metric

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

attributedSales30dOtherSKU Metric

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

attributedSales30dSameSKU Metric

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

attributedSales7d Metric

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

attributedSales7dOtherSKU Metric

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

attributedSales7dSameSKU Metric

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

attributedSalesNewToBrand14d Metric

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.

attributedSalesNewToBrandPercentage14d Metric

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.

attributedSalesSameSku14d Metric

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

attributedSalesSameSku1d Metric

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

attributedSalesSameSku30d Metric

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

attributedSalesSameSku7d Metric

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

attributedUnitsOrdered14d Metric

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

attributedUnitsOrdered14dOtherSKU Metric

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

attributedUnitsOrdered14dSameSKU Metric

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

attributedUnitsOrdered1d Metric

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

attributedUnitsOrdered1dOtherSKU Metric

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

attributedUnitsOrdered1dSameSKU Metric

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

attributedUnitsOrdered30d Metric

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

attributedUnitsOrdered30dOtherSKU Metric

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

attributedUnitsOrdered30dSameSKU Metric

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

attributedUnitsOrdered7d Metric

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

attributedUnitsOrdered7dOtherSKU Metric

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

attributedUnitsOrdered7dSameSKU Metric

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

attributedUnitsOrderedNewToBrand14d Metric

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.

attributedUnitsOrderedNewToBrandPercentage14d Metric

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.

attributedUnitsSold14d Dimension

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

attributionType Dimension

The model used to attribute conversions to ad interactions.

bidOptimization Dimension

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

bidRecommendations.closeMatch.highBid.suggestedBid Metric

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

bidRecommendations.closeMatch.lowBid.suggestedBid Metric

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

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

bidRecommendations.complements.highBid.suggestedBid Metric

The recommended high bid for displaying ads alongside complementary products.

bidRecommendations.complements.lowBid.suggestedBid Metric

The recommended low bid for displaying ads alongside complementary products.

bidRecommendations.complements.medianBid.suggestedBid Metric

The recommended median bid for displaying ads alongside complementary products.

bidRecommendations.impactMetrics.clicks.highBid.lower Dimension

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

bidRecommendations.impactMetrics.clicks.highBid.upper Dimension

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

bidRecommendations.impactMetrics.clicks.lowBid.lower Dimension

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

bidRecommendations.impactMetrics.clicks.lowBid.upper Dimension

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

bidRecommendations.impactMetrics.clicks.medianBid.lower Dimension

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

bidRecommendations.impactMetrics.clicks.medianBid.upper Dimension

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

bidRecommendations.impactMetrics.orders.highBid.lower Dimension

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

bidRecommendations.impactMetrics.orders.highBid.upper Dimension

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

bidRecommendations.impactMetrics.orders.lowBid.lower Dimension

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

bidRecommendations.impactMetrics.orders.lowBid.upper Dimension

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

bidRecommendations.impactMetrics.orders.medianBid.lower Dimension

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

bidRecommendations.impactMetrics.orders.medianBid.upper Dimension

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

bidRecommendations.keywordBroadMatch.highBid.suggestedBid Metric

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

bidRecommendations.keywordBroadMatch.lowBid.suggestedBid Metric

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

bidRecommendations.keywordBroadMatch.medianBid.suggestedBid Metric

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

bidRecommendations.keywordExactMatch.highBid.suggestedBid Metric

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

bidRecommendations.keywordExactMatch.lowBid.suggestedBid Metric

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

bidRecommendations.keywordExactMatch.medianBid.suggestedBid Metric

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

bidRecommendations.keywordPhraseMatch.highBid.suggestedBid Metric

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

bidRecommendations.keywordPhraseMatch.lowBid.suggestedBid Metric

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

bidRecommendations.keywordPhraseMatch.medianBid.suggestedBid Metric

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

bidRecommendations.looseMatch.highBid.suggestedBid Metric

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

bidRecommendations.looseMatch.lowBid.suggestedBid Metric

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

bidRecommendations.looseMatch.medianBid.suggestedBid Metric

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

bidRecommendations.substitutes.highBid.suggestedBid Metric

The recommended high bid for displaying ads alongside substitutable products.

bidRecommendations.substitutes.lowBid.suggestedBid Metric

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

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.

brand Dimension

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.

brandEntityId Dimension

The identifier for the brand entity.

brand_name Dimension

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

brandedSearches Metric

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

brandedSearchesClicks Metric

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

brandedSearchesViews Metric

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

campaignApplicableBudgetRuleId Dimension

The identifier of the budget rule applied to the campaign.

campaignApplicableBudgetRuleName Dimension

The name of the budget rule applied to the campaign.

campaignBiddingBidOptimization Dimension

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

campaignBiddingStrategy Dimension

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

campaignBrandEntityId Dimension

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.

campaignBudget Metric

Total budget allocated to the campaign.

campaignBudgetAmount Metric

The monetary amount allocated as the budget for the campaign.

campaignBudgetBudget Metric

The total budget allocated to the campaign.

campaignBudgetBudgetType Dimension

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

campaignBudgetCurrencyCode Dimension

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

campaignBudgetType Dimension

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

campaignCreationDate Metric

The date when the campaign was created.

campaignCreationDateISO Dimension

The ISO formatted date when the campaign was created.

campaignCreativeAsins Dimension

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.

campaignCreativeBrandLogoAssetID Dimension

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

campaignCreativeBrandLogoUrl Dimension

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

campaignCreativeBrandName Dimension

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

campaignCreativeHeadline Dimension

The headline text of the campaign's creative.

campaignCreativeType Dimension

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

campaignCreativeVideoAssetIds Dimension

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

campaignDynamicBiddingPlacementBiddingPercentage Metric

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

campaignDynamicBiddingPlacementBiddingPlacement Dimension

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

campaignDynamicBiddingStrategy Dimension

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

campaignEndDate Dimension

The scheduled end date for the campaign.

campaignEndDateISO Dimension

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

campaignExtendedDataServingStatus Dimension

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.

campaignId Dimension

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

campaignLandingPagePageType Dimension

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

campaignLandingPageUrl Dimension

The URL of the landing page for the campaign.

campaignLastUpdatedDate Metric

The date when the campaign was last updated.

campaignLastUpdatedDateISO Dimension

The ISO formatted date when the campaign was last updated.

campaignName Dimension

The name of the advertising campaign.

campaignPremiumBidAdjustment Dimension

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

campaignRuleBasedBudget Dimension

Indicates if the campaign budget is managed by a rule.

campaignRuleBasedBudgetAmount Dimension

The budget amount set by a rule for the campaign.

campaignServingStatus Dimension

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

campaignStartDate Dimension

The scheduled start date for the campaign.

campaignStartDateISO Dimension

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

campaignState Dimension

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

campaignStatus Dimension

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

campaignTactic Dimension

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

campaignTargetingType Dimension

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

campaignType Dimension

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

campaign_category Dimension

A classification or grouping assigned to a campaign, which may be used for organizational purposes or for breaking down performance data.

category Dimension

The product category.

clickThroughRate Metric

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

clicks Metric

Total number of ad clicks.

conversionsBrandHalo Metric

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

conversionsBrandHaloClicks Metric

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.

cost Metric

Total cost of ad clicks.

costPerClick Metric

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

costType Dimension

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.

cumulativeReach Metric

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.

currency Dimension

The currency code associated with the campaign.

date Dimension

The specific date for which the advertising data is reported.

detailPageViews Metric

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

detailPageViewsClicks Metric

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

dpv14d Metric

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

endDate Dimension

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

entityId Dimension

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

extract_timestamp Dimension
impressions Metric

Total number of ad impressions.

impressionsFrequencyAverage Metric

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

impressionsViews Metric

The total number of impressions or views an ad received.

keyword Dimension

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

keywordBid Dimension

The advertiser-set bid value for a keyword.

keywordId Dimension

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

keywordMatchType Dimension

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.

keywordState Dimension

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

keywordStatus Dimension

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

keywordText Dimension

Text of the keyword or phrase.

keywordType Dimension

Unique numerical ID of a campaign.

leadFormOpens Metric

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

leads Metric

The number of leads generated from ad interactions.

linkOuts Metric

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

market Dimension

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.

matchType Dimension

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

media_cost Metric

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

newToBrandDetailPageViewClicks Metric

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.

newToBrandDetailPageViewViews Metric

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.

newToBrandDetailPageViews Metric

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.

newToBrandPurchases Metric

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

newToBrandPurchases14d Metric

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

newToBrandPurchasesClicks Metric

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

newToBrandPurchasesPercentage14d Metric

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

newToBrandSales Metric

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

newToBrandSales14d Metric

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

newToBrandSalesClicks Metric

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

newToBrandSalesPercentage14d Metric

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.

newToBrandUnitsSold Metric

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

newToBrandUnitsSold14d Metric

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

newToBrandUnitsSoldClicks Metric

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

newToBrandUnitsSoldPercentage14d Metric

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

orders14d Metric

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

otherAsin Dimension

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

placement Dimension

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

placementClassification Dimension

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

portfolioId Dimension

A unique identifier for the portfolio.

portfolioName Dimension

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

productAdsAdId Dimension

Unique numerical ID of the product ad.

productAdsAsin Dimension

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

productAdsCreationDate Metric

The date when the product ad was created.

productAdsCreationDateISO Dimension

The ISO formatted date when the product ad was created.

productAdsLastUpdatedDate Metric

The date when the product ad was last updated.

productAdsLastUpdatedDateISO Dimension

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

productAdsServingStatus Dimension

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

productAdsState Dimension

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

productCategory Dimension

The product category of the advertised item.

productName Dimension

The name of the advertised product.

profileBrandName Dimension

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

profileCountryCode Dimension

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

profileId Dimension

A unique identifier for the advertising profile.

promotedAsin Dimension

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

promotedSku Dimension

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

purchasedAsin Dimension

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

purchases Metric

The total number of purchases attributed to advertising.

purchases14d Metric

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

purchases1d Metric

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

purchases30d Metric

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

purchases7d Metric

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

purchasesClicks Metric

The total number of purchases attributed to ad clicks.

purchasesOtherSku7d Metric

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

purchasesPromotedClicks Metric

The number of purchases attributed to clicks on promoted ads.

purchasesSameSku14d Metric

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

purchasesSameSku1d Metric

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

purchasesSameSku30d Metric

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

purchasesSameSku7d Metric

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

query Dimension

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.

roasClicks14d Metric

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

roasClicks7d Metric

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

sales Metric

The total sales generated from advertising.

sales14d Metric

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

sales1d Metric

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

sales30d Metric

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

sales7d Metric

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

salesBrandHalo Metric

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.

salesBrandHaloClicks Metric

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

salesClicks Metric

The sales generated that resulted from ad clicks.

salesOtherSku14d Metric

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.

salesOtherSku7d Metric

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

salesPromotedClicks Metric

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

searchTerm Dimension

The search term used by the customer.

searchTermImpressionRank Dimension

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

searchTermImpressionShare Dimension

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

spend Metric

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

startDate Dimension

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

storeId Dimension

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

storeName Dimension

The name of the brand's Store.

subcategory Dimension

A detailed classification of a product or service within a broader category, often used to refine reporting and analysis for product-related ads.

targetBid Dimension

The bid amount set for a specific target.

targeting Dimension

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

targetingExpression Dimension

The expression defining the targeting criteria for an ad.

targetingId Dimension

The identifier for a specific targeting rule or entity.

targetingText Dimension

The text description of the targeting criteria.

targetingType Dimension

The type of targeting used in the expression.

topOfSearchImpressionShare Metric

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

unitsSold Metric

The total number of units sold attributed to advertising.

unitsSold14d Metric

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.

unitsSoldBrandHalo Metric

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

unitsSoldBrandHaloClicks Metric

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.

unitsSoldClicks Metric

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

unitsSoldClicks14d Metric

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

unitsSoldClicks1d Metric

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

unitsSoldClicks30d Metric

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

unitsSoldClicks7d Metric

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

unitsSoldOtherSku14d Metric

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.

unitsSoldOtherSku7d Metric

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

unitsSoldSameSku14d Metric

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

unitsSoldSameSku1d Metric

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

unitsSoldSameSku30d Metric

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

unitsSoldSameSku7d Metric

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

vctr Metric

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

video5SecondViewRate Metric

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.

video5SecondViews Metric

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.

videoCompleteViews Metric

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

videoFirstQuartileViews Metric

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

videoMidpointViews Metric

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

videoThirdQuartileViews Metric

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

videoUnmutes Metric

The number of impressions where a customer unmuted the video.

viewClickThroughRate Metric

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

viewabilityRate Metric

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

viewableImpressions Metric

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

vtr Metric

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