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)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // 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 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, o valor performanceGoalType atribuído a um pedido de inserção determina os valores lineItemType possíveis disponíveis para itens de linha nesse pedido de inserção:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC e BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED só permitem itens de linha LINE_ITEM_TYPE_DISPLAY_DEFAULT ou LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA e BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN só permitem itens de linha LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • O BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH só permite itens de linha LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

Uma estratégia que ajusta automaticamente o lance para atingir ou superar uma meta de performance especificada. Ele só pode ser usado para uma entidade de item de linha.
youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

Uma estratégia de lances usada pelos recursos do YouTube e parceiros.

Ele só pode ser usado para um item de linha ou uma entidade de grupo de anúncios do YouTube e parceiros.
demandGenBid

object (DemandGenBiddingStrategy)

Uma estratégia de lances usada pelos recursos da Geração de Demanda.

Ele só pode ser usado para um item de linha ou uma entidade de grupo de anúncios de Geração de demanda.

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 da moeda do anunciante. Para a entidade de pedido de inserção, bidAmountMicros precisa ser definido como 0. Para o item de linha, bidAmountMicros precisa ser maior ou igual à unidade faturável da moeda especificada e menor ou igual ao limite máximo de 1.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 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 usado em lances, 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 está definido como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

Atribuir um algoritmo de lances personalizados que usa atividades do Floodlight não identificadas em floodlightActivityConfigs vai retornar um erro.

BiddingStrategyPerformanceGoalType

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

Tipos enumerados
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.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH Maximize o alcance.

PerformanceGoalBidStrategy

Uma estratégia que ajusta automaticamente o lance para atingir 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 alcançar ou superar, em micros da moeda do anunciante ou em micros do valor do 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 máximos. Cada performanceGoalType tem um limite máximo:

  • quando performanceGoalType é BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, o limite superior é de US$ 10.000.
  • quando performanceGoalType é BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, o limite superior é de US$ 1.000,00.
  • quando performanceGoalType é BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, o limite superior é 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 que cada impressão disponível seja 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 visível, 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 valor de ROAS.
maxAverageCpmBidAmountMicros

string (int64 format)

O CPM médio máximo que pode ser usado em lances, 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 está definido como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

Atribuir um algoritmo de lances personalizados que usa atividades do Floodlight não identificadas em floodlightActivityConfigs vai retornar um erro.

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 de CPA desejado efetivo para o grupo de anúncios.

YoutubeAndPartnersBiddingStrategyType

Tipos possíveis de estratégia de lances para recursos do YouTube e parceiros.

Tipos enumerados
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED O tipo não está 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 de 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 máximo de Lift.
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 enquanto calcula a média de um retorno do investimento em publicidade desejado (ROAS) específico.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Uma estratégia de lances que define lances automaticamente para maximizar a receita dentro do orçamento.

BiddingSource

Origem do valor do lance.

Tipos enumerados
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.

DemandGenBiddingStrategy

Configurações que controlam a estratégia de lances para recursos de Geração de demanda.

Representação JSON 
{
  "type": enum (DemandGenBiddingStrategyType),
  "value": string,
  "effectiveBiddingValue": string,
  "effectiveBiddingValueSource": enum (BiddingSource)
}
Campos
type

enum (DemandGenBiddingStrategyType)

Opcional. É o tipo de estratégia de lances.

Isso só pode ser definido quando atribuído a um item de linha. Os grupos de anúncios vão herdar esse valor do item de linha.
value

string (int64 format)

Opcional. O valor usado pela estratégia de lances. Isso pode ser definido quando atribuído a itens de linha ou grupos de anúncios. Esse campo só é aplicável aos seguintes tipos de estratégia:

  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS

O valor desse campo está em micros da moeda do anunciante ou do ROAS. Por exemplo, 1000000 representa 1,0 unidade padrão da moeda ou 100% do valor do ROAS. Se você não estiver usando uma estratégia aplicável, o valor desse campo será 0.
effectiveBiddingValue

string (int64 format)

Apenas saída. O valor usado de fato pela estratégia de lances. Esse campo será igual a value se estiver definido. Se value não estiver definido e a estratégia for atribuída a um grupo de anúncios, esse campo será herdado da estratégia de lances do item de linha.

Se type não for DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA ou DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS, esse campo será 0.
effectiveBiddingValueSource

enum (BiddingSource)

Apenas saída. Origem do valor de lance efetivo.

DemandGenBiddingStrategyType

Tipos possíveis de estratégia de lances para recursos da Geração de demanda.

Tipos enumerados
DEMAND_GEN_BIDDING_STRATEGY_TYPE_UNSPECIFIED O tipo não está especificado ou é desconhecido.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA Uma estratégia de lances que otimiza automaticamente as conversões por dólar.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS Uma estratégia de lances que maximiza automaticamente a receita enquanto calcula a média de um retorno do investimento em publicidade desejado (ROAS) específico.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Uma estratégia de lances que maximiza automaticamente o número de conversões
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Uma estratégia de lances que maximiza automaticamente a receita enquanto gasta seu orçamento.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS Uma estratégia de lances que maximiza automaticamente os cliques dentro de um determinado orçamento.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC Uma estratégia de lances que otimiza automaticamente o custo por clique.