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)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // 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 , присвоенное заказу на добавление, определяет возможные значения 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 должно быть больше или равно оплачиваемой единице в данной валюте и меньше или равно верхнему пределу 1000000000.

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

Стратегия максимизации расходов

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

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

enum ( BiddingStrategyPerformanceGoalType )

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

maxAverageCpmBidAmountMicros

string ( int64 format)

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

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

raiseBidForDeals

boolean

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

customBiddingAlgorithmId

string ( int64 format)

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

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

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

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

Перечисления
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 Видимый 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)

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

  • Если performanceGoalType имеет значение BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA , то верхняя граница составляет 10000,00 USD.
  • Если performanceGoalType имеет значение BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC , то верхняя граница составляет 1000,00 USD.
  • Когда performanceGoalType имеет значение BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM , верхняя граница составляет 1000,00 USD.
  • Когда performanceGoalType имеет значение BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO , верхняя граница составляет 1000,00, а нижняя — 0,01.

Пример: Если установлено значение BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM , цена ставки будет определяться на основе вероятности того, что каждый доступный показ будет показан. Например, если целевая цена CPM для видимых показов составляет 2 доллара, а вероятность того, что показ будет показан, составляет 40%, цена ставки составит 0,80 доллара CPM (40% от 2 долларов).

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

maxAverageCpmBidAmountMicros

string ( int64 format)

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

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

customBiddingAlgorithmId

string ( int64 format)

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

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

Стратегия торгов 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.

adGroupEffectiveTargetCpaValue

string ( int64 format)

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

adGroupEffectiveTargetCpaSource

enum ( BiddingSource )

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

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

BiddingSource

Источник информации о стоимости предложения.

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

Стратегия генерации спроса и размещения ставок

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

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

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

effectiveBiddingValue

string ( int64 format)

Только для вывода. Значение, фактически используемое стратегией назначения ставок. Если значение задано, оно будет совпадать со value в поле "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 Стратегия назначения ставок, которая автоматически максимизирует доход, обеспечивая при этом средний целевой показатель рентабельности инвестиций в рекламу (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 Стратегия назначения ставок, которая автоматически оптимизирует стоимость клика.