Criar uma campanha para apps

Crie campanhas para apps com a API Google Ads para promover seu app para dispositivos móveis na Pesquisa, no Google Play, no YouTube, na AdMob, no Discover e na Rede de Display do Google. Otimize campanhas para instalações, ações no app, valor da conversão ou pré-registros do Android. As campanhas ativadas estão sujeitas às cobranças padrão de veiculação de anúncios do Google Ads até o limite do seu orçamento.

Preparação

A meta da campanha (custo por instalação (CPI), custo por ação (CPA), retorno do investimento em publicidade (ROAS) ou pré-registros) determina as configurações da API. Encontre sua meta na tabela a seguir antes de concluir as etapas de criação. Para procurar um controle de interface do Google Ads, consulte Mapear as configurações da interface do Google Ads para os campos da API ou Sobre as campanhas para apps.

Seleção de meta e interface do Google Ads Subtipo e tipo enumerado de meta Estratégia de lances Configurações de conversão (conversion_actions)
Mais instalações (CPI desejado).
Volume de instalações > Todos os usuários, Definir um custo por instalação desejado (opcional) selecionado.
APP_CAMPAIGN.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST.
target_cpa (target_cpa_micros = CPI desejado). Opcional. Até uma ação DOWNLOAD em conversion_actions.
Mais instalações sem o CPI desejado.
Volume de instalações > Todos os usuários, Definir um custo por instalação desejado (opcional) desmarcado.
APP_CAMPAIGN.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST.
maximize_conversions (sem target_cpa_micros). Opcional. Até uma ação DOWNLOAD.
Instalações com ação no app (CPI desejado).
Volume de instalações > Usuários propensos a realizar uma ação no app, Custo por instalação desejado.
APP_CAMPAIGN.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST.
target_cpa (target_cpa_micros = CPI desejado). Obrigatório. Uma ação no app, além da ação opcional DOWNLOAD.
Ações no app (CPA desejado).
Ações no app, Definir um custo desejado por ação no app (opcional) selecionado (ou Custo por ação desejado para engajamento).
APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST.
target_cpa (target_cpa_micros = CPA desejado). Obrigatório. Ações pós-instalação. Opcional DOWNLOAD em APP_CAMPAIGN (nenhum no engajamento).
Ações no app sem CPA desejado.
Ações no app, Definir um custo desejado por ação no app (opcional) desmarcado.
APP_CAMPAIGN.
OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA.
maximize_conversions (sem target_cpa_micros). Obrigatório. Ações pós-instalação, além da ação opcional DOWNLOAD.
Valor da ação no app (ROAS desejado).
Valor da ação no app, Definir um retorno do investimento em publicidade desejado (opcional) selecionado (ou Retorno do investimento em publicidade desejado para engajamento).
APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND.
target_roas (target_roas = ROAS desejado). Obrigatório. Ações de valor (como Firebase ou GOOGLE_PLAY_IN_APP_PURCHASE). DOWNLOAD opcional somente em APP_CAMPAIGN.
Valor da ação no app sem ROAS desejado.
Valor da ação no app, Definir um retorno do investimento em publicidade desejado (opcional) desmarcado.
APP_CAMPAIGN.
OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS.
maximize_conversion_value (sem target_roas). Obrigatório. Ações de valor (como Firebase ou GOOGLE_PLAY_IN_APP_PURCHASE), além da ação opcional DOWNLOAD.
Pré-registro do app (somente para Android).
Pré-registro (custo desejado por pré-registro).
APP_CAMPAIGN_FOR_PRE_REGISTRATION (somente GOOGLE_APP_STORE).
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME.
target_cpa (target_cpa_micros = custo desejado por pré-registro). Não defina a selective_optimization. Adicione APP_PRE_REGISTRATION a optimization_goal_types.

Etapas

Crie todos os recursos de forma atômica em uma solicitação GoogleAdsService.Mutate usando IDs temporários negativos ou chame CampaignService.MutateCampaigns.

Configurar e criar a campanha

Configure o recurso Campaign:

  1. Crie um CampaignBudget diário para campaign_budget com amount_micros e explicitly_shared definidos como false (o padrão é true; os orçamentos compartilhados e CUSTOM_PERIOD falham). Consulte Criar orçamentos de campanha.

  2. Defina name e, se quiser, defina status como PAUSED ao anexar anúncios (o padrão é ENABLED).

  3. Defina o imutável advertising_channel_type como MULTI_CHANNEL e o imutável advertising_channel_sub_type como APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT ou APP_CAMPAIGN_FOR_PRE_REGISTRATION.

  4. Defina contains_eu_political_advertising como DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING ou CONTAINS_EU_POLITICAL_ADVERTISING. As chamadas MutateCampaigns independentes exigem essa declaração da União Europeia (UE) (opcional na v26 e em versões mais recentes ao segmentar de forma atômica apenas locais fora da UE; consulte Anúncios políticos da UE).

  5. Defina app_campaign_setting como um objeto AppCampaignSetting (app_store e app_id são imutáveis):

    • app_store: AppCampaignAppStore (GOOGLE_APP_STORE ou APPLE_APP_STORE; o pré-registro requer GOOGLE_APP_STORE).
    • app_id: nome do pacote do Google Play (com.example.app) ou ID numérico da App Store da Apple. O engajamento exige um número mínimo de instalações. O pré-registro exige um app de pré-registro não lançado do Play Console (não qualificado para APP_CAMPAIGN até o lançamento).
    • bidding_strategy_goal_type: AppCampaignBiddingStrategyGoalType da meta (mutável).
  6. Defina uma estratégia de lances padrão em Campaign (recursos de portfólio BiddingStrategy não são compatíveis). Ativar ou desativar uma meta de interface opcional muda bidding_strategy_goal_type e o campo de lances oneof:

    • CPI, CPA ou pré-registro desejado: defina target_cpa com target_cpa_micros positivo em micros da moeda da conta (1500000 = 1,50 unidade, como US $1,50).
    • ROAS desejado: defina target_roas com target_roas de 0.01 para 1000.0 (3.0 = 300% de ROAS).
    • Maximizar sem meta (somente APP_CAMPAIGN): defina como vazio maximize_conversions ou maximize_conversion_value. Não defina maximize_conversions.target_cpa_micros (rejeitado em MULTI_CHANNEL) ou maximize_conversion_value.target_roas.
  7. Configure as metas de conversão ou pré-registro:

  8. Opcional: a partir da v24, defina view_through_conversion_optimization_enabled como true em campanhas para Android APP_CAMPAIGN para lances de conversão de visualização (VTC) (padrão da interface true, padrão da API false).

  9. Opcional: defina start_date_time (00:00:00, hoje ou depois) e end_date_time (23:59:59) no fuso horário da conta (yyyy-MM-dd HH:mm:ss). Chame MutateCampaigns ou GoogleAdsService.Mutate.

Opcional: adicionar segmentação e exclusões de campanha

Refine a segmentação após a criação ou na mesma solicitação GoogleAdsService.Mutate:

Mapear as configurações da interface do Google Ads para os campos da API

Use esta tabela para mapear os controles de interface do Google Ads para os campos da API Google Ads (Lances e orçamento para instalações de apps ou Orçamento e lances para engajamento e pré-registro).

Seção e rótulo da interface do Google Ads Recurso e campo da API Detalhes
App > Selecione um subtipo de campanha (Instalações de apps, Engajamento com o app, Pré-registro do app (somente para Android)). Campaign.advertising_channel_type, Campaign.advertising_channel_sub_type. Imutável: MULTI_CHANNEL com APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT ou APP_CAMPAIGN_FOR_PRE_REGISTRATION.
Configurações da campanha > Nome da campanha. Campaign.name. Nome de exibição obrigatório na conta de cliente.
Configurações da campanha > App para dispositivos móveis. Campaign.app_campaign_setting.app_store, Campaign.app_campaign_setting.app_id. Imutável: GOOGLE_APP_STORE (nome do pacote; obrigatório para pré-registro) ou APPLE_APP_STORE (ID numérico).
Configurações da campanha > Locais e Idiomas. CampaignCriterion (location, language). Adicionado com MutateCampaignCriteria ou GoogleAdsService.Mutate atômico.
Configurações da campanha > Otimização de conversões de visualização > Ativar conversões de visualização. Campaign.view_through_conversion_optimization_enabled. Somente Android APP_CAMPAIGN (v24 e mais recentes). O padrão é true na interface e false na API.
Configurações da campanha > Anúncios políticos na UE (Sua campanha tem anúncios políticos na União Europeia?). Campaign.contains_eu_political_advertising. Mapeia Sim, esta campanha tem anúncios políticos na UE e Não, esta campanha não tem anúncios políticos na UE.
Configurações da campanha > Datas de início e término. Campaign.start_date_time, Campaign.end_date_time. Carimbos de data/hora opcionais do fuso horário da conta (00:00:00 hoje ou posterior e 23:59:59).
Lances e orçamento > Orçamento. CampaignBudget.amount_micros, Campaign.campaign_budget. Micros diários na moeda da conta com CampaignBudget.explicitly_shared definido como false.
Lances e orçamento > Lances > Qual é o foco da campanha? e Que tipo de usuário você quer segmentar?
Definir um custo por instalação desejado (opcional), Definir um custo desejado por ação no app (opcional) e Definir um retorno do investimento em publicidade desejado (opcional).
Custo por instalação desejado, custo por ação desejado e retorno do investimento em publicidade desejado.
Campaign.app_campaign_setting.bidding_strategy_goal_type, Campaign.target_cpa.target_cpa_micros, Campaign.target_roas.target_roas, Campaign.maximize_conversions, Campaign.maximize_conversion_value. Define o tipo enumerado da meta e o campo de lances oneof (consulte Preparação). As estratégias sem segmentação se aplicam apenas a APP_CAMPAIGN. No iOS, Otimizar para valores de conversão da SKAdNetwork é somente para interface (leia esquemas com CustomerSkAdNetworkConversionValueSchema).
Lances e orçamento > Lances > Como você quer acompanhar o volume de instalações?
Qual ação é mais importante para você? e Quais ações são mais importantes para você?
Campaign.selective_optimization.conversion_actions. O seletor de instalação adiciona até uma ação DOWNLOAD (somente APP_CAMPAIGN). Os seletores de ação adicionam uma (singular) ou várias (plural) ações que correspondem a app_id.
Orçamento e lances > Lances > Pré-registro e Custo desejado por pré-registro. Campaign.target_cpa.target_cpa_micros, Campaign.optimization_goal_setting.optimization_goal_types. Usa OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME e APP_PRE_REGISTRATION (não defina selective_optimization).

Exemplo de código e próximas etapas

Anexe um grupo de anúncios e recursos do criativo para que sua campanha possa veicular anúncios: