Campaign

string

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

customers/{customerId}/campaigns/{campaignId}

enum (CampaignPrimaryStatus)

Apenas saída. O status principal da campanha.

Fornece insights sobre o motivo de uma campanha não ser veiculada de maneira otimizada. A modificação da campanha e das entidades relacionadas a ela pode levar algum tempo para se refletir nesse status.

enum (CampaignPrimaryStatusReason)

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

Fornece insights sobre o motivo de uma campanha não ser veiculada de maneira otimizada. Esses motivos são agregados para determinar um CampaignPrimaryStatus geral.

enum (CampaignStatus)

É o status da campanha.

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

enum (CampaignServingStatus)

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

enum (BiddingStrategySystemStatus)

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

enum (AdServingOptimizationStatus)

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

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.

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.

object (CustomParameter)

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

object (LocalServicesCampaignSettings)

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

object (TravelCampaignSettings)

Configurações da campanha de viagens.

object (DemandGenCampaignSettings)

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

object (VideoCampaignSettings)

Configurações da campanha de vídeo.

object (RealTimeBiddingSetting)

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

object (NetworkSettings)

As configurações de rede da campanha.

object (HotelSettingInfo)

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

object (DynamicSearchAdsSetting)

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

object (ShoppingSetting)

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

object (TargetingSetting)

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

object (GeoTargetTypeSetting)

É a configuração da segmentação geográfica de anúncios.

object (LocalCampaignSetting)

A configuração da campanha local.

object (AppCampaignSetting)

A configuração relacionada à campanha para apps.

string

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

enum (CampaignExperimentType)

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

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.

string

Apenas saída. Nome do recurso de Accessible BiddingStrategy, uma visualização somente leitura dos atributos irrestritos da estratégia de lances de portfólio anexada identificada por "lanceStrategy". Em branco, se a campanha não usa uma estratégia de portfólio. Os atributos irrestritos de estratégia estão 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 estão disponíveis apenas para o cliente proprietário da estratégia e seus gerentes. Os atributos restritos só podem ser lidos no recurso BiddingStrategy.

object (FrequencyCapEntry)

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

enum (BrandSafetySuitability)

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údos adequados para sua marca. Consulte https://support.google.com/google-ads/answer/7515513.

object (VanityPharma)

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

object (SelectiveOptimization)

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

object (OptimizationGoalSetting)

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

object (TrackingSetting)

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

enum (PaymentMode)

Forma de pagamento da campanha.

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 esta campanha.

enum (AssetSetType)

Os tipos de conjunto de recursos que devem ser excluídos dessa campanha. As vinculações do conjunto de recursos com esses tipos não serão herdadas do nível superior por esta campanha. Os tipos de grupo de 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, nenhum conjunto de recursos do grupo por locais poderá ser vinculado a essa campanha, e todas as extensões de local (LE) e extensões de local de afiliado (ALEs, na sigla em inglês) não serão veiculadas nessa campanha. No momento, apenas LOCATION_SYNC é compatível.

object (PerformanceMaxUpgrade)

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

object (AssetAutomationSetting)

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

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 de uma campanha.

string (int64 format)

Apenas saída. O ID da campanha.

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

string

O modelo de URL para criar um URL de rastreamento.

object (AudienceSetting)

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

string

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

Este campo é somente leitura.

string

O orçamento da campanha.

string

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

string

O grupo a que essa campanha pertence.

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.

string

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

number

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

A pontuação de otimização é uma estimativa do desempenho de uma campanha. Ela varia de 0% (0,0) a 100% (1,0), sendo que 100% indica que a campanha está com o potencial máximo. Este 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.

boolean

Representa a desativação da expansão de URL para URLs mais segmentados. Se desativado (verdadeiro), somente os URLs finais do grupo de recursos ou os URLs especificados nos feeds de dados da empresa ou do Google Merchant Center do anunciante serão segmentados. Se a opção for 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".

string

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

enum (ListingType)

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

string

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

object (Commission)

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

object (ManualCpa)

Estratégia de lances de CPA manual padrão. 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.

object (ManualCpc)

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

object (ManualCpm)

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

object (ManualCpv)

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

object (MaximizeConversions)

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

object (MaximizeConversionValue)

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

object (TargetCpa)

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 que você definiu.

object (TargetImpressionShare)

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

object (TargetRoas)

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

object (TargetSpend)

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

object (PercentCpc)

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

object (TargetCpm)

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

object (FixedCpm)

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

object (TargetCpv)

Uma estratégia de lances automáticos que define lances para otimizar a performance de acordo com o CPV desejado que você definiu.