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
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
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
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
offAmazonSettings	offAmazonSettings	This field contains settings related to campaigns running on off-Amazon placements, such as budget control strategies for maximizing reach outside the Amazon platform.	dimension
portfolioId	portfolioId	Unique identifier for the portfolio to which the campaign belongs.	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