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.	metric
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
adGroupName	adGroupName	The name of 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
addToCart	addToCart	The number of times products were added to a shopping cart after an ad interaction.	metric
advertisedAsin	advertisedAsin	The ASIN of the product that was advertised.	dimension
advertisedSku	advertisedSku	The SKU being advertised.	dimension
asin	asin	The ASIN associated with an advertised product.	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
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
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
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
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
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
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
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
brandedSearches	brandedSearches	The number of searches for the brand associated with the advertised products.	metric
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
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
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
campaignCreativeBrandName	campaignCreativeBrandName	The brand name featured in the campaign’s creative elements, such as text or images.	dimension
campaignDynamicBiddingPlacementBiddingPercentage	campaignDynamicBiddingPlacementBiddingPercentage	The percentage adjustment applied to bids based on the specific ad placement, as part of a dynamic bidding strategy for a campaign.	metric
campaignDynamicBiddingPlacementBiddingPlacement	campaignDynamicBiddingPlacementBiddingPlacement	The specific location or context where an ad is displayed, and for which dynamic bidding adjustments are configured.	dimension
campaignEndDate	campaignEndDate	The scheduled end date for the campaign.	metric
campaignEndDateISO	campaignEndDateISO	The scheduled end date for the campaign, formatted according to ISO 8601 standard.	dimension
campaignName	campaignName	The name of the advertising campaign.	dimension
campaignStartDate	campaignStartDate	The scheduled start date for the campaign.	metric
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
clickThroughRate	clickThroughRate	The percentage of impressions that resulted in a click (clicks / impressions).	metric
clicks	clicks	Total number of 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).	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
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
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	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
keywordText	keywordText	Text of the keyword or phrase.	dimension
keywordType	campaignId	Unique numerical ID of a campaign.	metric
leads	leads	The number of leads generated from ad interactions.	metric
matchType	matchType	Type of matching for the keyword or phrase used in bid. Must be one of: broad, phrase, or exact.	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
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
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
productAdsSku	productAdsSku	The Seller SKU (Stock Keeping Unit) of the advertised product.	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.	metric
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.	dimension
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
purchasesSameSku7d	purchasesSameSku7d	The number of purchases of the same SKU as the advertised product, attributed to advertising within a 7-day attribution window.	metric
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
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 sales attributed to advertising campaigns, indicating the revenue 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
spend	spend	The total cost of advertising, equivalent to ‘cost’.	metric
startDate	startDate	The start date of the reporting period, in YYYYMMDD format.	dimension
targeting	targeting	Information related to the targeting strategy and clauses used in advertising campaigns.	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.	dimension
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
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%.	dimension
videoThirdQuartileViews	videoThirdQuartileViews	The number of impressions where the video was viewed to 75%.	dimension
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.	metric
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