Amazon Ads Metadata: Most-used fields

The table below gives information about most-used fields that you can import from Amazon Ads Metadata. 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
adGroupId	adGroupId	The unique identifier for the ad group to which the creative belongs.	dimension
adId	adId	The unique identifier for the ad.	dimension
asin	asin	The Amazon Standard Identification Number (ASIN) is a unique 10-character alphanumeric identifier for products on Amazon. It is used to specify which product is being advertised or targeted.	dimension
bidding	bidding	The configuration that defines how ad bids are managed for a campaign or ad group, encompassing bid amounts, bidding strategies (e.g., rule-based or optimized for clicks/conversions), and placement bid adjustments.	dimension
budget	budget	The allocated budget amount for a campaign.	metric
budgetType	budgetType	The type of budget, indicating its allocation period (e.g., daily).	dimension
budget_budget	budget_budget	The monetary amount allocated for the campaign’s budget.	metric
budget_budgetType	budget_budgetType	The type of budget, such as daily or lifetime.	dimension
budget_effectiveBudget	budget_effectiveBudget	This field indicates the current daily budget for a campaign, reflecting any adjustments made by active budget rules. It can be used to determine if budget rules have impacted the campaign’s budget.	metric
campaignId	campaignId	The unique identifier for an advertising campaign.	metric
costType	costType	The method by which advertising costs are calculated (e.g., cost-per-click (CPC), cost-per-thousand viewable impressions (vCPM)).	dimension
creationDate	creationDate	The date and time, in ISO 8601 format, when the advertising entity (e.g., campaign, ad group, product ad) was created.	dimension
creationDate_timestamp	creationDate_timestamp	The timestamp indicating when the entity was created.	dimension
creative_asins	creative_asins	This field refers to the Amazon Standard Identification Numbers (ASINs) associated with products that are featured in an ad creative or used for targeting and product recommendations.	dimension
creative_brandLogoAssetID	creative_brandLogoAssetID	The unique identifier for the brand logo image asset, retrieved from the Amazon Ads asset library.	dimension
creative_brandLogoCrop	creative_brandLogoCrop	Defines the cropping coordinates (top, left, width, height) for the brand logo image used in the creative.	dimension
creative_brandLogoUrl	creative_brandLogoUrl	The URL for the brand logo image used in the creative.	dimension
creative_brandName	creative_brandName	The name of the brand associated with the creative.	dimension
creative_collectionType	creative_collectionType	The classification type of the creative, indicating if it’s a manual collection, an automatic collection, or a product collection.	dimension
creative_consentToTranslate	creative_consentToTranslate	A boolean value indicating whether Amazon has consent to automatically translate the creative’s headline and/or video content if they are not in the marketplace’s default language.	dimension
creative_creativePropertiesToOptimize	creative_creativePropertiesToOptimize	A list of properties within the creative that are enabled for optimization, such as the headline.	dimension
creative_creativeStatus	creative_creativeStatus	The current status of the creative, indicating its moderation and publishing state, such as SUBMITTED_FOR_MODERATION or APPROVED_BY_MODERATION.	dimension
creative_creativeVersion	creative_creativeVersion	The version identifier of the creative.	metric
creative_customImageAssetId	creative_customImageAssetId	The unique identifier for a custom image asset used in the creative, retrieved from the Amazon Ads asset library.	dimension
creative_customImageUrl	creative_customImageUrl	The URL for a custom image used in the creative.	dimension
creative_customImages	creative_customImages	This field refers to custom image assets (e.g., rectangular or square images) used within an ad creative, distinct from brand logos, to visually represent the advertised product or brand.	dimension
creative_headline	creative_headline	The main text headline displayed as part of the ad creative.	dimension
creative_headlines	creative_headlines	This field represents the text displayed as the primary headline within an ad creative.	dimension
creative_originalHeadline	creative_originalHeadline	The original text of the headline before any modifications or potential translations.	dimension
creative_originalHeadlines	creative_originalHeadlines	This field contains the original text of the headline before any potential modifications or moderation.	dimension
creative_originalVideoAssetIds	creative_originalVideoAssetIds	A list of original video asset identifiers associated with the creative.	dimension
creative_subpages	creative_subpages	This field represents the specific sub-pages or landing pages within a Brand Store or a custom landing page that an ad creative directs shoppers to, allowing for detailed product showcasing or brand experience.	dimension
creative_type	creative_type	The type of the creative, such as IMAGE, VIDEO, PRODUCT_COLLECTION, MANUAL_COLLECTION, AUTO_COLLECTION, or STORE_SPOTLIGHT.	dimension
creative_videoAssetIds	creative_videoAssetIds	A list of unique identifiers for video assets used in the creative.	dimension
dynamicBidding_placementBidding	dynamicBidding_placementBidding	Adjustments to bids based on ad placement (e.g., top of search, product page).	dimension
dynamicBidding_shopperCohortBidding	dynamicBidding_shopperCohortBidding	This field relates to a bidding strategy where campaign bids are dynamically adjusted based on specific shopper cohorts, often defined through Amazon Marketing Cloud (AMC) audiences. It allows advertisers to optimize bid performance for targeted shopper segments.	dimension
dynamicBidding_strategy	dynamicBidding_strategy	The automated bidding strategy configured for the campaign.	dimension
endDate	endDate	The end date of the campaign in YYYYMMDD format.	dimension
extendedData_creationDate	extendedData_creationDate	The date and time when the advertising entity was initially created, specifically retrieved from the extended data set for the entity.	metric
extendedData_creationDateTime	extendedData_creationDateTime	The date and time when the entity was created, available in extended data.	dimension
extendedData_lastUpdateDate	extendedData_lastUpdateDate	The date and time when the advertising entity was last updated, specifically retrieved from the extended data set for the entity.	metric
extendedData_lastUpdateDateTime	extendedData_lastUpdateDateTime	The date and time when the entity was last updated, available in extended data.	dimension
extendedData_servingStatus	extendedData_servingStatus	The serving status of the entity, indicating whether it is eligible to serve ads, available in extended data.	dimension
extendedData_servingStatusDetails	extendedData_servingStatusDetails	Details regarding the serving status of the entity, available in extended data.	dimension
goal	goal	The primary objective or desired outcome of the advertising campaign, such as driving page visits or conversions.	dimension
isMultiAdGroupsEnabled	isMultiAdGroupsEnabled	Indicates whether a Sponsored Brands campaign supports a multi-ad group structure, allowing for more granular organization and management of ads within a single campaign.	dimension
kpi	kpi	A Key Performance Indicator (KPI) or metric used to measure performance or define conditions for automation and optimization rules within a campaign, such as ACOS (Advertising Cost of Sale) or impressions.	dimension
landingPage_pageType	landingPage_pageType	The type of landing page used for the ad, such as PRODUCT_LIST, STORE, MOMENT, or OFF_AMAZON_LINK.	dimension
landingPage_url	landingPage_url	The URL where customers will land after clicking on the ad.	dimension
lastUpdateDate	lastUpdateDate	The date and time, in ISO 8601 format, when the advertising entity (e.g., campaign, ad group, product ad) was last modified.	dimension
marketplaceBudgetAllocation	marketplaceBudgetAllocation	This setting defines how a campaign’s budget is allocated across different marketplaces. It allows for filtering campaigns based on their marketplace budget management strategy.	dimension
name	name	The human-readable name assigned to an advertising entity like a campaign, ad group, product ad, or budget rule.	dimension
portfolioId	portfolioId	Unique identifier for the portfolio to which the campaign belongs.	metric
profile	profile	Represents an advertiser’s account within a specific marketplace, containing details such as the profile ID, country code, and currency code.	metric
startDate	startDate	The start date of the campaign in YYYYMMDD format.	dimension
state	state	The current operational status of the advertising entity, such as ‘enabled’, ‘paused’, or ‘archived’.	dimension
targetingType	targetingType	The type of targeting used for the campaign, such as ‘auto’ or ‘manual’.	dimension