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	The unique identifier for the ad group to which the creative belongs.	dimension
adId	adId	The unique identifier for the ad.	dimension
asin	asin	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.	dimension
assetId	assetId	A unique identifier assigned to an asset in the Amazon Creative Asset Library. This ID is used to reference and manage images or videos across different ad campaigns.	dimension
bidding	bidding	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.	dimension
brandEntityId	brandEntityId	A unique identifier for a brand, often required for sellers when uploading assets for Sponsored Brands campaigns to associate content with a specific brand.	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
campaignId	campaignId	The unique identifier for an advertising campaign.	metric
code	code	A status code returned by the API indicating the result of an operation, such as ‘SUCCESS’ for a successful creative creation or registration.	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	creationDate	The date and time, in ISO 8601 format, when the advertising entity (e.g., campaign, ad group, product ad) was created.	dimension
creationDate_timestamp	creationDate_timestamp	The timestamp indicating when the entity was created.	dimension
creative_asins	creative_asins	This field refers to the Amazon Standard Identification Numbers (ASINs) associated with products that are featured in an ad creative or used for targeting and product recommendations.	dimension
creative_brandLogoAssetID	creative_brandLogoAssetID	The unique identifier for the brand logo image asset, retrieved from the Amazon Ads asset library.	dimension
creative_brandLogoCrop	creative_brandLogoCrop	Defines the cropping coordinates (top, left, width, height) for the brand logo image used in the creative.	dimension
creative_brandLogoUrl	creative_brandLogoUrl	The URL for the brand logo image used in the creative.	dimension
creative_brandName	creative_brandName	The name of the brand associated with the creative.	dimension
creative_collectionType	creative_collectionType	The classification type of the creative, indicating if it’s a manual collection, an automatic collection, or a product collection.	dimension
creative_consentToTranslate	creative_consentToTranslate	A boolean value indicating whether Amazon has consent to automatically translate the creative’s headline and/or video content if they are not in the marketplace’s default language.	dimension
creative_creativePropertiesToOptimize	creative_creativePropertiesToOptimize	A list of properties within the creative that are enabled for optimization, such as the headline.	dimension
creative_creativeStatus	creative_creativeStatus	The current status of the creative, indicating its moderation and publishing state, such as SUBMITTED_FOR_MODERATION or APPROVED_BY_MODERATION.	dimension
creative_creativeVersion	creative_creativeVersion	The version identifier of the creative.	metric
creative_customImageAssetId	creative_customImageAssetId	The unique identifier for a custom image asset used in the creative, retrieved from the Amazon Ads asset library.	dimension
creative_customImageCrop	creative_customImageCrop	This field defines the cropping coordinates (top, left, width, height) applied to a custom image used in an ad creative. It’s used in Sponsored Brands and Sponsored Display to specify how a custom image asset should be displayed within an ad.	dimension
creative_customImageUrl	creative_customImageUrl	The URL for a custom image used in the creative.	dimension
creative_customImages	creative_customImages	This field refers to custom image assets (e.g., rectangular or square images) used within an ad creative, distinct from brand logos, to visually represent the advertised product or brand.	dimension
creative_headline	creative_headline	The main text headline displayed as part of the ad creative.	dimension
creative_originalHeadline	creative_originalHeadline	The original text of the headline before any modifications or potential translations.	dimension
creative_originalVideoAssetIds	creative_originalVideoAssetIds	A list of original video asset identifiers associated with the creative.	dimension
creative_subpages	creative_subpages	This field represents the specific sub-pages or landing pages within a Brand Store or a custom landing page that an ad creative directs shoppers to, allowing for detailed product showcasing or brand experience.	dimension
creative_type	creative_type	The type of the creative, such as IMAGE, VIDEO, PRODUCT_COLLECTION, MANUAL_COLLECTION, AUTO_COLLECTION, or STORE_SPOTLIGHT.	dimension
creative_videoAssetIds	creative_videoAssetIds	A list of unique identifiers for video assets used in the creative.	dimension
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
entityId	entityId	A general identifier for an entity within the Amazon Ads platform, such as an advertiser’s account or a specific program associated with an asset.	dimension
extendedData_creationDate	extendedData_creationDate	The date and time when the advertising entity was initially created, specifically retrieved from the extended data set for the entity.	metric
extendedData_creationDateTime	extendedData_creationDateTime	The date and time when the entity was created, available in extended data.	dimension
extendedData_lastUpdateDate	extendedData_lastUpdateDate	The date and time when the advertising entity was last updated, specifically retrieved from the extended data set for the entity.	metric
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
goal	goal	The primary objective or desired outcome of the advertising campaign, such as driving page visits or conversions.	dimension
height	height	The height of the creative asset, typically measured in pixels. It is used in validating asset dimensions for various ad formats and is part of the asset’s metadata.	metric
isMultiAdGroupsEnabled	isMultiAdGroupsEnabled	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.	dimension
kpi	kpi	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.	dimension
landingPage_pageType	landingPage_pageType	The type of landing page used for the ad, such as PRODUCT_LIST, STORE, MOMENT, or OFF_AMAZON_LINK.	dimension
landingPage_url	landingPage_url	The URL where customers will land after clicking on the ad.	dimension
lastUpdateDate	lastUpdateDate	The date and time, in ISO 8601 format, when the advertising entity (e.g., campaign, ad group, product ad) was last modified.	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
mediaType	mediaType	The type of the asset, indicating whether it is an image or a video. This helps categorize and validate the content for different advertising programs.	dimension
name	name	The human-readable name assigned to an advertising entity like a campaign, ad group, product ad, or budget rule.	dimension
portfolioId	portfolioId	Unique identifier for the portfolio to which the campaign belongs.	metric
profile	profile	Represents an advertiser’s account within a specific marketplace, containing details such as the profile ID, country code, and currency code.	dimension
startDate	startDate	The start date of the campaign in YYYYMMDD format.	dimension
state	state	The current operational status of the advertising entity, such as ‘enabled’, ‘paused’, or ‘archived’.	dimension
storeId	storeId		dimension
storeName	storeName		dimension
storePageInfo	storePageInfo		dimension
storeStatus	storeStatus		dimension
targetingType	targetingType	The type of targeting used for the campaign, such as ‘auto’ or ‘manual’.	dimension
url	url	The URL for an asset. This can be a temporary upload URL for new assets or the direct URL where a processed asset file is stored for use in campaigns.	dimension
width	width	The width of the creative asset, typically measured in pixels. It is used in validating asset dimensions for various ad formats and is part of the asset’s metadata.	metric