Skip to content
Book a demo

Connect documentation

All documentation
Documentation

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.

FieldAdverity UI nameType
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'.