BiddingStrategy

Настройки, управляющие стратегией назначения ставок. Стратегия назначения ставок определяет цену ставки.

JSON-представление
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // End of mutually exclusive fields.
}
Поля
Обязательно. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
fixedBid

object (FixedBidStrategy)

Стратегия, в которой используются фиксированные ставки.

maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

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

На уровне заказа на размещение для markupType позиций нельзя задать значение PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM.

Кроме того, значение performanceGoalType, назначенное заказу на размещение, определяет, какие значения lineItemType доступны для позиций в этом заказе:

  • В BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC и BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED можно использовать только позиции типа LINE_ITEM_TYPE_DISPLAY_DEFAULT или LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • В BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA и BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN можно использовать только позиции типа LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • В BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH можно добавить не более LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP позиций.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

Стратегия, которая автоматически корректирует ставку для достижения или превышения заданной цели по эффективности. Его можно использовать только для позиций.

youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

Стратегия назначения ставок, которая используется для ресурсов YouTube и партнерских видеоресурсов.

Его можно использовать только для позиций или групп объявлений на YouTube и партнерских видеоресурсах.

demandGenBid

object (DemandGenBiddingStrategy)

Стратегия назначения ставок, используемая кампаниями для создания спроса.

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

Конец взаимоисключающих полей.

FixedBidStrategy

Стратегия, в которой используются фиксированные ставки.

JSON-представление
{
  "bidAmountMicros": string
}
Поля
bidAmountMicros

string (int64 format)

Фиксированная ставка в миллионных долях валюты рекламодателя. Для заказа на размещение значение bidAmountMicros должно быть равно 0. Для позиции значение bidAmountMicros должно быть больше или равно оплачиваемой единице в указанной валюте и меньше или равно верхнему пределу 1 000 000 000.

Например, 1500000 означает 1,5 стандартной единицы валюты.

MaximizeSpendBidStrategy

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

JSON-представление
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "maxAverageCpmBidAmountMicros": string,
  "raiseBidForDeals": boolean,
  "customBiddingAlgorithmId": string
}
Поля
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Обязательно. Тип цели по эффективности, которую стратегия назначения ставок пытается минимизировать, расходуя весь бюджет. BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM не поддерживается для этой стратегии.

maxAverageCpmBidAmountMicros

string (int64 format)

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

Например, 1500000 означает 1,5 стандартной единицы валюты.

raiseBidForDeals

boolean

Учитываются ли в стратегии минимальные цены сделок.

customBiddingAlgorithmId

string (int64 format)

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

Если вы назначите алгоритм специальных ставок, который использует действия Floodlight, не указанные в столбце floodlightActivityConfigs, то возникнет ошибка.

BiddingStrategyPerformanceGoalType

Возможные типы целей по эффективности для стратегии назначения ставок.

Перечисления
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED Значение типа не указано или неизвестно в этой версии.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA Цена за конверсию.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC Цена за клик.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM Цена за тысячу показов в видимой области экрана
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO Алгоритм специальных ставок.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA Показы до конца с включенным звуком в видимой области экрана.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN Просмотры в видимой области экрана длительностью более 10 секунд.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED Показы в видимой области экрана.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH Максимальный охват.

PerformanceGoalBidStrategy

Стратегия, которая автоматически корректирует ставку для достижения или превышения заданной цели по эффективности.

JSON-представление
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "performanceGoalAmountMicros": string,
  "maxAverageCpmBidAmountMicros": string,
  "customBiddingAlgorithmId": string
}
Поля
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Обязательно. Тип цели по эффективности, которую стратегия назначения ставок будет пытаться достичь или превзойти.

Для использования на уровне позиции значение должно быть одним из следующих:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.
performanceGoalAmountMicros

string (int64 format)

Обязательно. Цель по эффективности, которую стратегия назначения ставок будет пытаться достичь или превзойти. Указывается в микроединицах валюты рекламодателя или в микроединицах значения рентабельности инвестиций в рекламу, которое также основано на валюте рекламодателя. Значение должно быть больше или равно оплачиваемой единице указанной валюты и меньше или равно верхним границам. У каждого performanceGoalType есть верхняя граница:

  • Если performanceGoalType – BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, верхняя граница составляет 10 000 долларов США.
  • если performanceGoalType – BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, верхняя граница – 1000,00 долл.США.
  • Если performanceGoalType – BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, верхняя граница – 1000,00 долл.США.
  • Если performanceGoalType – это BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO, то верхняя граница – 1000,00, а нижняя – 0,01.

Пример. Если задано значение BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, цена за тысячу показов будет определяться на основе вероятности того, что каждый доступный показ будет видимым. Например, если целевая цена за тысячу показов в видимой области экрана составляет 2 доллара США, а вероятность просмотра объявления – 40 %, то ставка будет равна 0,8 доллара США за тысячу показов (40% от целевой цены).

Например, 1500000 означает 1,5 стандартной единицы валюты или рентабельности инвестиций в рекламу.

maxAverageCpmBidAmountMicros

string (int64 format)

Максимальная средняя цена за тысячу показов, которая может быть назначена, в миллионных долях валюты рекламодателя. Значение должно быть больше или равно единице оплаты в указанной валюте. Неприменимо, если для параметра performanceGoalType задано значение BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM.

Например, 1500000 означает 1,5 стандартной единицы валюты.

customBiddingAlgorithmId

string (int64 format)

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

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

YoutubeAndPartnersBiddingStrategy

Настройки, управляющие стратегией назначения ставок для ресурсов YouTube и партнерских видеоресурсов.

JSON-представление
{
  "type": enum (YoutubeAndPartnersBiddingStrategyType),
  "value": string,
  "adGroupEffectiveTargetCpaValue": string,
  "adGroupEffectiveTargetCpaSource": enum (BiddingSource)
}
Поля
type

enum (YoutubeAndPartnersBiddingStrategyType)

Тип стратегии назначения ставок.

value

string (int64 format)

Значение, используемое стратегией назначения ставок.

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

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Если стратегия назначения ставок задана на уровне группы объявлений, это поле можно использовать только для следующих типов стратегий:

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Если вы не используете подходящую стратегию, значение в этом поле будет равно 0.

adGroupEffectiveTargetCpaValue

string (int64 format)

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

adGroupEffectiveTargetCpaSource

enum (BiddingSource)

Только для вывода. Источник эффективной целевой цены за конверсию для группы объявлений.

YoutubeAndPartnersBiddingStrategyType

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

Перечисления
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED Тип не указан или неизвестен.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV Стратегия назначения ставок, при которой вы платите заданную сумму за каждый просмотр видео.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM Стратегия назначения ставок, при которой за каждый показ выплачивается настраиваемая сумма.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA Стратегия назначения ставок, которая автоматически оптимизирует конверсии на каждый доллар.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM Стратегия назначения ставок, при которой за каждый показ выплачивается настраиваемая сумма.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM Стратегия назначения ставок для позиций с быстрым резервированием на YouTube, при которой за каждый показ выплачивается фиксированная сумма.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT Стратегия автоматического назначения ставок, которая позволяет достичь максимального роста.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Стратегия назначения ставок, которая автоматически максимизирует количество конверсий в рамках дневного бюджета.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV Стратегия назначения ставок, которая автоматически оптимизирует цену за просмотр видео.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS Стратегия назначения ставок, которая автоматически повышает доход, поддерживая среднюю целевую рентабельность инвестиций в рекламу.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Стратегия назначения ставок, которая автоматически устанавливает ставки, чтобы максимизировать доход в рамках вашего бюджета.

BiddingSource

Источник значения ставки.

Перечисления
BIDDING_SOURCE_UNSPECIFIED Источник назначения ставок не указан или неизвестен.
BIDDING_SOURCE_LINE_ITEM Значение ставки наследуется от позиции.
BIDDING_SOURCE_AD_GROUP Значение ставки определяется в группе объявлений.

DemandGenBiddingStrategy

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

JSON-представление
{
  "type": enum (DemandGenBiddingStrategyType),
  "value": string,
  "effectiveBiddingValue": string,
  "effectiveBiddingValueSource": enum (BiddingSource)
}
Поля
type

enum (DemandGenBiddingStrategyType)

Необязательное поле. Тип стратегии назначения ставок.

Это можно сделать только при назначении позиции. Группы объявлений наследуют это значение от позиции.

value

string (int64 format)

Необязательное поле. Значение, используемое стратегией назначения ставок. Это можно сделать при назначении объектов позициям или группам объявлений. Это поле применимо только для следующих типов стратегий:

  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Значение этого поля указывается в микроединицах валюты рекламодателя или в виде значения рентабельности инвестиций в рекламу. Например, 1000000 означает 1,0 стандартной единицы валюты или 100% рентабельности инвестиций в рекламу. Если вы не используете подходящую стратегию, значение в этом поле будет равно 0.

effectiveBiddingValue

string (int64 format)

Только для вывода. Значение, которое эффективно используется стратегией назначения ставок. Если задано поле value, то значение в этом поле будет таким же. Если поле value не заполнено и стратегия назначена группе объявлений, то значение этого поля будет унаследовано из стратегии назначения ставок для позиции.

Если для поля type не задано значение DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA или DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS, в этом поле будет указано 0.

effectiveBiddingValueSource

enum (BiddingSource)

Только для вывода. Источник эффективного значения ставки.

DemandGenBiddingStrategyType

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

Перечисления
DEMAND_GEN_BIDDING_STRATEGY_TYPE_UNSPECIFIED Тип не указан или неизвестен.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA Стратегия назначения ставок, которая автоматически оптимизирует конверсии на каждый доллар.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS Стратегия назначения ставок, которая автоматически повышает доход, поддерживая среднюю целевую рентабельность инвестиций в рекламу.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Стратегия назначения ставок, которая автоматически максимизирует количество конверсий
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Стратегия назначения ставок, которая автоматически максимизирует доход в рамках заданного бюджета.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS Стратегия назначения ставок, которая автоматически максимизирует количество кликов в рамках заданного бюджета.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC Стратегия назначения ставок, которая автоматически оптимизирует цену за клик.