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)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
Поля
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. Допустимы и другие типы нормализации. Примеры: "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)

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

Если вы хотите задать ограничение, используйте поле 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 и партнерских видеоресурсов.
demandGenSettings

object (DemandGenSettings)

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

Доступно только для позиций из кампаний для создания спроса.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

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

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

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

boolean

Необязательное поле. Указывает, нужно ли включить оптимизацию ставок DV360 для позиций с фиксированной ставкой.

По умолчанию Дисплей и Видео 360 оптимизирует фиксированную ставку, автоматически снижая ее для показов, которые с меньшей вероятностью будут эффективными. Эта оптимизация включена по умолчанию (значение true).

Если в этом поле указано значение false, то оптимизация отключена и ставка не будет снижаться ни при каких условиях.

Эта настройка применяется только к позициям, у которых biddingStrategy имеет тип FIXED_BID.

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 Аудиообъявления, проданные в рамках аукциона в реальном времени для показа на различных платформах.
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.
LINE_ITEM_TYPE_DEMAND_GEN Объявления для создания спроса.

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

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

enum (BudgetUnit)

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

string (int64 format)

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

Если 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)

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

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

string (int64 format)

Обязательно. Размер наценки в модели тарификации партнера. Значение должно быть больше или равно 0.

  • Если для поля markupType задано значение PARTNER_REVENUE_MODEL_MARKUP_TYPE_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).

PartnerRevenueModelMarkupType

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

Перечисления
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)
    }
  ],
  "primaryAttributionModelId": string
}
Поля
postViewCountPercentageMillis

string (int64 format)

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

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

object (TrackingFloodlightActivityConfig)

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

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

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

string (int64 format)

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

MobileApp

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

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

string

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

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

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

enum (Platform)

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

string

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

string

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

Платформа

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

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

YoutubeAndPartnersSettings

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

Необязательное поле. Идентификатор аккаунта Merchant Center, который используется для предоставления фида товаров.

Этот аккаунт Merchant Center уже должен быть связан с рекламодателем.
relatedVideoIds[]

string

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

string (int64 format)

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

object (VideoAdSequenceSettings)

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

object (VideoAdInventoryControl)

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

ThirdPartyMeasurementConfigs

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

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
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

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

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

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_MACROMILL

ThirdPartyVendorConfig

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

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

enum (ThirdPartyVendor)

Сторонний поставщик услуг по сбору статистики.
placementId

string

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

ThirdPartyVendor

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

Перечисления
THIRD_PARTY_VENDOR_UNSPECIFIED Неизвестный сторонний поставщик.
THIRD_PARTY_VENDOR_MOAT Moat.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science.
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY Телеметрия.
THIRD_PARTY_VENDOR_MEETRICS Meetrics.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.
THIRD_PARTY_VENDOR_TRANSUNION TransUnion.
THIRD_PARTY_VENDOR_ORIGIN источником.
THIRD_PARTY_VENDOR_GEMIUS Gemius.
THIRD_PARTY_VENDOR_MEDIA_SCOPE Mediascope.
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Audience Project.
THIRD_PARTY_VENDOR_VIDEO_AMP Video Amp.
THIRD_PARTY_VENDOR_ISPOT_TV iSpot.tv.
THIRD_PARTY_VENDOR_INTAGE Intage.
THIRD_PARTY_VENDOR_MACROMILL Macromill.
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Video Research.
THIRD_PARTY_VENDOR_AQUILA Aquila.

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.

VideoAdSequenceSettings

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

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

enum (VideoAdSequenceMinimumDuration)

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

object (VideoAdSequenceStep)

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

VideoAdSequenceMinimumDuration

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

Перечисления
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)

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

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,
  "allowNonSkippableInStream": boolean
}
Поля
allowInStream

boolean

Необязательное поле. Можно ли показывать объявления в формате In-Stream.
allowInFeed

boolean

Необязательное поле. Могут ли объявления показываться в фиде.
allowShorts

boolean

Необязательное поле. Можно ли показывать объявления в формате Shorts.
allowNonSkippableInStream

boolean

Необязательное поле. Указывает, могут ли объявления показываться в формате In-Stream без возможности пропуска.

DemandGenSettings

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

JSON-представление 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
Поля
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

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

string (int64 format)

Необязательное поле. Идентификатор аккаунта Merchant Center, который используется для предоставления фида товаров.

Этот аккаунт Merchant Center уже должен быть связан с рекламодателем.
geoLanguageTargetingEnabled

boolean

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

Методы

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

bulkUpdate

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

create

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

delete

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

duplicate

 Создает копию позиции.

get

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

list

 Возвращает список позиций рекламодателя.

patch

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