BiddingStrategy

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

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

  // Union field bid_strategy_scheme can be only one of the following:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  }
  // End of list of possible types for union field bid_strategy_scheme.
}
Поля
Поле объединения bid_strategy_scheme . Необходимый. bid_strategy_scheme может быть только одним из следующих:
fixedBid

object ( FixedBidStrategy )

Стратегия, использующая фиксированную цену предложения.

maximizeSpendAutoBid

object ( MaximizeSpendBidStrategy )

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

На уровне заказа на размещение для параметра markupType позиций нельзя установить значение PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM . Кроме того, если performanceGoalType имеет одно из следующих значений:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED ,

lineItemType позиций заказа на размещение должен иметь одно из следующих значений:

  • LINE_ITEM_TYPE_DISPLAY_DEFAULT
  • LINE_ITEM_TYPE_VIDEO_DEFAULT ,

и когда performanceGoalType имеет значение:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN

lineItemType позиций заказа на размещение должен иметь значение LINE_ITEM_TYPE_VIDEO_DEFAULT .

performanceGoalAutoBid

object ( PerformanceGoalBidStrategy )

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

Стратегия фиксированной ставки

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

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

string ( int64 format)

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

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

Стратегия MaximizeSpendBid

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

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 .

Стратегия назначения ставокЭффективностьТип цели

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

Перечисления
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 Видимые показы.

ПроизводительностьЦельСтратегия ставок

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

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)

Необходимый. Цель эффективности, которую стратегия назначения ставок будет стремиться достичь или превзойти, выражается в микро-валюте рекламодателя или в микро-значении рентабельности инвестиций в рекламу (ROAS), которое также зависит от валюты рекламодателя. Должно быть больше или равно расчетной единице данной валюты и меньше или равно верхним границам. Каждый performanceGoalType имеет свою верхнюю границу:

  • если performanceGoalType установлено BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA , верхняя граница составляет 10 000,00 долларов США.
  • если 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,80 доллара США за тысячу показов (40 % от 2 долларов США).

Например, 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 .