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 может быть только одним из следующих:
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 )

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

youtubeAndPartnersBid

object ( YoutubeAndPartnersBiddingStrategy )

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

FixedBidStrategy

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

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

string ( int64 format)

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

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

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

Например, 1500000 представляет собой 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 Видимая цена за тысячу показов.
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 Видимые показы.

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 долларов США.
  • если 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 стандартные единицы валюты или значение ROAS.

maxAverageCpmBidAmountMicros

string ( int64 format)

The maximum average CPM that may be bid, in micros of the advertiser's currency. Must be greater than or equal to a billable unit of the given currency. Not applicable when performanceGoalType is set to 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 Instant Reserve, при которой выплачивается фиксированная сумма за показ.
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 Значение ставки определяется в группе объявлений.