BiddingStrategy

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

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

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

object ( FixedBidStrategy )

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

maximize Spend Auto Bid

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 .

performance Goal Auto Bid

object ( PerformanceGoalBidStrategy )

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

youtube And Partners Bid

object ( YoutubeAndPartnersBiddingStrategy )

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

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

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

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

string ( int64 format)

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

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

Стратегия MaximizeSpendBid

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

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

enum ( BiddingStrategyPerformanceGoalType )

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

max Average Cpm Bid Amount Micros

string ( int64 format)

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

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

raise Bid For Deals

boolean

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

custom Bidding Algorithm Id

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
}
Поля
performance Goal Type

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 .
performance Goal Amount Micros

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 стандартных единицы валюты или значения рентабельности инвестиций в рекламу.

max Average Cpm Bid Amount Micros

string ( int64 format)

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

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

custom Bidding Algorithm Id

string ( int64 format)

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

YoutubeAndPartnersБиддингСтратегия

Настройки, управляющие стратегией назначения ставок для ресурсов 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.

ad Group Effective Target Cpa Value

string ( int64 format)

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

ad Group Effective Target Cpa Source

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 Стратегия назначения ставок, которая автоматически максимизирует доход при усреднении определенной целевой рентабельности инвестиций в рекламу (ROAS).
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Стратегия назначения ставок, которая автоматически устанавливает ставки, чтобы максимизировать доход при расходовании бюджета.

Источник ставок

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

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