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 |
|---|---|---|---|
ROAS |
ROAS |
Return on Ad Spend, calculated by dividing the total sales generated by the advertising spend invested on the campaign. It’s represented as a multiplier. |
metric |
Report date |
Report date |
The date for which the report data is generated. |
dimension |
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. |
metric |
adGroupCreationDate |
adGroupCreationDate |
metric |
|
adGroupCreationDateISO |
adGroupCreationDateISO |
dimension |
|
adGroupDefaultBid |
adGroupDefaultBid |
The default bid amount configured for the ad group. |
metric |
adGroupLastUpdatedDate |
adGroupLastUpdatedDate |
metric |
|
adGroupLastUpdatedDateISO |
adGroupLastUpdatedDateISO |
dimension |
|
adGroupName |
adGroupName |
The name of the ad group. |
dimension |
adGroupServingStatus |
adGroupServingStatus |
The serving status of the ad group, indicating whether it is eligible to serve ads. |
dimension |
adGroupState |
adGroupState |
The current state of the ad group, such as enabled, paused, or archived. |
dimension |
adGroupSuggestedBid |
adGroupSuggestedBid |
The suggested bid amount for the ad group. |
dimension |
adId |
adId |
Unique numerical ID of the ad. |
metric |
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 |
ad_group_id |
ad_group_id |
The unique identifier for the ad group. |
dimension |
ad_type |
ad_type |
The type of ad, such as Sponsored Products (SP), Sponsored Brands (SB), or Sponsored Display (SD). |
dimension |
addToCart |
addToCart |
The number of times products were added to a shopping cart after an ad interaction. |
metric |
addToCartClicks |
addToCartClicks |
The number of times a product was added to a shopping cart after an ad click. |
metric |
addToCartRate |
addToCartRate |
The rate at which products were added to a shopping cart after an ad interaction. |
dimension |
addToCartViews |
addToCartViews |
The number of times a product was added to a shopping cart after an ad view. |
metric |
addToList |
addToList |
The number of times products were added to a wish list or other lists after an ad interaction. |
metric |
advertisedAsin |
advertisedAsin |
The ASIN of the product that was advertised. |
dimension |
advertisedSku |
advertisedSku |
The SKU being advertised. |
dimension |
advertiserId |
advertiserId |
A unique identifier for the advertiser. |
metric |
advertiserName |
advertiserName |
The name of the advertiser. |
dimension |
applicableBudgetRuleId |
applicableBudgetRuleId |
The ID associated with the active budget rule for Sponsored Brands campaigns. |
dimension |
applicableBudgetRuleName |
applicableBudgetRuleName |
The name associated with the active budget rule for Sponsored Brands campaigns. |
dimension |
asin |
asin |
The ASIN associated with an advertised product. |
dimension |
asinBrandHalo |
asinBrandHalo |
Data related to sales or conversions of other products within the same brand as the advertised ASIN, attributed to advertising. |
dimension |
asins |
asins |
A list of Amazon Standard Identification Numbers (ASINs) associated with the advertised products. |
dimension |
assets.{NUM}.assetId |
assets.{NUM}.assetId |
The unique identifier for a specific creative asset. |
dimension |
assets.{NUM}.mediaType |
assets.{NUM}.mediaType |
The type of media for the creative asset (e.g., image, video). |
dimension |
assets.{NUM}.name |
assets.{NUM}.name |
The name given to the creative asset. |
dimension |
assets.{NUM}.url |
assets.{NUM}.url |
The URL where the creative asset is stored. |
dimension |
attributedAddToCartClicks14d |
attributedAddToCartClicks14d |
The number of times shoppers added a product to their cart within 14 days of an ad click, attributed to an ad view or click. |
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 attributed conversion events occurring within 1 day of an ad click where the purchased SKU was the same as the advertised SKU. For Sponsored Brands, this also applies to ad views. |
metric |
attributedConversions30d |
attributedConversions30d |
The number of attributed conversion events occurring within 30 days of an ad click. For Sponsored Brands, this applies to conversions occurring within 30 days of an ad click or view. |
metric |
attributedConversions30dSameSKU |
attributedConversions30dSameSKU |
The number of attributed conversion events occurring within 30 days of an ad click where the purchased SKU was the same as the advertised SKU. For Sponsored Brands, this also applies to ad views. |
metric |
attributedConversions7d |
attributedConversions7d |
The number of attributed conversion events occurring within 7 days of an ad click. For Sponsored Brands, this applies to conversions occurring within 7 days of an ad click or view. |
metric |
attributedConversions7dSameSKU |
attributedConversions7dSameSKU |
The number of attributed conversion events occurring within 7 days of an ad click where the purchased SKU was the same as the advertised SKU. For Sponsored Brands, this also applies to ad views. |
metric |
attributedDPV14d |
attributedDPV14d |
The total number of attributed detail page views occurring within 14 days of an ad click. For Sponsored Display vCPM campaigns, this also includes views. |
dimension |
attributedDetailPageView14d |
attributedDetailPageView14d |
The total number of attributed detail page views occurring within 14 days of an ad click. |
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 total number of purchases occurring within 14 days of an ad interaction, attributed to an ad click or view. |
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 |
The total sales amount (in local currency) from attributed purchases of products other than the advertised SKU, occurring within 1 day of an ad interaction. |
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 value of sales occurring within 30 days of an ad click. |
metric |
attributedSales30dOtherSKU |
attributedSales30dOtherSKU |
The total sales amount (in local currency) from attributed purchases of products other than the advertised SKU, occurring within 30 days of an ad interaction. |
metric |
attributedSales30dSameSKU |
attributedSales30dSameSKU |
The total sales amount (in local currency) from attributed purchases occurring within 30 days of an ad interaction, where the purchased SKU was the same as the advertised SKU. |
metric |
attributedSales7d |
attributedSales7d |
Total value of sales occurring within seven days of an ad click. |
metric |
attributedSales7dOtherSKU |
attributedSales7dOtherSKU |
The total sales amount (in local currency) from attributed purchases of products other than the advertised SKU, occurring within 7 days of an ad interaction. |
metric |
attributedSales7dSameSKU |
attributedSales7dSameSKU |
The total sales amount (in local currency) from attributed purchases occurring within 7 days of an ad interaction, where the purchased SKU was the same as the advertised SKU. |
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 total number of units ordered within 14 days of an ad click where the purchased SKU was the same as the advertised SKU. For Sponsored Brands, this also applies to ad views. |
metric |
attributedUnitsOrdered1d |
attributedUnitsOrdered1d |
Total number of units ordered within 24 hours of an ad click. |
metric |
attributedUnitsOrdered1dOtherSKU |
attributedUnitsOrdered1dOtherSKU |
The total number of units ordered from products other than the advertised SKU, occurring within 1 day of an ad click. Also known as a “brand halo” conversion. |
metric |
attributedUnitsOrdered1dSameSKU |
attributedUnitsOrdered1dSameSKU |
The total number of units ordered within 1 day of an ad click where the purchased SKU was the same as the advertised SKU. |
metric |
attributedUnitsOrdered30d |
attributedUnitsOrdered30d |
Total number of units ordered within 30 days of an ad click. |
metric |
attributedUnitsOrdered30dOtherSKU |
attributedUnitsOrdered30dOtherSKU |
The total number of units ordered from products other than the advertised SKU, occurring within 30 days of an ad click. |
metric |
attributedUnitsOrdered30dSameSKU |
attributedUnitsOrdered30dSameSKU |
The total number of units ordered within 30 days of an ad click where the purchased SKU was the same as the advertised SKU. |
metric |
attributedUnitsOrdered7d |
attributedUnitsOrdered7d |
Total number of units ordered within 7 days of an ad click. |
metric |
attributedUnitsOrdered7dOtherSKU |
attributedUnitsOrdered7dOtherSKU |
The total number of units ordered from products other than the advertised SKU, occurring within 7 days of an ad click. |
metric |
attributedUnitsOrdered7dSameSKU |
attributedUnitsOrdered7dSameSKU |
The total number of units ordered within 7 days of an ad click where the purchased SKU was the same as the advertised SKU. |
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 advertising interactions, such as “last touch” or “first touch”. |
dimension |
bid |
bid |
The bid amount for the ad or keyword. |
dimension |
bidOptimization |
bidOptimization |
Bid optimization for Sponsored Display ad groups. For vCPM campaigns, the value is always ‘reach’. For CPC campaigns, value is either ‘clicks’ or ‘conversions’. |
dimension |
bidRecommendations.closeMatch.lowBid.suggestedBid |
bidRecommendations.closeMatch.lowBid.suggestedBid |
The low-end suggested bid for close-match targeting, recommended by Amazon to optimize ad performance. |
metric |
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 |
brandEntityId |
brandEntityId |
A unique identifier for the brand associated with the advertising activities. |
dimension |
brandName |
brandName |
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 originated from branded searches. |
metric |
brandedSearchesViews |
brandedSearchesViews |
The number of searches that included the brand name, attributed to an ad view. |
metric |
campaignAdFormat |
campaignAdFormat |
The format of the ad creative used in the campaign. |
dimension |
campaignApplicableBudgetRuleId |
campaignApplicableBudgetRuleId |
The ID associated with the active budget rule for Sponsored Brands campaigns. This is also referred to as applicableBudgetRuleId. |
dimension |
campaignApplicableBudgetRuleName |
campaignApplicableBudgetRuleName |
The name associated with the active budget rule for Sponsored Brands campaigns. This is also referred to as applicableBudgetRuleName. |
dimension |
campaignBidMultiplier |
campaignBidMultiplier |
A factor used to adjust bids for specific targeting attributes or placements within a campaign. |
dimension |
campaignBidOptimization |
campaignBidOptimization |
The strategy used to optimize bids within the campaign to achieve specific performance goals. |
dimension |
campaignBiddingAdjustmentsPredicate |
campaignBiddingAdjustmentsPredicate |
dimension |
|
campaignBiddingBidOptimization |
campaignBiddingBidOptimization |
Details about the bid optimization strategy applied to the campaign. |
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. This is also referred to as campaignBudget. |
metric |
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 |
metric |
|
campaignCreationDateISO |
campaignCreationDateISO |
dimension |
|
campaignCreativeAsins |
campaignCreativeAsins |
dimension |
|
campaignCreativeBrandLogoAssetID |
campaignCreativeBrandLogoAssetID |
The asset ID of the brand logo used in the campaign’s creative. |
dimension |
campaignCreativeBrandLogoUrl |
campaignCreativeBrandLogoUrl |
The URL of the brand logo used in the campaign’s creative. |
dimension |
campaignCreativeBrandName |
campaignCreativeBrandName |
dimension |
|
campaignCreativeHeadline |
campaignCreativeHeadline |
The headline text displayed in the campaign’s creative. |
dimension |
campaignCreativeShouldOptimizeAsins |
campaignCreativeShouldOptimizeAsins |
dimension |
|
campaignCreativeType |
campaignCreativeType |
The type of creative asset used in the campaign. |
dimension |
campaignCreativeVideoAssetIds |
campaignCreativeVideoAssetIds |
The asset IDs for video creatives used in the campaign. |
dimension |
campaignCreativeVideoMediaIds |
campaignCreativeVideoMediaIds |
The media IDs for video assets used in the campaign’s creative. |
dimension |
campaignDailyBudget |
campaignDailyBudget |
The maximum amount of money allocated to be spent on the campaign per day. |
dimension |
campaignDynamicBiddingPlacementBiddingPercentage |
campaignDynamicBiddingPlacementBiddingPercentage |
The percentage adjustment applied to bids for specific placements when dynamic bidding is enabled for the campaign. |
metric |
campaignDynamicBiddingPlacementBiddingPlacement |
campaignDynamicBiddingPlacementBiddingPlacement |
The specific ad placement for which dynamic bidding adjustments are applied. |
dimension |
campaignDynamicBiddingStrategy |
campaignDynamicBiddingStrategy |
The dynamic bidding strategy configured for the campaign (e.g., up and down, down only). |
dimension |
campaignEndDate |
campaignEndDate |
metric |
|
campaignEndDateISO |
campaignEndDateISO |
dimension |
|
campaignExtendedDataServingStatus |
campaignExtendedDataServingStatus |
dimension |
|
campaignLandingPagePageType |
campaignLandingPagePageType |
The type of landing page used for the campaign (e.g., product detail page, Brand Store). |
dimension |
campaignLandingPageUrl |
campaignLandingPageUrl |
The URL of the landing page where users are directed after clicking on an ad. |
dimension |
campaignLastUpdatedDate |
campaignLastUpdatedDate |
metric |
|
campaignLastUpdatedDateISO |
campaignLastUpdatedDateISO |
dimension |
|
campaignName |
campaignName |
The name of the advertising campaign. |
dimension |
campaignPremiumBidAdjustment |
campaignPremiumBidAdjustment |
An additional percentage increase applied to bids for premium placements or targeting. |
dimension |
campaignPriceTypeCode |
campaignPriceTypeCode |
The pricing type code for the campaign (e.g., CPC for cost-per-click, CPM for cost-per-thousand impressions). |
dimension |
campaignRuleBasedBudget |
campaignRuleBasedBudget |
The value of the rule-based budget for Sponsored Brands campaigns. |
dimension |
campaignRuleBasedBudgetAmount |
campaignRuleBasedBudgetAmount |
The monetary amount of the rule-based budget for Sponsored Brands campaigns. This is also referred to as campaignRuleBasedBudget. |
dimension |
campaignServingStatus |
campaignServingStatus |
The serving status of the campaign, indicating whether it is eligible to serve ads. |
dimension |
campaignStartDate |
campaignStartDate |
metric |
|
campaignStartDateISO |
campaignStartDateISO |
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 broad category of targeting used in the campaign (e.g., keyword targeting, product targeting, audience targeting). |
dimension |
campaignType |
campaignType |
The type of advertising campaign (e.g., Sponsored Products, Sponsored Brands, Sponsored Display). |
dimension |
campaign_state |
campaign_state |
The current status or state of the campaign (e.g., enabled, paused, archived). |
dimension |
clickThroughRate |
clickThroughRate |
The percentage of impressions that resulted in a click (clicks / impressions). |
metric |
clicks |
clicks |
Total number of ad clicks. |
metric |
conversions |
conversions |
The total number of conversion events, such as purchases, attributed to ad interactions. |
metric |
conversionsBrandHalo |
conversionsBrandHalo |
The total number of conversions attributed to brand halo effects from advertising. |
metric |
conversionsBrandHaloClicks |
conversionsBrandHaloClicks |
For Sponsored Display vCPM campaigns, the total number of attributed conversion events occurring within 14 days of an ad click where the purchased SKU was different from the SKU advertised. |
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_code |
country_code |
The two-letter country code (e.g., US, GB) relevant to the advertising data. |
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 |
day |
day |
The specific day for which the data is reported. |
dimension |
detailPageViewClicks |
detailPageViewClicks |
The number of clicks that led to a detail page view. |
metric |
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 |
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 |
interactiveImpressions |
interactiveImpressions |
The number of impressions where users interacted with the ad creative. |
metric |
intervalEnd |
intervalEnd |
The end of the reporting interval. |
dimension |
intervalStart |
intervalStart |
The start of the reporting interval. |
dimension |
keyword |
keyword |
The keyword or phrase used in targeting. This is also referred to as keywordText. |
dimension |
keywordBid |
keywordBid |
The advertiser-set bid value for a keyword. |
metric |
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. |
dimension |
keywordText |
keywordText |
Text of the keyword or phrase. |
dimension |
keywordType |
campaignId |
Unique numerical ID of a campaign. |
metric |
leadFormOpens |
leadFormOpens |
metric |
|
leads |
leads |
The number of leads generated from ad interactions. |
metric |
linkOuts |
linkOuts |
The number of clicks that directed users to a destination outside of Amazon. |
metric |
marketplace |
marketplace |
The Amazon marketplace where the advertising activity occurred (e.g., US, UK, DE). |
dimension |
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 detail page views from shoppers new to the brand, attributed to an ad click. A shopper is considered new if they haven’t viewed a detail page for the brand in the past 365 days. |
dimension |
newToBrandDetailPageViewViews |
newToBrandDetailPageViewViews |
The number of detail page views from shoppers new to the brand, attributed to an ad view. A shopper is considered new if they haven’t viewed a detail page for the brand in the past 365 days. |
dimension |
newToBrandDetailPageViews |
newToBrandDetailPageViews |
The total number of detail page views from shoppers new to the brand, attributed to an ad interaction (click or view). |
dimension |
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 total number of orders attributed to clicks within a 14-day attribution window. |
metric |
periodicity |
periodicity |
The reporting period or frequency for the data (e.g., daily, summary). |
dimension |
placementClassification |
placementClassification |
The classification of where the ad was placed (e.g., top of search, rest of search, product page). |
dimension |
portfolioId |
portfolioId |
A unique identifier for the portfolio. |
metric |
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 |
metric |
|
productAdsCreationDateISO |
productAdsCreationDateISO |
dimension |
|
productAdsLastUpdatedDate |
productAdsLastUpdatedDate |
metric |
|
productAdsLastUpdatedDateISO |
productAdsLastUpdatedDateISO |
dimension |
|
productAdsServingStatus |
productAdsServingStatus |
The serving status of the product ad, indicating whether it is eligible to serve. |
dimension |
productAdsSku |
productAdsSku |
The Seller SKU (Stock Keeping Unit) of the advertised product. |
dimension |
productAdsState |
productAdsState |
The current state of the product ad, such as enabled, paused, or archived. |
dimension |
productAsin |
productAsin |
The Amazon Standard Identification Number (ASIN) of a product. |
dimension |
productCategory |
productCategory |
The product category of the advertised item. |
dimension |
productConversionType |
productConversionType |
dimension |
|
productGroup |
productGroup |
dimension |
|
productName |
productName |
The name of the advertised product. |
dimension |
productSubcategory |
productSubcategory |
dimension |
|
profileBrandName |
profileBrandName |
dimension |
|
profileCountryCode |
profileCountryCode |
dimension |
|
profileId |
profileId |
A unique identifier for the advertising profile. |
metric |
profileName |
profileName |
The name associated with an advertiser’s 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 |
publisher |
publisher |
The source of the traffic or ad impression, particularly relevant for Amazon Attribution API that measures non-Amazon media performance (e.g., Google, Facebook). |
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 as the advertised product, attributed to advertising 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 for an asynchronously generated report. |
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 generated from brand halo effects attributed to advertising. |
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 |
The total sales revenue attributed to 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 |
The sales generated from advertising for SKUs other than the advertised product, within a 7-day attribution window. |
metric |
salesPromoted |
salesPromoted |
The total sales generated by promoted products. |
metric |
salesPromotedClicks |
salesPromotedClicks |
The sales generated from clicks on promoted ads. |
metric |
searchTerm |
searchTerm |
The search term used by the customer. |
dimension |
searchTermImpressionRank |
searchTermImpressionRank |
Account-level ad-attributed impression rank for search terms. |
metric |
searchTermImpressionShare |
searchTermImpressionShare |
Account-level ad-attributed impression share for search terms. |
metric |
sku |
sku |
The Stock Keeping Unit (SKU) used by the seller to identify a specific product variation. |
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 Store associated with the campaign or advertiser. |
dimension |
suggestedBid.bidRecId |
suggestedBid.bidRecId |
The unique identifier for a specific bid recommendation. |
dimension |
suggestedBid.rangeEnd |
suggestedBid.rangeEnd |
The upper boundary of the suggested bid range. |
dimension |
suggestedBid.rangeStart |
suggestedBid.rangeStart |
The lower boundary of the suggested bid range. |
dimension |
suggestedBid.suggested |
suggestedBid.suggested |
The specific suggested bid value. |
dimension |
targetBid |
targetBid |
The target bid amount set for a specific keyword or product target. |
dimension |
targeting |
targeting |
Information related to the targeting strategy and clauses used in advertising campaigns. |
dimension |
targetingExpression |
targetingExpression |
A string representation of the expression object used in the targeting clause. |
dimension |
targetingId |
targetingId |
The identifier of the targeting expression. |
metric |
targetingText |
targetingText |
The text used in the targeting expression. |
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 |
totalCost |
totalCost |
The total cost incurred for the advertising campaign or entity. |
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. |
dimension |
unitsSoldBrandHalo |
unitsSoldBrandHalo |
The total number of units sold due to brand halo effects attributed to advertising. |
metric |
unitsSoldBrandHaloClicks |
unitsSoldBrandHaloClicks |
The number of units sold due to brand halo effects that resulted 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 as the advertised product, attributed to advertising within a 1-day attribution window. |
metric |
unitsSoldSameSku30d |
unitsSoldSameSku30d |
The number of units sold for the same SKU as the advertised product, attributed to advertising within a 30-day attribution window. |
metric |
unitsSoldSameSku7d |
unitsSoldSameSku7d |
The number of units sold for the same SKU as the advertised product, attributed to advertising within a 7-day attribution window. |
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 |
For Sponsored Display vCPM campaigns, the total number of searches that included the name of your brand occurring within 14 days of an ad view. For CPC campaigns, this value is equal to attributedBrandedSearches14d (which is click-based). |
dimension |
viewAttributedConversions14d |
viewAttributedConversions14d |
For Sponsored Display vCPM campaigns, the total number of attributed conversion events occurring within 14 days of an ad click or view. For CPC campaigns, this value is equal to attributedConversions14d. |
metric |
viewAttributedDetailPageView14d |
viewAttributedDetailPageView14d |
For Sponsored Display vCPM campaigns, the total number of attributed detail page views occurring within 14 days of an ad click or view. For CPC campaigns, this value is equal to attributedDetailPageView14d. |
metric |
viewAttributedOrdersNewToBrand14d |
viewAttributedOrdersNewToBrand14d |
For Sponsored Display vCPM campaigns, the total number of attributed new-to-brand orders occurring within 14 days of an ad click or view. |
metric |
viewAttributedSales14d |
viewAttributedSales14d |
For Sponsored Display vCPM campaigns, the total attributed sales amount occurring within 14 days of an ad click or view. For CPC campaigns, this value is equal to attributedSales14d. |
metric |
viewAttributedSalesNewToBrand14d |
viewAttributedSalesNewToBrand14d |
For Sponsored Display vCPM campaigns, the total attributed sales amount from new-to-brand purchases occurring within 14 days of an ad click or view. |
metric |
viewAttributedUnitsOrdered14d |
viewAttributedUnitsOrdered14d |
For Sponsored Display vCPM campaigns, the total number of attributed units ordered occurring within 14 days of an ad click or view. |
metric |
viewAttributedUnitsOrderedNewToBrand14d |
viewAttributedUnitsOrderedNewToBrand14d |
Total number of attributed units ordered as part of new-to-brand 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 |
viewClickThroughRate |
viewClickThroughRate |
Click-through rate for views (clicks divided by views). This is also referred to as vctr. |
dimension |
viewImpressions |
viewImpressions |
The number of viewable impressions served for display or video ads. |
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 |