- Ресурс: InsertionOrder
- Инсертинордертипе
- Бюджет заказа на вставку
- Инсерционордеравтоматионтипе
- Инсерционордербюджетсегмент
- Оплачиваемый результат
- Методы
Ресурс: 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 | Дополнительные сведения об интеграции заказа на размещение. |
performanceGoal | Необходимый. Цель эффективности заказа на размещение. |
budget | Необходимый. Настройки распределения бюджета заказа на размещение. |
bidStrategy | Стратегия назначения ставок в заказе на размещение. По умолчанию установлена |
reservationType | Только вывод. Тип резервирования заказа на размещение. |
billableOutcome | Неизменяемый. Оплачиваемый результат заказа на размещение. Покупка на основе результатов устарела. |
Инсертинордертипе
Возможные типы заказа на размещение.
Тип заказа на размещение определяет, какие настройки и параметры применимы, например формат объявлений или параметры таргетинга.
Перечисления | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED | Тип заказа на размещение не указан или неизвестен. |
RTB | Торги в режиме реального времени. |
OVER_THE_TOP | Чрезмерно. |
Бюджет заказа на вставку
Настройки, управляющие распределением бюджета заказа на размещение.
JSON-представление |
---|
{ "budgetUnit": enum ( |
Поля | |
---|---|
budgetUnit | Необходимый. Неизменяемый. Бюджетная единица определяет, основан ли бюджет на валюте или на показах. |
automationType | Тип автоматизации, используемый для управления ставками и бюджетом заказа на размещение. Если это поле не указано при создании, значение по умолчанию равно |
budgetSegments[] | Необходимый. Перечень сегментов бюджета. Используйте сегмент бюджета, чтобы указать конкретный бюджет на определенный период времени, в течение которого действует заказ на размещение. |
Инсерционордеравтоматионтипе
Возможные варианты автоматизации ставки и бюджета заказа на размещение.
Перечисления | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED | В этой версии опция автоматизации заказа на размещение не указана или неизвестна. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET | Автоматическое распределение бюджета. Разрешите системе автоматически перераспределять бюджет на собственные позиции, чтобы оптимизировать эффективность, определенную performanceGoal . Никакой автоматизации в настройках ставок. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE | Никакой автоматизации ставок или бюджета на уровне заказа на размещение. Ставку и бюджет необходимо настроить вручную на уровне позиции. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET | Разрешите системе автоматически корректировать ставки и переносить бюджет на собственные позиции, чтобы оптимизировать эффективность, определенную параметром performanceGoal . |
Инсерционордербюджетсегмент
Настройки, управляющие бюджетом одного сегмента бюджета.
JSON-представление |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
Поля | |
---|---|
budgetAmountMicros | Необходимый. Сумма бюджета, которую заказ на размещение потратит за заданный |
description | Описание бюджетного сегмента. Его можно использовать для ввода информации о заказе на поставку для каждого сегмента бюджета и печати этой информации в счетах-фактурах. Должно быть в кодировке UTF-8. |
dateRange | Необходимый. Настройки даты начала и окончания бюджетного сегмента. Они разрешаются относительно часового пояса родительского рекламодателя.
|
campaignBudgetId | |
Оплачиваемый результат
Возможные оплачиваемые результаты заказа на размещение.
Перечисления | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED | Неуказанный оплачиваемый результат. |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION | Плата за показы. |
BILLABLE_OUTCOME_PAY_PER_CLICK | Платите за клик. |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION | Плата за активный просмотр. |
Методы | |
---|---|
| Создает новый заказ на размещение. |
| Удаляет заказ на размещение. |
| Получает заказ на размещение. |
| Перечисляет заказы на размещение у рекламодателя. |
| Перечисляет назначенные параметры таргетинга заказа на размещение для всех типов таргетинга. |
| Обновляет существующий заказ на размещение. |