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)
  }
}
Поля
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 и партнеров.

ТипЛинии

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

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

Перечисления
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 Реклама Over-the-top, присутствующая в заказах на вставку 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, которая оптимизирует охват большего количества уникальных пользователей по более низкой цене. Может включать в себя рекламу-заставку, пропускаемую рекламу в потоке или сочетание типов.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью 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 для подключенного ТВ, которая оптимизирует охват большего количества уникальных пользователей по более низкой цене. Может включать в себя рекламу-заставку, пропускаемую рекламу в потоковом режиме или сочетание типов.

Позиции этого типа и их таргетинг не могут быть созданы или обновлены с помощью 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 В данной позиции используются собственные даты выполнения.

LineItemБюджет

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

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 К данной позиции не применяется ограничение бюджета.

Модель дохода партнера

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

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 Рассчитайте доход партнера на основе процентной надбавки к его общей стоимости рекламы, которая включает все партнерские расходы и расходы на данные.

КонверсияПодсчетКонфигурация

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

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

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

string ( int64 format)

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

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

floodlightActivityConfigs[]

object ( TrackingFloodlightActivityConfig )

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

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

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

ОтслеживаниеFloodlightActivityConfig

Настройки, управляющие поведением отдельной конфигурации активности 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 Таргетинг Apps & URLs этой позиции не включает мобильные приложения. Тип этой позиции требует, чтобы вы включили мобильные приложения в таргетинг канала, списка сайтов или приложений. Эта позиция не будет запущена.
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 идентифицируются по идентификатору пакета, используемому в магазине Android Play, например, com.google.android.gm .

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

platform

enum ( Platform )

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

displayName

string

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

publisher

string

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

Платформа

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

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

YoutubeAndPartnersНастройки

Настройки для позиций 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)
  }
}
Поля
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.

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

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

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_ZERF
  • 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

Конфигурация стороннего поставщика

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

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 Двойная проверка.
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 Дината.

YoutubeAndPartnersInventorySourceConfig

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

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

boolean

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

includeGoogleTv

boolean

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

includeYoutubeVideoPartners

boolean

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

YoutubeAndPartnersКонтентКатегория

Категории безопасности бренда для контента 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 Категория, состоящая из ограниченного количества контента, который соответствует повышенным требованиям, особенно в отношении ненормативной лексики и сексуального подтекста.

ЦелеваяЧастота

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

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

VideoAdSequenceSettings

Настройки, связанные с 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 дней.

ВидеоРекламныйПоследовательностьШаг

Детали одного шага в последовательности видеорекламы.

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 )

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

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

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

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

Методы

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

bulkUpdate

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

create

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

delete

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

duplicate

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

generateDefault

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

get

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

list

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

patch

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