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 o lance automaticamente 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 ,

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 fixo de lance.

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 1000000000.

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 que pode ser um lance, em micros da moeda do anunciante. Precisa ser maior ou igual a uma unidade faturável da moeda especificada.

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

boolean

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

Tipos possíveis de meta de desempenho para a estratégia de lances.

Enums
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED O valor do tipo não é 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 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 performance que a estratégia de lances tentará atingir ou superar.

Para uso no nível do item de linha, o valor precisa ser uma das seguintes opções:

  • 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 no micros do valor do retorno do 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 superior será US$ 10.000,00.
  • quando performanceGoalType for BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, o limite superior será US$ 1.000,00.
  • quando performanceGoalType for BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, o limite superior será US$ 1.000,00.
  • quando performanceGoalType é BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO, o limite superior é 1.000,00 e o limite inferior é 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 ser visível. Por exemplo, se o CPM desejado for de R $2,00 e uma impressão tiver 40% de probabilidade de ser visível, o preço do lance será de CPM de R $0,80 (40% de R $2,00).

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

string (int64 format)

O CPM médio máximo que pode ser um lance, em micros da moeda do anunciante. Precisa ser maior ou igual a uma unidade faturável da moeda especificada. Não aplicável quando performanceGoalType estiver 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.