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)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  }
  // 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 a meta de performance enquanto gasta 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 é uma das seguintes opções:

  • 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 atender ou superar uma meta de performance especificada. Ele deve ser usado apenas para uma entidade de item de linha.
youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

Uma estratégia de lances usada pelos recursos do YouTube e dos parceiros. Ele só pode ser usado para uma entidade de grupo de anúncios ou item de linha do YouTube e parceiros.

FixedBidStrategy

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

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

string (int64 format)

O valor do lance fixo, em micros da moeda do anunciante. Para a entidade do pedido de inserção, bidAmountMicros precisa ser definido como 0. Para a entidade de 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, 1500000 representa 1,5 unidades padrão da moeda.

MaximizeSpendBidStrategy

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

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 ao gastar 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 dado em micros da 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 considera 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 somente quando performanceGoalType é 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 e detectá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 atender ou superar uma meta de performance 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 vai tentar atingir ou superar, em micros da moeda do anunciante ou do valor de ROAS (retorno do investimento em publicidade), que também é baseado 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 máximo:

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

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

string (int64 format)

O CPM médio máximo que pode ser dado 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 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 somente quando performanceGoalType é definido como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

YoutubeAndPartnersBiddingStrategy

Configurações que controlam a estratégia de lances para recursos do YouTube e parceiros.

Representação JSON 
{
  "type": enum (YoutubeAndPartnersBiddingStrategyType),
  "value": string,
  "adGroupEffectiveTargetCpaValue": string,
  "adGroupEffectiveTargetCpaSource": enum (BiddingSource)
}
Campos
type

enum (YoutubeAndPartnersBiddingStrategyType)

É o tipo de estratégia de lances.
value

string (int64 format)

O valor usado pela estratégia de lances.

Quando a estratégia de lances é atribuída no nível do item de linha, esse campo só é aplicável aos seguintes tipos de estratégia:

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Quando a estratégia de lances é atribuída no nível do grupo de anúncios, esse campo só é aplicável aos seguintes tipos de estratégia:

  • 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

Se você não estiver usando uma estratégia aplicável, o valor desse campo será 0.
adGroupEffectiveTargetCpaValue

string (int64 format)

Apenas saída. O CPA desejado efetivo do grupo de anúncios, em micros da moeda do anunciante.
adGroupEffectiveTargetCpaSource

enum (BiddingSource)

Apenas saída. Origem do valor do CPA desejado efetivo do grupo de anúncios.

YoutubeAndPartnersBiddingStrategyType

Possíveis tipos de estratégia de lances para recursos do YouTube e dos Parceiros.

Enums
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED O tipo não foi especificado ou é desconhecido.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV Uma estratégia de lances que paga um valor configurável por visualização de vídeo.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM Uma estratégia de lances que paga um valor configurável por impressão.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA Uma estratégia de lances que otimiza automaticamente as conversões por dólar.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM Uma estratégia de lances que paga um valor configurável por impressão.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM Uma estratégia de lances para itens de linha da Reserva instantânea do YouTube que paga um valor fixo por impressão.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT Uma estratégia de lances automática que define lances para alcançar o aumento máximo.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Uma estratégia de lances que maximiza automaticamente o número de conversões com um orçamento diário.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV Uma estratégia de lances que otimiza automaticamente o custo por visualização de vídeo.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS Uma estratégia de lances que maximiza automaticamente a receita e calcula a média de um retorno do investimento em publicidade (ROAS) desejado específico.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Uma estratégia que define lances automaticamente para maximizar a receita enquanto gasta seu orçamento.

BiddingSource

Origem do valor do lance.

Enums
BIDDING_SOURCE_UNSPECIFIED A origem do lance não foi especificada ou é desconhecida.
BIDDING_SOURCE_LINE_ITEM O valor do lance é herdado do item de linha.
BIDDING_SOURCE_AD_GROUP O valor do lance é definido no grupo de anúncios.