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 desempenho 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:

  • 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 for:

  • 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 para uma entidade de item de linha.

FixedBidStrategy

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

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

string (int64 format)

O valor fixo do lance, em micros na 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 máximo de 10.000.000.000.

Por exemplo, 1500000 representa 1,5 unidades padrão da moeda.

MaximizeSpendBidStrategy

Uma estratégia que ajusta automaticamente o lance para otimizar uma meta de desempenho específica 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 que pode ser definido para um lance, em micros na moeda do anunciante. Precisa ser maior ou igual a uma unidade faturável da moeda especificada.

Por exemplo, 1500000 representa 1,5 unidades padrão da moeda.

raiseBidForDeals

boolean

Se a estratégia leva em conta 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 performance para a estratégia de lances.

Enums
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED O valor do tipo não foi 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, visíveis e audíveis.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN Tempo de visualização acima de 10 segundos.
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 performance que a estratégia de lances vai tentar alcançar ou superar.

Para o 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 performance que a estratégia de lances tentará atingir ou superar, em micros da moeda do anunciante ou em micro do valor de retorno do investimento em publicidade (ROAS), 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 um limite superior:

  • quando performanceGoalType for BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, o limite máximo será de USD 10.000.
  • quando performanceGoalType for BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, o limite máximo será de USD 1.000.
  • quando performanceGoalType for BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, o limite máximo será de USD 1.000.
  • 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 ficar visível. Por exemplo, se o CPM desejado for US $2,00 e uma impressão tiver 40% de probabilidade de ser visível, o preço do lance será de US $0,80 de CPM (40% de US $2).

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

maxAverageCpmBidAmountMicros

string (int64 format)

O CPM médio máximo que pode ser definido para um lance, em micros na moeda do anunciante. Precisa ser maior ou igual a uma unidade faturável da moeda especificada. Não aplicável quando performanceGoalType está definido como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM.

Por exemplo, 1500000 representa 1,5 unidades 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.