Amazon DSP Metadata: Most-used fields

Accessible names that are labels given to HTML elements for assistive technologies like screen readers.

The position where the AdChoices icon is displayed on the ad creative, e.g., 'BOTTOM_LEFT', 'TOP_RIGHT'.

A list of categories that describe the content or nature of the ad creative.

The ad copy details, including its type and value, used in the creative.

The type of ad copy, such as 'BODY' for the main text content.

The actual text content of the ad copy.

The format type of the ad creative, e.g., 'DISPLAY', 'VIDEO', 'AUDIO', 'THIRD_PARTY', or 'COMPONENT'.

Additional attributes and settings specific to the ad creative's format.

A flag that indicates whether Cost-Based Campaigns (CBC) are permitted to drive traffic to video content within the ad creative.

Indicates whether third-party sellers are allowed for the ad creative.

Specifies the retail formats permitted for the ad creative.

The content type of the ad creative.

The optimization goal set for the ad creative, influencing how it is delivered for performance.

Additional attributes related to how the ad creative is rendered to optimize its display.

Specifies the intended placements for the ad creative, such as above or below the fold, or in-feed.

A collection of assets, such as images or videos, used in the ad creative.

Indicates whether a border should be applied to the creative asset.

The coordinates used to define how an asset (like an image) within the ad creative should be cropped.

The unique identifier of the asset used in the ad creative.

The type of creative asset, such as 'IMAGE' or 'VIDEO'.

The version of the asset.

The ad experience associated with the asset.

The URL of the asset used in the ad creative.

Defines the actions that occur when the ad creative is clicked.

The ad experience associated with the click action.

The type of action performed on click, e.g., navigating to a URL.

Describes the properties of the end card displayed as part of the ad creative's click actions, typically appearing at the conclusion of an interactive ad experience.

Describes the properties of interactive panels or sections within the ad creative that respond to user clicks, defining their behavior and content.

The position of an AdChoices icon or other clickable elements on the ad creative. For instance, 'TOP_RIGHT' indicates the AdChoices icon is displayed in the top right corner of the ad.

The URL to which the user is directed when the ad is clicked.

The dimensions and responsiveness settings for the ad creative.

The height of the creative size in pixels.

Indicates whether the creative size is responsive.

The width of the creative size in pixels.

Contains properties related to interactive elements within the ad creative, enabling user engagement beyond simple clicks.

Specifies the type of interactive experience offered by the ad creative, such as polls, quizzes, or expandable content.

Indicates the placement or coordinates of the interactive element within the ad creative's display area.

The URL where the user is directed upon interacting with the interactive element of the ad creative.

Configures settings for optimizing the ad creative's performance, such as dynamic creative optimization rules or asset rotation strategies.

A boolean flag indicating whether render optimizations are enabled for the ad creative, influencing how the creative is displayed for improved performance.

A list of products associated with the ad creative, including their details.

The unique identifier of the product associated with the ad creative.

The title of the product associated with the ad creative.

The type of product, e.g., 'ASIN'.

The review text for the product associated with the ad creative.

The URL for the product review associated with the ad creative.

Settings that define whether an ad creative can be skipped by the viewer.

The specific type of skippability for an ad creative, defining if and how a user can skip the ad.

Details for third-party ad tags used in the creative.

Indicates whether the third-party tag links to an Amazon site (AMAZON) or an external site (OTHER).

The URL or content of the third-party creative tag, such as a VAST tag URL.

The type of third-party tag used in the ad creative, for example, VAST_VPAID.

A list of tracking URLs used for monitoring ad performance.

The ad experience associated with the tracking URL.

The type of tracking URL, such as 'CLICK' for click-through tracking.

The URL used for tracking ad events.

Universal identifiers associated with the ad creative, used for consistent identification across various platforms and systems.

The unique identifier for the ad creative.

The name of the ad creative.

A collection of ad experiences, representing rendered views of a creative for specific contexts.

The specific ad experience, representing a rendered view of the creative.

The moderation status of the ad experience association.

The unique identifier for the ad group.

The advertising product associated with the entity, e.g., 'AMAZON_DSP'.

Additional HTML content to be added to the creative for surveys or other supplemental purposes.

A list of identifiers for the product categories being advertised in the campaign, used to determine inventory eligibility.

The unique identifier for the advertiser account.

The ideal amount, expressed in the campaign's currency, that you aim to pay per thousand impressions for your ad inventory.

The currency code used for the bid amount at the ad group level.

The maximum average Cost Per Mille (CPM) that the system optimizes towards for ad delivery over the campaign duration.

A unique identifier for the brand associated with the campaign or advertiser account.

The numerical value representing the budget allocated for a campaign flight or ad group.

Container for budget limitation settings applied to a campaign or ad group, including amount, currency, and recurrence.

The numerical value of the budget cap, which sets a daily or monthly spending limit for a campaign or ad group.

The currency code for the budget cap amount.

The time period for which the budget cap recurs, such as daily or monthly.

A unique identifier for the Amazon DSP campaign.

The country associated with the campaign or creative, in ISO 3166-1 alpha-2 format.

The date and time when the entity was created.

The date when the campaign, ad group, or creative was initially created.

The date and time when the entity was created.

The overall moderation status of the creative association.

Determines how creatives are rotated within an ad group, such as randomly or weighted.

The currency used for the advertiser's account or campaign.

The current status of the campaign or ad group's delivery, for example, 'ACTIVE', 'PAUSED', or 'ENABLED'.

The end date of the association or flight.

The date and time when the campaign or flight is scheduled to end.

Fees represent various charges associated with advertising campaigns on Amazon DSP, including agency fees, Amazon audience fees, demand-side fees, third-party service fees, and managed services fees. These can be percentage-based or flat rates applied to the total budget.

The monetary amount of a specific fee that is added to the total budget spent for an ad group.

The currency code in which the fees are expressed.

The type of fee applied, such as Amazon audience fees or third-party fees.

The monetary value associated with a specific fee.

The type of value used for the fee, such as a percentage or a flat amount.

The third-party provider associated with a specific fee.

Defines the schedule for a campaign's delivery, including start and end dates, and associated budget.

The budget allocated for a specific flight within a campaign.

The currency code (e.g., 'USD', 'EUR') for the budget associated with a campaign flight.

The end date of a specific flight within a campaign.

The end date and time of a specific flight within a campaign.

A unique identifier for a specific flight within a campaign.

The name or identifier for a specific flight period within a campaign.

The start date of a specific flight within a campaign.

The start date and time of a specific flight within a campaign.

frequencyType defines how frequency capping is applied to an ad campaign or ad group. It indicates whether there is a limit on the number of times an ad is shown to a user or household (capped) or if there is no such limit (uncapped).

The type of frequency cap applied, such as uncapped or custom.

The maximum number of times an ad impression will be served to a single user within the defined time unit.

The unit of time used for frequency capping, such as days or hours.

The number of time units for the frequency cap.

Indicates whether the ad creative is hosted by Amazon or a third party.

The type of inventory where ads will be served, such as Display, Streaming TV, or Online Video.

The language used in the creative, in ISO_639-1 standard.

The date and time when the entity was last updated.

The date and time when the entity was last updated.

The identifier of the Amazon marketplace where the campaign is running (e.g., ATVPDKIKX0DER for Amazon.com).

The name of the campaign, ad group, or creative.

Indicates whether bid allocation is automatically managed by Amazon DSP to optimize campaign performance.

Indicates whether budget allocation is automatically managed by Amazon DSP to optimize campaign performance.

The strategy employed for bidding within the campaign to achieve specific advertising goals.

This setting defines how any leftover budget from completed flights is handled, such as rolling over to the next flight or not.

rolloverStrategy specifies how any unused budget from a completed flight is handled and allocated to subsequent flights within a campaign. Available strategies include not rolling over unused budget, rolling over unused budget from the most recently completed flight, or rolling over cumulative unused budget from all previous flights.

The currency code used for the goal setting of the campaign.

The primary objective or goal set for the campaign (e.g., driving sales, increasing brand awareness).

The Key Performance Indicator (KPI) used to measure the success of the campaign's goal.

The target Key Performance Indicator (KPI) value set for campaign optimization.

The main types of inventory (e.g., display, video, audio) prioritized for campaign optimization.

A deprecated field that previously allowed advertisers to increase ad delivery aggressiveness under 'Even' pacing, but is now ignored in ad delivery and replaced by Dynamic Catchup.

Determines how the system distributes budget and delivers impressions over the duration of the ad group's flight, with options like evenly, front-loaded, or ASAP.

The identifier of the profile associated with the advertiser account.

The start date of the association or flight.

The date and time when the campaign or flight is scheduled to start.

The current state of the entity, e.g., 'ACTIVE', 'PAUSED', 'ENABLED'.

Targeting settings related to the initiation of an ad.

The specific type of target related to the initiation of an ad, used to define when or how an ad should start playing or displaying.

Specifies the type of video ad initiation for targeting purposes, such as pre-roll, mid-roll, or post-roll.

Targeting settings based on the size of the ad player.

The size of the ad player for targeting purposes.

The type of targeting, specifically for ad player size.

Targeting settings related to specific mobile applications.

Defines targets based on specific audiences, which can be Amazon-created, custom-built, or from a third-party data provider.

The operator used to join audience groups, such as ALL (AND logic).

The unique identifier for an audience in audience targeting.

The group ID for an audience within audience targeting.

The operator used to join audiences within a group, such as ANY (OR logic) or ALL (AND logic).

The type of audience target, specifically AUDIENCE.

Configuration for automatically generated targeting expressions for an ad group.

The match type for auto-targeting, such as 'KEYWORDS_CLOSE_MATCH'.

The type of auto-targeting applied, often represented as 'THEME' for automatically generated targets.

Targeting settings based on the genre of the content.

Defines targeting for ads placed within video content streams (in-stream), specifying criteria for their position relative to the main video content.

Defines targeting for ads placed outside of video content streams (out-stream), specifying criteria for their position within general web content.

This field specifies the type of targeting applied to the content outstream position. Content outstream position targeting allows advertisers to control where their ads appear within video content outside of a video player, for instance, in articles or interstitial spaces.

Specifies content rating criteria for targeting, allowing ads to appear on or avoid content based on its rating.

Targeting settings based on specific days of the week and times of the day.

The specific day of the week included in the day part targeting for the ad group.

The specific hour slot included in the day part targeting for the ad group.

The type of day part target being applied.

Targeting settings based on device types or operating systems.

Defines targets based on specific site domains for inclusion or exclusion.

Details for domain-based targeting, including specific domain names for inclusion or exclusion.

The type of domain targeting being applied, which is 'DOMAIN'.

Targets ads based on Interactive Advertising Bureau (IAB) content categories, which classify the content of web pages.

Targeting that specifies the inventory sources or exchanges where ads should be shown. By default, all eligible inventory sources are included.

The unique identifier for an inventory source used in targeting, defining where ad placements are sourced.

The type or category of the inventory source used in targeting, such as an ad exchange or a specific publisher.

The specific type of targeting applied to an inventory source, categorizing the nature of the inventory being included or excluded.

Targeting settings based on specific keywords.

This field specifies geographical targeting criteria, allowing advertisers to reach audiences in particular countries, states, postal codes, Designated Market Areas (DMAs), or cities.

This field defines targeting based on the position of an ad within native content, influencing where ads appear in a native advertising context.

Targets ads based on their on-screen position, such as above or below the fold.

A type of contextual targeting using ASIN categories.

A specific Amazon Standard Identification Number (ASIN) category or browse node used for contextual targeting. This allows advertisers to target ads based on Amazon's retail product taxonomy.

The type of targeting being applied to the ad group. When using product category targeting, this field indicates that the ad group is targeting a product category.

This field specifies targeting criteria based on specific Amazon products (ASINs) or product categories (Browse Nodes), allowing ads to be shown alongside or in relation to particular product content.

The Amazon Standard Identification Number (ASIN) of the product to be targeted in Amazon DSP campaigns. Advertisers use ASINs to precisely target individual products for ad delivery.

This field specifies the matching criteria for product targeting, defining whether the ad targets the exact ASIN specified or also includes similar products like substitutes or complements.

This field indicates the specific type of targeting being used within the targetDetails object. For product targeting, its value would identify the target as product-based, differentiating it from other target types like audience or location.

Targeting based on segments provided by third-party data vendors.

The specific type of third-party target being used.

Specific details for the third-party target segment.

Defines targets based on video ad formats.

The type of targeting, specifically for video ad format.

The specific video ad format for targeting purposes.

This field represents the unique identifier assigned to a specific target within the Amazon DSP API, used for managing (creating, reading, updating, or deleting) targeting configurations.

Indicates whether to include impressions that cannot be measured for viewability.

The Amazon viewability tier used for targeting.

The automated targeting tactic applied, such as remarketing, to optimize ad delivery.

The default match type applied to audience targeting within an ad group, such as 'EXACT' match.

A boolean indicator to enable or disable language-based targeting for an ad group.

The criteria used to exclude audiences based on past purchases, varying by tactic and conversion type.

Specifies the time zone used for ad group delivery, such as the viewer's time zone or the advertiser's region.

The geographical location type of users targeted by the ad group.

The type of signal utilized to determine the user's geographical location for targeting purposes.

The video completion tier specifies a targeting setting for video ads, indicating the minimum percentage of video playback that needs to be completed for an impression to count.

Indicates whether the campaign or ad group targets specific Amazon advertising deals, such as programmatic guaranteed deals, to place ads through the Amazon DSP platform.

The timezone associated with the advertiser account or for reporting purposes.

The URL associated with the advertiser's website or the ad creative's click-through destination.