Amazon Advertising: Most-used fields

Amazon Advertising: Most-used fields#

The table below gives information about most-used fields that you can import from Amazon Advertising. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

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