BiddingStrategy

Configurações que controlam a estratégia de lances. A estratégia de lances determina o preço do lance.

Representação 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.
}
Campos
Campo de união bid_strategy_scheme. Obrigatório. bid_strategy_scheme pode ser apenas de um dos tipos a seguir:
fixedBid

object (FixedBidStrategy)

Uma estratégia que usa um preço de lance fixo.
maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

Uma estratégia que ajusta automaticamente o lance para otimizar sua meta de performance gastando todo o orçamento.

No nível do pedido de inserção, o markupType dos itens de linha não pode ser definido como PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM. Além disso, quando performanceGoalType for um dos seguintes:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED ,

o lineItemType dos itens de linha do pedido de inserção precisa ser:

  • LINE_ITEM_TYPE_DISPLAY_DEFAULT
  • LINE_ITEM_TYPE_VIDEO_DEFAULT ,

e quando performanceGoalType é:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN

o lineItemType dos itens de linha do pedido de inserção precisa ser LINE_ITEM_TYPE_VIDEO_DEFAULT.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

Uma estratégia que ajusta automaticamente o lance para atingir ou superar uma meta de desempenho especificada. Ele deve ser usado somente com uma entidade de item de linha.

FixedBidStrategy

Uma estratégia que usa um preço fixo de lance.

Representação JSON 
{
  "bidAmountMicros": string
}
Campos
bidAmountMicros

string (int64 format)

O valor fixo do lance, em micros da moeda do anunciante. Para a entidade do pedido de inserção, bidAmountMicros precisa ser definido como "0". Para a entidade do item de linha, bidAmountMicros precisa ser maior ou igual à unidade faturável da moeda especificada e menor ou igual ao limite superior de 1.000000000.

Por exemplo, 1.500.000 representa 1,5 unidade padrão da moeda.

MaximizeSpendBidStrategy

Uma estratégia que ajusta automaticamente o lance para otimizar uma meta de performance especificada gastando todo o orçamento.

Representação JSON 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "maxAverageCpmBidAmountMicros": string,
  "raiseBidForDeals": boolean,
  "customBiddingAlgorithmId": string
}
Campos
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Obrigatório. O tipo de meta de performance que a estratégia de lances tenta minimizar enquanto gasta todo o orçamento. BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM não é compatível com essa estratégia.
maxAverageCpmBidAmountMicros

string (int64 format)

O CPM médio máximo do lance, em micros da moeda do anunciante. Precisa ser maior ou igual a uma unidade faturável de determinada moeda.

Por exemplo, 1.500.000 representa 1,5 unidade padrão da moeda.
raiseBidForDeals

boolean

Define se a estratégia leva em consideração os preços mínimos da transação.
customBiddingAlgorithmId

string (int64 format)

O ID do algoritmo de lances personalizados usado por essa estratégia. Aplicável apenas quando performanceGoalType está definido como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

BiddingStrategyPerformanceGoalType

Possíveis tipos de meta de desempenho para a estratégia de lances.

Enums
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED O valor do tipo não está especificado ou é desconhecido nesta versão.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA Custo por ação.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC Custo por clique.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM CPM visível.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO Algoritmo de lances personalizados.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA Visualizações concluídas e audíveis.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN Tempo de visualização acima de 10 segundos de visualizações.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED Impressões visíveis.

PerformanceGoalBidStrategy

Uma estratégia que ajusta automaticamente o lance para atingir ou superar uma meta de desempenho especificada.

Representação JSON 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "performanceGoalAmountMicros": string,
  "maxAverageCpmBidAmountMicros": string,
  "customBiddingAlgorithmId": string
}
Campos
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Obrigatório. O tipo de meta de desempenho que a estratégia de lances tentará alcançar ou superar.

Para uso no nível do item de linha, o valor precisa ser um dos seguintes:

  • 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)

Obrigatório. A meta de desempenho que a estratégia de lances tentará atingir ou superar, em micros da moeda do anunciante ou em micros do valor do retorno sobre o investimento em publicidade (ROAS, na sigla em inglês), que também se baseia na moeda do anunciante. Precisa ser maior ou igual a uma unidade faturável da moeda especificada e menor ou igual aos limites superiores. Cada performanceGoalType tem seu limite superior:

  • quando performanceGoalType for BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, o limite máximo será de USD 10.000,00.
  • quando performanceGoalType for BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, o limite máximo será de USD 1.000,00.
  • quando performanceGoalType for BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, o limite máximo será de USD 1.000,00.
  • Quando performanceGoalType for BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO, o limite superior será 1.000,00 e o limite inferior será 0,01.

Exemplo: se definido como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, o preço do lance será baseado na probabilidade de cada impressão disponível estar visível. Por exemplo, se o CPM desejado for R $2,00 e uma impressão tiver 40% de probabilidade de ser visível, o preço do lance será um CPM de R $0,80 (40% de R $2,00).

Por exemplo, 1.500.000 representa 1,5 unidade padrão da moeda ou valor do ROAS.
maxAverageCpmBidAmountMicros

string (int64 format)

O CPM médio máximo do lance, em micros da moeda do anunciante. Precisa ser maior ou igual a uma unidade faturável de determinada moeda. Não se aplica quando performanceGoalType está definido como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM.

Por exemplo, 1.500.000 representa 1,5 unidade padrão da moeda.
customBiddingAlgorithmId

string (int64 format)

O ID do algoritmo de lances personalizados usado por essa estratégia. Aplicável apenas quando performanceGoalType está definido como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.