- Ресурс: InsertionOrder
- Инсертинордертипе
- КПИ
- Тип Kpi
- Бюджет заказа на вставку
- Инсерционордеравтоматионтипе
- Инсерционордербюджетсегмент
- Цель оптимизации
- Методы
Ресурс: InsertionOrder
Единый заказ на размещение.
JSON-представление |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
Поля | |
---|---|
name | Только вывод. Название ресурса заказа на размещение. |
advertiserId | Только вывод. Уникальный идентификатор рекламодателя, которому принадлежит заказ на размещение. |
campaignId | Необходимый. Неизменяемый. Уникальный идентификатор кампании, которой принадлежит заказ на размещение. |
insertionOrderId | Только вывод. Уникальный идентификатор заказа на размещение. Назначается системой. |
displayName | Необходимый. Отображаемое название заказа на размещение. Должен быть в кодировке UTF-8 с максимальным размером 240 байт. |
insertionOrderType | Тип заказа на размещение. Если это поле не указано при создании, по умолчанию используется значение |
entityStatus | Необходимый. Определяет, может ли заказ на размещение расходовать свой бюджет и делать ставки на инвентарь.
|
updateTime | Только вывод. Временная метка последнего обновления заказа на размещение. Назначается системой. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
partnerCosts[] | Расходы партнера, связанные с заказом на размещение. Если метод |
pacing | Необходимый. Настройка скорости расходования бюджета в заказе на размещение. |
frequencyCap | Необходимый. Настройка ограничения частоты показов в заказе на размещение. |
integrationDetails | Дополнительные сведения об интеграции заказа на размещение. |
kpi | Необходимый. Ключевой показатель эффективности (KPI) заказа на размещение. В интерфейсе Display & Video 360 это обозначается как «Цель». |
budget | Необходимый. Настройки распределения бюджета заказа на размещение. |
bidStrategy | Стратегия назначения ставок в заказе на размещение. По умолчанию установлена |
reservationType | Только вывод. Тип резервирования заказа на размещение. |
optimizationObjective | Необязательный. Цель оптимизации заказа на размещение. Это поле доступно только клиентам из белого списка. Если клиент не внесен в белый список, это поле будет пустым, и попытки его установить вернут ошибку. |
Инсерционордертипе
Возможные типы заказа на размещение.
Тип заказа на размещение определяет, какие настройки и параметры применимы, например формат объявлений или параметры таргетинга.
Перечисления | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED | Тип заказа на размещение не указан или неизвестен. |
RTB | Торги в режиме реального времени. |
OVER_THE_TOP | Чрезмерно. |
КПИ
Настройки, управляющие ключевым показателем эффективности (KPI) заказа на размещение.
JSON-представление |
---|
{ "kpiType": enum ( |
Поля | |
---|---|
kpiType | Необходимый. Тип КПЭ. |
kpiAlgorithmId | Необязательный. Идентификатор специального алгоритма назначения ставок, связанный с KPI_CUSTOM_IMPRESSION_VALUE_OVER_COST. Это поле игнорируется, если не выбран правильный KPI. |
Поле объединения kpi_value . Необходимый. Значение KPI. Соответствующее поле соответствует kpi_type . kpi_value может быть только одним из следующих: | |
kpiAmountMicros | Целевая сумма в микронах валюты рекламодателя. Применимо, когда
Например: 1500000 представляет собой 1,5 стандартных единицы валюты. |
kpiPercentageMicros | Десятичное представление процента цели в микронах. Применимо, когда
Например: 70000 представляет собой 7% (десятичное 0,07). |
kpiString | Строка ключевого показателя эффективности, которая может быть пустой. Должен иметь кодировку UTF-8 и длину не более 100 символов. Применимо, когда |
Тип Kpi
Возможные типы ключевых показателей эффективности (KPI).
Перечисления | |
---|---|
KPI_TYPE_UNSPECIFIED | В этой версии тип KPI не указан или неизвестен. |
KPI_TYPE_CPM | KPI — CPM (стоимость за тысячу показов). |
KPI_TYPE_CPC | KPI — CPC (стоимость за клик). |
KPI_TYPE_CPA | KPI — CPA (стоимость за действие). |
KPI_TYPE_CTR | KPI — это процент CTR (рейтинга кликов). |
KPI_TYPE_VIEWABILITY | KPI — процент видимости. |
KPI_TYPE_CPIAVC | KPI – CPIAVC (цена за показ слышна и видна при завершении). |
KPI_TYPE_CPE | KPI — CPE (стоимость за взаимодействие). |
KPI_TYPE_CPV | KPI устанавливается в CPV (стоимость за просмотр). |
KPI_TYPE_CLICK_CVR | KPI — это процент конверсии кликов (конверсий на клик). |
KPI_TYPE_IMPRESSION_CVR | KPI — процент конверсии показов (конверсий на показ). |
KPI_TYPE_VCPM | KPI – VCPM (стоимость за тысячу видимых показов). |
KPI_TYPE_VTR | KPI — это процент просмотров YouTube (просмотров YouTube на показ). |
KPI_TYPE_AUDIO_COMPLETION_RATE | KPI — это процент завершения аудио (полное прослушивание аудио на показ). |
KPI_TYPE_VIDEO_COMPLETION_RATE | KPI — это процент завершения видео (полных просмотров видео на показ). |
KPI_TYPE_CPCL | KPI устанавливается в CPCL (стоимость полного прослушивания аудио). |
KPI_TYPE_CPCV | KPI задается в CPCV (стоимость за полный просмотр видео). |
KPI_TYPE_TOS10 | KPI задается в виде продолжительности времени на экране 10+ секунд (процент измеряемых показов без возможности пропуска, которые находились на экране не менее 10 секунд). |
KPI_TYPE_MAXIMIZE_PACING | KPI призван максимизировать влияние бренда при приоритетном расходовании всего бюджета. |
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST | KPI задается в виде индивидуальной ценности показа, разделенной на стоимость. |
KPI_TYPE_OTHER | KPI — это какое-то другое значение. |
Бюджет заказа на вставку
Настройки, управляющие распределением бюджета заказа на размещение.
JSON-представление |
---|
{ "budgetUnit": enum ( |
Поля | |
---|---|
budgetUnit | Необходимый. Неизменяемый. Бюджетная единица определяет, основан ли бюджет на валюте или на показах. |
automationType | Тип автоматизации, используемый для управления ставками и бюджетом заказа на размещение. Если это поле не указано при создании, значение по умолчанию равно |
budgetSegments[] | Необходимый. Перечень сегментов бюджета. Используйте сегмент бюджета, чтобы указать конкретный бюджет на определенный период времени, в течение которого действует заказ на размещение. |
Инсерционордеравтоматионтипе
Возможные варианты автоматизации ставки и бюджета заказа на размещение.
Перечисления | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED | В этой версии опция автоматизации заказа на размещение не указана или неизвестна. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET | Автоматическое распределение бюджета. Разрешите системе автоматически перераспределять бюджет на собственные позиции, чтобы оптимизировать эффективность, определяемую kpi . Никакой автоматизации в настройках ставок. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE | Никакой автоматизации ставок или бюджета на уровне заказа на размещение. Ставку и бюджет необходимо настроить вручную на уровне позиции. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET | Разрешите системе автоматически корректировать ставки и переносить бюджет на принадлежащие позиции, чтобы оптимизировать эффективность, определяемую kpi . |
Инсерционордербюджетсегмент
Настройки, управляющие бюджетом одного сегмента бюджета.
JSON-представление |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
Поля | |
---|---|
budgetAmountMicros | Необходимый. Сумма бюджета, которую заказ на размещение потратит за заданный |
description | Описание бюджетного сегмента. Его можно использовать для ввода информации о заказе на поставку для каждого сегмента бюджета и печати этой информации в счетах-фактурах. Должно быть в кодировке UTF-8. |
dateRange | Необходимый. Настройки даты начала и окончания бюджетного сегмента. Они разрешаются относительно часового пояса родительского рекламодателя.
|
campaignBudgetId | |
Цель оптимизации
Возможные типы целей оптимизации.
Перечисления | |
---|---|
OPTIMIZATION_OBJECTIVE_UNSPECIFIED | Значение типа не указано или неизвестно в этой версии. |
CONVERSION | Отдавайте приоритет показам, которые увеличивают продажи и конверсию. |
CLICK | Отдавайте приоритет показам, которые увеличивают посещаемость сайта, приложений и магазинов приложений. |
BRAND_AWARENESS | Отдавайте приоритет показам определенного качества. |
CUSTOM | Цель определяется назначенным специальным алгоритмом назначения ставок. |
NO_OBJECTIVE | Цель не определена. Можно использовать любой KPI или стратегию назначения ставок. |
Методы | |
---|---|
| Создает новый заказ на размещение. |
| Удаляет заказ на размещение. |
| Получает заказ на размещение. |
| Перечисляет заказы на размещение у рекламодателя. |
| Перечисляет назначенные параметры таргетинга заказа на размещение для всех типов таргетинга. |
| Обновляет существующий заказ на размещение. |