REST Resource: advertisers.lineItems

Ресурс: Строка позиции

Одна строка в списке.

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 дробных знаков. Допускаются также смещения, отличные от "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 )

Необязательно. Обязательно, если тип позиции не 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 для позиций с фиксированной ставкой.

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

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

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

Тип элемента строки

Возможные типы позиций в строке.

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

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

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

Создание и обновление позиций этого типа и их целевых объектов с помощью API невозможно.

LINE_ITEM_TYPE_DISPLAY_DEFAULT Рекламные объявления в виде изображений, HTML5, нативной рекламы или мультимедийных объявлений.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL Показывайте рекламу, которая стимулирует установку приложения.
LINE_ITEM_TYPE_VIDEO_DEFAULT Видеореклама, продаваемая по модели CPM (оплата за тысячу показов) для различных платформ.
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 Audio продавалась в различных условиях.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP Реклама, размещаемая через OTT-платформы (over-the-top ads), присутствует в заказах на размещение 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 по умолчанию для подключенных телевизоров. Включать только рекламные объявления в формате, соответствующем формату потока.

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

Позиционный бюджет

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

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)

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

Тип распределения бюджета по позициям

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

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

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

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

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).

PartnerRevenueModelMarkupType

Возможные типы наценки в модели получения дохода от партнеров.

Перечисления
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED В данной версии тип значения не указан или неизвестен.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM Рассчитайте доход от партнеров на основе фиксированной 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 до 100000 включительно.

Например, чтобы отслеживать 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)

Обязательно. Идентификатор активности «Прожектор».

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 идентифицируются по идентификатору пакета (bundle ID), используемому магазином Play для 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)

Необязательно. Идентификатор учетной записи 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_NIELSEN
  • THIRD_PARTY_VENDOR_MACROMILL

ThirdPartyVendorConfig

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

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

enum ( ThirdPartyVendor )

Сторонний поставщик измерительных услуг.

placementId

string

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

Сторонний поставщик

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

Перечисления
THIRD_PARTY_VENDOR_UNSPECIFIED Неизвестный сторонний поставщик.
THIRD_PARTY_VENDOR_MOAT Ров.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Интегральная рекламная наука.
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY Телеметрия.
THIRD_PARTY_VENDOR_MEETRICS Метрики.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Нильсен.
THIRD_PARTY_VENDOR_KANTAR Кантара.
THIRD_PARTY_VENDOR_DYNATA Дината.
THIRD_PARTY_VENDOR_TRANSUNION Трансюнион.
THIRD_PARTY_VENDOR_ORIGIN Источник.
THIRD_PARTY_VENDOR_GEMIUS Гемиус.
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope.
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Проект «Аудитория».
THIRD_PARTY_VENDOR_VIDEO_AMP Видеоусилитель.
THIRD_PARTY_VENDOR_ISPOT_TV Ispot TV.
THIRD_PARTY_VENDOR_INTAGE Интаж.
THIRD_PARTY_VENDOR_MACROMILL Макромельница.
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Видеоисследования.

YoutubeAndPartnersInventorySourceConfig

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

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

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

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 )

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

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

Необязательно. Можно ли показывать рекламу в качестве контента в потоке.

allowInFeed

boolean

Необязательно. Можно ли размещать рекламу в виде вложенных объявлений.

allowShorts

boolean

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

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

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