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.
adGroupId Dimension
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.
adId Dimension
The unique identifier for an individual ad within an ad group.
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.
bidOptimization Dimension
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.
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.
campaignId Dimension
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.
creativeType Dimension
The type of creative used in an ad, such as image, video, or custom creative.
creative_asins Dimension
A list of Amazon Standard Identification Numbers (ASINs) associated with the products featured in the creative.
creative_brandLogoAssetID Dimension
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_brandLogoCrop Dimension
Defines the cropping coordinates applied to the brand logo image asset within the creative.
creative_brandLogoUrl Dimension
The URL of the brand logo image used in the creative.
creative_brandName Dimension
The name of the brand associated with the creative.
creative_collectionType Dimension
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_consentToTranslate Dimension
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_creativePropertiesToOptimize Dimension
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_creativeStatus Dimension
The current moderation status of the creative, indicating whether it is pending review, approved, or rejected.
creative_creativeVersion Metric
The version number of the creative, used for tracking changes or iterations.
creative_customImageAssetId Dimension
The asset ID for a custom image used in the creative, which must be uploaded to the Asset library API.
creative_customImageCrop Dimension
Defines the cropping coordinates applied to the custom image asset within the creative.
creative_customImageUrl Dimension
The URL of the custom image used in the creative.
creative_customImages Dimension
A collection of custom images used within the creative, allowing for multiple visual assets.
creative_headline Dimension
The primary text headline displayed as part of the creative content.
creative_headlines Dimension
Text headlines associated with creative assets for ad campaigns, typically used in Sponsored Display and Sponsored Brands.
creative_originalHeadline Dimension
The original, untranslated headline text for the creative.
creative_originalHeadlines Dimension
The initial version of headlines used in creative assets, which could be either user-provided or system-generated before any subsequent modifications or optimizations.
creative_originalVideoAssetIds Dimension
A list of asset IDs for the original video files used in the creative before any modifications or localizations.
creative_subpages Dimension
A collection of specific subpages from an advertiser's Amazon Store that are featured within a creative, typically for Sponsored Brands Store Spotlight ads. Each subpage can include a title, associated ASIN, and URL.
creative_type Dimension
The specific type or format of the ad creative, such as standard image, video, or product collection.
creative_videoAssetIds Dimension
A list of asset IDs for video files used in the creative, which enables video ads.
defaultBid Metric
The initial or standard bid amount set for an ad group or targeting element, subject to bid constraints.
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.
landingPage_pageType Dimension
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_url Dimension
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.
lastUpdateDate Dimension
The date and time, in ISO 8601 format, when the advertising entity (e.g., campaign, ad group, product ad) was last modified.
lastUpdatedDate Dimension
The timestamp indicating when the entity (e.g., ad, ad group, campaign) was last modified or updated.
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 Dimension
Unique identifier for the portfolio to which the campaign belongs.
profile Metric
The unique identifier for an advertising profile, used as the `Amazon-Advertising-API-Scope` header to manage advertising resources for a specific advertiser account.
ruleBasedBudget Dimension
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.
servingStatus Dimension
The current status of an ad or campaign regarding its eligibility to be served, such as enabled, paused, or archived.
siteRestrictions Dimension
Defines restrictions on the websites or placements where an ad campaign can appear, such as limiting ads to 'AMAZON_BUSINESS'.
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'.
tactic Dimension
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).
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.
targetedPGDealId Metric
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.
targetingType Dimension
The type of targeting used for the campaign, such as 'auto' or 'manual'.