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	Unique identifier for an ad group within a campaign.	metric
bidOptimization	bidOptimization	The strategy to optimize bids for specific goals like reach, clicks, or conversions.	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
costType	costType	The method by which advertising costs are calculated (e.g., cost-per-click (CPC), cost-per-thousand viewable impressions (vCPM)).	dimension
creationDate_timestamp	creationDate_timestamp	The timestamp indicating when the entity was created.	dimension
creativeType	creativeType	The type of creative (e.g., image, video, product collection, store spotlight).	dimension
defaultBid	defaultBid	The default bid amount for an ad group, used if no specific bid is set.	metric
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_creationDateTime	extendedData_creationDateTime	The date and time when the entity was created, available in extended data.	dimension
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
lastUpdatedDate	lastUpdatedDate	The date when the entity was last updated.	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
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
profile	profile	Represents an advertiser and their account’s marketplace, used to scope API calls.	metric
servingStatus	servingStatus	The current serving status of the ad, ad group, or campaign.	dimension
siteRestrictions	siteRestrictions	This field specifies restrictions on the sites where an ad campaign can be displayed, such as limiting campaigns to Amazon Business.	dimension
startDate	startDate	The start date of the campaign in YYYYMMDD format.	dimension
tactic	tactic	A machine learning-optimized strategy or approach, often applied to ad groups, that defines specific targeting and optimization methods for advertising campaigns, especially within Amazon DSP.	dimension
targetingType	targetingType	The type of targeting used for the campaign, such as ‘auto’ or ‘manual’.	dimension