Campaign

Uma campanha.

Representação JSON
{
  "resourceName": string,
  "primaryStatus": enum (CampaignPrimaryStatus),
  "primaryStatusReasons": [
    enum (CampaignPrimaryStatusReason)
  ],
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "localServicesCampaignSettings": {
    object (LocalServicesCampaignSettings)
  },
  "travelCampaignSettings": {
    object (TravelCampaignSettings)
  },
  "discoveryCampaignSettings": {
    object (DiscoveryCampaignSettings)
  },
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "hotelSetting": {
    object (HotelSettingInfo)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "targetingSetting": {
    object (TargetingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "localCampaignSetting": {
    object (LocalCampaignSetting)
  },
  "appCampaignSetting": {
    object (AppCampaignSetting)
  },
  "labels": [
    string
  ],
  "experimentType": enum (CampaignExperimentType),
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "vanityPharma": {
    object (VanityPharma)
  },
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "paymentMode": enum (PaymentMode),
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "performanceMaxUpgrade": {
    object (PerformanceMaxUpgrade)
  },
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "audienceSetting": {
    object (AudienceSetting)
  },
  "baseCampaign": string,
  "campaignBudget": string,
  "startDate": string,
  "campaignGroup": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "optimizationScore": number,
  "urlExpansionOptOut": boolean,
  "hotelPropertyAssetSet": string,
  "listingType": enum (ListingType),

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "commission": {
    object (Commission)
  },
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "manualCpv": {
    object (ManualCpv)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Campos
resourceName

string

Imutável. O nome do recurso da campanha. Os nomes dos recursos da campanha têm o seguinte formato:

customers/{customerId}/campaigns/{campaignId}

primaryStatus

enum (CampaignPrimaryStatus)

Apenas saída. O status principal da campanha.

Fornece insights sobre por que uma campanha não está sendo veiculada ou não está sendo veiculada de maneira ideal. A modificação na campanha e nas entidades relacionadas pode levar algum tempo para ser refletida nesse status.

primaryStatusReasons[]

enum (CampaignPrimaryStatusReason)

Apenas saída. Os principais motivos do status da campanha.

Fornece insights sobre por que uma campanha não está sendo veiculada ou não está sendo veiculada de maneira ideal. Esses motivos são agregados para determinar um CampaignPrimaryStatus geral.

status

enum (CampaignStatus)

É o status da campanha.

Quando uma nova campanha é adicionada, o status é ATIVADO.

servingStatus

enum (CampaignServingStatus)

Apenas saída. O status de veiculação de anúncios da campanha.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Apenas saída. O status do sistema da estratégia de lances da campanha.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

O status de otimização da veiculação de anúncios da campanha.

advertisingChannelType

enum (AdvertisingChannelType)

Imutável. É a principal meta de veiculação de anúncios na campanha. As opções de segmentação podem ser refinadas em networkSettings.

Este campo é obrigatório e não deve ficar vazio ao criar novas campanhas.

Pode ser definido apenas ao criar campanhas. Depois que a campanha é criada, o campo não pode ser alterado.

advertisingChannelSubType

enum (AdvertisingChannelSubType)

Imutável. Refinamento opcional para advertisingChannelType. Precisa ser um subtipo válido do tipo de canal principal.

Pode ser definido apenas ao criar campanhas. Depois que a campanha é criada, o campo não pode ser alterado.

urlCustomParameters[]

object (CustomParameter)

A lista de mapeamentos usados para substituir tags de parâmetros personalizados em um trackingUrlTemplate, um finalUrls ou um mobile_final_urls.

localServicesCampaignSettings

object (LocalServicesCampaignSettings)

As configurações relacionadas à campanha dos Serviços Locais.

travelCampaignSettings

object (TravelCampaignSettings)

Configurações da campanha de viagens.

discoveryCampaignSettings

object (DiscoveryCampaignSettings)

Configurações da campanha Discovery.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

Configurações para lances em tempo real, um recurso disponível somente para campanhas que segmentam a rede do Ad Exchange.

networkSettings

object (NetworkSettings)

As configurações de rede da campanha.

hotelSetting

object (HotelSettingInfo)

Imutável. A configuração do hotel para a campanha.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

Configuração para controlar os anúncios dinâmicos de pesquisa (DSA).

shoppingSetting

object (ShoppingSetting)

A configuração para controlar as campanhas do Shopping.

targetingSetting

object (TargetingSetting)

Configuração para recursos relacionados à segmentação.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

A configuração da segmentação geográfica dos anúncios.

localCampaignSetting

object (LocalCampaignSetting)

A configuração da campanha local.

appCampaignSetting

object (AppCampaignSetting)

A configuração relacionada à campanha para apps.

labels[]

string

Apenas saída. Os nomes dos recursos dos rótulos anexados a esta campanha.

experimentType

enum (CampaignExperimentType)

Apenas saída. Tipo de campanha: normal, rascunho ou experimental.

biddingStrategyType

enum (BiddingStrategyType)

Apenas saída. É o tipo de estratégia de lances.

Para criar uma estratégia de lances, defina o esquema de lances para criar uma estratégia de lances padrão ou o campo biddingStrategy para criar uma estratégia de lances de portfólio.

Este campo é somente leitura.

accessibleBiddingStrategy

string

Apenas saída. Nome do recurso de AccessibleBiddingStrategy, uma visualização somente leitura dos atributos irrestritos da estratégia de lances de portfólio anexada, identificada por "biddingStrategy". Vazio se a campanha não usa uma estratégia de portfólio. Os atributos de estratégia irrestritos ficam disponíveis para todos os clientes com quem a estratégia é compartilhada e são lidos no recurso AccessibleBiddingStrategy. Por outro lado, os atributos restritos só estão disponíveis para o cliente proprietário da estratégia e os gerentes dele. Os atributos restritos só podem ser lidos no recurso BiddingStrategy.

frequencyCaps[]

object (FrequencyCapEntry)

Uma lista que limita a frequência com que cada usuário verá os anúncios dessa campanha.

videoBrandSafetySuitability

enum (BrandSafetySuitability)

Apenas saída. Configuração de brand safety no nível da campanha individual. Permite selecionar um tipo de inventário para mostrar os anúncios em conteúdo adequado à sua marca. Consulte https://support.google.com/google-ads/answer/7515513.

vanityPharma

object (VanityPharma)

Descreve como os anúncios de produtos farmacêuticos sem marca serão exibidos.

selectiveOptimization

object (SelectiveOptimization)

Configuração de otimização seletiva para esta campanha, que inclui um conjunto de ações de conversão para otimização dela. Esse recurso só se aplica a campanhas para apps que usam MULTI_CHANNEL como AdvertisingChannelType e APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType.

optimizationGoalSetting

object (OptimizationGoalSetting)

Configuração da meta de otimização para esta campanha, que inclui um conjunto de tipos de meta de otimização.

trackingSetting

object (TrackingSetting)

Apenas saída. Configurações no nível da campanha para informações de acompanhamento.

paymentMode

enum (PaymentMode)

Forma de pagamento da campanha.

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

Os tipos de campo de recurso que devem ser excluídos dessa campanha. As vinculações de recursos com esses tipos de campo não serão herdadas do nível superior por essa campanha.

excludedParentAssetSetTypes[]

enum (AssetSetType)

Os tipos de conjunto de recursos que devem ser excluídos dessa campanha. As vinculações de grupos de recursos com esses tipos não serão herdadas do nível superior por essa campanha. Os tipos de grupos por locais (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP e STATIC_LOCATION_GROUP) são tipos secundários de LOCATION_SYNC. Portanto, se LOCATION_SYNC estiver definido para esse campo, nenhum conjunto de recursos do grupo de locais poderá ser vinculado a essa campanha, e as extensões de local (LE) e as extensões de local de afiliado (ALE, na sigla em inglês) não serão veiculadas nessa campanha. No momento, apenas LOCATION_SYNC é compatível.

performanceMaxUpgrade

object (PerformanceMaxUpgrade)

Apenas saída. Informações sobre as campanhas que estão sendo atualizadas para Performance Max.

id

string (int64 format)

Apenas saída. O ID da campanha.

name

string

O nome da campanha.

Este campo é obrigatório e não deve ficar vazio ao criar novas campanhas.

Ele não pode conter nenhum caractere nulo (ponto de código 0x0), feed de linha NL (ponto de código 0xA) nem retorno de carro (ponto de código 0xD).

trackingUrlTemplate

string

O modelo de URL para criar um URL de rastreamento.

audienceSetting

object (AudienceSetting)

Imutável. Configuração para recursos relacionados ao público-alvo.

baseCampaign

string

Apenas saída. O nome do recurso da campanha base de uma campanha de rascunho ou experimental. Para campanhas de base, ele é igual a resourceName.

Este campo é somente leitura.

campaignBudget

string

O orçamento da campanha.

startDate

string

A data em que a campanha começou a ser veiculada no fuso horário do cliente no formato AAAA-MM-DD.

campaignGroup

string

O grupo a que esta campanha pertence.

endDate

string

O último dia da campanha no fuso horário da veiculação no formato AAAA-MM-DD. Na criação, o padrão é 2037-12-30, ou seja, a campanha será exibida indefinidamente. Para definir que uma campanha existente seja exibida indefinidamente, defina esse campo para 2037-12-30.

finalUrlSuffix

string

Sufixo usado para anexar parâmetros de consulta a páginas de destino veiculadas com acompanhamento paralelo.

optimizationScore

number

Apenas saída. Pontuação de otimização da campanha.

A pontuação de otimização é uma estimativa da performance de uma campanha. Ela varia de 0% (0,0) a 100% (1,0), e 100% indica que a campanha apresenta o potencial máximo. Esse campo é nulo para campanhas sem pontuação.

Consulte "Sobre a pontuação de otimização" em https://support.google.com/google-ads/answer/9061546.

Este campo é somente leitura.

urlExpansionOptOut

boolean

Representa a desativação da expansão de URL para URLs mais segmentados. Se a opção estiver desativada (verdadeiro), somente os URLs finais no grupo de recursos ou os URLs especificados no Google Merchant Center ou nos feeds de dados da empresa do anunciante serão segmentados. Se a opção estiver ativada (falso), todo o domínio será segmentado. Esse campo só pode ser definido para campanhas Performance Max, em que o valor padrão é "falso".

hotelPropertyAssetSet

string

Imutável. O conjunto de propriedades do hotel para campanhas Performance Max para metas de turismo.

listingType

enum (ListingType)

Imutável. Tipo de listagem dos anúncios veiculados para essa campanha. Esse campo é restrito para uso com campanhas Performance Max.

Campo de união campaign_bidding_strategy. Estratégia de lances da campanha.

Precisa ser um portfólio (criado por meio do serviço BiddingStrategy) ou padrão incorporado à campanha. campaign_bidding_strategy pode ser apenas de um dos tipos a seguir:

biddingStrategy

string

Estratégia de lances de portfólio usada pela campanha.

commission

object (Commission)

A comissão é uma estratégia de lances automática em que o anunciante paga uma determinada parte do valor da conversão.

manualCpa

object (ManualCpa)

Estratégia padrão de lances manuais de CPA. Estratégia de lances manuais que permite ao anunciante definir o lance por ação especificada pelo anunciante. Compatível apenas com campanhas dos Serviços Locais.

manualCpc

object (ManualCpc)

Estratégia padrão de lances manuais de CPC. Lance manual baseado em clique, no qual o usuário paga por clique.

manualCpm

object (ManualCpm)

Estratégia padrão de lances manuais de CPM. Lance manual baseado em impressão, no qual o usuário paga por mil impressões.

manualCpv

object (ManualCpv)

Uma estratégia de lances que paga um valor configurável por exibição de vídeo.

maximizeConversions

object (MaximizeConversions)

A estratégia de lances padrão "Maximizar conversões" que maximiza automaticamente o número de conversões dentro do seu orçamento.

maximizeConversionValue

object (MaximizeConversionValue)

A estratégia padrão "Maximizar o valor da conversão" define lances automaticamente para maximizar a receita gastando o orçamento automaticamente.

targetCpa

object (TargetCpa)

Estratégia de lances de CPA desejado padrão que define automaticamente os lances para gerar o maior número possível de conversões sem exceder o custo por aquisição (CPA) desejado que você definiu.

targetImpressionShare

object (TargetImpressionShare)

Estratégia de lances de parcela de impressões desejada. Uma estratégia de lances automática que define lances para atingir uma determinada porcentagem de impressões.

targetRoas

object (TargetRoas)

A estratégia de lances de ROAS desejado padrão que maximiza automaticamente a receita, encontrando uma média de retorno do investimento em publicidade (ROAS) desejado específico.

targetSpend

object (TargetSpend)

Estratégia de lances de gasto desejado padrão que define automaticamente seus lances para conseguir o máximo de cliques possível dentro do seu orçamento.

percentCpc

object (PercentCpc)

Estratégia de lances de CPC de porcentagem padrão em que os lances são uma fração do preço anunciado para algum produto ou serviço.

targetCpm

object (TargetCpm)

Uma estratégia de lances que otimiza automaticamente o custo por mil impressões.

CampaignPrimaryStatus

Enumeração que descreve o possível status principal da campanha. Fornece insights sobre por que uma campanha não está sendo veiculada ou não está sendo veiculada de maneira ideal. A modificação na campanha e nas entidades relacionadas pode levar algum tempo para ser refletida nesse status.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ELIGIBLE A campanha está qualificada para veiculação.
PAUSED O status da campanha especificado pelo usuário está pausado.
REMOVED O status da campanha especificado pelo usuário é removido.
ENDED O horário de término especificado pelo usuário para essa campanha já passou.
PENDING A campanha pode ser veiculada no futuro.
MISCONFIGURED A campanha ou as entidades associadas têm configurações incorretas definidas pelo usuário.
LIMITED A campanha ou as entidades associadas são limitadas pelas configurações especificadas pelo usuário.
LEARNING O sistema de lances automáticos está se ajustando de acordo com as mudanças especificadas pelo usuário na campanha ou nas entidades associadas.
NOT_ELIGIBLE A campanha não está qualificada para veiculação.

CampaignPrimaryStatusReason

Enumeração que descreve os possíveis motivos do status principal da campanha. Fornece insights sobre por que uma campanha não está sendo veiculada ou não está sendo veiculada de maneira ideal. Esses motivos são agregados para determinar o status geral principal da campanha.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
CAMPAIGN_REMOVED O status da campanha especificado pelo usuário é removido.
CAMPAIGN_PAUSED O status da campanha especificado pelo usuário está pausado.
CAMPAIGN_PENDING O horário de início especificado pelo usuário para o início desta campanha está no futuro.
CAMPAIGN_ENDED O horário de término especificado pelo usuário para essa campanha já passou.
CAMPAIGN_DRAFT A campanha é um rascunho.
BIDDING_STRATEGY_MISCONFIGURED A estratégia de lances tem configurações incorretas pelo usuário.
BIDDING_STRATEGY_LIMITED A estratégia de lances é limitada por configurações especificadas pelo usuário, como falta de dados ou algo semelhante.
BIDDING_STRATEGY_LEARNING O sistema de lances automáticos está se ajustando às mudanças especificadas pelo usuário na estratégia de lances.
BIDDING_STRATEGY_CONSTRAINED A campanha pode gerar um valor de conversão maior se ajustar as metas de CPA/ROAS.
BUDGET_CONSTRAINED O orçamento está limitando a capacidade de veiculação da campanha.
BUDGET_MISCONFIGURED O orçamento tem configurações incorretas definidas pelo usuário.
SEARCH_VOLUME_LIMITED A campanha não está segmentando todas as consultas relevantes.
AD_GROUPS_PAUSED Todos os status do grupo de anúncios especificados pelo usuário são pausados.
NO_AD_GROUPS Não há grupos de anúncios qualificados nesta campanha.
KEYWORDS_PAUSED Todos os status de palavra-chave especificados pelo usuário são pausados.
NO_KEYWORDS Não há palavras-chave qualificadas nesta campanha.
AD_GROUP_ADS_PAUSED Todos os status de anúncio do grupo de anúncios especificados pelo usuário estão pausados.
NO_AD_GROUP_ADS Não há anúncios do grupo de anúncios qualificados nesta campanha.
HAS_ADS_LIMITED_BY_POLICY Pelo menos um anúncio desta campanha está limitado pela política.
HAS_ADS_DISAPPROVED Pelo menos um anúncio desta campanha foi reprovado.
MOST_ADS_UNDER_REVIEW A maioria dos anúncios desta campanha está com revisão pendente.
MISSING_LEAD_FORM_EXTENSION A campanha tem uma meta de formulário de lead, mas não há extensão de formulário de lead.
MISSING_CALL_EXTENSION A campanha tem uma meta de chamada, e a extensão de chamada não foi incluída.
LEAD_FORM_EXTENSION_UNDER_REVIEW A extensão de formulário de lead está em revisão.
LEAD_FORM_EXTENSION_DISAPPROVED A extensão de lead foi reprovada.
CALL_EXTENSION_UNDER_REVIEW A extensão de chamada está em análise.
CALL_EXTENSION_DISAPPROVED A extensão de chamada foi reprovada.
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA Não existem critérios de grupos de anúncios de aplicativos para dispositivos móveis qualificados nesta campanha.
CAMPAIGN_GROUP_PAUSED O status do grupo de campanhas especificado pelo usuário é pausado.
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED Os horários especificados pelo usuário para todos os orçamentos de grupo associados ao grupo de campanhas principal já passaram.
APP_NOT_RELEASED O app associado a essa campanha ACi não foi lançado nos países de destino da campanha.
APP_PARTIALLY_RELEASED O app associado a essa campanha ACi foi lançado parcialmente nos países de destino da campanha.
HAS_ASSET_GROUPS_DISAPPROVED Pelo menos um grupo de recursos nesta campanha foi reprovado.
HAS_ASSET_GROUPS_LIMITED_BY_POLICY Pelo menos um grupo de recursos nesta campanha está limitado pela política.
MOST_ASSET_GROUPS_UNDER_REVIEW A maioria dos grupos de recursos desta campanha está com revisão pendente.

CampaignStatus

Possíveis status de uma campanha.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED A campanha está ativa e pode exibir anúncios.
PAUSED A campanha foi pausada pelo usuário.
REMOVED A campanha foi removida.

CampaignServingStatus

Possíveis status de veiculação de uma campanha.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor apenas de resposta.

SERVING Disponibilização.
NONE Nenhum.
ENDED Finalizada.
PENDING Pendente.
SUSPENDED Suspenso.

BiddingStrategySystemStatus

Os possíveis status do sistema de uma BiddingStrategy.

Enums
UNSPECIFIED Indica que um erro inesperado ocorreu. Por exemplo, nenhum tipo de estratégia de lances foi encontrado ou nenhuma informação de status foi encontrada.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
ENABLED A estratégia de lances está ativa, e o Google AdWords não encontrou nenhum problema específico com a estratégia.
LEARNING_NEW A estratégia de lances está em aprendizado porque foi criada ou reativada recentemente.
LEARNING_SETTING_CHANGE A estratégia de lances está aprendendo devido a uma alteração recente na configuração.
LEARNING_BUDGET_CHANGE A estratégia de lances está aprendendo devido a uma alteração recente no orçamento.
LEARNING_COMPOSITION_CHANGE A estratégia de lances está aprendendo devido a uma alteração recente no número de campanhas, grupos de anúncios ou palavras-chave anexadas a ela.
LEARNING_CONVERSION_TYPE_CHANGE A estratégia de lances depende dos relatórios de conversão e dos tipos de conversão que o cliente modificou recentemente e que eram relevantes para a estratégia de lances.
LEARNING_CONVERSION_SETTING_CHANGE A estratégia de lances depende dos relatórios de conversão, e o cliente mudou as configurações de conversão recentemente.
LIMITED_BY_CPC_BID_CEILING A estratégia de lances está limitada pelo lance máximo.
LIMITED_BY_CPC_BID_FLOOR A estratégia de lances está limitada pelo lance mínimo.
LIMITED_BY_DATA A estratégia de lances está limitada porque não houve tráfego de conversão suficiente nas últimas semanas.
LIMITED_BY_BUDGET Uma fração significativa das palavras-chave nesta estratégia de lances está limitada pelo orçamento.
LIMITED_BY_LOW_PRIORITY_SPEND A estratégia de lances não pode alcançar o gasto desejado porque a prioridade do gasto foi removida.
LIMITED_BY_LOW_QUALITY Uma fração significativa das palavras-chave nesta estratégia de lances tem um Índice de qualidade baixo.
LIMITED_BY_INVENTORY A estratégia de lances não pode gastar todo o orçamento devido à segmentação restrita.
MISCONFIGURED_ZERO_ELIGIBILITY Não há acompanhamento de conversões (não há pings) e/ou listas de remarketing para as CISs.
MISCONFIGURED_CONVERSION_TYPES A estratégia de lances depende dos relatórios de conversão, e o cliente não tem tipos de conversão que possam ser informados sobre essa estratégia.
MISCONFIGURED_CONVERSION_SETTINGS A estratégia de lances depende dos relatórios de conversão, e as configurações de conversão do cliente estão configuradas incorretamente.
MISCONFIGURED_SHARED_BUDGET Há campanhas fora da estratégia de lances que compartilham orçamentos com as campanhas incluídas na estratégia.
MISCONFIGURED_STRATEGY_TYPE A campanha tem um tipo de estratégia inválido e não está sendo veiculada.
PAUSED A estratégia de lances não está ativa. Não há campanhas, palavras-chave ou grupos de anúncios ativos vinculados à estratégia de lances. ou não há orçamentos ativos associados à estratégia de lances.
UNAVAILABLE No momento, essa estratégia de lances não é compatível com relatórios de status.
MULTIPLE_LEARNING Havia vários status de sistema LEARNING_* para essa estratégia de lances no período em questão.
MULTIPLE_LIMITED Havia vários status de sistema LIMITED_* para essa estratégia de lances durante o período em questão.
MULTIPLE_MISCONFIGURED Havia vários status de sistema MISCONFIGURED_* para essa estratégia de lances durante o período em questão.
MULTIPLE Havia vários status de sistema para essa estratégia de lances durante o período em questão.

AdServingOptimizationStatus

Enumeração que descreve possíveis status de exibição.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor apenas de resposta.

OPTIMIZE A veiculação do anúncio é otimizada com base na CTR da campanha.
CONVERSION_OPTIMIZE A veiculação do anúncio é otimizada com base na CTR * conversão da campanha. Se a campanha não estiver na estratégia de lances do otimizador de conversões, o padrão será OTIMIZADO.
ROTATE Os anúncios são alternados de maneira uniforme por 90 dias e depois otimizados para cliques.
ROTATE_INDEFINITELY Exiba anúncios de menor desempenho de forma mais uniforme com anúncios de melhor desempenho e não otimize.
UNAVAILABLE O status de otimização do serviço de anúncios não está disponível.

LocalServicesCampaignSettings

Configurações do sub-recurso LocalServicesCampaign.

Representação JSON
{
  "categoryBids": [
    {
      object (CategoryBid)
    }
  ]
}
Campos
categoryBids[]

object (CategoryBid)

Lances no nível categórico associados à estratégia de lances MANUAL_CPA.

CategoryBid

Lances de categoria em LocalServicesReportingCampaignSettings.

Representação JSON
{
  "categoryId": string,
  "manualCpaBidMicros": string
}
Campos
categoryId

string

Categoria à qual o lance será associado. Por exemplo, "xcat:service_area_business_encanador".

manualCpaBidMicros

string (int64 format)

Lance de CPA manual para a categoria. O lance precisa ser maior que o preço de reserva associado à categoria em questão. O valor está em micros e na moeda do anunciante.

TravelCampaignSettings

Configurações da campanha de viagens.

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

string (int64 format)

Imutável. O ID da conta de viagens associado à campanha de viagens.

DiscoveryCampaignSettings

Configurações da campanha Discovery.

Representação JSON
{
  "upgradedTargeting": boolean
}
Campos
upgradedTargeting

boolean

Imutável. Especifica se esta campanha usa opções de segmentação atualizadas. Quando esse campo é definido como true, você pode usar a segmentação por local e idioma no grupo de anúncios em vez da segmentação padrão no nível da campanha. Por padrão, esse campo é false e só pode ser definido durante a criação de uma campanha.

RealTimeBiddingSetting

Configurações para lances em tempo real, um recurso disponível somente para campanhas que segmentam a rede do Ad Exchange.

Representação JSON
{
  "optIn": boolean
}
Campos
optIn

boolean

Indica se os lances em tempo real estão ativados na campanha.

NetworkSettings

As configurações de rede da campanha.

Representação JSON
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
Campos
targetSearchNetwork

boolean

Indica se os anúncios serão veiculados em sites parceiros na rede de pesquisa do Google (requer que targetGoogleSearch também seja true).

targetContentNetwork

boolean

Indica se os anúncios serão veiculados em canais específicos na Rede de Display do Google. Os canais são especificados usando o critério Canal.

targetPartnerSearchNetwork

boolean

Indica se os anúncios serão veiculados na rede de parceiros do Google. Esse recurso está disponível apenas para algumas contas de parceiros do Google selecionadas.

HotelSettingInfo

Configurações no nível da campanha para anúncios de hotel.

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

string (int64 format)

Imutável. A conta da Central para Hotéis vinculada.

DynamicSearchAdsSetting

Configuração para controlar os anúncios dinâmicos de pesquisa (DSA).

Representação JSON
{
  "domainName": string,
  "languageCode": string,
  "feeds": [
    string
  ],
  "useSuppliedUrlsOnly": boolean
}
Campos
domainName

string

Obrigatório. O nome de domínio da Internet que essa configuração representa, por exemplo, "google.com" ou "www.google.com".

languageCode

string

Obrigatório. O código de idioma que especifica o idioma do domínio, por exemplo, "en".

feeds[]

string

A lista de feeds de páginas associados à campanha.

useSuppliedUrlsOnly

boolean

Se a campanha usa exclusivamente URLs fornecidos pelo anunciante.

ShoppingSetting

A configuração das campanhas do Shopping. Define o universo de produtos que podem ser anunciados pela campanha e como ela interage com outras campanhas do Shopping.

Representação JSON
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "advertisingPartnerIds": [
    string
  ],
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
Campos
feedLabel

string

Rótulo do feed dos produtos a serem incluídos na campanha. Somente um dos atributos "feedLabel" ou "salesCountry" pode ser definido. Se usado em vez de salesCountry, o campo feedLabel aceitará códigos de país no mesmo formato, por exemplo: "XX". Caso contrário, pode ser qualquer string usada para o rótulo do feed no Google Merchant Center.

useVehicleInventory

boolean

Imutável. Indica se o inventário de informações de veículos será segmentado. Esse campo só é compatível com campanhas inteligentes do Shopping. Para definir o inventário de informações de veículos nas campanhas Performance Max, use listingType.

advertisingPartnerIds[]

string (int64 format)

Imutável. Os IDs das contas de anúncios dos parceiros que cooperam na campanha.

merchantId

string (int64 format)

Imutável. ID da conta do Merchant Center. Este campo é obrigatório para operações de criação. Esse campo não pode ser modificado nas campanhas do Shopping.

salesCountry

string

O país de venda dos produtos a serem incluídos na campanha. Somente um dos atributos "feedLabel" ou "salesCountry" pode ser definido. O campo é imutável, exceto para limpeza. Depois que esse campo for preenchido, será necessário usar "feedLabel" se você quiser definir o país de venda.

campaignPriority

integer

Prioridade da campanha. As campanhas com prioridades numericamente mais altas têm precedência sobre aquelas com prioridades mais baixas. Esse campo é obrigatório para campanhas do Shopping, com valores entre 0 e 2. Esse campo é opcional para campanhas inteligentes do Shopping, mas precisa ser igual a 3, se definido.

enableLocal

boolean

Indica se produtos disponíveis na loja física devem ser incluídos.

AudienceSetting

Configurações da segmentação por público-alvo.

Representação JSON
{
  "useAudienceGrouped": boolean
}
Campos
useAudienceGrouped

boolean

Imutável. Se verdadeiro, a campanha usa um recurso de público-alvo para a segmentação por público-alvo. Se for falso, a campanha poderá usar critérios de segmento de público-alvo.

GeoTargetTypeSetting

Representa um conjunto de configurações relacionadas à segmentação geográfica dos anúncios.

Representação JSON
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Campos
positiveGeoTargetType

enum (PositiveGeoTargetType)

A configuração usada para a segmentação geográfica positiva nessa campanha específica.

negativeGeoTargetType

enum (NegativeGeoTargetType)

A configuração usada para a segmentação geográfica negativa nessa campanha específica.

PositiveGeoTargetType

Os possíveis tipos positivos de segmentação geográfica.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
PRESENCE_OR_INTEREST Especifica que um anúncio será acionado se o usuário estiver nas regiões de segmentação do anunciante ou se ele demonstrar interesse nelas.
SEARCH_INTEREST Especifica que um anúncio será acionado se o usuário pesquisar as regiões de segmentação do anunciante. Essa opção só pode ser usada em campanhas padrão do Shopping e de pesquisa.
PRESENCE Especifica que um anúncio será acionado se o usuário estiver nas regiões de segmentação do anunciante ou regularmente.

NegativeGeoTargetType

Os possíveis tipos de segmentação geográfica negativa.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
PRESENCE_OR_INTEREST Especifica que um usuário não poderá ver o anúncio se estiver nos locais excluídos do anunciante ou tiver interesse neles.
PRESENCE Especifica que um usuário não poderá ver o anúncio se estiver nos locais excluídos do anunciante.

LocalCampaignSetting

Configuração para campanhas locais.

Representação JSON
{
  "locationSourceType": enum (LocationSourceType)
}
Campos
locationSourceType

enum (LocationSourceType)

O tipo de origem do local para essa campanha local.

LocationSourceType

Os tipos possíveis de uma origem de local.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
GOOGLE_MY_BUSINESS Locais associados ao Perfil da Empresa vinculado ao cliente.
AFFILIATE Locais das lojas dos afiliados (rede). Por exemplo, locais da loja Best Buy.

AppCampaignSetting

Configurações no nível da campanha em campanhas para apps.

Representação JSON
{
  "biddingStrategyGoalType": enum (AppCampaignBiddingStrategyGoalType),
  "appStore": enum (AppCampaignAppStore),
  "appId": string
}
Campos
biddingStrategyGoalType

enum (AppCampaignBiddingStrategyGoalType)

Representa a meta que a estratégia de lances dessa campanha para apps precisa otimizar.

appStore

enum (AppCampaignAppStore)

Imutável. A loja de aplicativos que distribui o aplicativo específico.

appId

string

Imutável. Uma string que identifica exclusivamente um aplicativo para dispositivos móveis.

AppCampaignBiddingStrategyGoalType

Tipo de meta da campanha para apps BiddingStrategy.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST Tente maximizar o número de instalações de apps. O lance de CPA é o custo por instalação desejado.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST Busque maximizar o número de longo prazo de conversões no aplicativo selecionadas a partir de instalações de aplicativos. O lance de CPA é o custo por instalação desejado.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST Busque maximizar o número de longo prazo de conversões no aplicativo selecionadas a partir de instalações de aplicativos. O lance de CPA é o custo desejado por conversão no app. O CPA real pode parecer maior do que o CPA desejado a princípio, já que as conversões de longo prazo ainda não ocorreram.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND Tente maximizar o valor de todas as conversões, por exemplo, instalações + conversões no app selecionadas, atingindo ou excedendo o retorno do investimento em publicidade desejado.
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME Busque maximizar o pré-registro do app.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST Tente maximizar o número de instalações do app sem o custo por instalação desejado.

AppCampaignAppStore

Enumeração que descreve a app store da campanha para apps.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
APPLE_APP_STORE App Store da Apple.
GOOGLE_APP_STORE Google Play

CampaignExperimentType

Indica se essa campanha é normal, de rascunho ou experimental.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
BASE Esta é uma campanha comum.
DRAFT Esta é uma versão de rascunho de uma campanha. Ela tem algumas modificações de uma campanha de base, mas não veicula nem acumula métricas.
EXPERIMENT Esta é uma versão experimental de uma campanha. Ela tem algumas modificações de uma campanha de base, e uma porcentagem do tráfego está sendo desviada da campanha BASE para esta campanha experimental.

FrequencyCapEntry

Uma regra que especifica o número máximo de vezes que um anúncio (ou algum conjunto de anúncios) pode ser exibido a um usuário em determinado período.

Representação JSON
{
  "key": {
    object (FrequencyCapKey)
  },
  "cap": integer
}
Campos
key

object (FrequencyCapKey)

A chave de um limite de frequência específico. Não pode haver mais de um limite de frequência com a mesma chave.

cap

integer

Número máximo de eventos permitidos para esse limite durante o período.

FrequencyCapKey

Um grupo de campos usados como chaves para um limite de frequência. Não pode haver mais de um limite de frequência com a mesma chave.

Representação JSON
{
  "level": enum (FrequencyCapLevel),
  "eventType": enum (FrequencyCapEventType),
  "timeUnit": enum (FrequencyCapTimeUnit),
  "timeLength": integer
}
Campos
level

enum (FrequencyCapLevel)

O nível no qual o limite deve ser aplicado (por exemplo, anúncio do grupo de anúncios, grupo de anúncios). O limite é aplicado a todas as entidades desse nível.

eventType

enum (FrequencyCapEventType)

É o tipo de evento a que o limite se aplica (por exemplo, impressão).

timeUnit

enum (FrequencyCapTimeUnit)

Unidade de tempo em que o limite é definido (por exemplo, dia, semana).

timeLength

integer

Número de unidades de tempo que o limite dura.

FrequencyCapLevel

O nível no qual o limite deve ser aplicado (por exemplo, anúncio do grupo de anúncios, grupo de anúncios). O limite é aplicado a todos os recursos desse nível.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
AD_GROUP_AD O limite é aplicado no nível do anúncio do grupo de anúncios.
AD_GROUP O limite é aplicado no nível do grupo de anúncios.
CAMPAIGN O limite é aplicado no nível da campanha.

FrequencyCapEventType

É o tipo de evento a que o limite se aplica (por exemplo, impressão).

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
IMPRESSION O limite se aplica às impressões de anúncios.
VIDEO_VIEW O limite se aplica às exibições de anúncios em vídeo.

BrandSafetySuitability

Controle de adequação de brand safety em três níveis.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
EXPANDED_INVENTORY Com essa opção, você pode exibir anúncios em todo o inventário no YouTube e em parceiros de vídeo que atendem aos nossos padrões de monetização. Ela é interessante para marcas que querem ter acesso total a todas as opções de vídeos qualificados para anúncios, incluindo, por exemplo, vídeos com linguagem obscena em comédias ou documentários ou com violência extrema em videogames.
STANDARD_INVENTORY Com essa opção, você pode veicular anúncios em uma grande variedade de conteúdo apropriado para a maioria das marcas, como videoclipes famosos, documentários e trailers de filmes. O conteúdo em que você pode exibir anúncios baseia-se nas diretrizes de conteúdo adequado para publicidade do YouTube, que consideram, por exemplo, a intensidade ou a frequência da linguagem obscena ou a adequação de assuntos como eventos sensíveis. Os anúncios não serão veiculados, por exemplo, em conteúdo com linguagem obscena recorrente, conteúdo sexual pesado ou violência explícita.
LIMITED_INVENTORY Com essa opção, você pode exibir anúncios em uma faixa reduzida de conteúdo, adequada a marcas com diretrizes rigorosas em relação a linguagem imprópria e insinuação sexual, que vão muito além do que as diretrizes de conteúdo adequado para publicidade do YouTube. Os vídeos acessíveis nessa categoria sensível atendem a requisitos mais rigorosos, especialmente para linguagem imprópria e conotação sexual. Por exemplo, seus anúncios não são veiculados em alguns dos videoclipes mais famosos e em outros conteúdos de cultura pop no YouTube e nos parceiros de vídeo do Google.

VanityPharma

Descreve como os anúncios de produtos farmacêuticos sem marca serão exibidos.

Representação JSON
{
  "vanityPharmaDisplayUrlMode": enum (VanityPharmaDisplayUrlMode),
  "vanityPharmaText": enum (VanityPharmaText)
}
Campos
vanityPharmaDisplayUrlMode

enum (VanityPharmaDisplayUrlMode)

O modo de exibição para URLs de produtos farmacêuticos curtos.

vanityPharmaText

enum (VanityPharmaText)

O texto que será exibido no URL de visualização do anúncio de texto quando a descrição do website for o modo de exibição selecionado para URLs de produtos farmacêuticos.

VanityPharmaDisplayUrlMode

Enumeração que descreve possíveis modos de exibição para URLs de produtos farmacêuticos curtos.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
MANUFACTURER_WEBSITE_URL Substitua o URL de produtos farmacêuticos pelo URL do site do fabricante.
WEBSITE_DESCRIPTION Substitua o URL de produtos farmacêuticos pela descrição do site.

VanityPharmaText

Enumeração que descreve o texto possível.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
PRESCRIPTION_TREATMENT_WEBSITE_EN Site sobre tratamentos controlados com conteúdo em inglês.
PRESCRIPTION_TREATMENT_WEBSITE_ES Site sobre tratamentos controlados com conteúdo em espanhol (Sitio de tratamientos con receta).
PRESCRIPTION_DEVICE_WEBSITE_EN Site sobre dispositivos controlados com conteúdo em inglês.
PRESCRIPTION_DEVICE_WEBSITE_ES Site sobre dispositivos controlados com conteúdo de site em espanhol (Sitio de dispositivos con receta).
MEDICAL_DEVICE_WEBSITE_EN Site sobre dispositivos médicos com conteúdo em inglês.
MEDICAL_DEVICE_WEBSITE_ES Site sobre dispositivos médicos com conteúdo em espanhol (Sitio de dispositivos médicos).
PREVENTATIVE_TREATMENT_WEBSITE_EN Site sobre tratamentos preventivos com conteúdo em inglês.
PREVENTATIVE_TREATMENT_WEBSITE_ES Site sobre tratamentos preventivos com conteúdo em espanhol (Sitio de tratamientos preventivos).
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN Site sobre contraceptivos controlados com conteúdo em inglês.
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES Site sobre contraceptivos controlados com conteúdo em espanhol (Sitio de anticonceptivos con receta).
PRESCRIPTION_VACCINE_WEBSITE_EN Site sobre vacinas controladas com conteúdo em inglês.
PRESCRIPTION_VACCINE_WEBSITE_ES Site sobre vacinas controladas com conteúdo em espanhol (Sitio de vacunas con receta).

SelectiveOptimization

Configuração de otimização seletiva para esta campanha, que inclui um conjunto de ações de conversão para otimização dela. Esse recurso só se aplica a campanhas para apps que usam MULTI_CHANNEL como AdvertisingChannelType e APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT como AdvertisingChannelSubType.

Representação JSON
{
  "conversionActions": [
    string
  ]
}
Campos
conversionActions[]

string

O conjunto selecionado de ações de conversão para otimizar esta campanha.

OptimizationGoalSetting

Configuração da meta de otimização para esta campanha, que inclui um conjunto de tipos de meta de otimização.

Representação JSON
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Campos
optimizationGoalTypes[]

enum (OptimizationGoalType)

A lista de tipos de meta de otimização.

OptimizationGoalType

O tipo de meta de otimização

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas como valor de retorno. Representa um valor desconhecido nesta versão.
CALL_CLICKS Otimizar para cliques de chamada. As conversões de cliques de chamada são vezes em que as pessoas selecionaram "Ligar" para entrar em contato com uma loja depois de ver um anúncio.
DRIVING_DIRECTIONS Otimizar para rotas de carro. As conversões de rotas de carro são os momentos em que as pessoas selecionaram "Como chegar" para ir a uma loja depois de visualizar um anúncio.
APP_PRE_REGISTRATION Otimizar para pré-registro. As conversões de pré-registro são o número de inscrições de pré-registro para receber uma notificação quando o app for lançado.

TrackingSetting

Configurações no nível da campanha para informações de acompanhamento.

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

string

Apenas saída. O URL usado para rastreamento dinâmico.

PaymentMode

Enumeração que descreve possíveis modos de pagamento.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
CLICKS Pagamento por interação.
CONVERSION_VALUE Pagamento por valor de conversão. Esse modo só é compatível com campanhas com AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION e BudgetType.DEFAULT.
CONVERSIONS Pagamento por conversão. Esse modo só é compatível com campanhas com AdvertisingChannelType.DISPLAY (exceto AdvertisingChannelSubType.DISPLAY_ histórico), BiddingStrategyType.TARGET_CPA e orçamentoType.FIXED_CPA. O cliente também precisa estar qualificado para esse modo. Consulte Customer.eligibility_fail_reasons para conferir mais detalhes.
GUEST_STAY Valor de pagamento por estadia do hóspede. Esse modo só é compatível com campanhas com AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION e BudgetType.DEFAULT.

PerformanceMaxUpgrade

Informações sobre uma campanha que está sendo atualizada para Performance Max.

Representação JSON
{
  "performanceMaxCampaign": string,
  "preUpgradeCampaign": string,
  "status": enum (PerformanceMaxUpgradeStatus)
}
Campos
performanceMaxCampaign

string

Apenas saída. Indica para qual campanha Performance Max a campanha será atualizada.

preUpgradeCampaign

string

Apenas saída. Indica que a campanha legada foi atualizada para Performance Max.

status

enum (PerformanceMaxUpgradeStatus)

Apenas saída. O status do upgrade de uma campanha que precisa ser atualizada para Performance Max.

PerformanceMaxUpgradeStatus

Enumeração do status do upgrade das campanhas Performance Max para a campanha.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
UPGRADE_ELIBIGLE A campanha pode ser atualizada para Performance Max.
UPGRADE_IN_PROGRESS O upgrade para uma campanha Performance Max está em andamento.
UPGRADE_COMPLETE O upgrade para uma campanha Performance Max foi concluído.
UPGRADE_FAILED Falha no upgrade para uma campanha Performance Max. A campanha ainda será veiculada como estava antes da tentativa de upgrade.

ListingType

Possíveis tipos de listagens.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
VEHICLES Esta campanha veicula anúncios de veículos.

Comissão

A comissão é uma estratégia de lances automática em que o anunciante paga uma determinada parte do valor da conversão.

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

string (int64 format)

A taxa de comissão define a parte do valor da conversão que será cobrada do anunciante. Uma taxa de comissão de x deve ser passada a esse campo como (x * 1.000.000). Por exemplo, 106.000 representa uma taxa de comissão de 0,106 (10,6%).

ManualCpa

Esse tipo não tem campos.

Estratégia de lances manuais que permite ao anunciante definir o lance por ação especificada pelo anunciante.

ManualCpc

Lance manual baseado em clique, no qual o usuário paga por clique.

Representação JSON
{
  "enhancedCpcEnabled": boolean
}
Campos
enhancedCpcEnabled

boolean

Indica se os lances devem ser otimizados com base nos dados do otimizador de conversões.

ManualCpm

Esse tipo não tem campos.

Lance manual baseado em impressão, no qual o usuário paga por mil impressões.

ManualCpv

Esse tipo não tem campos.

Lances com base em visualizações em que o usuário paga por exibição de vídeo.

PercentCpc

Estratégia de lances em que os lances são uma fração do preço anunciado para algum produto ou serviço.

Representação JSON
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Campos
cpcBidCeilingMicros

string (int64 format)

Limite de lance máximo que pode ser definido pela estratégia de lances. Este é um campo opcional inserido pelo anunciante e especificado em micros locais. Observação: um valor zero é interpretado da mesma maneira que ter bid_threshold indefinido.

enhancedCpcEnabled

boolean

Ajusta o lance para cada leilão para cima ou para baixo, dependendo da probabilidade de uma conversão. Os lances individuais podem exceder cpcBidCeilingMicros, mas o valor do lance médio de uma campanha não deve.

TargetCpm

O CPM (custo por mil impressões) desejado é uma estratégia de lances automáticos que define lances para otimizar a performance de acordo com o CPM desejado que você definiu.

Representação JSON
{

  // Union field goal can be only one of the following:
  "targetFrequencyGoal": {
    object (TargetCpmTargetFrequencyGoal)
  }
  // End of list of possible types for union field goal.
}
Campos
Campo de união goal. Outras informações relacionadas à meta de lances. goal pode ser apenas de um dos tipos a seguir:
targetFrequencyGoal

object (TargetCpmTargetFrequencyGoal)

Detalhes da meta de lances de frequência desejada

TargetCpmTargetFrequencyGoal

Detalhes da meta de lances de frequência desejada

Representação JSON
{
  "targetCount": string,
  "timeUnit": enum (TargetFrequencyTimeUnit)
}
Campos
targetCount

string (int64 format)

A contagem de frequência desejada representa quantas vezes você quer alcançar um único usuário.

timeUnit

enum (TargetFrequencyTimeUnit)

Janela de tempo que expressa o período em que você quer atingir a targetCount especificada.

TargetFrequencyTimeUnit

Enumeração que descreve a janela de tempo em que queremos atingir a frequência desejada.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
WEEKLY Otimize os lances para alcançar a frequência desejada em uma semana.