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	Unique identifier for an ad group within a campaign.	metric
adId	adId	Unique identifier for a product ad.	metric
asin	asin	Amazon Standard Identification Number (ASIN) of a product.	dimension
asinCountRange	asinCountRange	The estimated range of targetable ASINs within a category.	dimension
asinCountRange_max	asinCountRange_max	The maximum number of targetable ASINs within the range.	metric
asinCountRange_min	asinCountRange_min	The minimum number of targetable ASINs within the range.	metric
assetId	assetId	The unique identifier for an asset (e.g., image, video) used in a creative.	dimension
bid	bid	The bid amount set for a keyword or targeting clause.	metric
bidOptimization	bidOptimization	The strategy to optimize bids for specific goals like reach, clicks, or conversions.	dimension
bidding	bidding	The overall bidding strategy and adjustments for a campaign.	dimension
brandEntityId	brandEntityId	The unique identifier for a brand entity.	dimension
brandId	brandId	The unique identifier for a 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
campaignId	campaignId	Unique identifier for an advertising campaign.	metric
categoryRefinementId	categoryRefinementId	The unique identifier for a specific category refinement.	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 when the entity was created.	dimension
creationDate_timestamp	creationDate_timestamp	The timestamp indicating when the entity was created.	dimension
creationTime	creationTime	The timestamp when the creative was created.	metric
creative	creative	An object containing details and properties of the ad creative, such as images, videos, and text.	dimension
creativeId	creativeId	The unique identifier for the ad creative.	metric
creativeProperties_asins	creativeProperties_asins	A list of ASINs associated with the creative properties.	dimension
creativeProperties_brandLogoAssetId	creativeProperties_brandLogoAssetId	The asset ID of the brand logo used in the creative properties.	dimension
creativeProperties_brandLogoCrop	creativeProperties_brandLogoCrop	Cropping coordinates for the brand logo within the creative properties.	dimension
creativeProperties_brandLogoUrl	creativeProperties_brandLogoUrl	The URL of the brand logo used in the creative properties.	dimension
creativeProperties_brandName	creativeProperties_brandName	The brand name displayed in the creative properties.	dimension
creativeProperties_customImageAssetId	creativeProperties_customImageAssetId	The asset ID of the custom image used in the creative properties.	dimension
creativeProperties_customImageCrop	creativeProperties_customImageCrop	Cropping coordinates for the custom image within the creative properties.	dimension
creativeProperties_customImageUrl	creativeProperties_customImageUrl	The URL of the custom image used in the creative properties.	dimension
creativeProperties_customImages	creativeProperties_customImages	A list of custom image assets and their properties used in the creative.	dimension
creativeProperties_headline	creativeProperties_headline	The headline text displayed in the creative properties.	dimension
creativeProperties_landingPage	creativeProperties_landingPage	Details about the landing page destination for the creative properties, including ASINs and URL.	dimension
creativeProperties_originalHeadline	creativeProperties_originalHeadline	The original headline text of the creative properties before any modifications or translations.	dimension
creativeProperties_originalVideoAssetIds	creativeProperties_originalVideoAssetIds	A list of original video asset identifiers associated with the creative properties.	dimension
creativeProperties_subpages	creativeProperties_subpages	Details of subpages associated with the creative properties, typically for Store Spotlight ads.	dimension
creativeProperties_videoAssetIds	creativeProperties_videoAssetIds	A list of video asset identifiers associated with the creative properties.	dimension
creativeStatus	creativeStatus	The moderation status of the ad creative.	dimension
creativeType	creativeType	The type of creative (e.g., image, video, product collection, store spotlight).	dimension
creativeVersion	creativeVersion	The version identifier of the ad creative.	metric
creative_asins	creative_asins	A list of ASINs included in the ad creative.	dimension
creative_brandLogoAssetID	creative_brandLogoAssetID	The asset ID of the brand logo used in the ad creative.	dimension
creative_brandLogoCrop	creative_brandLogoCrop	Cropping coordinates for the brand logo within the ad creative.	dimension
creative_brandLogoUrl	creative_brandLogoUrl	The URL of the brand logo used in the ad creative.	dimension
creative_brandName	creative_brandName	The brand name displayed in the ad creative.	dimension
creative_consentToTranslate	creative_consentToTranslate	Indicates if Amazon is permitted to translate creative elements (e.g., headline, video) into the marketplace’s default language.	dimension
creative_creativeVersion	creative_creativeVersion	The version identifier of the ad creative.	metric
creative_customImageAssetId	creative_customImageAssetId	The asset ID of the custom image used in the ad creative.	dimension
creative_customImageUrl	creative_customImageUrl	The URL of the custom image used in the ad creative.	dimension
creative_customImages	creative_customImages	A list of custom image assets and their properties used in the ad creative.	dimension
creative_headline	creative_headline	The headline text displayed in the ad creative.	dimension
creative_originalHeadline	creative_originalHeadline	The original headline text of the ad creative before any modifications or translations.	dimension
creative_originalVideoAssetIds	creative_originalVideoAssetIds	A list of original video asset identifiers associated with the ad creative.	dimension
creative_subpages	creative_subpages	Details of subpages associated with the ad creative, typically for Store Spotlight ads.	dimension
creative_type	creative_type	The specific type of the ad creative within the creative object (e.g., Product Collection).	dimension
creative_videoAssetIds	creative_videoAssetIds	A list of video asset identifiers associated with the ad creative.	dimension
defaultBid	defaultBid	The default bid amount for an ad group, used if no specific bid is set.	metric
dynamicBidding_placementBidding	dynamicBidding_placementBidding	Adjustments to bids based on ad placement (e.g., top of search, product page).	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.	metric
entityId	entityId	A generic identifier for an entity, such as an account, store, or ad group.	dimension
expression	expression	The targeting expression used to define the target audience or product.	dimension
expressionType	expressionType	The type of targeting expression, either manual or auto.	dimension
expression_type	expression_type	The specific type of the targeting expression component (e.g., ASIN_BRAND_SAME_AS, similarProduct).	dimension
expression_value	expression_value	The value associated with a specific component of the targeting expression.	dimension
expressions	expressions	A list of targeting expressions.	dimension
extendedData_creationDate	extendedData_creationDate	The creation date of the entity, available in extended data.	metric
extendedData_creationDateTime	extendedData_creationDateTime	The date and time when the entity was created, available in extended data.	dimension
extendedData_lastUpdateDate	extendedData_lastUpdateDate	The last update date of the entity, available in extended data.	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 specific objective or goal set for the campaign (e.g., brand awareness, page visits).	dimension
isTargetable	isTargetable	Indicates whether a category or entity can be targeted by ads.	dimension
keywordId	keywordId	Unique identifier for a keyword.	metric
keywordText	keywordText	The text of the keyword used for targeting.	dimension
kpi	kpi		dimension
landingPage	landingPage	Object containing details about the landing page where customers are directed after clicking an ad.	dimension
landingPage_pageType	landingPage_pageType	The type of landing page (e.g., Product List, Store).	dimension
landingPage_url	landingPage_url	The URL of the landing page.	dimension
lastUpdateDate	lastUpdateDate	The date when the entity was last updated.	dimension
lastUpdatedDate	lastUpdatedDate	The date when the entity was last updated.	dimension
matchType	matchType	The keyword match type (e.g., broad, exact, phrase, negative).	dimension
moderationStatus	moderationStatus	The status of the creative after the moderation review process.	dimension
name	name	The name of the entity.	dimension
parentCategoryRefinementId	parentCategoryRefinementId	The identifier of the parent category refinement.	metric
portfolioId	portfolioId	Unique identifier for the portfolio to which the campaign belongs.	metric
profile	profile	Represents an advertiser and their account’s marketplace, used to scope API calls.	metric
resolvedExpression	resolvedExpression	The resolved targeting expression, providing a more detailed or canonical representation.	dimension
resolvedExpression_type	resolvedExpression_type	The specific type of the resolved targeting expression component.	dimension
resolvedExpression_value	resolvedExpression_value	The value associated with a specific component of the resolved targeting expression.	dimension
resolvedExpressions	resolvedExpressions	A list of resolved targeting expressions.	dimension
servingStatus	servingStatus	The current serving status of the ad, ad group, or campaign.	dimension
sku	sku	Stock Keeping Unit (SKU) of a product, used for seller accounts.	dimension
startDate	startDate	The start date of the campaign in YYYYMMDD format.	dimension
state	state	The current state of the entity (e.g., enabled, paused, archived).	dimension
targetId	targetId	Unique identifier for a targeting clause.	metric
targetingType	targetingType	The type of targeting used for the campaign, such as ‘auto’ or ‘manual’.	dimension
url	url	A URL associated with an ad, such as a landing page, brand logo, or custom image URL.	dimension