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)
  },
  "demandGenCampaignSettings": {
    object (DemandGenCampaignSettings)
  },
  "videoCampaignSettings": {
    object (VideoCampaignSettings)
  },
  "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)
  },
  "assetAutomationSettings": [
    {
      object (AssetAutomationSetting)
    }
  ],
  "keywordMatchType": enum (CampaignKeywordMatchType),
  "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)
  },
  "fixedCpm": {
    object (FixedCpm)
  },
  "targetCpv": {
    object (TargetCpv)
  }
  // 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 de 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 otimizada. A modificação da campanha e das 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 otimizada. 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, finalUrls ou mobile_final_urls.
localServicesCampaignSettings

object (LocalServicesCampaignSettings)

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

object (TravelCampaignSettings)

Configurações da campanha de viagens.
demandGenCampaignSettings

object (DemandGenCampaignSettings)

Configurações da campanha Geração de demanda.
videoCampaignSettings

object (VideoCampaignSettings)

Configurações da campanha de vídeo.
realTimeBiddingSetting

object (RealTimeBiddingSetting)

Configurações para lances em tempo real, um recurso disponível apenas 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 de hotel da campanha.
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

A 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 de segmentação geográfica de 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.

Uma estratégia de lances pode ser criada definindo 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 não restritos da estratégia de lances de portfólio anexada identificada por "biddingStrategy". Vazia, se a campanha não usar uma estratégia de portfólio. Os atributos de estratégia irrestrita estão disponíveis para todos os clientes com quem a estratégia é compartilhada e são lidos no recurso AccessibleBiddingStrategy. Já os atributos restritos estão disponíveis apenas para o cliente proprietário da estratégia e os gerentes dele. Os atributos restritos só podem ser lidos do recurso BiddingStrategy.
frequencyCaps[]

object (FrequencyCapEntry)

Uma lista que limita a frequência com que cada usuário vai receber os anúncios da campanha.
videoBrandSafetySuitability

enum (BrandSafetySuitability)

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

object (VanityPharma)

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

object (SelectiveOptimization)

Configuração de otimização seletiva para essa campanha, que inclui um conjunto de ações de conversão para otimização. 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 essa 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)

Modo de pagamento da campanha.
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

Os tipos de campo de recurso que precisam ser excluídos dessa campanha. Os links de recursos com esses tipos de campo não serão herdados por essa campanha do nível superior.
excludedParentAssetSetTypes[]

enum (AssetSetType)

Os tipos de conjunto de recursos que precisam ser excluídos dessa campanha. Os links de conjuntos de recursos com esses tipos não serão herdados por essa campanha do nível superior. Os tipos de grupo por locais (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP e STATIC_LOCATION_GROUP) são tipos filhos de LOCATION_SYNC. Portanto, se LOCATION_SYNC estiver definido para esse campo, não será possível vincular todos os conjuntos de recursos de grupo de local a essa campanha, e todas as extensões de local (EL) e extensões de local de afiliado (ELA) não serão veiculadas nessa campanha. No momento, apenas LOCATION_SYNC é compatível.
performanceMaxUpgrade

object (PerformanceMaxUpgrade)

Apenas saída. Informações sobre o upgrade de campanhas para Performance Max.
assetAutomationSettings[]

object (AssetAutomationSetting)

Contém o status de ativação/desativação de cada AssetAutomationType. Consulte a documentação de cada tipo de enumeração de automação de recursos para saber o comportamento padrão de ativação/desativação.
keywordMatchType

enum (CampaignKeywordMatchType)

Tipo de correspondência de palavra-chave da campanha. Defina como "AMPLA" para definir a correspondência ampla para todas as palavras-chave em uma campanha.
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. Em campanhas base, ele é igual a resourceName.

Este campo é somente leitura.
campaignBudget

string

O nome do recurso do 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 nome do recurso do grupo de campanhas ao qual a 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 às páginas de destino veiculadas com o 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), sendo que 100% indica que a campanha está com o desempenho 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 URLs para URLs mais segmentados. Se desativada (verdadeiro), apenas os URLs finais no grupo de recursos ou URLs especificados no Google Merchant Center ou feeds de dados comerciais do anunciante sã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 é "false".
hotelPropertyAssetSet

string

Imutável. O nome do recurso de um conjunto de propriedades de hotéis para campanhas Performance Max para metas de turismo.
listingType

enum (ListingType)

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

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

Precisa ser de portfólio (criado pelo serviço BiddingStrategy) ou padrão, que é incorporado à campanha. campaign_bidding_strategy pode ser apenas de um dos tipos a seguir:
biddingStrategy

string

O nome do recurso da 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 certa parte do valor da conversão.
manualCpa

object (ManualCpa)

Estratégia de lances de CPA manual padrão. Estratégia de lances manual que permite ao anunciante definir o lance por ação especificada pelo anunciante. Disponível apenas para campanhas de Serviços locais.
manualCpc

object (ManualCpc)

Estratégia de lances padrão de CPC manual. Lances manuais com base no clique, em que o usuário paga por clique.
manualCpm

object (ManualCpm)

Estratégia de lances padrão de CPM manual. Lances manuais com base nas impressões em que o usuário paga por mil impressões.
manualCpv

object (ManualCpv)

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

object (MaximizeConversions)

Estratégia de lances padrão "Maximizar conversões", que maximiza automaticamente o número de conversões ao gastar seu orçamento.
maximizeConversionValue

object (MaximizeConversionValue)

Estratégia de lances padrão que maximiza o valor da conversão e define lances automaticamente para maximizar a receita sem exceder o orçamento.
targetCpa

object (TargetCpa)

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

object (TargetImpressionShare)

Estratégia de lances de parcela de impressões desejada. Uma estratégia de lances automática que define lances para alcançar uma porcentagem de impressões escolhida.
targetRoas

object (TargetRoas)

Estratégia de lances padrão de ROAS desejado que maximiza automaticamente a receita e calcula a média de um 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 com o orçamento disponível.
percentCpc

object (PercentCpc)

Estratégia de lances de percentual de CPC padrão em que os lances são uma fração do preço anunciado de um bem ou serviço.
targetCpm

object (TargetCpm)

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

object (FixedCpm)

Uma estratégia de lances manuais com um CPM fixo.
targetCpv

object (TargetCpv)

Uma estratégia de lances automática que define lances para otimizar a performance com base no CPV desejado definido.

CampaignPrimaryStatus

Enum 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 otimizada. A modificação da campanha e das entidades relacionadas pode levar algum tempo para ser refletida nesse status.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o 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 é pausado.
REMOVED O status da campanha especificado pelo usuário é removido.
ENDED O horário especificado pelo usuário para o término da campanha já passou.
PENDING A campanha pode ser veiculada no futuro.
MISCONFIGURED A campanha ou as entidades associadas têm configurações especificadas pelo usuário incorretas.
LIMITED A campanha ou as entidades associadas a ela são limitadas por configurações especificadas pelo usuário.
LEARNING O sistema de lances automáticos está se ajustando a 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 otimizada. Esses motivos são agregados para determinar o status principal da campanha.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o 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 é pausado.
CAMPAIGN_PENDING O horário especificado pelo usuário para o início da campanha é no futuro.
CAMPAIGN_ENDED O horário especificado pelo usuário para o término da campanha já passou.
CAMPAIGN_DRAFT A campanha é um rascunho.
BIDDING_STRATEGY_MISCONFIGURED A estratégia de lances tem configurações especificadas pelo usuário incorretas.
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 a mudanças especificadas pelo usuário na estratégia de lances.
BIDDING_STRATEGY_CONSTRAINED A campanha pode capturar mais valor de conversão ajustando 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 especificadas pelo usuário incorretas.
SEARCH_VOLUME_LIMITED A campanha não está segmentando todas as consultas relevantes.
AD_GROUPS_PAUSED Os status do grupo de anúncios especificados pelo usuário estão todos pausados.
NO_AD_GROUPS Não há grupos de anúncios qualificados nesta campanha.
KEYWORDS_PAUSED Os status das palavras-chave especificadas pelo usuário estão todos pausados.
NO_KEYWORDS Não há palavras-chave qualificadas nesta campanha.
AD_GROUP_ADS_PAUSED Os status dos anúncios do grupo especificados pelo usuário estão todos pausados.
NO_AD_GROUP_ADS Não há anúncios de grupos de anúncios qualificados nesta campanha.
HAS_ADS_LIMITED_BY_POLICY Pelo menos um anúncio dessa campanha está limitado pela política.
HAS_ADS_DISAPPROVED Pelo menos um anúncio dessa campanha foi reprovado.
MOST_ADS_UNDER_REVIEW A maioria dos anúncios dessa campanha está em análise.
MISSING_LEAD_FORM_EXTENSION A campanha tem uma meta de formulário de lead, mas não tem a extensão correspondente.
MISSING_CALL_EXTENSION A campanha tem uma meta de chamada, mas não tem a extensão correspondente.
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 revisão.
CALL_EXTENSION_DISAPPROVED A extensão de chamada foi reprovada.
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA Não há 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 está pausado.
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED Os horários especificados pelo usuário de todos os orçamentos de grupo associados ao grupo de campanhas principal já passaram.
APP_NOT_RELEASED O app associado a essa campanha de ACi não foi lançado nos países de destino dela.
APP_PARTIALLY_RELEASED O app associado a essa campanha de ACi foi lançado parcialmente nos países de destino da campanha.
HAS_ASSET_GROUPS_DISAPPROVED Pelo menos um grupo de recursos desta 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á em análise.
NO_ASSET_GROUPS Não há grupos de recursos qualificados nesta campanha.
ASSET_GROUPS_PAUSED Todos os grupos de recursos desta campanha estão pausados.

CampaignStatus

Possíveis status de uma campanha.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o 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 somente de resposta.
SERVING Exibição.
NONE Nenhum.
ENDED Finalizado.
PENDING Pendente.
SUSPENDED Suspenso.

BiddingStrategySystemStatus

Os possíveis status do sistema de uma estratégia de lances.

Enums
UNSPECIFIED Indica que ocorreu um erro inesperado, por exemplo, nenhum tipo de estratégia de lances foi encontrado ou nenhuma informação de status foi encontrada.
UNKNOWN Usado apenas para o 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á aprendendo porque foi criada ou reativada recentemente.
LEARNING_SETTING_CHANGE A estratégia de lances está aprendendo devido a uma mudança recente na configuração.
LEARNING_BUDGET_CHANGE A estratégia de lances está em processo de aprendizado devido a uma mudança recente no orçamento.
LEARNING_COMPOSITION_CHANGE A estratégia de lances está aprendendo devido a uma mudança recente no número de campanhas, grupos de anúncios ou palavras-chave associadas a ela.
LEARNING_CONVERSION_TYPE_CHANGE A estratégia de lances depende dos relatórios de conversão e dos tipos de conversão relevantes para a estratégia que o cliente modificou recentemente.
LEARNING_CONVERSION_SETTING_CHANGE A estratégia de lances depende dos relatórios de conversão, e o cliente mudou recentemente as configurações de conversão.
LIMITED_BY_CPC_BID_CEILING A estratégia de lances é limitada pelo teto de lances.
LIMITED_BY_CPC_BID_FLOOR A estratégia de lances é 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 parte significativa das palavras-chave nessa estratégia de lances está limitada pelo orçamento.
LIMITED_BY_LOW_PRIORITY_SPEND A estratégia de lances não consegue atingir o gasto desejado porque a prioridade dele foi removida.
LIMITED_BY_LOW_QUALITY Uma parte significativa das palavras-chave nessa 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 Acompanhamento de conversões ausente (sem pings) e/ou listas de remarketing para a SSC.
MISCONFIGURED_CONVERSION_TYPES A estratégia de lances depende dos relatórios de conversão, e o cliente não tem os tipos de conversão que podem ser informados para 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 incorretas.
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, grupos de anúncios ou palavras-chave ativas vinculadas à estratégia de lances. Ou não há orçamentos ativos conectados à estratégia de lances.
UNAVAILABLE No momento, essa estratégia de lances não é compatível com o Relatório de status.
MULTIPLE_LEARNING Houve vários status do sistema LEARNING_* para essa estratégia de lances durante o período em questão.
MULTIPLE_LIMITED Houve vários status LIMITED_* do sistema para essa estratégia de lances durante o período em questão.
MULTIPLE_MISCONFIGURED Houve vários status de sistema MISCONFIGURED_* para essa estratégia de lances durante o período em questão.
MULTIPLE Houve vários status do sistema para essa estratégia de lances durante o período em questão.

AdServingOptimizationStatus

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

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

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

Esse é um valor somente de resposta.
OPTIMIZE A veiculação de anúncios é otimizada com base na CTR da campanha.
CONVERSION_OPTIMIZE A veiculação de anúncios é 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 forma uniforme por 90 dias e, em seguida, otimizados para cliques.
ROTATE_INDEFINITELY Mostrar anúncios com desempenho inferior de maneira mais uniforme com anúncios de desempenho superior e não otimizar.
UNAVAILABLE O status de otimização do serviço de anúncios não está disponível.

LocalServicesCampaignSettings

Configurações do subrecurso LocalServicesCampaign.

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

object (CategoryBid)

Lances no nível da categoria associados à estratégia de lances MANUAL_CPA.

CategoryBid

Lances de categoria em LocalServicesReportingCampaignSettings.

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

string

Categoria com que o lance será associado. Por exemplo, xcat:service_area_business_plumber.
manualCpaBidMicros

string (int64 format)

Lance de CPA manual para a categoria. O lance precisa ser maior do que o preço de reserva associado a essa categoria. 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 associada à campanha de viagens.

DemandGenCampaignSettings

Configurações da campanha Geração de demanda.

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

boolean

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

VideoCampaignSettings

Configurações da campanha de vídeo.

Representação JSON 
{
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
Campos
videoAdInventoryControl

object (VideoAdInventoryControl)

Controle de inventário para contêineres de anúncios responsivos em campanhas de alcance.

VideoAdInventoryControl

Para campanhas que usam contêineres de anúncios responsivos, os controles de inventário determinam em quais inventários os anúncios podem ser exibidos. Isso só se aplica a campanhas com as estratégias de lances TARGET_CPM e FIXED_CPM.

Representação JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
Campos
allowInStream

boolean

Determine se os anúncios responsivos em vídeo podem ser usados para anúncios em vídeo in-stream.
allowInFeed

boolean

Determine se os anúncios responsivos em vídeo podem ser usados para anúncios em vídeo In-feed.
allowShorts

boolean

Determine se os anúncios responsivos em vídeo podem ser usados como formato de Shorts.

RealTimeBiddingSetting

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

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

boolean

Indica se a campanha está ativada para lances em tempo real.

NetworkSettings

As configurações de rede da campanha.

Representação JSON 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean,
  "targetYoutube": boolean,
  "targetGoogleTvNetwork": 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.
targetYoutube

boolean

Indica se os anúncios serão veiculados no YouTube.
targetGoogleTvNetwork

boolean

Indica se os anúncios serão veiculados na rede Google TV.

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

A 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 do idioma que especifica o idioma do domínio, por exemplo, "en".
feeds[]

string

Lista de nomes de recursos dos recursos do feed de páginas associados à campanha.
useSuppliedUrlsOnly

boolean

Indica se a campanha usa apenas 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,
  "campaignPriority": integer,
  "enableLocal": boolean,
  "disableProductFeed": boolean
}
Campos
feedLabel

string

Rótulo do feed de produtos a serem incluídos na campanha. Só é possível definir um dos campos feedLabel ou sales_country. Se usado em vez de "sales_country", o campo "feedLabel" aceita 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 listagem de veículos será segmentado. Esse campo só é aceito em campanhas inteligentes do Shopping. Para definir o inventário de listagem de veículos em campanhas Performance Max, use listingType.
advertisingPartnerIds[]

string (int64 format)

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

string (int64 format)

ID da conta do Merchant Center. Este campo é obrigatório para operações de criação. Esse campo é imutável para campanhas do Shopping.
campaignPriority

integer

Prioridade da campanha. As campanhas com prioridades numéricas mais altas têm precedência sobre as de 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

Se os produtos locais serão incluídos.
disableProductFeed

boolean

Desative o feed de produtos opcional. No momento, esse campo só é aceito em campanhas Geração de demanda. Acesse https://support.google.com/google-ads/answer/13721750 para saber mais sobre esse recurso.

AudienceSetting

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

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

boolean

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

GeoTargetTypeSetting

Representa um conjunto de configurações relacionadas à segmentação geográfica de 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 de segmentação por área geográfica positiva.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
PRESENCE_OR_INTEREST Especifica que um anúncio é acionado se o usuário estiver nos locais segmentados do anunciante ou demonstrar interesse neles.
SEARCH_INTEREST Especifica que um anúncio é acionado se o usuário pesquisar os locais segmentados do anunciante. Esse recurso só pode ser usado com campanhas de pesquisa e padrão do Shopping.
PRESENCE Especifica que um anúncio é acionado se o usuário está ou costuma estar nos locais segmentados do anunciante.

NegativeGeoTargetType

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nessa versão.
PRESENCE_OR_INTEREST Especifica que um usuário não pode ver o anúncio se estiver em um local excluído do anunciante ou demonstrar interesse por ele.
PRESENCE Especifica que um usuário não pode ver o anúncio se estiver em locais excluídos do anunciante.

LocalCampaignSetting

Configuração de campanhas locais.

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

enum (LocationSourceType)

O tipo de origem do local para essa campanha local.

LocationSourceType

Os possíveis tipos de origem de local.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
GOOGLE_MY_BUSINESS Locais associados ao Perfil da Empresa vinculado do cliente.
AFFILIATE Locais de lojas afiliadas (redes). Por exemplo, as lojas da Best Buy.

AppCampaignSetting

Configurações no nível da campanha para 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 esse app específico.
appId

string

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

AppCampaignBiddingStrategyGoalType

Tipo de meta da estratégia de lances da campanha para apps.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST Tente maximizar o número de instalações do app. O lance de cpa é o custo por instalação desejado.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST Tenha como objetivo maximizar o número de conversões no aplicativo selecionadas a longo prazo a partir das instalações do app. O lance de cpa é o custo por instalação desejado.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST Tenha como objetivo maximizar o número de conversões no aplicativo selecionadas a longo prazo a partir das instalações do app. O lance de CPA é o custo desejado por conversão no app. O CPA real pode parecer maior que o desejado no início, já que as conversões de longo prazo ainda não aconteceram.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND Tenha como objetivo maximizar o valor de todas as conversões, por exemplo, instalação + conversões no app selecionadas, enquanto atinge ou excede o retorno do investimento em publicidade desejado.
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME Tenha como objetivo maximizar o pré-registro do app.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST Tenha como objetivo maximizar a instalação do app sem usar 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 o 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 a campanha é normal, de rascunho ou experimental.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o 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 essa campanha experimental.

FrequencyCapEntry

Uma regra que especifica o número máximo de vezes que um anúncio (ou um conjunto de anúncios) pode ser mostrado a um usuário em um 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 durante o período de tempo por esse limite.

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 em que o limite será aplicado (por exemplo, grupo de anúncios, anúncio do grupo de anúncios). O limite é aplicado a todas as entidades desse nível.
eventType

enum (FrequencyCapEventType)

O tipo de evento ao qual 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 em que o limite 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 o valor de retorno. Representa um valor desconhecido nesta versão.
AD_GROUP_AD O limite é aplicado no nível 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 ao qual o limite se aplica (por exemplo, impressão).

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o 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 visualizações de anúncios em vídeo.

VanityPharma

Descreve como os anúncios 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 fictícios.
vanityPharmaText

enum (VanityPharmaText)

O texto que vai aparecer no URL de visualização do anúncio de texto quando a descrição do site for o modo de exibição selecionado para URLs de farmácia de fantasia.

VanityPharmaDisplayUrlMode

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

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

VanityPharmaText

Enumeração que descreve possíveis textos.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o 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 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 essa campanha, que inclui um conjunto de ações de conversão para otimização. 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

Conjunto selecionado de nomes de recursos para ações de conversão para otimizar esta campanha.

OptimizationGoalSetting

Configuração da meta de otimização para essa 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 um valor de retorno. Representa um valor desconhecido nesta versão.
CALL_CLICKS Otimizar para cliques em ligações. As conversões de cliques em ligações são as vezes que as pessoas selecionaram "Ligar" para entrar em contato com uma loja depois de visualizar um anúncio.
DRIVING_DIRECTIONS Otimize para rotas de carro. As conversões de direções de carro são as vezes que as pessoas selecionaram "Como chegar" para ir a uma loja depois de ver um anúncio.
APP_PRE_REGISTRATION Otimizar para pré-registro. As conversões de pré-registro são o número de inscrições 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 o acompanhamento dinâmico.

PaymentMode

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

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
CLICKS Pagamento por interação.
CONVERSION_VALUE Pagar pelo valor da conversão. Esse modo só é compatível com campanhas que usam AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION e BudgetType.STANDARD.
CONVERSIONS Pagamento por conversão. Esse modo só é compatível com campanhas com AdvertisingChannelType.DISPLAY (exceto AdvertisingChannelSubType.DISPLAY_GMAIL), BiddingStrategyType.TARGET_CPA e BudgetType.FIXED_CPA. O cliente também precisa estar qualificado para esse modo. Consulte Customer.eligibility_failure_reasons para mais detalhes.
GUEST_STAY Pagar pelo valor da estadia do hóspede. Esse modo só é compatível com campanhas que têm AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION e BudgetType.STANDARD.

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. O nome do recurso da campanha Performance Max para a qual a campanha está sendo atualizada.
preUpgradeCampaign

string

Apenas saída. O nome do recurso da campanha legada atualizada para Performance Max.
status

enum (PerformanceMaxUpgradeStatus)

Apenas saída. O status de upgrade de uma campanha solicitada para a Performance Max.

PerformanceMaxUpgradeStatus

Enum de status de upgrade da campanha Performance Max.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
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 O upgrade para uma campanha Performance Max falhou. A campanha ainda vai ser veiculada como antes da tentativa de upgrade.
UPGRADE_ELIGIBLE A campanha está qualificada para upgrade para Performance Max.

ListingType

Possíveis tipos de ficha.

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

AssetAutomationSetting

A configuração de automação de recursos contém um par de AssetAutomationType e o status de ativação/desativação da automação de recursos.

Representação JSON 
{
  "assetAutomationType": enum (AssetAutomationType),
  "assetAutomationStatus": enum (AssetAutomationStatus)
}
Campos
assetAutomationType

enum (AssetAutomationType)

O anunciante quer ativar/desativar o tipo de automação de recursos.
assetAutomationStatus

enum (AssetAutomationStatus)

O status de ativação/desativação do tipo de automação de recursos.

AssetAutomationType

O tipo de automação de recursos.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas como um valor de retorno. Representa um valor desconhecido nesta versão.
TEXT_ASSET_AUTOMATION A automação de recursos de texto inclui títulos e descrições. Por padrão, os anunciantes ativam as campanhas Performance Max e desativam a rede de pesquisa.

AssetAutomationStatus

O status da automação de recursos.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas como um valor de retorno. Representa um valor desconhecido nesta versão.
OPTED_IN A ativação vai permitir a geração e a veiculação de um tipo de automação de recursos.
OPTED_OUT A desativação vai interromper a geração e veiculação de um tipo de automação de recurso.

CampaignKeywordMatchType

Enum que descreve o tipo de correspondência de palavra-chave da campanha.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
BROAD Corresponde à correspondência ampla no nível da campanha.

Comissão

A comissão é uma estratégia de lances automática em que o anunciante paga uma certa 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 precisa ser transmitida 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 manual que permite ao anunciante definir o lance por ação especificada pelo anunciante.

ManualCpc

Lances manuais com base no clique, em que 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.

Lances manuais com base nas impressões em que o usuário paga por mil impressões.

ManualCpv

Esse tipo não tem campos.

Lances com base na visualização, em que o usuário paga por visualização de vídeo.

PercentCpc

Uma estratégia de lances em que os lances são uma fração do preço anunciado de um 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. É um campo opcional inserido pelo anunciante e especificado nos micros locais. Observação: um valor zero é interpretado da mesma forma que um bid_ceiling 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 o cpcBidCeilingMicros, mas o valor médio do lance de uma campanha não.

TargetCpm

O CPM desejado (custo por mil impressões) é uma estratégia de lances automática que define lances para otimizar a performance com base no CPM desejado.

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)

Contagem da frequência desejada que 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 alcançar a contagem de destino especificada.

FixedCpm

Estratégia de lances de CPM (custo por mil impressões) fixo. Uma estratégia de lances manuais com um CPM fixo.

Representação JSON 
{
  "goal": enum (FixedCpmGoal),

  // Union field goal_info can be only one of the following:
  "targetFrequencyInfo": {
    object (FixedCpmTargetFrequencyGoalInfo)
  }
  // End of list of possible types for union field goal_info.
}
Campos
goal

enum (FixedCpmGoal)

Meta de lance de CPM fixo. Determina os parâmetros exatos de otimização de lances.
Campo de união goal_info. Outras informações relacionadas à meta de lances. goal_info pode ser apenas de um dos tipos a seguir:
targetFrequencyInfo

object (FixedCpmTargetFrequencyGoalInfo)

Detalhes da meta de lances de frequência desejada.

FixedCpmGoal

Enum que descreve a meta da estratégia de lances de CPM fixo.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para o valor de retorno. Representa um valor desconhecido nesta versão.
REACH Maximizar o alcance, ou seja, o número de usuários que viram os anúncios na campanha.
TARGET_FREQUENCY Bidder de CPM de frequência desejada. Otimize os lances para alcançar um único usuário com a frequência solicitada.

FixedCpmTargetFrequencyGoalInfo

Detalhes da meta de lances de frequência desejada para a estratégia de lances de CPM fixo. Só é relevante se a meta da estratégia de lances for TARGET_FREQUENCY.

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

string (int64 format)

A contagem de frequência desejada representa o número de vezes que um anunciante quer veicular o anúncio para um único usuário.
timeUnit

enum (FixedCpmTargetFrequencyTimeUnit)

Janela de tempo que expressa o período em que você quer alcançar a contagem de destino especificada.

FixedCpmTargetFrequencyTimeUnit

Um tipo enumerado que descreve o período em que os lances são otimizados para atender à frequência desejada ao usar a estratégia de lances de CPM fixo.

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

TargetCpv

Esse tipo não tem campos.

Estratégia de lances de CPV (custo por visualização) desejado. Uma estratégia de lances automática que define lances para otimizar a performance com base no CPV desejado definido.