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.
asin Dimension
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.
bidding Dimension
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.
budget Metric
The allocated budget amount for a campaign.
budgetType Dimension
The type of budget, indicating its allocation period (e.g., daily).
budget_budget Metric
The monetary amount allocated for the campaign's budget.
budget_budgetType Dimension
The type of budget, such as daily or lifetime.
budget_effectiveBudget Metric
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.
campaignId Metric
The unique identifier for an advertising campaign.
costType Dimension
The method by which advertising costs are calculated (e.g., cost-per-click (CPC), cost-per-thousand viewable impressions (vCPM)).
creationDate Dimension
The date and time, in ISO 8601 format, when the advertising entity (e.g., campaign, ad group, product ad) was created.
creationDate_timestamp Dimension
The timestamp indicating when the entity was created.
dynamicBidding_placementBidding Dimension
Adjustments to bids based on ad placement (e.g., top of search, product page).
dynamicBidding_shopperCohortBidding Dimension
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.
dynamicBidding_strategy Dimension
The automated bidding strategy configured for the campaign.
endDate Dimension
The end date of the campaign in YYYYMMDD format.
extendedData_creationDate Metric
The date and time when the advertising entity was initially created, specifically retrieved from the extended data set for the entity.
extendedData_creationDateTime Dimension
The date and time when the entity was created, available in extended data.
extendedData_lastUpdateDate Metric
The date and time when the advertising entity was last updated, specifically retrieved from the extended data set for the entity.
extendedData_lastUpdateDateTime Dimension
The date and time when the entity was last updated, available in extended data.
extendedData_servingStatus Dimension
The serving status of the entity, indicating whether it is eligible to serve ads, available in extended data.
extendedData_servingStatusDetails Dimension
Details regarding the serving status of the entity, available in extended data.
goal Dimension
The primary objective or desired outcome of the advertising campaign, such as driving page visits or conversions.
isMultiAdGroupsEnabled Dimension
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.
kpi Dimension
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.
lastUpdateDate Dimension
The date and time, in ISO 8601 format, when the advertising entity (e.g., campaign, ad group, product ad) was last modified.
marketplaceBudgetAllocation Dimension
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.
name Dimension
The human-readable name assigned to an advertising entity like a campaign, ad group, product ad, or budget rule.
offAmazonSettings Dimension
Contains settings for managing campaigns that run outside of the Amazon platform, such as budget control strategies for off-Amazon placements.
portfolioId Metric
Unique identifier for the portfolio to which the campaign belongs.
startDate Dimension
The start date of the campaign in YYYYMMDD format.
state Dimension
The current operational status of the advertising entity, such as 'enabled', 'paused', or 'archived'.
tags Dimension
Custom labels that users can assign to campaign entities to organize and categorize them within the Amazon Ads platform. Tags are represented as key-value pairs.
targetingType Dimension
The type of targeting used for the campaign, such as 'auto' or 'manual'.