REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

string (int64 format)

Required. ID of the channel. Should refer to the channel ID field on a Partner-owned channel or advertiser-owned channel resource.

boolean

Indicates if this option is being negatively targeted. For advertiser level assigned targeting option, this field must be true.

string

Output only. The display name of the app category.

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_APP_CATEGORY.

boolean

Indicates if this option is being negatively targeted.

string

Required. The ID of the app.

Android's Play store app uses bundle ID, for example com.google.android.gm. Apple's App store app ID uses 9 digit string, for example 422689480.

string

Output only. The display name of the app.

boolean

Indicates if this option is being negatively targeted.

enum (AppPlatform)

Indicates the platform of the targeted app. If this field is not specified, the app platform will be assumed to be mobile (i.e., Android or iOS), and we will derive the appropriate mobile platform from the app ID.

string

Required. The URL, for example example.com.

DV360 supports two levels of subdirectory targeting, for example www.example.com/one-subdirectory-level/second-level, and five levels of subdomain targeting, for example five.four.three.two.one.example.com.

boolean

Indicates if this option is being negatively targeted.

enum (DayOfWeek)

Required. The day of the week for this day and time targeting setting.

integer

Required. The start hour for day and time targeting. Must be between 0 (start of day) and 23 (1 hour before end of day).

integer

Required. The end hour for day and time targeting. Must be between 1 (1 hour after start of day) and 24 (end of day).

enum (TimeZoneResolution)

Required. The mechanism used to determine which timezone to use for this day and time targeting setting.

enum (AgeRange)

Required. The age range of an audience. We only support targeting a continuous age range of an audience. Thus, the age range represented in this field can be 1) targeted solely, or, 2) part of a larger continuous age range. The reach of a continuous age range targeting can be expanded by also targeting an audience of an unknown age.

string (int64 format)

Required. ID of the regional location list. Should refer to the locationListId field of a LocationList resource whose type is TARGETING_LOCATION_TYPE_REGIONAL.

boolean

Indicates if this option is being negatively targeted.

string (int64 format)

Required. ID of the proximity location list. Should refer to the locationListId field of a LocationList resource whose type is TARGETING_LOCATION_TYPE_PROXIMITY.

number

Required. Radius expressed in the distance units set in proximityRadiusUnit. This represents the size of the area around a chosen location that will be targeted. Radius should be between 1 and 500 miles or 800 kilometers.

enum (ProximityRadiusUnit)

Required. Radius distance units.

enum (Gender)

Required. The gender of the audience.

enum (VideoPlayerSize)

Required. The video player size.

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_USER_REWARDED_CONTENT.

enum (UserRewardedContent)

Output only. User rewarded content status for video ads.

enum (ParentalStatus)

Required. The parental status of the audience.

enum (ContentInstreamPosition)

Required. The content instream position for video or audio ads.

enum (AdType)

Output only. The ad type to target. Only applicable to insertion order targeting and new line items supporting the specified ad type will inherit this targeting option by default. Possible values are:

• AD_TYPE_VIDEO, the setting will be inherited by new line item when lineItemType is LINE_ITEM_TYPE_VIDEO_DEFAULT.
• AD_TYPE_AUDIO, the setting will be inherited by new line item when lineItemType is LINE_ITEM_TYPE_AUDIO_DEFAULT.

enum (ContentOutstreamPosition)

Required. The content outstream position.

enum (AdType)

Output only. The ad type to target. Only applicable to insertion order targeting and new line items supporting the specified ad type will inherit this targeting option by default. Possible values are:

• AD_TYPE_DISPLAY, the setting will be inherited by new line item when lineItemType is LINE_ITEM_TYPE_DISPLAY_DEFAULT.
• AD_TYPE_VIDEO, the setting will be inherited by new line item when lineItemType is LINE_ITEM_TYPE_VIDEO_DEFAULT.

enum (DeviceType)

Required. The display name of the device type.

number

Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price.

For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0.

Only applicable to YouTube and Partners line items.

object (FirstAndThirdPartyAudienceGroup)

The first and third party audience ids and recencies of included first and third party audience groups. Each first and third party audience group contains first and third party audience ids only. The relation between each first and third party audience group is INTERSECTION, and the result is UNION'ed with other audience groups. Repeated groups with same settings will be ignored.

object (GoogleAudienceGroup)

The Google audience ids of the included Google audience group. Contains Google audience ids only.

object (CustomListGroup)

The custom list ids of the included custom list group. Contains custom list ids only.

object (CombinedAudienceGroup)

The combined audience ids of the included combined audience group. Contains combined audience ids only.

object (FirstAndThirdPartyAudienceGroup)

The first and third party audience ids and recencies of the excluded first and third party audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. All items are logically ‘OR’ of each other.

object (GoogleAudienceGroup)

The Google audience ids of the excluded Google audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. Only contains Affinity, In-market and Installed-apps type Google audiences. All items are logically ‘OR’ of each other.

object (FirstAndThirdPartyAudienceTargetingSetting)

Required. All first and third party audience targeting settings in first and third party audience group. Repeated settings with same id are not allowed.

string (int64 format)

Required. First and third party audience id of the first and third party audience targeting setting. This id is firstAndThirdPartyAudienceId.

enum (Recency)

The recency of the first and third party audience targeting setting. Only applicable to first party audiences, otherwise will be ignored. For more info, refer to https://support.google.com/displayvideo/answer/2949947#recency When unspecified, no recency limit will be used.

object (GoogleAudienceTargetingSetting)

Required. All Google audience targeting settings in Google audience group. Repeated settings with same id will be ignored.

string (int64 format)

Required. Google audience id of the Google audience targeting setting. This id is googleAudienceId.

object (CustomListTargetingSetting)

Required. All custom list targeting settings in custom list group. Repeated settings with same id will be ignored.

string (int64 format)

Required. Custom id of custom list targeting setting. This id is customListId.

object (CombinedAudienceTargetingSetting)

Required. All combined audience targeting settings in combined audience group. Repeated settings with same id will be ignored. The number of combined audience settings should be no more than five, error will be thrown otherwise.

string (int64 format)

Required. Combined audience id of combined audience targeting setting. This id is combinedAudienceId.

string

Output only. The display name of the browser.

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_BROWSER.

boolean

Indicates if this option is being negatively targeted. All assigned browser targeting options on the same resource must have the same value for this field.

enum (HouseholdIncome)

Required. The household income of the audience.

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_ON_SCREEN_POSITION.

enum (OnScreenPosition)

Output only. The on screen position.

enum (AdType)

Output only. The ad type to target. Only applicable to insertion order targeting and new line items supporting the specified ad type will inherit this targeting option by default. Possible values are:

• AD_TYPE_DISPLAY, the setting will be inherited by new line item when lineItemType is LINE_ITEM_TYPE_DISPLAY_DEFAULT.
• AD_TYPE_VIDEO, the setting will be inherited by new line item when lineItemType is LINE_ITEM_TYPE_VIDEO_DEFAULT.

string

Output only. The display name of the carrier or ISP.

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_CARRIER_AND_ISP.

boolean

Indicates if this option is being negatively targeted. All assigned carrier and ISP targeting options on the same resource must have the same value for this field.

string

Required. The keyword, for example car insurance.

Positive keyword cannot be offensive word. Must be UTF-8 encoded with a maximum size of 255 bytes. Maximum number of characters is 80. Maximum number of words is 10.

boolean

Indicates if this option is being negatively targeted.

string (int64 format)

Required. ID of the negative keyword list. Should refer to the negativeKeywordListId field of a NegativeKeywordList resource.

string

Output only. The display name of the operating system.

string

Required. The targeting option ID populated in targetingOptionId field when targetingType is TARGETING_TYPE_OPERATING_SYSTEM.

boolean

Indicates if this option is being negatively targeted.

string

Output only. The display name of the device make and model.

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_DEVICE_MAKE_MODEL.

boolean

Indicates if this option is being negatively targeted.

enum (Environment)

Required. The serving environment.

string (int64 format)

Required. ID of the inventory source. Should refer to the inventorySourceId field of an InventorySource resource.

string

Output only. The display name of the category.

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_CATEGORY.

boolean

Indicates if this option is being negatively targeted.

enum (Viewability)

Required. The predicted viewability percentage.

enum (AuthorizedSellerStatus)

Output only. The authorized seller status to target.

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

string

Output only. The display name of the language (e.g., "French").

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_LANGUAGE.

boolean

Indicates if this option is being negatively targeted. All assigned language targeting options on the same resource must have the same value for this field.

string

Output only. The display name of the geographic region (e.g., "Ontario, Canada").

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_GEO_REGION.

enum (GeoRegionType)

Output only. The type of geographic region targeting.

boolean

Indicates if this option is being negatively targeted.

string (int64 format)

Required. ID of the inventory source group. Should refer to the inventorySourceGroupId field of an InventorySourceGroup resource.

enum (ContentRatingTier)

Required. The display name of the digital content label rating tier to be EXCLUDED.

enum (SensitiveCategory)

Required. An enum for the DV360 Sensitive category content classified to be EXCLUDED.

enum (Exchange)

Required. The enum value for the exchange.

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_SUB_EXCHANGE.

object (Adloox)

Third party brand verifier -- Adloox.

object (DoubleVerify)

Third party brand verifier -- DoubleVerify.

object (IntegralAdScience)

Third party brand verifier -- Integral Ad Science.

enum (AdlooxCategory)

Adloox categories to exclude.

enum (FraudIvtMfaCategory)

Optional. Adloox's fraud IVT MFA categories to exclude.

enum (GarmRiskExclusion)

Optional. Adult and Explicit Sexual Content GARM risk ranges to exclude.

enum (GarmRiskExclusion)

Optional. Crime and Harmful Acts Content GARM risk ranges to exclude.

enum (GarmRiskExclusion)

Optional. Arms and Ammunition Content GARM risk ranges to exclude.

enum (GarmRiskExclusion)

Optional. Death, Injury, or Military Conflict Content GARM risk ranges to exclude.

enum (GarmRiskExclusion)

Optional. Debated Sensitive Social Issue Content GARM risk ranges to exclude.

enum (GarmRiskExclusion)

Optional. Illegal Drugs/Alcohol Content GARM risk ranges to exclude.

enum (GarmRiskExclusion)

Optional. Online Piracy Content GARM risk ranges to exclude.

enum (GarmRiskExclusion)

Optional. Hate Speech and Acts of Aggression Content GARM risk ranges to exclude.

enum (GarmRiskExclusion)

Optional. Obscenity and Profanity Content GARM risk ranges to exclude.

enum (GarmRiskExclusion)

Optional. Spam or Harmful Content GARM risk ranges to exclude.

enum (GarmRiskExclusion)

Optional. Terrorism Content GARM risk ranges to exclude.

enum (GarmRiskExclusion)

Optional. Misinformation Content GARM risk ranges to exclude.

enum (DisplayIabViewability)

Optional. IAB viewability threshold for display ads.

enum (VideoIabViewability)

Optional. IAB viewability threshold for video ads.

object (BrandSafetyCategories)

DV Brand Safety Controls.

enum (AgeRating)

Avoid bidding on apps with the age rating.

object (AppStarRating)

Avoid bidding on apps with the star ratings.

object (DisplayViewability)

Display viewability settings (applicable to display line items only).

object (VideoViewability)

Video viewability settings (applicable to video line items only).

object (FraudInvalidTraffic)

Avoid Sites and Apps with historical Fraud & IVT Rates.

string (int64 format)

The custom segment ID provided by DoubleVerify. The ID must start with "51" and consist of eight digits. Custom segment ID cannot be specified along with any of the following fields:

• brandSafetyCategories
• avoidedAgeRatings
• appStarRating
• fraudInvalidTraffic

boolean

Unknown or unrateable.

enum (HighSeverityCategory)

Brand safety high severity avoidance categories.

enum (MediumSeverityCategory)

Brand safety medium severity avoidance categories.

enum (StarRating)

Avoid bidding on apps with the star ratings.

boolean

Avoid bidding on apps with insufficient star ratings.

enum (IAB)

Target web and app inventory to maximize IAB viewable rate.

enum (ViewableDuring)

Target web and app inventory to maximize 100% viewable duration.

enum (VideoIAB)

Target web inventory to maximize IAB viewable rate.

enum (VideoViewableRate)

Target web inventory to maximize fully viewable rate.

enum (PlayerImpressionRate)

Target inventory to maximize impressions with 400x300 or greater player size.

enum (FraudOption)

Avoid Sites and Apps with historical Fraud & IVT.

boolean

Insufficient Historical Fraud & IVT Stats.

enum (TRAQScore)

True advertising quality (applicable to Display line items only).

boolean

Brand Safety - Unrateable.

enum (Adult)

Brand Safety - Adult content.

enum (Alcohol)

Brand Safety - Alcohol.

enum (IllegalDownloads)

Brand Safety - Illegal downloads.

enum (Drugs)

Brand Safety - Drugs.

enum (HateSpeech)

Brand Safety - Hate speech.

enum (OffensiveLanguage)

Brand Safety - Offensive language.

enum (Violence)

Brand Safety - Violence.

enum (Gambling)

Brand Safety - Gambling.

enum (AdFraudPrevention)

Ad Fraud settings.

enum (DisplayViewability)

Display Viewability section (applicable to display line items only).

enum (VideoViewability)

Video Viewability Section (applicable to video line items only).

string (int64 format)

The custom segment ID provided by Integral Ad Science. The ID must be between 1000001 and 1999999, inclusive.

string

Output only. The display name of a POI, e.g. "Times Square", "Space Needle", followed by its full address if available.

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_POI.

Accepted POI targeting option IDs can be retrieved using targetingTypes.targetingOptions.search.

If targeting a specific latitude/longitude coordinate removed from an address or POI name, you can generate the necessary targeting option ID by rounding the desired coordinate values to the 6th decimal place, removing the decimals, and concatenating the string values separated by a semicolon. For example, you can target the latitude/longitude pair of 40.7414691, -74.003387 using the targeting option ID "40741469;-74003387". Upon creation, this field value will be updated to append a semicolon and alphanumerical hash value if only latitude/longitude coordinates are provided.

number

Output only. Latitude of the POI rounding to 6th decimal place.

number

Output only. Longitude of the POI rounding to 6th decimal place.

number

Required. The radius of the area around the POI that will be targeted. The units of the radius are specified by proximityRadiusUnit. Must be 1 to 800 if unit is DISTANCE_UNIT_KILOMETERS and 1 to 500 if unit is DISTANCE_UNIT_MILES.

enum (DistanceUnit)

Required. The unit of distance by which the targeting radius is measured.

string

Output only. The display name of a business chain, e.g. "KFC", "Chase Bank".

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_BUSINESS_CHAIN.

Accepted business chain targeting option IDs can be retrieved using SearchTargetingOptions.

number

Required. The radius of the area around the business chain that will be targeted. The units of the radius are specified by proximityRadiusUnit. Must be 1 to 800 if unit is DISTANCE_UNIT_KILOMETERS and 1 to 500 if unit is DISTANCE_UNIT_MILES. The minimum increment for both cases is 0.1. Inputs will be rounded to the nearest acceptable value if it is too granular, e.g. 15.57 will become 15.6.

enum (DistanceUnit)

Required. The unit of distance by which the targeting radius is measured.

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_CONTENT_DURATION.

enum (ContentDuration)

Output only. The content duration.

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_CONTENT_STREAM_TYPE.

enum (ContentStreamType)

Output only. The content stream type.

enum (NativeContentPosition)

Required. The content position.

enum (Omid)

Required. The type of Open Measurement enabled inventory.

enum (AudioContentType)

Required. The audio content type.

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_CONTENT_GENRE.

string

Output only. The display name of the content genre.

boolean

Indicates if this option is being negatively targeted.

string

YouTube video id as it appears on the YouTube watch page.

boolean

Indicates if this option is being negatively targeted.

string

The YouTube uploader channel id or the channel code of a YouTube channel.

boolean

Indicates if this option is being negatively targeted.

enum (SessionPosition)

The position where the ad will show in a session.