REST Resource: advertisers.lineItems

Ресурс: LineItem

Одна строка.

JSON-представление 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
Поля
name

string

Только вывод. Имя ресурса позиции.

advertiserId

string ( int64 format)

Только вывод. Уникальный идентификатор рекламодателя, которому принадлежит позиция.

campaignId

string ( int64 format)

Только вывод. Уникальный идентификатор кампании, к которой принадлежит позиция.

insertionOrderId

string ( int64 format)

Обязательно. Неизменяемо. Уникальный идентификатор заказа на размещение, к которому принадлежит позиция.

lineItemId

string ( int64 format)

Только вывод. Уникальный идентификатор позиции. Назначается системой.

displayName

string

Обязательно. Отображаемое имя позиции.

Должен быть в кодировке UTF-8 с максимальным размером 240 байт.

lineItemType

enum ( LineItemType )

Обязательно. Неизменяемо. Тип позиции.

entityStatus

enum ( EntityStatus )

Обязательно. Определяет, может ли позиция расходовать свой бюджет и делать ставки на инвентарь.

  • Для метода lineItems.create допускается только ENTITY_STATUS_DRAFT . Чтобы активировать позицию, используйте метод lineItems.patch и обновите её статус до ENTITY_STATUS_ACTIVE после создания.
  • Статус позиции нельзя изменить обратно на ENTITY_STATUS_DRAFT из любого другого статуса.
  • Если родительский заказ на размещение позиции не активен, позиция не может расходовать свой бюджет, даже если ее собственный статус — ENTITY_STATUS_ACTIVE .
updateTime

string ( Timestamp format)

Только вывод. Метка времени последнего обновления позиции. Назначается системой.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

partnerCosts[]

object ( PartnerCost )

Расходы партнера, связанные с позицией.

Если метод lineItems.create отсутствует или пуст, то вновь созданная позиция унаследует партнерские затраты из своего родительского заказа на размещение.

flight

object ( LineItemFlight )

Обязательно. Время начала и окончания показа позиции.

budget

object ( LineItemBudget )

Обязательно. Настройка распределения бюджета по позиции.

pacing

object ( Pacing )

Обязательно. Настройка скорости расходования бюджета по данной позиции.

frequencyCap

object ( FrequencyCap )

Обязательно. Настройки ограничения частоты показов позиции.

Поле maxImpressions в этом объекте настроек необходимо использовать при назначении ограниченного лимита.

partnerRevenueModel

object ( PartnerRevenueModel )

Обязательно. Настройка модели дохода партнёра для данной позиции.

conversionCounting

object ( ConversionCountingConfig )

Настройка отслеживания конверсий позиции.

creativeIds[]

string ( int64 format)

Идентификаторы креативов, связанных с позицией.

bidStrategy

object ( BiddingStrategy )

Обязательно. Стратегия назначения ставок для позиции.

integrationDetails

object ( IntegrationDetails )

Подробности интеграции позиции.

targetingExpansion

object ( TargetingExpansionConfig )

Оптимизированные настройки таргетинга позиции.

Эта конфигурация применима только для позиций с медийной, видео- или аудиорекламой, которые используют автоматизированные ставки и нацелены на списки подходящей аудитории.

warningMessages[]

enum ( LineItemWarningMessage )

Только вывод. Предупреждения, генерируемые позицией. Эти предупреждения не блокируют сохранение позиции, но некоторые из них могут блокировать её запуск.

mobileApp

object ( MobileApp )

Мобильное приложение, продвигаемое позицией.

Это применимо только в том случае, если lineItemType имеет значение LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL или LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL .

reservationType

enum ( ReservationType )

Только вывод. Тип резервирования позиции.

excludeNewExchanges

boolean

Исключать ли новые биржи из автоматического таргетинга позиции. По умолчанию это поле имеет значение false.

youtubeAndPartnersSettings

object ( YoutubeAndPartnersSettings )

Только вывод. Настройки, специфичные для позиций YouTube и партнёрских программ.

containsEuPoliticalAds

enum ( EuPoliticalAdvertisingStatus )

Будет ли эта позиция показывать политическую рекламу Европейского Союза.

Если для свойства containsEuPoliticalAds в родительском рекламодателе задано значение DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING , то этому полю будет присвоено значение DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING если не указано иное. Это поле можно обновить через пользовательский интерфейс, API или файлы структурированных данных.

Это поле необходимо задать при создании новой позиции. В противном случае запрос advertisers.lineItems.create завершится ошибкой .

LineItemType

Возможные типы позиций.

Тип позиции определяет, какие настройки и параметры применимы, например формат объявлений или параметры таргетинга.

Перечисления
LINE_ITEM_TYPE_UNSPECIFIED

Значение типа не указано или неизвестно в данной версии.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_DISPLAY_DEFAULT Графическая, HTML5, нативная или мультимедийная реклама.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL Показ рекламы, стимулирующей установку приложения.
LINE_ITEM_TYPE_VIDEO_DEFAULT Видеореклама продается по цене за тысячу показов для различных сред.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL Видеореклама, стимулирующая установку приложения.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

Демонстрационная реклама, размещаемая в инвентаре мобильного приложения.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

Видеореклама, размещаемая в мобильных приложениях.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_AUDIO_DEFAULT Аудиореклама RTB продается в различных средах.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP Реклама OTT, присутствующая в заказах на размещение OTT. Этот тип применим только к позициям с заказом на размещение insertionOrderType OVER_THE_TOP .
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

Видеореклама на YouTube, стимулирующая конверсии.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

Рекламные видеоролики YouTube (до 15 секунд), которые нельзя пропустить.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

Рекламные видеоролики на YouTube, которые демонстрируют историю в определенной последовательности с использованием сочетания форматов.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

Аудиореклама на YouTube.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

Видеореклама на YouTube, которая позволяет охватить больше уникальных пользователей по более низкой цене. Может включать в себя рекламные объявления-заставки, пропускаемую in-stream рекламу или сочетание этих типов.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

Стандартная видеореклама на YouTube.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

Рекламные видеоролики YouTube для подключенного ТВ (до 15 секунд), которые нельзя пропустить.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

Видеореклама на YouTube для подключенных телевизоров, которая позволяет охватить больше уникальных пользователей по более низкой цене. Может включать в себя рекламные объявления-заставки, пропускаемую рекламу In-Stream или сочетание этих типов.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

Видеореклама YouTube по умолчанию для подключенного телевизора. Включает только формат in-stream рекламы.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

Целью этого типа позиции является показ целевой рекламы YouTube определенное количество раз одному и тому же человеку за определенный период времени.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

Рекламные видеоролики на YouTube, нацеленные на получение большего количества просмотров с помощью различных форматов рекламы.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

Рекламные объявления, размещаемые на цифровых наружных носителях.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

Видеореклама, размещаемая на наружной цифровой рекламе.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью API.

LineItemFlight

Настройки, управляющие продолжительностью активности позиции.

JSON-представление 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
Поля
flightDateType

enum ( LineItemFlightDateType )

Обязательно. Тип даты выполнения позиции.

dateRange

object ( DateRange )

Даты начала и окончания показа позиции. Они определяются относительно часового пояса родительского рекламодателя.

  • Требуется, если flightDateType равен LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM . В противном случае выводится только результат.
  • При создании нового рейса startDate и endDate должны быть в будущем.
  • Существующий рейс с startDate в прошлом имеет изменяемую endDate , но неизменяемую startDate .
  • endDate должен быть равен startDate или более поздней дате, обе до 2037 года.

LineItemFlightDateType

Возможные типы дат выполнения позиции.

Перечисления
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED Значение типа не указано или неизвестно в данной версии.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED Даты показов позиции наследуются из ее родительского заказа на размещение.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM Позиция использует собственные даты выполнения.

LineItemBudget

Настройки, управляющие распределением бюджета.

JSON-представление 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
Поля
budgetAllocationType

enum ( LineItemBudgetAllocationType )

Обязательно. Тип распределения бюджета.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC применим только в том случае, если для родительского заказа на размещение включено автоматическое распределение бюджета.

budgetUnit

enum ( BudgetUnit )

Только вывод. Единица бюджета определяет, основан ли бюджет на валюте или на показах. Это значение наследуется из родительского заказа на размещение.

maxAmount

string ( int64 format)

Максимальная сумма бюджета, которую может потратить позиция. Должна быть больше 0.

Когда budgetAllocationType равен:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC , это поле является неизменяемым и устанавливается системой.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED , если budgetUnit равен:
    • BUDGET_UNIT_CURRENCY — это поле указывает максимальную сумму бюджета, которую можно потратить, в микродолях валюты рекламодателя. Например, 1500000 соответствует 1,5 условным единицам валюты.
    • BUDGET_UNIT_IMPRESSIONS — это поле представляет собой максимальное количество показов для обслуживания.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED , это поле неприменимо и будет проигнорировано системой.

LineItemBudgetAllocationType

Возможные типы распределения бюджета.

Перечисления
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED Значение типа не указано или неизвестно в данной версии.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC Для данной позиции включено автоматическое распределение бюджета.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED Для каждой позиции выделяется фиксированная максимальная сумма бюджета.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED Бюджетные ограничения к данной позиции не применяются.

PartnerRevenueModel

Настройки, управляющие расчетом дохода партнера.

JSON-представление 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
Поля
markupType

enum ( PartnerRevenueModelMarkupType )

Обязательно. Тип наценки модели дохода партнёра.

markupAmount

string ( int64 format)

Обязательно. Размер наценки партнёрской модели дохода. Должен быть больше или равен 0.

  • Если для markupType задано значение PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM , это поле представляет собой наценку за тысячу показов (CPM) в микродолях валюты рекламодателя. Например, 1500000 соответствует 1,5 условным единицам валюты.
  • Если для markupType задано значение PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP , это поле представляет процентную наценку на стоимость рекламы в миллисекундах. Например, 100 соответствует 0,1% (десятичное значение — 0,001).
  • Если для markupType задано значение PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP , это поле отображает процентную наценку на общую стоимость рекламы в миллисекундах. Например, 100 соответствует 0,1% (десятичное значение — 0,001).

Партнерская модель дохода Тип наценки

Возможные типы наценки партнерской модели дохода.

Перечисления
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED Значение типа не указано или неизвестно в данной версии.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM Рассчитайте доход партнера на основе фиксированной цены за тысячу показов.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

Рассчитайте доход партнера на основе процентной надбавки к его стоимости рекламы.

PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP Рассчитайте доход партнера на основе процентной надбавки к его общей стоимости рекламы, которая включает все партнерские расходы и расходы на данные.

ConversionCountingConfig

Настройки, управляющие подсчетом конверсий.

Все конверсии после клика будут учтены. Для подсчёта конверсий после просмотра можно задать процентное значение.

JSON-представление 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}
Поля
postViewCountPercentageMillis

string ( int64 format)

Процент конверсий после просмотра, учитываемый в миллисекундах (1/1000 процента). Должен быть в диапазоне от 0 до 100000 включительно.

Например, чтобы отслеживать 50% конверсий после клика, установите значение 50000.

floodlightActivityConfigs[]

object ( TrackingFloodlightActivityConfig )

Конфигурации активности Floodlight, используемые для отслеживания конверсий.

Количество подсчитанных конверсий представляет собой сумму всех конверсий, подсчитанных по всем идентификаторам активности Floodlight, указанным в этом поле.

Это поле невозможно обновить, если позиции назначен индивидуальный алгоритм назначения ставок. Если вы задаёте это поле и назначаете индивидуальный алгоритм назначения ставок в одном запросе, действия Floodlight должны соответствовать действиям, используемым этим индивидуальным алгоритмом назначения ставок.

TrackingFloodlightActivityConfig

Настройки, управляющие поведением отдельной конфигурации активности Floodlight.

JSON-представление 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
Поля
floodlightActivityId

string ( int64 format)

Обязательно. Идентификатор действия Floodlight.

postClickLookbackWindowDays

integer

Обязательно. Количество дней после клика по объявлению, в течение которых может быть засчитана конверсия. Должно быть от 0 до 90 включительно.

postViewLookbackWindowDays

integer

Обязательно. Количество дней после просмотра рекламы, в течение которых может быть засчитана конверсия. Должно быть от 0 до 90 включительно.

LineItemWarningMessage

Предупреждения, генерируемые позицией. Эти типы предупреждений не блокируют сохранение позиции, но могут заблокировать её запуск.

Перечисления
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED Не указано или неизвестно.
INVALID_FLIGHT_DATES Эта позиция имеет недопустимые даты начала и окончания. Эта позиция не будет запущена.
EXPIRED Дата окончания этой позиции уже в прошлом.
PENDING_FLIGHT Данная позиция будет запущена в будущем.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED Все биржи, подключенные к партнерам, имеют отрицательный таргетинг. Позиция не будет запущена.
INVALID_INVENTORY_SOURCE Активные источники инвентаря не используются. Позиция не будет запущена.
APP_INVENTORY_INVALID_SITE_TARGETING Таргетинг этой позиции на приложения и URL-адреса не включает мобильные приложения. Этот тип позиции требует включения мобильных приложений в таргетинг канала, списка сайтов или приложений. Позиция не будет запущена.
APP_INVENTORY_INVALID_AUDIENCE_LISTS Эта позиция не ориентирована на мобильных пользователей. Для этого типа позиции требуется настроить таргетинг на список пользователей, использующих мобильные устройства. Позиция не будет запущена.
NO_VALID_CREATIVE Эта позиция не содержит допустимых креативов. Она не будет запущена.
PARENT_INSERTION_ORDER_PAUSED Заказ на размещение этой позиции приостановлен. Позиция не будет запущена.
PARENT_INSERTION_ORDER_EXPIRED Дата окончания размещения этой позиции уже установлена ​​в прошлом. Позиция не будет запущена.

Мобильное приложение

Мобильное приложение, продвигаемое с помощью позиции «Установка мобильного приложения».

JSON-представление 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
Поля
appId

string

Обязательно. Идентификатор приложения, предоставленный магазином платформы.

Приложения Android идентифицируются по идентификатору пакета, используемому магазином Play Store для Android, например, com.google.android.gm .

Приложения iOS идентифицируются девятизначным идентификатором приложения, используемым магазином приложений Apple, например, 422689480 .

platform

enum ( Platform )

Только вывод. Платформа приложений.

displayName

string

Только вывод. Имя приложения.

publisher

string

Только вывод. Издатель приложения.

Платформа

Возможные платформы мобильных приложений.

Перечисления
PLATFORM_UNSPECIFIED Платформа не указана.
IOS Платформа iOS.
ANDROID Платформа Android.

Настройки YouTube и партнеров

Настройки для позиций YouTube и партнеров.

JSON-представление 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
Поля
viewFrequencyCap

object ( FrequencyCap )

Настройки ограничения частоты показов позиции.

Поле maxViews в этом объекте настроек необходимо использовать при назначении ограниченного лимита.

thirdPartyMeasurementConfigs

object ( ThirdPartyMeasurementConfigs )

Необязательно. Конфигурации сторонних измерений позиции.

inventorySourceSettings

object ( YoutubeAndPartnersInventorySourceConfig )

Настройки, определяющие, на какие ресурсы YouTube и партнеров будет ориентирована позиция.

contentCategory

enum ( YoutubeAndPartnersContentCategory )

Только вывод. Тип контента, на котором будет показываться реклама YouTube и партнёрских сайтов.

effectiveContentCategory

enum ( YoutubeAndPartnersContentCategory )

Только для вывода. Категория контента, которая применяется при показе позиции. Если категория контента задана и для позиции, и для рекламодателя, при показе позиции будет применяться более строгая категория.

Новые позиции унаследуют только настройки уровня рекламодателя.

targetFrequency

object ( TargetFrequency )

Необязательно. Среднее количество показов рекламы из этой позиции одному и тому же человеку за определённый период времени.

linkedMerchantId

string ( int64 format)

Необязательно. Идентификатор продавца, связанного с позицией в фиде товаров.

relatedVideoIds[]

string

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

leadFormId

string ( int64 format)

Необязательно. Идентификатор формы для генерации лидов.

videoAdSequenceSettings

object ( VideoAdSequenceSettings )

Необязательно. Настройки, связанные с VideoAdSequence.

videoAdInventoryControl

object ( VideoAdInventoryControl )

Необязательно. Настройки, определяющие, какой инвентарь разрешён для этой позиции.

Конфигурации измерений третьих сторон

Настройки, контролирующие, какие показатели отдельных позиций измеряют сторонние поставщики.

JSON-представление 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
Поля
viewabilityVendorConfigs[]

object ( ThirdPartyVendorConfig )

Необязательно. Сторонние поставщики, измеряющие видимость.

Применимы следующие сторонние поставщики:

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object ( ThirdPartyVendorConfig )

Необязательно. Сторонние поставщики, оценивающие безопасность бренда.

Применимы следующие сторонние поставщики:

  • THIRD_PARTY_VENDOR_ZEFR
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object ( ThirdPartyVendorConfig )

Необязательно. Сторонние поставщики, измеряющие охват.

Применимы следующие сторонние поставщики:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brandLiftVendorConfigs[]

object ( ThirdPartyVendorConfig )

Необязательно. Сторонние поставщики, измеряющие эффективность бренда.

Применимы следующие сторонние поставщики:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_NIELSEN

ThirdPartyVendorConfig

Параметры, управляющие настройкой сторонних поставщиков измерений.

JSON-представление 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
Поля
vendor

enum ( ThirdPartyVendor )

Сторонний поставщик измерений.

placementId

string

Идентификатор, используемый платформой стороннего поставщика для идентификации позиции.

ThirdPartyVendor

Поставщики, которые выполняют сторонние измерения.

Перечисления
THIRD_PARTY_VENDOR_UNSPECIFIED Неизвестный сторонний поставщик.
THIRD_PARTY_VENDOR_MOAT Ров.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Интегральная рекламная наука.
THIRD_PARTY_VENDOR_COMSCORE Комскор.
THIRD_PARTY_VENDOR_TELEMETRY Телеметрия.
THIRD_PARTY_VENDOR_MEETRICS Метрика.
THIRD_PARTY_VENDOR_ZEFR ЗЕФР.
THIRD_PARTY_VENDOR_NIELSEN Нильсен.
THIRD_PARTY_VENDOR_KANTAR Кантар.
THIRD_PARTY_VENDOR_DYNATA Дината.
THIRD_PARTY_VENDOR_TRANSUNION Транссоюз.

YoutubeAndPartnersInventorySourceConfig

Настройки, управляющие тем, на какие ресурсы YouTube будет нацеливаться позиция YouTube и партнерские программы.

JSON-представление 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
Поля
includeYoutube

boolean

Необязательно. Можно ли таргетингировать инвентарь на YouTube? Это включает в себя поиск, каналы и видео.

includeGoogleTv

boolean

Необязательно. Можно ли таргетировать инвентарь в видеоприложениях, доступных на Google TV?

includeYoutubeVideoPartners

boolean

Следует ли нацеливать инвентарь на ряд партнерских сайтов и приложений, которые следуют тем же стандартам безопасности бренда, что и YouTube.

YoutubeAndPartnersContentCategory

Категории безопасности бренда для контента YouTube и партнеров.

Перечисления
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED Категория контента в этой версии не указана или неизвестна.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD Категория, включающая широкий спектр контента, подходящего большинству брендов. Этот контент основан на правилах YouTube по созданию контента, удобного для рекламодателей .
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED Категория, включающая весь контент YouTube и видеопартнеров, соответствующий стандартам монетизации.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED Категория, состоящая из ограниченного спектра контента, отвечающего повышенным требованиям, особенно в отношении ненормативной лексики и сексуального подтекста.

TargetFrequency

Настройка, контролирующая среднее количество показов рекламы одному и тому же человеку за определенный период времени.

JSON-представление 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
Поля
targetCount

string ( int64 format)

Целевое количество раз, в среднем, которое реклама будет показана одному и тому же человеку в течение периода времени, определяемого timeUnit и timeUnitCount .

timeUnit

enum ( TimeUnit )

Единица времени, в которой будет применяться целевая частота.

Применяется следующая единица времени:

  • TIME_UNIT_WEEKS
timeUnitCount

integer

Число timeUnit в течение которого будет длиться целевая частота.

В зависимости от значения timeUnit применяются следующие ограничения:

  • TIME_UNIT_WEEKS - должно быть 1

Настройки последовательности видеорекламы

Настройки, связанные с VideoAdSequence.

JSON-представление 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
Поля
minimumDuration

enum ( VideoAdSequenceMinimumDuration )

Минимальный интервал времени, прежде чем тот же пользователь снова увидит эту последовательность.

steps[]

object ( VideoAdSequenceStep )

Шаги, из которых состоит последовательность.

VideoAdSequenceMinimumDuration

Перечисление для возможного минимального интервала времени, прежде чем тот же пользователь снова увидит VideoAdSequence.

Перечисления
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED Не указано или неизвестно.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 дней.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 дней.

VideoAdSequenceStep

Детали отдельного шага в VideoAdSequence.

JSON-представление 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
Поля
stepId

string ( int64 format)

Идентификатор шага.

adGroupId

string ( int64 format)

Идентификатор соответствующей группы объявлений шага.

previousStepId

string ( int64 format)

Идентификатор предыдущего шага. У первого шага нет предыдущего шага.

interactionType

enum ( InteractionType )

Взаимодействие на предыдущем шаге, которое приведёт зрителя к этому шагу. У первого шага нет типа взаимодействия.

Тип взаимодействия

Типы взаимодействия на шаге.

Перечисления
INTERACTION_TYPE_UNSPECIFIED Не указано или неизвестно
INTERACTION_TYPE_PAID_VIEW Платный просмотр.
INTERACTION_TYPE_SKIP Пропущено зрителем.
INTERACTION_TYPE_IMPRESSION (Просмотренный) показ рекламы.
INTERACTION_TYPE_ENGAGED_IMPRESSION Показ рекламы, который не был сразу пропущен зрителем, но и не дошел до оплачиваемого события.

VideoAdInventoryControl

Управление инвентарем видеорекламы, используемое в определенных типах позиций YouTube.

JSON-представление 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
Поля
allowInStream

boolean

Необязательно. Может ли реклама отображаться в формате in-stream?

allowInFeed

boolean

Необязательно. Может ли реклама отображаться в ленте новостей?

allowShorts

boolean

Необязательно. Можно ли использовать формат коротких видеороликов?

Методы

bulkEditAssignedTargetingOptions

 Массовое редактирование параметров таргетинга в нескольких позициях.

bulkListAssignedTargetingOptions

 Перечисляет назначенные параметры таргетинга для нескольких позиций по типам таргетинга.

bulkUpdate

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

create

 Создает новую позицию.

delete

 Удаляет позицию.

duplicate

 Дублирует позицию.

generateDefault

 Создает новую позицию с настройками (включая таргетинг), унаследованными из заказа на размещение, и entity_status ENTITY_STATUS_DRAFT .

get

 Получает позицию.

list

 Перечисляет позиции рекламодателя.

patch

 Обновляет существующую позицию.