- Ресурс: LineItem
- LineItemType
- LineItemПолет
- LineItemFlightDateType
- ПозицияБюджет
- LineItemBudgetAllocationType
- Партнерская модель дохода
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- ОтслеживаниеFloodlightActivityConfig
- Конфигурация расширения таргетинга
- Уровень расширения таргетинга
- LineItemПредупреждениеСообщение
- Мобильное приложение
- Платформа
- Методы
Ресурс: LineItem
Одна позиция.
JSON-представление |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
Поля | |
---|---|
name | Только вывод. Имя ресурса позиции. |
advertiserId | Только вывод. Уникальный идентификатор рекламодателя, которому принадлежит позиция. |
campaignId | Только вывод. Уникальный идентификатор кампании, к которой принадлежит позиция. |
insertionOrderId | Необходимый. Неизменяемый. Уникальный идентификатор заказа на размещение, к которому принадлежит позиция. |
lineItemId | Только вывод. Уникальный идентификатор позиции. Назначается системой. |
displayName | Необходимый. Отображаемое название позиции. Должен быть в кодировке UTF-8 с максимальным размером 240 байт. |
lineItemType | Необходимый. Неизменяемый. Тип позиции. |
entityStatus | Необходимый. Определяет, может ли позиция расходовать свой бюджет и делать ставки на инвентарь.
|
updateTime | Только вывод. Временная метка последнего обновления позиции. Назначается системой. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
partnerCosts[] | Расходы партнера, связанные с кампанией. Если метод |
flight | Необходимый. Время начала и окончания периода действия позиции. |
budget | Необходимый. Настройка распределения бюджета позиции. |
pacing | Необходимый. Настройка скорости расходования бюджета позиции. |
frequencyCap | Необходимый. Настройки ограничения частоты показов для позиции. Поле |
partnerRevenueModel | Необходимый. Параметр партнерской модели дохода для позиции. |
conversionCounting | Настройка отслеживания конверсий позиции. |
creativeIds[] | Идентификаторы объявлений, связанных с позицией. |
bidStrategy | Необходимый. Стратегия назначения ставок для позиции. |
integrationDetails | Подробности интеграции позиции. |
inventorySourceIds[] | Идентификаторы источников частного инвентаря, назначенных позиции. |
targetingExpansion | Оптимизированные настройки таргетинга позиции. Эта конфигурация применима только к медийным, видео- и аудиопозициям, в которых используется автоматическое назначение ставок и таргетинг на списки подходящей аудитории. |
warningMessages[] | Только вывод. Предупреждающие сообщения, создаваемые кампанией. Эти предупреждения не блокируют сохранение позиции, но некоторые из них могут блокировать ее запуск. |
mobileApp | Мобильное приложение, рекламируемое позицией. Это применимо только в том случае, если |
reservationType | Только вывод. Тип резервирования позиции. |
excludeNewExchanges | Следует ли исключить новые биржи из автоматического таргетинга позиции. По умолчанию это поле имеет значение false. |
LineItemType
Возможные типы позиции.
Тип позиции определяет, какие настройки и параметры применимы, например формат объявлений или параметры таргетинга.
Перечисления | |
---|---|
LINE_ITEM_TYPE_UNSPECIFIED | Значение типа не указано или неизвестно в этой версии. Позиции этого типа и их таргетинг нельзя создавать или обновлять с помощью API. |
LINE_ITEM_TYPE_DISPLAY_DEFAULT | Графические, HTML5, нативные или мультимедийные объявления. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL | Показывайте рекламу, которая увеличивает количество установок приложения. |
LINE_ITEM_TYPE_VIDEO_DEFAULT | Видеореклама продается по цене за тысячу показов для различных сред. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL | Видеореклама, которая увеличивает количество установок приложения. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY | Медийная реклама, показываемая на инвентаре мобильных приложений. Позиции этого типа и их таргетинг нельзя создавать или обновлять с помощью API. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY | Видеореклама показывается на инвентаре мобильных приложений. Позиции этого типа и их таргетинг нельзя создавать или обновлять с помощью API. |
LINE_ITEM_TYPE_AUDIO_DEFAULT | Аудиообъявления RTB, продаваемые для различных сред. |
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP | Чрезмерная реклама присутствует в заказах на размещение OTT. Этот тип применим только к позициям с заказом на размещение insertionOrderType OVER_THE_TOP . |
LineItemПолет
Настройки, управляющие активной продолжительностью позиции.
JSON-представление |
---|
{ "flightDateType": enum ( |
Поля | |
---|---|
flightDateType | Необходимый. Тип дат окончания действия позиции. |
dateRange | Даты начала и окончания периода действия позиции. Они разрешаются относительно часового пояса родительского рекламодателя.
|
triggerId | Идентификатор ручного триггера, связанного с кампанией.
Предупреждение. Позиции, в которых используются ручные триггеры, больше не отображаются в Display & Video 360. Действие этого поля будет прекращено 1 августа 2023 г. Для получения дополнительной информации прочтите наше объявление об прекращении поддержки функции . |
LineItemFlightDateType
Возможные типы дат окончания действия позиции.
Перечисления | |
---|---|
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED | Значение типа не указано или неизвестно в этой версии. |
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED | Даты выполнения позиции наследуются из родительского заказа на размещение. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM | В позиции используются собственные даты начала показа. |
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER | В позиции используется триггер. Предупреждение. Позиции, использующие ручные триггеры, больше не отображаются в Display & Video 360. Это значение перестанет действовать 1 августа 2023 г. Для получения дополнительной информации прочтите наше объявление об прекращении поддержки функции . |
ПозицияБюджет
Настройки, управляющие распределением бюджета.
JSON-представление |
---|
{ "budgetAllocationType": enum ( |
Поля | |
---|---|
budgetAllocationType | Необходимый. Тип распределения бюджета. |
budgetUnit | Только вывод. Бюджетная единица определяет, основан ли бюджет на валюте или на показах. Это значение наследуется от родительского заказа на размещение. |
maxAmount | Максимальная сумма бюджета, которую потратит позиция. Должно быть больше 0. Когда
|
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 ( |
Поля | |
---|---|
markupType | Необходимый. Тип наценки партнерской модели дохода. |
markupAmount | Необходимый. Сумма наценки партнерской модели дохода. Должно быть больше или равно 0.
|
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 ( |
Поля | |
---|---|
postViewCountPercentageMillis | Процент учитываемых конверсий после просмотра, в миллисах (1/1000 процента). Должно быть от 0 до 100 000 включительно. Например, чтобы отслеживать 50 % конверсий после клика, установите значение 50 000. |
floodlightActivityConfigs[] | Конфигурации действий Floodlight, используемые для отслеживания конверсий. Количество подсчитанных конверсий представляет собой сумму всех конверсий, подсчитанных всеми идентификаторами действий Floodlight, указанными в этом поле. |
ОтслеживаниеFloodlightActivityConfig
Настройки, управляющие поведением отдельной конфигурации действия Floodlight.
JSON-представление |
---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
Поля | |
---|---|
floodlightActivityId | Необходимый. Идентификатор действия Floodlight. |
postClickLookbackWindowDays | Необходимый. Количество дней после клика по объявлению, в течение которых может быть засчитана конверсия. Должно быть от 0 до 90 включительно. |
postViewLookbackWindowDays | Необходимый. Количество дней после просмотра объявления, в течение которых может быть засчитана конверсия. Должно быть от 0 до 90 включительно. |
Конфигурация расширения таргетинга
Настройки, управляющие оптимизированными настройками таргетинга позиции.
JSON-представление |
---|
{
"targetingExpansionLevel": enum ( |
Поля | |
---|---|
targetingExpansionLevel | Необходимый. Включен ли оптимизированный таргетинг. Это поле поддерживает следующие значения:
Если в этом поле установлено любое другое значение, ему автоматически будет присвоено значение |
excludeFirstPartyAudience | Исключить ли собственные аудитории из использования при расширении таргетинга. Это поле устарело с запуском оптимизированного таргетинга . В этом поле будет установлено значение |
Уровень расширения таргетинга
Настройка оптимизированного таргетинга.
Перечисления | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED | Параметр оптимизированного таргетинга в этой версии не указан или неизвестен. |
NO_EXPANSION | Оптимизированный таргетинг отключен. |
LEAST_EXPANSION | Оптимизированный таргетинг включен. |
SOME_EXPANSION | Если используется, автоматически будет установлено значение |
BALANCED_EXPANSION | Если используется, автоматически будет установлено значение |
MORE_EXPANSION | Если используется, автоматически будет установлено значение |
MOST_EXPANSION | Если используется, автоматически будет установлено значение |
LineItemПредупреждениеСообщение
Предупреждающие сообщения, создаваемые кампанией. Эти типы предупреждений не блокируют сохранение позиции, но могут блокировать ее запуск.
Перечисления | |
---|---|
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 | Дата окончания заказа на размещение этой позиции установлена в прошлом. Позиция не будет показываться. |
NO_POSITIVE_AUDIENCE_LIST_TARGETED | Эта позиция не ориентирована ни на какие списки аудитории, что может привести к слишком быстрому расходованию бюджета. |
APP_INSTALL_NO_CONVERSION_PIXEL | Для этой позиции, ориентированной на установку приложения, не настроен ни один пиксель конверсии. |
TARGETING_REVOKED_OR_CLOSED_USER_LIST | Эта позиция нацелена на один или несколько списков пользователей, которые больше не доступны. В будущем это приведет к невозможности показа позиции, поэтому рассмотрите возможность удаления этих списков из вашего таргетинга. |
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY | Для этой позиции, ориентированной на установку приложения, не задана оптимальная стратегия назначения ставок. |
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS | Сделки, на которые нацелена эта позиция, допускают размеры креативов, которые не используются. Это может ограничить показ или эффективность позиции. |
NO_CREATIVE_FOR_TARGETED_DEALS | Эта позиция не содержит креативов для целевых сделок. |
TARGETING_DEPRECATED_GEO_TARGET | Таргетинг этой позиции настроен на устаревшую географическую цель. |
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION | В этой позиции используется параметр Обновите интеграцию API, чтобы напрямую исключать любые собственные аудитории, использующие таргетинг на аудиторию , до 25 марта 2023 г., чтобы учесть прекращение действия поля |
Мобильное приложение
Мобильное приложение, рекламируемое с помощью позиции установки мобильного приложения.
JSON-представление |
---|
{
"appId": string,
"platform": enum ( |
Поля | |
---|---|
appId | Необходимый. Идентификатор приложения, предоставленный магазином платформы. Приложения Android идентифицируются по идентификатору пакета, используемому магазином Android Play, например Приложения iOS идентифицируются по девятизначному идентификатору приложения, используемому магазином приложений Apple, например |
platform | Только вывод. Платформа приложений. |
displayName | Только вывод. Имя приложения. |
publisher | Только вывод. Издатель приложения. |
Платформа
Возможные платформы мобильных приложений.
Перечисления | |
---|---|
PLATFORM_UNSPECIFIED | Платформа не указана. |
IOS | iOS-платформа. |
ANDROID | Платформа Андроид. |
Методы | |
---|---|
| Массовое изменение параметров таргетинга в рамках одной позиции. |
| Перечисляет назначенные параметры таргетинга позиции по типам таргетинга. |
| Создает новую позицию. |
| Удаляет позицию. |
| Создает новую позицию с настройками (включая таргетинг), унаследованными от заказа на размещение entity_status и ENTITY_STATUS_DRAFT . |
| Получает позицию. |
| Перечисляет позиции рекламодателя. |
| Обновляет существующую позицию. |