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.
adGroupIdDimension
The unique identifier for an ad group, which is a collection of ads with a common theme, used for filtering creatives and retrieving their moderation status.
adIdDimension
The unique identifier for an individual ad within an ad group.
asinDimension
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.
bidOptimizationDimension
The strategy or objective that determines how bids are automatically adjusted for an ad group to achieve specific goals, such as optimizing for reach (viewable impressions), clicks, or conversions.
biddingDimension
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.
budgetMetric
The allocated budget amount for a campaign.
budgetTypeDimension
The type of budget, indicating its allocation period (e.g., daily).
budget_budgetMetric
The monetary amount allocated for the campaign's budget.
budget_budgetTypeDimension
The type of budget, such as daily or lifetime.
campaignIdDimension
The unique identifier for an advertising campaign.
costTypeDimension
The method by which advertising costs are calculated (e.g., cost-per-click (CPC), cost-per-thousand viewable impressions (vCPM)).
creationDateDimension
The date and time, in ISO 8601 format, when the advertising entity (e.g., campaign, ad group, product ad) was created.
creationDate_timestampDimension
The timestamp indicating when the entity was created.
creativeTypeDimension
The type of creative used in an ad, such as image, video, or custom creative.
creative_asinsDimension
A list of Amazon Standard Identification Numbers (ASINs) associated with the products featured in the creative.
creative_brandLogoAssetIDDimension
The asset ID for the brand logo image used in the creative, which must be uploaded to the Asset library API prior to creative creation.
creative_brandLogoCropDimension
Defines the cropping coordinates applied to the brand logo image asset within the creative.
creative_brandLogoUrlDimension
The URL of the brand logo image used in the creative.
creative_brandNameDimension
The name of the brand associated with the creative.
creative_collectionTypeDimension
Specifies the method used to assemble a collection of products within a creative, such as 'manual collections' (advertiser-selected products) or 'automatic collections' (AI-dynamically grouped products).
creative_consentToTranslateDimension
Indicates whether the advertiser has granted consent for the creative content, such as headlines, to be automatically translated into the default language of the target marketplace.
creative_creativePropertiesToOptimizeDimension
Specifies the elements or attributes of a creative asset that the advertising platform can optimize (e.g., images, videos, headlines, logos, or other dynamic ad copy) to improve ad performance.
creative_creativeStatusDimension
The current moderation status of the creative, indicating whether it is pending review, approved, or rejected.
creative_creativeVersionMetric
The version number of the creative, used for tracking changes or iterations.
creative_customImageAssetIdDimension
The asset ID for a custom image used in the creative, which must be uploaded to the Asset library API.
creative_customImageCropDimension
Defines the cropping coordinates applied to the custom image asset within the creative.
creative_customImageUrlDimension
The URL of the custom image used in the creative.
creative_customImagesDimension
A collection of custom images used within the creative, allowing for multiple visual assets.
creative_headlineDimension
The primary text headline displayed as part of the creative content.
creative_headlinesDimension
The advertiser-provided headline text for the creative. This field is available for both Sponsored Brands and Sponsored Display creatives.
creative_originalHeadlineDimension
The original, untranslated headline text for the creative.
creative_originalHeadlinesDimension
The original headline text provided by the advertiser, before any potential localization or optimization by Amazon. This field is available for both Sponsored Brands and Sponsored Display creatives.
creative_originalVideoAssetIdsDimension
A list of asset IDs for the original video files used in the creative before any modifications or localizations.
creative_subpagesDimension
Represents the individual pages within an Amazon Brand Store that an ad creative directs customers to. These subpages are part of a brand's presence on Amazon and can be listed using the Brand Home API.
creative_titleDimension
The title of the creative, specifically found in Sponsored Brands Manual Collection Ads. This field serves as a descriptive label for the ad creative.
creative_typeDimension
The specific type or format of the ad creative, such as standard image, video, or product collection.
creative_videoAssetIdsDimension
A list of asset IDs for video files used in the creative, which enables video ads.
defaultBidMetric
The initial or standard bid amount set for an ad group or targeting element, subject to bid constraints.
dynamicBidding_placementBiddingDimension
Adjustments to bids based on ad placement (e.g., top of search, product page).
dynamicBidding_shopperCohortBiddingDimension
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_strategyDimension
The automated bidding strategy configured for the campaign.
endDateDimension
The end date of the campaign in YYYYMMDD format.
extendedData_creationDateMetric
The date and time when the advertising entity was initially created, specifically retrieved from the extended data set for the entity.
extendedData_creationDateTimeDimension
The date and time when the entity was created, available in extended data.
extendedData_lastUpdateDateMetric
The date and time when the advertising entity was last updated, specifically retrieved from the extended data set for the entity.
extendedData_lastUpdateDateTimeDimension
The date and time when the entity was last updated, available in extended data.
extendedData_servingStatusDimension
The serving status of the entity, indicating whether it is eligible to serve ads, available in extended data.
extendedData_servingStatusDetailsDimension
Details regarding the serving status of the entity, available in extended data.
goalDimension
The primary objective or desired outcome of the advertising campaign, such as driving page visits or conversions.
isMultiAdGroupsEnabledDimension
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.
kpiDimension
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.
landingPage_pageTypeDimension
Defines the type of landing page to which an ad directs shoppers, such as a custom URL, an Amazon Store page, or a product detail page.
landingPage_urlDimension
The URL to which users are directed after clicking on the ad, which can be an Amazon product page, brand store, or an external website.
lastUpdateDateDimension
The date and time, in ISO 8601 format, when the advertising entity (e.g., campaign, ad group, product ad) was last modified.
lastUpdatedDateDimension
The timestamp indicating when the entity (e.g., ad, ad group, campaign) was last modified or updated.
marketplaceBudgetAllocationDimension
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.
nameDimension
The human-readable name assigned to an advertising entity like a campaign, ad group, product ad, or budget rule.
offAmazonSettingsDimension
Contains settings for managing campaigns that run outside of the Amazon platform, such as budget control strategies for off-Amazon placements.
portfolioIdDimension
Unique identifier for the portfolio to which the campaign belongs.
profileMetric
The unique identifier for an advertising profile, used as the `Amazon-Advertising-API-Scope` header to manage advertising resources for a specific advertiser account.
ruleBasedBudgetDimension
Performance-based rules enable the creation of budget rules that automatically adjust the campaign budget when specified conditions are met, such as increasing the budget when top-of-search impression share exceeds a certain threshold.
servingStatusDimension
The current status of an ad or campaign regarding its eligibility to be served, such as enabled, paused, or archived.
siteRestrictionsDimension
Defines restrictions on the websites or placements where an ad campaign can appear, such as limiting ads to 'AMAZON_BUSINESS'.
startDateDimension
The start date of the campaign in YYYYMMDD format.
stateDimension
The current operational status of the advertising entity, such as 'enabled', 'paused', or 'archived'.
tacticDimension
Represents an advertising strategy or approach, often machine learning-optimized, that defines pre-configured ad groups and specialized targeting to achieve specific campaign objectives such as awareness, consideration, or conversions (e.g., prospecting, remarketing).
tagsDimension
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.
targetedPGDealIdMetric
The unique identifier for a Programmatic Guaranteed (PG) deal that an ad group is configured to target. PG deals are pre-negotiated agreements for fixed impression volumes at a set price.
targetingTypeDimension
The type of targeting used for the campaign, such as 'auto' or 'manual'.