REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

string ( int64 format)

Обязательно. Идентификатор канала. Должен ссылаться на поле идентификатора канала на канале, принадлежащем партнёру или рекламодателю .

boolean

Указывает, используется ли для этого параметра отрицательный таргетинг. Для параметра таргетинга, назначенного на уровне рекламодателя, это поле должно иметь значение true.

string

Только вывод. Отображаемое имя категории приложения.

string

Обязательно. Поле targetingOptionId , если targetingType — TARGETING_TYPE_APP_CATEGORY .

boolean

Указывает, направлен ли этот параметр негативно.

string

Обязательно. Идентификатор приложения.

Приложение Play Store для Android использует идентификатор пакета, например, com.google.android.gm . Идентификатор приложения App Store для Apple использует 9-значную строку, например, 422689480 .

string

Только вывод. Отображаемое имя приложения.

boolean

Указывает, направлен ли этот параметр негативно.

enum ( AppPlatform )

Указывает платформу целевого приложения. Если это поле не указано, будет считаться, что платформа приложения мобильная (например, Android или iOS), и мы определим соответствующую мобильную платформу по идентификатору приложения.

string

Обязательно. URL-адрес, например example.com .

DV360 поддерживает два уровня таргетинга подкаталогов, например www.example.com/one-subdirectory-level/second-level , и пять уровней таргетинга поддоменов, например five.four.three.two.one.example.com .

boolean

Указывает, направлен ли этот параметр негативно.

enum ( DayOfWeek )

Обязательно. День недели для этого дня и времени настройки таргетинга.

integer

Обязательно. Начальный час для таргетинга по времени и дню. Должен быть в диапазоне от 0 (начало дня) до 23 (за 1 час до конца дня).

integer

Обязательно. Час окончания для таргетинга по времени суток. Должен быть в диапазоне от 1 (1 час после начала дня) до 24 (конец дня).

enum ( TimeZoneResolution )

Обязательно. Механизм, используемый для определения часового пояса, используемого для настройки таргетинга на этот день и время.

enum ( AgeRange )

Обязательно. Возрастной диапазон аудитории. Мы поддерживаем таргетинг только на непрерывный возрастной диапазон аудитории. Таким образом, представленный в этом поле возрастной диапазон может быть 1) выбран исключительно в качестве таргетинга или 2) частью более широкого непрерывного возрастного диапазона. Охват непрерывного возрастного диапазона можно расширить, настроив таргетинг на аудиторию неизвестного возраста.

string ( int64 format)

Обязательно. Идентификатор списка региональных местоположений. Должен ссылаться на поле locationListId ресурса LocationList типа TARGETING_LOCATION_TYPE_REGIONAL .

boolean

Указывает, направлен ли этот параметр негативно.

string ( int64 format)

Обязательно. Идентификатор списка местоположений с ближайшими пунктами назначения. Должен ссылаться на поле locationListId ресурса LocationList типа TARGETING_LOCATION_TYPE_PROXIMITY .

number

Обязательно. Радиус указывается в единицах измерения расстояния, заданных в параметре proximityRadiusUnit . Он представляет собой размер области вокруг выбранного местоположения, которая будет использоваться в качестве цели. Радиус должен быть в диапазоне от 1 до 500 миль (800 километров).

enum ( ProximityRadiusUnit )

Обязательно. Единицы измерения радиуса и расстояния.

enum ( Gender )

Обязательно. Пол аудитории.

enum ( VideoPlayerSize )

Обязательно. Размер видеоплеера.

string

Обязательно. Поле targetingOptionId , если targetingType — TARGETING_TYPE_USER_REWARDED_CONTENT .

enum ( UserRewardedContent )

Только вывод. Статус контента, вознаграждаемого пользователем, для видеорекламы.

enum ( ParentalStatus )

Обязательно. Родительский статус аудитории.

enum ( ContentInstreamPosition )

Обязательно. Позиция контента в потоке для видео- или аудиорекламы.

enum ( AdType )

Только вывод. Тип таргетингового объявления. Применимо только к таргетингу заказа на размещение, и новые позиции, поддерживающие указанный тип объявления, наследуют этот параметр таргетинга по умолчанию. Возможные значения:

• AD_TYPE_VIDEO — настройка будет унаследована новой позицией, если lineItemType равен LINE_ITEM_TYPE_VIDEO_DEFAULT .
• AD_TYPE_AUDIO — настройка будет унаследована новой позицией строки, если lineItemType равен LINE_ITEM_TYPE_AUDIO_DEFAULT .

enum ( ContentOutstreamPosition )

Обязательно. Позиция контента в потоке.

enum ( AdType )

Только вывод. Тип таргетингового объявления. Применимо только к таргетингу заказа на размещение, и новые позиции, поддерживающие указанный тип объявления, наследуют этот параметр таргетинга по умолчанию. Возможные значения:

• AD_TYPE_DISPLAY — настройка будет унаследована новой позицией строки, если lineItemType равен LINE_ITEM_TYPE_DISPLAY_DEFAULT .
• AD_TYPE_VIDEO — настройка будет унаследована новой позицией, если lineItemType равен LINE_ITEM_TYPE_VIDEO_DEFAULT .

enum ( DeviceType )

Обязательно. Отображаемое имя типа устройства.

number

Только вывод. Множитель ставки позволяет показывать рекламу чаще или реже в зависимости от типа устройства. Он применяет множитель к исходной цене ставки. Значение в этом поле равно 0, что означает, что это поле не применяется, а исходная цена ставки умножается на 0.

Например, если цена предложения без множителя составляет 10,0 долл. США, а множитель для планшета равен 1,5, то результирующая цена предложения для планшета составит 15,0 долл. США.

Применимо только к позициям YouTube и партнеров.

object ( GoogleAudienceGroup )

Необязательно. Идентификаторы аудитории Google для включённой группы аудитории Google. Содержит только идентификаторы аудитории Google.

object ( CustomListGroup )

Необязательно. Идентификаторы пользовательских списков включённой группы пользовательских списков. Содержит только идентификаторы пользовательских списков.

object ( CombinedAudienceGroup )

Необязательно. Идентификаторы объединённой аудитории включённой группы объединённой аудитории. Содержит только идентификаторы объединённой аудитории.

object ( GoogleAudienceGroup )

Необязательно. Идентификаторы аудитории Google для исключенной группы аудитории. Используется для негативного таргетинга. ДОПОЛНЕНИЕ к ОБЪЕДИНЕНИЮ этой группы и других исключенных групп аудитории используется как ПЕРЕСЕЧЕНИЕ для любого позитивного таргетинга аудитории. Содержит только аудитории Google типа «по интересам», «на рынке» и «установленные приложения». Все элементы логически связаны оператором «ИЛИ».

object ( FirstPartyAndPartnerAudienceGroup )

Необязательно. Идентификаторы основной и партнёрской аудитории, а также давность посещения включённых групп основной и партнёрской аудитории. Каждая группа основной и партнёрской аудитории содержит только идентификаторы основной и партнёрской аудитории. Связь между каждой группой основной и партнёрской аудитории — ПЕРЕСЕЧЕНИЕ, а результат — ОБЪЕДИНЕНИЕ с другими группами аудитории. Повторяющиеся группы с одинаковыми настройками будут игнорироваться.

object ( FirstPartyAndPartnerAudienceGroup )

Необязательно. Идентификаторы основной и партнёрской аудитории, а также давность исключённой основной и партнёрской аудитории. Используется для негативного таргетинга. ДОПОЛНЕНИЕ к ОБЪЕДИНЕНИЮ этой группы и других исключённых аудиторий используется как ПЕРЕСЕЧЕНИЕ для любого позитивного таргетинга аудитории. Все элементы логически связаны оператором «ИЛИ».

object ( GoogleAudienceTargetingSetting )

Обязательно. Все настройки таргетинга аудитории Google в группе аудитории Google. Повторяющиеся настройки с одинаковым идентификатором будут игнорироваться.

string ( int64 format)

Обязательно. Идентификатор аудитории Google для настройки таргетинга аудитории Google. Этот идентификатор — googleAudienceId .

object ( CustomListTargetingSetting )

Обязательно. Все настройки таргетинга на основе пользовательских списков в группе пользовательских списков. Повторяющиеся настройки с одинаковым идентификатором будут игнорироваться.

string ( int64 format)

Обязательно. Пользовательский идентификатор настройки таргетинга на основе пользовательского списка. Этот идентификатор — customListId .

object ( CombinedAudienceTargetingSetting )

Обязательно. Все настройки таргетинга комбинированной аудитории в группе комбинированной аудитории. Повторяющиеся настройки с одинаковым идентификатором будут игнорироваться. Количество настроек комбинированной аудитории не должно превышать пяти, в противном случае возникнет ошибка.

string ( int64 format)

Обязательно. Идентификатор комбинированной аудитории для настройки таргетинга на комбинированную аудиторию. Этот идентификатор — combinedAudienceId .

object ( FirstPartyAndPartnerAudienceTargetingSetting )

Обязательно. Все настройки таргетинга на собственную аудиторию и аудиторию партнёров в группе собственной аудитории и аудитории партнёров. Повторные настройки с одинаковым идентификатором не допускаются.

string ( int64 format)

Обязательно. Идентификатор основной аудитории и аудитории партнёров для настройки таргетинга на основную аудиторию и аудиторию партнёров. Этот идентификатор — firstPartyAndPartnerAudienceId .

enum ( Recency )

Обязательно. Укажите давность таргетинга на собственную аудиторию и аудиторию партнёра. Применимо только к собственной аудитории, в противном случае будет проигнорировано. Подробнее см. на странице https://support.google.com/displayvideo/answer/2949947#recency . Если не указано иное, ограничение давности не применяется.

string

Только вывод. Отображаемое имя браузера.

string

Обязательно. targetingOptionId для TargetingOption типа TARGETING_TYPE_BROWSER .

boolean

Указывает, используется ли для этого параметра негативное таргетинг. Все назначенные параметры таргетинга браузера на одном ресурсе должны иметь одинаковое значение этого поля.

enum ( HouseholdIncome )

Обязательно. Семейный доход аудитории.

string

Обязательно. Поле targetingOptionId , если targetingType — TARGETING_TYPE_ON_SCREEN_POSITION .

enum ( OnScreenPosition )

Только вывод. Положение на экране.

enum ( AdType )

Только вывод. Тип таргетингового объявления. Применимо только к таргетингу заказа на размещение, и новые позиции, поддерживающие указанный тип объявления, наследуют этот параметр таргетинга по умолчанию. Возможные значения:

• AD_TYPE_DISPLAY — настройка будет унаследована новой позицией строки, если lineItemType равен LINE_ITEM_TYPE_DISPLAY_DEFAULT .
• AD_TYPE_VIDEO — настройка будет унаследована новой позицией, если lineItemType равен LINE_ITEM_TYPE_VIDEO_DEFAULT .

string

Только вывод. Отображаемое имя оператора связи или интернет-провайдера.

string

Обязательно. targetingOptionId для TargetingOption типа TARGETING_TYPE_CARRIER_AND_ISP .

boolean

Указывает, используется ли для этого параметра негативное таргетинг. Все назначенные параметры таргетинга на операторов связи и интернет-провайдеров для одного ресурса должны иметь одинаковое значение этого поля.

string

Обязательно. Ключевое слово, например, car insurance .

Положительное ключевое слово не может быть оскорбительным. Должно быть в кодировке UTF-8 и иметь максимальный размер 255 байт. Максимальное количество символов — 80. Максимальное количество слов — 10.

boolean

Указывает, направлен ли этот параметр негативно.

string ( int64 format)

Обязательно. Идентификатор списка минус-слов. Должен ссылаться на поле negativeKeywordListId ресурса NegativeKeywordList .

string

Только вывод. Отображаемое имя операционной системы.

string

Обязательно. Идентификатор параметра таргетинга указывается в поле targetingOptionId если targetingType — TARGETING_TYPE_OPERATING_SYSTEM .

boolean

Указывает, направлен ли этот параметр негативно.

string

Только вывод. Отображаемое название марки и модели устройства.

string

Обязательно. Поле targetingOptionId , если targetingType — TARGETING_TYPE_DEVICE_MAKE_MODEL .

boolean

Указывает, направлен ли этот параметр негативно.

enum ( Environment )

Обязательно. Среда обслуживания.

string ( int64 format)

Обязательно. Идентификатор источника инвентаря. Должен ссылаться на поле inventorySourceId ресурса InventorySource .

string

Только вывод. Отображаемое имя категории.

string

Обязательно. Поле targetingOptionId , если targetingType — TARGETING_TYPE_CATEGORY .

boolean

Указывает, направлен ли этот параметр негативно.

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 (eg, "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 (eg, "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.

string

Required. ID of the content theme to be EXCLUDED.

enum ( ContentTheme )

Output only. An enum for the DV360 content theme classifier.

enum ( ContentTheme )

Required. An enum for the DV360 content theme 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 -- Scope3 (previously known as Adloox).

object ( DoubleVerify )

Third party brand verifier -- DoubleVerify.

object ( IntegralAdScience )

Third party brand verifier -- Integral Ad Science.

enum ( AdlooxCategory )

Scope3 categories to exclude.

enum ( FraudIvtMfaCategory )

Optional. Scope3'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 or 3000001 and 3999999 , inclusive.

string ( int64 format)

Optional. The quality sync custom segment ID provided by Integral Ad Science. The ID must be between 3000000 and 4999999 , inclusive.

string

Output only. The display name of a POI, eg "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, eg "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, eg 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.