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. |
dimension |
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 |
adGroupSuggestedBid |
adGroupSuggestedBid |
The suggested bid amount for the ad group. |
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 |
addToCartViews |
addToCartViews |
The total number of views of ‘Add to Cart’ buttons. |
metric |
addToList |
addToList |
The number of times a product was added to a list (e.g., wish list) 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 |
Sales or units attributed to the brand beyond the advertised ASIN. |
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 |
attributedDetailPageView14d |
attributedDetailPageView14d |
The number of detail page views attributed to ads within a 14-day attribution window. |
metric |
attributedDetailPageViewsClicks14d |
attributedDetailPageViewsClicks14d |
The number of attributed detail page view conversions occurring within 14 days of ad click. |
metric |
attributedOrderRateNewToBrand14d |
attributedOrderRateNewToBrand14d |
The number of new-to-brand orders relative to the number of clicks. New-to-brand order rate = new-to-brand orders / clicks. Not available for book vendors. |
metric |
attributedOrdersNewToBrand14d |
attributedOrdersNewToBrand14d |
The number of first-time orders for brand products over a one-year lookback window, attributed to an ad occurring within 14 days of an ad click. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view. |
metric |
attributedOrdersNewToBrandPercentage14d |
attributedOrdersNewToBrandPercentage14d |
The percentage of total orders that are new-to-brand orders. Not available for book vendors. For Sponsored Brands only, this applies to attributed conversion events occurring within 14 days of an ad click or view. |
metric |
attributedPurchases14d |
attributedPurchases14d |
The 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 product or campaign. |
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 |
Clicks on ads resulting from branded search terms. |
metric |
brandedSearchesViews |
brandedSearchesViews |
Views of ads resulting from branded search terms. |
metric |
campaignAdFormat |
campaignAdFormat |
The format of the ad in the campaign (e.g., text, image, video). |
dimension |
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 |
campaignBidMultiplier |
campaignBidMultiplier |
The multiplier applied to bids within a campaign. |
dimension |
campaignBidOptimization |
campaignBidOptimization |
The bid optimization strategy applied to the campaign. |
dimension |
campaignBiddingAdjustmentsPredicate |
campaignBiddingAdjustmentsPredicate |
The predicate or condition used for bidding adjustments within 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. |
dimension |
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 |
campaignCreativeShouldOptimizeAsins |
campaignCreativeShouldOptimizeAsins |
Indicates whether the campaign creative should optimize ASINs. |
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 |
campaignCreativeVideoMediaIds |
campaignCreativeVideoMediaIds |
A list of media IDs for videos used in the campaign creative. |
dimension |
campaignDailyBudget |
campaignDailyBudget |
The daily budget allocated to the campaign. |
dimension |
campaignDynamicBiddingPlacementBiddingPercentage |
campaignDynamicBiddingPlacementBiddingPercentage |
The percentage adjustment for bids based on ad placement in dynamic bidding campaigns. |
dimension |
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 extended campaign data. |
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. |
dimension |
campaignLastUpdatedDateISO |
campaignLastUpdatedDateISO |
The ISO formatted date when the campaign was last updated. |
dimension |
campaignName |
campaignName |
The name of the advertising campaign. |
dimension |
campaignPremiumBidAdjustment |
campaignPremiumBidAdjustment |
The premium bid adjustment applied to the campaign. |
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 |
Conversions attributed to the brand beyond the advertised products. |
metric |
conversionsBrandHaloClicks |
conversionsBrandHaloClicks |
Conversions attributed to the brand beyond the advertised products, resulting from ad clicks. |
metric |
cost |
cost |
Total cost of ad clicks. |
metric |
costPerClick |
costPerClick |
The average cost incurred for each click on an ad (cost / clicks). |
dimension |
costType |
costType |
Determines how the campaign will bid and charge, such as ‘vCPM’ (cost per thousand viewable impressions) or ‘CPC’ (cost per click). Only relevant for Sponsored Display campaigns. |
dimension |
country_code |
country_code |
The country code for the marketplace where the ad campaign runs. |
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 an ad was shown to a unique user. |
dimension |
impressionsViews |
impressionsViews |
The total number of impressions or views an ad received. |
metric |
iso_cw |
iso_cw |
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 |
Clicks on detail pages from new-to-brand customers. |
metric |
newToBrandDetailPageViewViews |
newToBrandDetailPageViewViews |
Detail page views from new-to-brand customers after viewing an ad. |
metric |
newToBrandDetailPageViews |
newToBrandDetailPageViews |
Detail page views from new-to-brand customers. |
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 |
periodicity |
periodicity |
The frequency or interval at which data is reported (e.g., daily, summary). |
dimension |
placement |
placement |
The location where the ad is displayed on the page (e.g., top of search, product page). |
dimension |
placementClassification |
placementClassification |
The classification of where an ad was placed (e.g., top of search, rest of search). |
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. |
dimension |
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 |
report_id |
report_id |
The unique identifier of the generated report. |
dimension |
roasClicks14d |
roasClicks14d |
Return on Advertising Spend (ROAS) calculated based on sales occurring within 14 days of an ad click. |
dimension |
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 |
Sales generated from promoted products. |
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 ranking of an ad’s impressions for a given search term. |
dimension |
searchTermImpressionShare |
searchTermImpressionShare |
The share of impressions for an ad relative to a specific search term. |
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 |
Units sold for the brand, beyond the advertised ASIN, attributed to ads. |
metric |
unitsSoldBrandHaloClicks |
unitsSoldBrandHaloClicks |
The number of units sold for the brand, beyond the advertised ASIN, resulting from ad clicks. |
metric |
unitsSoldClicks |
unitsSoldClicks |
The total number of units sold that are attributed to ad clicks. |
metric |
unitsSoldClicks14d |
unitsSoldClicks14d |
The number of units sold that resulted from ad clicks, attributed within a 14-day attribution window. |
metric |
unitsSoldClicks1d |
unitsSoldClicks1d |
The number of units sold that resulted from ad clicks, attributed within a 1-day attribution window. |
metric |
unitsSoldClicks30d |
unitsSoldClicks30d |
The number of units sold that resulted from ad clicks, attributed within a 30-day attribution window. |
metric |
unitsSoldClicks7d |
unitsSoldClicks7d |
The number of units sold that resulted from ad clicks, attributed within a 7-day attribution window. |
metric |
unitsSoldOtherSku14d |
unitsSoldOtherSku14d |
The total number of units ordered from products other than the advertised SKU, occurring within 14 days of an ad click. This includes brand halo units. |
metric |
unitsSoldOtherSku1d |
unitsSoldOtherSku1d |
The total number of units ordered from products other than the advertised SKU, occurring within 1 day of an ad click. |
metric |
unitsSoldOtherSku30d |
unitsSoldOtherSku30d |
The total number of units ordered from products other than the advertised SKU, occurring within 30 days of an ad click. |
metric |
unitsSoldOtherSku7d |
unitsSoldOtherSku7d |
The number of units sold for SKUs other than the advertised product, attributed within a 7-day attribution window. |
metric |
unitsSoldSameSku14d |
unitsSoldSameSku14d |
The number of units sold for the same SKU as the advertised product, attributed to advertising within a 14-day attribution window. |
metric |
unitsSoldSameSku1d |
unitsSoldSameSku1d |
The number of units sold for the same SKU 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 |
viewAttributedBrandedSearches14d |
viewAttributedBrandedSearches14d |
Branded searches attributed to ad views within a 14-day attribution window. |
dimension |
viewAttributedConversions14d |
viewAttributedConversions14d |
Conversions attributed to ad views within a 14-day attribution window. |
metric |
viewAttributedDetailPageView14d |
viewAttributedDetailPageView14d |
Detail page views attributed to ad views within a 14-day attribution window. |
metric |
viewAttributedOrdersNewToBrand14d |
viewAttributedOrdersNewToBrand14d |
Orders from new-to-brand customers attributed to ad views within a 14-day attribution window. |
metric |
viewAttributedSales14d |
viewAttributedSales14d |
Sales attributed to ad views within a 14-day attribution window. |
metric |
viewAttributedSalesNewToBrand14d |
viewAttributedSalesNewToBrand14d |
Sales from new-to-brand customers attributed to ad views within a 14-day attribution window. |
metric |
viewAttributedUnitsOrdered14d |
viewAttributedUnitsOrdered14d |
Units ordered attributed to ad views within a 14-day attribution window. |
metric |
viewAttributedUnitsOrderedNewToBrand14d |
viewAttributedUnitsOrderedNewToBrand14d |
Units ordered by new-to-brand customers attributed to ad views within a 14-day attribution window. |
metric |
viewClickThroughRate |
viewClickThroughRate |
Click-through rate for views (clicks divided by views). This is also referred to as vctr. |
metric |
viewImpressions |
viewImpressions |
The total number of impressions attributed to ad views. |
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 |
dimension |