Amazon Advertising: Most-used fields#
The table below gives information about most-used fields that you can import from Amazon Advertising. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
acosClicks14d |
acosClicks14d |
Advertising Cost of Sale (ACOS) calculated based on sales occurring within 14 days of an ad click. |
metric |
acosClicks7d |
acosClicks7d |
Advertising Cost of Sale (ACOS) calculated based on sales occurring within 7 days of an ad click. |
metric |
adGroupBid |
adGroupId |
The bid amount set for the ad group. |
dimension |
adGroupCreationDate |
adGroupCreationDate |
The date when the ad group was created. |
metric |
adGroupCreationDateISO |
adGroupCreationDateISO |
The date when the ad group was created, formatted according to ISO 8601 standard. |
dimension |
adGroupDefaultBid |
adGroupDefaultBid |
The default bid set for the ad group. |
metric |
adGroupLastUpdatedDate |
adGroupLastUpdatedDate |
The date when the ad group was last updated. |
metric |
adGroupLastUpdatedDateISO |
adGroupLastUpdatedDateISO |
The ISO formatted date when the ad group was last updated. |
dimension |
adGroupName |
adGroupName |
The name of the ad group. |
dimension |
adGroupServingStatus |
adGroupServingStatus |
The serving status of the ad group (e.g., delivering, paused, archived). |
dimension |
adGroupState |
adGroupState |
The state of the ad group (e.g., enabled, paused, archived). |
dimension |
adId |
adId |
Unique numerical ID of the ad. |
dimension |
adKeywordStatus |
adKeywordStatus |
The status of the keyword within the ad group. |
dimension |
adStatus |
adStatus |
The current status of the ad (e.g., enabled, paused, archived). |
dimension |
addToCart |
addToCart |
The number of times products were added to a shopping cart after an ad interaction. |
metric |
addToCartClicks |
addToCartClicks |
The total number of clicks on ‘Add to Cart’ buttons. |
metric |
addToCartRate |
addToCartRate |
The rate at which shoppers add a brand’s products to their cart, calculated by dividing the number of add-to-cart events by the total impressions. This metric is attributed to an ad view. |
dimension |
addToCartViews |
addToCartViews |
The number of times shoppers added a brand’s products to their cart, specifically attributed to an ad view. |
metric |
addToList |
addToList |
The number of times a promoted product was added to a customer’s list (e.g., wishlist) after an ad interaction. |
metric |
advertisedAsin |
advertisedAsin |
The ASIN of the product that was advertised. |
dimension |
advertisedSku |
advertisedSku |
The SKU being advertised. |
dimension |
advertiserName |
advertiserName |
The name of the advertiser. |
dimension |
applicableBudgetRuleId |
applicableBudgetRuleId |
The identifier of the budget rule applied to the campaign or ad group. |
dimension |
applicableBudgetRuleName |
applicableBudgetRuleName |
The name of the budget rule applied to the campaign or ad group. |
dimension |
asin |
asin |
The ASIN associated with an advertised product. |
dimension |
asinBrandHalo |
asinBrandHalo |
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. |
dimension |
assets.{NUM}.assetId |
assets.{NUM}.assetId |
A unique identifier assigned to a creative asset, such as an image or video, used within Amazon Advertising campaigns. |
dimension |
assets.{NUM}.mediaType |
assets.{NUM}.mediaType |
The type of media for the creative asset, such as an image or video, used in advertising campaigns. |
dimension |
assets.{NUM}.name |
assets.{NUM}.name |
The name given to the creative asset for organizational and identification purposes within the advertising platform. |
dimension |
assets.{NUM}.url |
assets.{NUM}.url |
The URL where the creative asset is stored and can be accessed or retrieved. |
dimension |
attributedAddToCartClicks14d |
attributedAddToCartClicks14d |
The number of add-to-cart clicks attributed to ads within a 14-day attribution window. |
metric |
attributedBrandedSearches14d |
attributedBrandedSearches14d |
The number of searches that included the name of your brand occurring within 14 days of an ad click. |
metric |
attributedConversions14d |
attributedConversions14d |
Number of attributed conversion events occurring within 14 days of an ad click. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view. |
metric |
attributedConversions14dSameSKU |
attributedConversions14dSameSKU |
Number of attributed conversion events occurring within 14 days of ad click where the purchased SKU was the same as the SKU advertised. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view. |
metric |
attributedConversions1d |
attributedConversions1d |
The number of attributed conversion events occurring within 1 day of an ad click. For Sponsored Brands, this applies to conversions occurring within 1 day of an ad click or view. |
metric |
attributedConversions1dSameSKU |
attributedConversions1dSameSKU |
The number of conversions for the same SKU attributed to ads within a 1-day attribution window. |
metric |
attributedConversions30d |
attributedConversions30d |
The total number of conversions attributed to ads within a 30-day attribution window. |
metric |
attributedConversions30dSameSKU |
attributedConversions30dSameSKU |
The number of conversions for the same SKU attributed to ads within a 30-day attribution window. |
metric |
attributedConversions7d |
attributedConversions7d |
The total number of conversions attributed to ads within a 7-day attribution window. |
metric |
attributedConversions7dSameSKU |
attributedConversions7dSameSKU |
The number of conversions for the same SKU attributed to ads within a 7-day attribution window. |
metric |
attributedDPV14d |
attributedDPV14d |
Detail Page Views attributed to ads within a 14-day attribution window. |
dimension |
attributedDetailPageViewsClicks14d |
attributedDetailPageViewsClicks14d |
The number of attributed detail page view conversions occurring within 14 days of ad click. |
metric |
attributedOrderRateNewToBrand14d |
attributedOrderRateNewToBrand14d |
The number of new-to-brand orders relative to the number of clicks. New-to-brand order rate = new-to-brand orders / clicks. Not available for book vendors. |
metric |
attributedOrdersNewToBrand14d |
attributedOrdersNewToBrand14d |
The number of first-time orders for brand products over a one-year lookback window, attributed to an ad occurring within 14 days of an ad click. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view. |
metric |
attributedOrdersNewToBrandPercentage14d |
attributedOrdersNewToBrandPercentage14d |
The percentage of total orders that are new-to-brand orders. Not available for book vendors. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view. |
metric |
attributedPurchases14d |
attributedPurchases14d |
The number of purchases attributed to ads within a 14-day attribution window. |
metric |
attributedSales14d |
attributedSales14d |
Total value of sales occurring within 14 days of an ad click. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view. |
metric |
attributedSales14dOtherSKU |
attributedSales14dOtherSKU |
Total value of sales occurring within 14 days of an ad click where the purchased SKU was different from the SKU advertised. |
metric |
attributedSales14dSameSKU |
attributedSales14dSameSKU |
Total value of sales occurring within 14 days of ad click where the purchased SKU was the same as the SKU advertised. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view. |
metric |
attributedSales1d |
attributedSales1d |
Total value of sales occurring within 24 hours of an ad click. |
metric |
attributedSales1dOtherSKU |
attributedSales1dOtherSKU |
Sales of other SKUs attributed to ads within a 1-day attribution window. |
metric |
attributedSales1dSameSKU |
attributedSales1dSameSKU |
The total sales amount (in local currency) from attributed purchases occurring within 1 day of an ad interaction, where the purchased SKU was the same as the advertised SKU. |
metric |
attributedSales30d |
attributedSales30d |
Total sales attributed to ads within a 30-day attribution window. |
metric |
attributedSales30dOtherSKU |
attributedSales30dOtherSKU |
Sales of other SKUs attributed to ads within a 30-day attribution window. |
metric |
attributedSales30dSameSKU |
attributedSales30dSameSKU |
Sales of the same SKU attributed to ads within a 30-day attribution window. |
metric |
attributedSales7d |
attributedSales7d |
Total sales attributed to ads within a 7-day attribution window. |
metric |
attributedSales7dOtherSKU |
attributedSales7dOtherSKU |
Sales of other SKUs attributed to ads within a 7-day attribution window. |
metric |
attributedSales7dSameSKU |
attributedSales7dSameSKU |
Sales of the same SKU attributed to ads within a 7-day attribution window. |
metric |
attributedSalesNewToBrand14d |
attributedSalesNewToBrand14d |
Total value of new-to-brand sales occurring within 14 days of an ad click. Not available for book vendors. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view. |
metric |
attributedSalesNewToBrandPercentage14d |
attributedSalesNewToBrandPercentage14d |
Percentage of total sales made up of new-to-brand purchases. Not available for book vendors. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view. |
metric |
attributedSalesSameSku14d |
attributedSalesSameSku14d |
Sales attributed to the same SKU (stock keeping unit) within a 14-day attribution window. |
metric |
attributedSalesSameSku1d |
attributedSalesSameSku1d |
Total value of sales occurring within 24 hours of ad click where the purchased SKU was the same as the SKU advertised. |
metric |
attributedSalesSameSku30d |
attributedSalesSameSku30d |
Total value of sales occurring within 30 days of ad click where the purchased SKU was the same as the SKU advertised. |
metric |
attributedSalesSameSku7d |
attributedSalesSameSku7d |
Total value of sales occurring within seven days of ad click where the purchased SKU was the same as the SKU advertised. |
metric |
attributedUnitsOrdered14d |
attributedUnitsOrdered14d |
Total number of units ordered within 14 days of an ad click. |
metric |
attributedUnitsOrdered14dOtherSKU |
attributedUnitsOrdered14dOtherSKU |
Total number of units ordered within 14 days of an ad click where the purchased SKU was different from the SKU advertised. |
metric |
attributedUnitsOrdered14dSameSKU |
attributedUnitsOrdered14dSameSKU |
The number of units ordered for the same SKU attributed to ads within a 14-day attribution window. |
metric |
attributedUnitsOrdered1d |
attributedUnitsOrdered1d |
The number of units ordered within a 1-day attribution window after an ad interaction. |
metric |
attributedUnitsOrdered1dOtherSKU |
attributedUnitsOrdered1dOtherSKU |
The number of units ordered for other SKUs attributed to ads within a 1-day attribution window. |
metric |
attributedUnitsOrdered1dSameSKU |
attributedUnitsOrdered1dSameSKU |
The number of units ordered for the same SKU attributed to ads within a 1-day attribution window. |
metric |
attributedUnitsOrdered30d |
attributedUnitsOrdered30d |
The number of units ordered within a 30-day attribution window after an ad interaction. |
metric |
attributedUnitsOrdered30dOtherSKU |
attributedUnitsOrdered30dOtherSKU |
The number of units ordered for other SKUs attributed to ads within a 30-day attribution window. |
metric |
attributedUnitsOrdered30dSameSKU |
attributedUnitsOrdered30dSameSKU |
The number of units ordered for the same SKU attributed to ads within a 30-day attribution window. |
metric |
attributedUnitsOrdered7d |
attributedUnitsOrdered7d |
The number of units ordered within a 7-day attribution window after an ad interaction. |
metric |
attributedUnitsOrdered7dOtherSKU |
attributedUnitsOrdered7dOtherSKU |
The number of units ordered for other SKUs attributed to ads within a 7-day attribution window. |
metric |
attributedUnitsOrdered7dSameSKU |
attributedUnitsOrdered7dSameSKU |
The number of units ordered for the same SKU attributed to ads within a 7-day attribution window. |
metric |
attributedUnitsOrderedNewToBrand14d |
attributedUnitsOrderedNewToBrand14d |
Total number of attributed units ordered as part of new-to-brand sales occurring within 14 days of an ad click. Not available for book vendors. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view. |
metric |
attributedUnitsOrderedNewToBrandPercentage14d |
attributedUnitsOrderedNewToBrandPercentage14d |
Percentage of total attributed units ordered within 14 days of an ad click that are part of a new-to-brand purchase. Not available for book vendors. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view. |
metric |
attributedUnitsSold14d |
attributedUnitsSold14d |
Number of attributed units sold within 14 days of click on an ad. This is also referred to as unitsSold14d. |
dimension |
attributionType |
attributionType |
The model used to attribute conversions to ad interactions. |
dimension |
bidOptimization |
bidOptimization |
The strategy used to optimize bids for campaigns or ad groups. |
dimension |
bidRecommendations.substitutes.lowBid.suggestedBid |
bidRecommendations.substitutes.lowBid.suggestedBid |
The suggested bid for a substitute product at the lower end of the bid range within bid recommendations. |
metric |
bidRecommendations.substitutes.medianBid.suggestedBid |
bidRecommendations.substitutes.medianBid.suggestedBid |
The suggested bid for a substitute product at the median of the bid range within bid recommendations. |
metric |
brand |
brand |
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. |
dimension |
brandEntityId |
brandEntityId |
The identifier for the brand entity. |
dimension |
brand_name |
brand_name |
The name of the brand associated with the product or campaign. |
dimension |
brandedSearches |
brandedSearches |
The number of searches for the brand associated with the advertised products. |
metric |
brandedSearchesClicks |
brandedSearchesClicks |
The number of clicks on ads that occurred after customers performed searches including the brand’s name. |
metric |
brandedSearchesViews |
brandedSearchesViews |
The number of searches that included the name of a brand, attributed to an ad view, occurring within a specified attribution window. |
metric |
campaignApplicableBudgetRuleId |
campaignApplicableBudgetRuleId |
The identifier of the budget rule applied to the campaign. |
dimension |
campaignApplicableBudgetRuleName |
campaignApplicableBudgetRuleName |
The name of the budget rule applied to the campaign. |
dimension |
campaignBiddingBidOptimization |
campaignBiddingBidOptimization |
The bid optimization strategy applied to the campaign’s bidding. |
dimension |
campaignBiddingStrategy |
campaignBiddingStrategy |
The bidding strategy employed for the campaign (e.g., dynamic bids - down only, fixed bids). |
dimension |
campaignBudget |
campaignBudget |
Total budget allocated to the campaign. |
metric |
campaignBudgetAmount |
campaignBudgetAmount |
The monetary amount allocated as the budget for the campaign. |
metric |
campaignBudgetBudget |
campaignBudgetBudget |
The total budget allocated to the campaign. |
dimension |
campaignBudgetBudgetType |
campaignBudgetBudgetType |
The type of budget applied to a campaign (e.g., daily budget, lifetime budget). |
dimension |
campaignBudgetCurrencyCode |
campaignBudgetCurrencyCode |
The currency code for the campaign budget (e.g., USD, EUR). |
dimension |
campaignBudgetType |
campaignBudgetType |
The type of budget allocated to the campaign, either ‘daily’ or ‘lifetime’. |
dimension |
campaignCreationDate |
campaignCreationDate |
The date when the campaign was created. |
metric |
campaignCreationDateISO |
campaignCreationDateISO |
The ISO formatted date when the campaign was created. |
dimension |
campaignCreativeAsins |
campaignCreativeAsins |
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. |
dimension |
campaignCreativeBrandLogoAssetID |
campaignCreativeBrandLogoAssetID |
The asset ID of the brand logo used in the campaign creative. |
dimension |
campaignCreativeBrandLogoUrl |
campaignCreativeBrandLogoUrl |
The URL of the brand logo used in the campaign creative. |
dimension |
campaignCreativeBrandName |
campaignCreativeBrandName |
The brand name featured in the campaign’s creative elements, such as text or images. |
dimension |
campaignCreativeHeadline |
campaignCreativeHeadline |
The headline text of the campaign’s creative. |
dimension |
campaignCreativeType |
campaignCreativeType |
The type of creative used in the campaign (e.g., image, video, custom). |
dimension |
campaignCreativeVideoAssetIds |
campaignCreativeVideoAssetIds |
A list of asset IDs for videos used in the campaign creative. |
dimension |
campaignDynamicBiddingPlacementBiddingPercentage |
campaignDynamicBiddingPlacementBiddingPercentage |
The percentage adjustment for bids based on ad placement in dynamic bidding campaigns. |
metric |
campaignDynamicBiddingPlacementBiddingPlacement |
campaignDynamicBiddingPlacementBiddingPlacement |
The specific placement to which a dynamic bidding percentage adjustment is applied. |
dimension |
campaignDynamicBiddingStrategy |
campaignDynamicBiddingStrategy |
The dynamic bidding strategy applied to the campaign (e.g., down only, up and down). |
dimension |
campaignEndDate |
campaignEndDate |
The scheduled end date for the campaign. |
dimension |
campaignEndDateISO |
campaignEndDateISO |
The scheduled end date for the campaign, formatted according to ISO 8601 standard. |
dimension |
campaignExtendedDataServingStatus |
campaignExtendedDataServingStatus |
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. |
dimension |
campaignLandingPagePageType |
campaignLandingPagePageType |
The type of page the campaign’s landing page is (e.g., product detail page, Store page). |
dimension |
campaignLandingPageUrl |
campaignLandingPageUrl |
The URL of the landing page for the campaign. |
dimension |
campaignLastUpdatedDate |
campaignLastUpdatedDate |
The date when the campaign was last updated. |
metric |
campaignLastUpdatedDateISO |
campaignLastUpdatedDateISO |
The ISO formatted date when the campaign was last updated. |
dimension |
campaignName |
campaignName |
The name of the advertising campaign. |
dimension |
campaignPremiumBidAdjustment |
campaignPremiumBidAdjustment |
Indicates whether premium bid adjustments are enabled for a campaign, allowing for increased bids in competitive placements. |
dimension |
campaignPriceTypeCode |
campaignPriceTypeCode |
The price type code associated with the campaign (e.g., CPC, vCPM). |
dimension |
campaignRuleBasedBudget |
campaignRuleBasedBudget |
Indicates if the campaign budget is managed by a rule. |
dimension |
campaignRuleBasedBudgetAmount |
campaignRuleBasedBudgetAmount |
The budget amount set by a rule for the campaign. |
dimension |
campaignServingStatus |
campaignServingStatus |
The serving status of the campaign (e.g., delivering, paused, archived). |
dimension |
campaignStartDate |
campaignStartDate |
The scheduled start date for the campaign. |
dimension |
campaignStartDateISO |
campaignStartDateISO |
The scheduled start date for the campaign, formatted according to ISO 8601 standard. |
dimension |
campaignState |
campaignState |
The current state of the campaign (e.g., enabled, paused, archived). This is also referred to as campaignStatus. |
dimension |
campaignStatus |
campaignStatus |
The current operational status or state of the campaign (e.g., enabled, paused, archived). |
dimension |
campaignTactic |
campaignTactic |
The specific targeting tactic used in a Sponsored Display campaign (e.g., product targeting, audience targeting). |
dimension |
campaignTargetingType |
campaignTargetingType |
The type of targeting strategy employed by the campaign, such as contextual targeting or audience targeting. |
dimension |
campaignType |
campaignType |
The type of advertising campaign (e.g., Sponsored Products, Sponsored Brands, Sponsored Display). |
dimension |
category |
category |
The product category. |
dimension |
clickThroughRate |
clickThroughRate |
The percentage of impressions that resulted in a click (clicks / impressions). |
metric |
clicks |
clicks |
Total number of ad clicks. |
metric |
conversionsBrandHalo |
conversionsBrandHalo |
The number of conversion events for products of the same brand as the promoted products (brand halo), excluding the promoted products themselves. |
metric |
conversionsBrandHaloClicks |
conversionsBrandHaloClicks |
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. |
metric |
cost |
cost |
Total cost of ad clicks. |
metric |
costPerClick |
costPerClick |
The average cost incurred for each click on an ad (cost / clicks). |
metric |
costType |
costType |
Determines how the campaign will bid and charge, such as ‘vCPM’ (cost per thousand viewable impressions) or ‘CPC’ (cost per click). Only relevant for Sponsored Display campaigns. |
dimension |
country_id |
country_id |
The identifier for the country or marketplace where the advertising campaign is active. Amazon Advertising API operations are tied to specific regional marketplaces. |
dimension |
cumulativeReach |
cumulativeReach |
Total number of unique users exposed to an ad from either a campaign, ad group, or product ad over the lifetime of the campaign or the past six months, whichever is shorter. |
metric |
currency |
currency |
The currency code associated with the campaign. |
dimension |
date |
date |
The specific date for which the advertising data is reported. |
dimension |
detailPageViews |
detailPageViews |
The total number of times product detail pages were viewed after an ad interaction. |
metric |
detailPageViewsClicks |
detailPageViewsClicks |
The total number of product detail page views that resulted from clicks on an ad. |
metric |
dpv14d |
dpv14d |
Number of attributed detail page views occurring within 14 days of click on an ad. This is a vendor-only field. |
metric |
endDate |
endDate |
The end date of the reporting period, in YYYYMMDD format. |
dimension |
entityId |
entityId |
A unique identifier for the entity (e.g., campaign, ad group, advertiser) that the data refers to. |
dimension |
impressions |
impressions |
Total number of ad impressions. |
metric |
impressionsFrequencyAverage |
impressionsFrequencyAverage |
The average number of times unique users were exposed to an ad over the lifetime of the campaign. |
metric |
impressionsViews |
impressionsViews |
The total number of impressions or views an ad received. |
metric |
keyword |
keyword |
The keyword or phrase used in targeting. This is also referred to as keywordText. |
dimension |
keywordBid |
keywordId |
The advertiser-set bid value for a keyword. |
dimension |
keywordMatchType |
keywordMatchType |
The type of matching for the keyword or phrase used in the bid, such as broad, phrase, or exact. This is also referred to as matchType. |
dimension |
keywordState |
keywordState |
The current state of the keyword (e.g., enabled, paused, archived). |
dimension |
keywordStatus |
keywordStatus |
The status of the keyword (e.g., enabled, paused, archived). |
dimension |
keywordText |
keywordText |
Text of the keyword or phrase. |
dimension |
keywordType |
campaignId |
Unique numerical ID of a campaign. |
dimension |
leadFormOpens |
leadFormOpens |
The number of times a lead form associated with an ad was opened. |
metric |
leads |
leads |
The number of leads generated from ad interactions. |
metric |
linkOuts |
linkOuts |
The number of clicks that led users away from Amazon to an external site. |
metric |
matchType |
matchType |
Type of matching for the keyword or phrase used in bid. Must be one of: broad, phrase, or exact. |
dimension |
newToBrandDetailPageViewClicks |
newToBrandDetailPageViewClicks |
The number of 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. |
metric |
newToBrandDetailPageViewViews |
newToBrandDetailPageViewViews |
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. |
metric |
newToBrandDetailPageViews |
newToBrandDetailPageViews |
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. |
metric |
newToBrandPurchases |
newToBrandPurchases |
The total number of purchases made by new-to-brand customers. |
metric |
newToBrandPurchases14d |
newToBrandPurchases14d |
The total number of purchases made by new-to-brand customers within a 14-day attribution window. |
metric |
newToBrandPurchasesClicks |
newToBrandPurchasesClicks |
The number of purchases made by new-to-brand customers that resulted from ad clicks. |
metric |
newToBrandPurchasesPercentage14d |
newToBrandPurchasesPercentage14d |
The percentage of purchases attributed to new-to-brand customers within a 14-day attribution window. |
metric |
newToBrandSales |
newToBrandSales |
The total sales generated from new-to-brand customers. |
metric |
newToBrandSales14d |
newToBrandSales14d |
Total value of new-to-brand sales occurring within 14 days of an ad click. This is also referred to as attributedSalesNewToBrand14d. |
metric |
newToBrandSalesClicks |
newToBrandSalesClicks |
The sales generated from new-to-brand customers that resulted from ad clicks. |
metric |
newToBrandSalesPercentage14d |
newToBrandSalesPercentage14d |
The percentage of total sales made up of new-to-brand purchases within 14 days of an ad interaction. This is also referred to as attributedSalesNewToBrandPercentage14d. |
metric |
newToBrandUnitsSold |
newToBrandUnitsSold |
The total number of units sold to new-to-brand customers. |
metric |
newToBrandUnitsSold14d |
newToBrandUnitsSold14d |
The total number of units sold to new-to-brand customers within a 14-day attribution window. |
metric |
newToBrandUnitsSoldClicks |
newToBrandUnitsSoldClicks |
The number of units sold to new-to-brand customers that resulted from ad clicks. |
metric |
newToBrandUnitsSoldPercentage14d |
newToBrandUnitsSoldPercentage14d |
The percentage of total attributed units ordered within 14 days of an ad click that are part of a new-to-brand purchase. |
metric |
orders14d |
orders14d |
The number of orders occurring within 14 days, attributed to an ad click or view. |
metric |
ordersClicks14d |
ordersClicks14d |
The number of orders generated from clicks within a 14-day attribution window. |
metric |
otherAsin |
otherAsin |
An Amazon Standard Identification Number (ASIN) that was purchased as a result of an ad, but was not the specific ASIN advertised. |
dimension |
placement |
placement |
The location where the ad is displayed on the page (e.g., top of search, product page). |
dimension |
placementClassification |
placementClassification |
A dimension that categorizes the page location where an ad appeared, helping to understand ad visibility and performance across different placements. |
dimension |
portfolioId |
portfolioId |
A unique identifier for the portfolio. |
dimension |
portfolioName |
portfolioName |
The name of the portfolio to which the campaign or advertising entity belongs. |
dimension |
productAdsAdId |
productAdsAdId |
Unique numerical ID of the product ad. |
metric |
productAdsAsin |
productAdsAsin |
The ASIN of the product being advertised in the product ad. |
dimension |
productAdsCreationDate |
productAdsCreationDate |
The date when the product ad was created. |
metric |
productAdsCreationDateISO |
productAdsCreationDateISO |
The ISO formatted date when the product ad was created. |
dimension |
productAdsLastUpdatedDate |
productAdsLastUpdatedDate |
The date when the product ad was last updated. |
metric |
productAdsLastUpdatedDateISO |
productAdsLastUpdatedDateISO |
The ISO formatted date when the product ad was last updated. |
dimension |
productAdsServingStatus |
productAdsServingStatus |
The serving status of the product ad (e.g., delivering, paused, archived). |
dimension |
productAdsSku |
productAdsSku |
The Seller SKU (Stock Keeping Unit) of the advertised product. |
dimension |
productAdsState |
productAdsState |
The state of the product ad (e.g., enabled, paused, archived). |
dimension |
productCategory |
productCategory |
The product category of the advertised item. |
dimension |
productName |
productName |
The name of the advertised product. |
dimension |
profileBrandName |
profileBrandName |
The registered brand name associated with the advertiser’s profile. This is used to identify the brand data for an advertiser ID. |
dimension |
profileCountryCode |
profileCountryCode |
The country code associated with the Amazon Advertising profile, indicating the marketplace (e.g., US, UK, DE) where the advertising activities are managed. |
dimension |
profileId |
profileId |
A unique identifier for the advertising profile. |
dimension |
promotedAsin |
promotedAsin |
The Amazon Standard Identification Number (ASIN) of the promoted product. |
dimension |
promotedSku |
promotedSku |
The Seller SKU (Stock Keeping Unit) of the promoted product. |
dimension |
purchasedAsin |
purchasedAsin |
The ASIN (Amazon Standard Identification Number) of the product purchased following an ad interaction. |
dimension |
purchases |
purchases |
The total number of purchases attributed to advertising. |
metric |
purchases14d |
purchases14d |
The total number of purchases attributed to advertising within a 14-day attribution window. |
metric |
purchases1d |
purchases1d |
The total number of purchases attributed to advertising within a 1-day attribution window. |
metric |
purchases30d |
purchases30d |
The total number of purchases attributed to advertising within a 30-day attribution window. |
metric |
purchases7d |
purchases7d |
The total number of purchases attributed to advertising within a 7-day attribution window. |
metric |
purchasesClicks |
purchasesClicks |
The total number of purchases attributed to ad clicks. |
metric |
purchasesOtherSku14d |
purchasesOtherSku14d |
The total number of purchases of products other than the advertised SKU, occurring within 14 days of an ad interaction. This often refers to “brand halo” conversions. |
metric |
purchasesOtherSku1d |
purchasesOtherSku1d |
The total number of purchases of products other than the advertised SKU, occurring within 1 day of an ad interaction. |
metric |
purchasesOtherSku30d |
purchasesOtherSku30d |
The total number of purchases of products other than the advertised SKU, occurring within 30 days of an ad interaction. |
metric |
purchasesOtherSku7d |
purchasesOtherSku7d |
The total number of purchases of products other than the advertised SKU, occurring within 7 days of an ad interaction. |
metric |
purchasesPromotedClicks |
purchasesPromotedClicks |
The number of purchases attributed to clicks on promoted ads. |
metric |
purchasesSameSku14d |
purchasesSameSku14d |
The number of purchases of the same SKU as the advertised product, attributed to advertising within a 14-day attribution window. |
metric |
purchasesSameSku1d |
purchasesSameSku1d |
The number of purchases of the same SKU as the advertised product, attributed to advertising within a 1-day attribution window. |
metric |
purchasesSameSku30d |
purchasesSameSku30d |
The number of purchases of the same SKU within a 30-day attribution window. |
metric |
purchasesSameSku7d |
purchasesSameSku7d |
The number of purchases of the same SKU as the advertised product, attributed to advertising within a 7-day attribution window. |
metric |
query |
query |
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. |
dimension |
roasClicks14d |
roasClicks14d |
Return on Advertising Spend (ROAS) calculated based on sales occurring within 14 days of an ad click. |
metric |
roasClicks7d |
roasClicks7d |
Return on Advertising Spend (ROAS) calculated based on sales occurring within 7 days of an ad click. |
metric |
sales |
sales |
The total sales generated from advertising. |
metric |
sales14d |
sales14d |
Total value of sales occurring within 14 days of click on an ad. |
metric |
sales1d |
sales1d |
The sales generated from advertising within a 1-day attribution window. |
metric |
sales30d |
sales30d |
Total value of sales occurring within 30 days of an ad interaction. |
metric |
sales7d |
sales7d |
The sales generated from advertising within a 7-day attribution window. |
metric |
salesBrandHalo |
salesBrandHalo |
The total sales 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. |
metric |
salesBrandHaloClicks |
salesBrandHaloClicks |
The sales generated from brand halo effects that resulted from ad clicks. |
metric |
salesClicks |
salesClicks |
The sales generated that resulted from ad clicks. |
metric |
salesClicks14d |
salesClicks14d |
Sales generated from clicks within a 14-day attribution window. |
metric |
salesOtherSku14d |
salesOtherSku14d |
The total sales amount (in local currency) from purchases of products other than the advertised SKU, occurring within 14 days of an ad interaction. This reflects sales attributed to brand halo. |
metric |
salesOtherSku1d |
salesOtherSku1d |
The total sales amount (in local currency) from purchases of products other than the advertised SKU, occurring within 1 day of an ad interaction. |
metric |
salesOtherSku30d |
salesOtherSku30d |
The total sales amount (in local currency) from purchases of products other than the advertised SKU, occurring within 30 days of an ad interaction. |
metric |
salesOtherSku7d |
salesOtherSku7d |
Sales generated from other SKUs within a 7-day attribution window following an ad interaction. |
metric |
salesPromoted |
salesPromoted |
The total value of sales (in local currency) for promoted products purchased by customers on Amazon after an associated ad click. |
metric |
salesPromotedClicks |
salesPromotedClicks |
The number of clicks on an ad that resulted in sales. This metric helps measure the direct impact of ad interactions on product purchases. |
metric |
searchTerm |
searchTerm |
The search term used by the customer. |
dimension |
searchTermImpressionRank |
searchTermImpressionRank |
The account-level ad-attributed impression rank for specific search terms. |
dimension |
searchTermImpressionShare |
searchTermImpressionShare |
The account-level ad-attributed impression share for specific search terms, indicating the percentage of impressions received out of eligible impressions. |
dimension |
spend |
spend |
The total cost of advertising, equivalent to ‘cost’. |
metric |
startDate |
startDate |
The start date of the reporting period, in YYYYMMDD format. |
dimension |
storeName |
storeName |
The name of the brand’s Store. |
dimension |
targetBid |
targetBid |
The bid amount set for a specific target. |
dimension |
targeting |
targeting |
Information related to the targeting strategy and clauses used in advertising campaigns. |
dimension |
targetingExpression |
targetingExpression |
The expression defining the targeting criteria for an ad. |
dimension |
targetingId |
targetingId |
The identifier for a specific targeting rule or entity. |
dimension |
targetingText |
targetingText |
The text description of the targeting criteria. |
dimension |
targetingType |
targetingType |
The type of targeting used in the expression. |
dimension |
topOfSearchImpressionShare |
topOfSearchImpressionShare |
The percentage of top-of-search impressions earned out of all eligible top-of-search impressions for a given date range. |
metric |
unitsSold |
unitsSold |
The total number of units sold attributed to advertising. |
metric |
unitsSold14d |
unitsSold14d |
Number of attributed units sold within 14 days of click on an ad. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view. |
metric |
unitsSoldBrandHalo |
unitsSoldBrandHalo |
The total number of units sold for products of the same brand as the promoted products (brand halo), excluding the promoted products themselves. |
metric |
unitsSoldBrandHaloClicks |
unitsSoldBrandHaloClicks |
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. |
metric |
unitsSoldClicks |
unitsSoldClicks |
The total number of units sold that are attributed to ad clicks. |
metric |
unitsSoldClicks14d |
unitsSoldClicks14d |
The number of units sold that resulted from ad clicks, attributed within a 14-day attribution window. |
metric |
unitsSoldClicks1d |
unitsSoldClicks1d |
The number of units sold that resulted from ad clicks, attributed within a 1-day attribution window. |
metric |
unitsSoldClicks30d |
unitsSoldClicks30d |
The number of units sold that resulted from ad clicks, attributed within a 30-day attribution window. |
metric |
unitsSoldClicks7d |
unitsSoldClicks7d |
The number of units sold that resulted from ad clicks, attributed within a 7-day attribution window. |
metric |
unitsSoldOtherSku14d |
unitsSoldOtherSku14d |
The total number of units ordered from products other than the advertised SKU, occurring within 14 days of an ad click. This includes brand halo units. |
metric |
unitsSoldOtherSku1d |
unitsSoldOtherSku1d |
The total number of units ordered from products other than the advertised SKU, occurring within 1 day of an ad click. |
metric |
unitsSoldOtherSku30d |
unitsSoldOtherSku30d |
The total number of units ordered from products other than the advertised SKU, occurring within 30 days of an ad click. |
metric |
unitsSoldOtherSku7d |
unitsSoldOtherSku7d |
The number of units sold for SKUs other than the advertised product, attributed within a 7-day attribution window. |
metric |
unitsSoldSameSku14d |
unitsSoldSameSku14d |
The number of units sold for the same SKU as the advertised product, attributed to advertising within a 14-day attribution window. |
metric |
unitsSoldSameSku1d |
unitsSoldSameSku1d |
The number of units sold for the same SKU within a 1-day attribution window. |
metric |
unitsSoldSameSku30d |
unitsSoldSameSku30d |
The number of units sold for the same SKU within a 30-day attribution window. |
metric |
unitsSoldSameSku7d |
unitsSoldSameSku7d |
The number of units sold for the same SKU within a 7-day attribution window. |
metric |
vctr |
vctr |
The Viewable Click-Through Rate (vCTR), calculated as the number of clicks on an ad divided by the number of viewable impressions. |
metric |
video5SecondViewRate |
video5SecondViewRate |
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. |
metric |
video5SecondViews |
video5SecondViews |
The number of impressions where the customer watched the complete video or 5 seconds (whichever is shorter). This is a Sponsored Brands video-only metric. |
metric |
videoCompleteViews |
videoCompleteViews |
The number of impressions where the video was viewed to 100%. |
metric |
videoFirstQuartileViews |
videoFirstQuartileViews |
The number of impressions where the video was viewed to 25%. |
metric |
videoMidpointViews |
videoMidpointViews |
The number of impressions where the video was viewed to 50%. |
metric |
videoThirdQuartileViews |
videoThirdQuartileViews |
The number of impressions where the video was viewed to 75%. |
metric |
videoUnmutes |
videoUnmutes |
The number of impressions where a customer unmuted the video. |
metric |
viewClickThroughRate |
viewClickThroughRate |
Click-through rate for views (clicks divided by views). This is also referred to as vctr. |
dimension |
viewabilityRate |
viewabilityRate |
The percentage of impressions that were viewable according to industry standards. |
metric |
viewableImpressions |
viewableImpressions |
Number of impressions that met the Media Ratings Council (MRC) viewability standard. |
metric |
vtr |
vtr |
The View-Through Rate, calculated as the number of views divided by the total number of impressions for an ad. |
metric |
year |
year |
A time dimension used to break down report data on a yearly basis, allowing for aggregation and analysis of events by year. |
dimension |