Starting
September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our
deprecations page for more details on how to update your integration to make this declaration.
TargetingExpansionConfig
Stay organized with collections
Save and categorize content based on your preferences.
| JSON representation |
{
"enableOptimizedTargeting": boolean,
"audienceExpansionSeedListExcluded": boolean,
"audienceExpansionLevel": enum (AudienceExpansionLevel)
} |
| Fields |
enableOptimizedTargeting |
boolean
Required. Whether to enable Optimized Targeting for the line item. Optimized targeting is not compatible with all bid strategies. Attempting to set this field to true for a line item using the BiddingStrategy field fixedBid or one of the following combinations of BiddingStrategy fields and BiddingStrategyPerformanceGoalType will result in an error: maximize_auto_spend_bid:
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVABIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TENBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED performanceGoalAutoBid:
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM
|
audienceExpansionSeedListExcluded |
boolean
Output only. Whether to exclude seed list for audience expansion. This field only applies to YouTube and Partners line item and ad group resources.
|
audienceExpansionLevel |
enum (AudienceExpansionLevel)
Output only. Magnitude of expansion for eligible first-party user lists under this ad group. This field only applies to YouTube and Partners line item and ad group resources.
|
AudienceExpansionLevel
Qualitative description of audience expansion level.
| Enums |
UNKNOWN |
Audience expansion level is not specified or is unknown in this version. |
NO_REACH |
Audience expansion off. |
LEAST_REACH |
Conservative audience expansion. |
MID_REACH |
Moderate audience expansion. |
MOST_REACH |
Aggressive audience expansion. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-27 UTC.
[null,null,["Last updated 2025-03-27 UTC."],[],["The Display & Video 360 API v4, in beta, defines settings for optimized targeting. Key configurations include `enableOptimizedTargeting` (a boolean to activate this feature, but incompatible with certain bid strategies, and it will be incompatible with fixedBid after March 6, 2025), `audienceExpansionSeedListExcluded` (a boolean to exclude seed lists for YouTube and partners), and `audienceExpansionLevel` (an enum controlling expansion magnitude with levels from `NO_REACH` to `MOST_REACH`, also for YouTube and partners).\n"],null,["# TargetingExpansionConfig\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [AudienceExpansionLevel](#AudienceExpansionLevel)\n\nSettings that control the [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"enableOptimizedTargeting\": boolean, \"audienceExpansionSeedListExcluded\": boolean, \"audienceExpansionLevel\": enum (/display-video/api/reference/rest/v4/TargetingExpansionConfig#AudienceExpansionLevel) } ``` |\n\n| Fields ||\n|-------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `enableOptimizedTargeting` | `boolean` Required. Whether to enable Optimized Targeting for the line item. Optimized targeting is not compatible with all bid strategies. Attempting to set this field to `true` for a line item using the [BiddingStrategy](/display-video/api/reference/rest/v4/BiddingStrategy) field [fixedBid](/display-video/api/reference/rest/v4/BiddingStrategy#FIELDS.fixed_bid) or one of the following combinations of [BiddingStrategy](/display-video/api/reference/rest/v4/BiddingStrategy) fields and [BiddingStrategyPerformanceGoalType](/display-video/api/reference/rest/v4/BiddingStrategy#BiddingStrategyPerformanceGoalType) will result in an error: [maximize_auto_spend_bid](/display-video/api/reference/rest/v4/BiddingStrategy#FIELDS.maximize_spend_auto_bid): - `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` - `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN` - `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` [performanceGoalAutoBid](/display-video/api/reference/rest/v4/BiddingStrategy#FIELDS.performance_goal_auto_bid): - `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` |\n| `audienceExpansionSeedListExcluded` | `boolean` Output only. Whether to exclude seed list for audience expansion. This field only applies to YouTube and Partners line item and ad group resources. |\n| `audienceExpansionLevel` | `enum (`[AudienceExpansionLevel](/display-video/api/reference/rest/v4/TargetingExpansionConfig#AudienceExpansionLevel)`)` Output only. Magnitude of expansion for eligible first-party user lists under this ad group. This field only applies to YouTube and Partners line item and ad group resources. |\n\nAudienceExpansionLevel\n----------------------\n\nQualitative description of audience expansion level.\n\n| Enums ||\n|---------------|--------------------------------------------------------------------------|\n| `UNKNOWN` | Audience expansion level is not specified or is unknown in this version. |\n| `NO_REACH` | Audience expansion off. |\n| `LEAST_REACH` | Conservative audience expansion. |\n| `MID_REACH` | Moderate audience expansion. |\n| `MOST_REACH` | Aggressive audience expansion. |"]]
