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:
Crie um
CampaignBudgetdiário paracampaign_budgetcomamount_microseexplicitly_shareddefinidos comofalse(o padrão étrue; os orçamentos compartilhados eCUSTOM_PERIODfalham). Consulte Criar orçamentos de campanha.Defina
namee, se quiser, definastatuscomoPAUSEDao anexar anúncios (o padrão éENABLED).Defina o imutável
advertising_channel_typecomoMULTI_CHANNELe o imutáveladvertising_channel_sub_typecomoAPP_CAMPAIGN,APP_CAMPAIGN_FOR_ENGAGEMENTouAPP_CAMPAIGN_FOR_PRE_REGISTRATION.Defina
contains_eu_political_advertisingcomoDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGouCONTAINS_EU_POLITICAL_ADVERTISING. As chamadasMutateCampaignsindependentes 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).Defina
app_campaign_settingcomo um objetoAppCampaignSetting(app_storeeapp_idsão imutáveis):app_store:AppCampaignAppStore(GOOGLE_APP_STOREouAPPLE_APP_STORE; o pré-registro requerGOOGLE_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 paraAPP_CAMPAIGNaté o lançamento).bidding_strategy_goal_type:AppCampaignBiddingStrategyGoalTypeda meta (mutável).
Defina uma estratégia de lances padrão em
Campaign(recursos de portfólioBiddingStrategynão são compatíveis). Ativar ou desativar uma meta de interface opcional mudabidding_strategy_goal_typee o campo de lancesoneof:- CPI, CPA ou pré-registro desejado: defina
target_cpacomtarget_cpa_microspositivo em micros da moeda da conta (1500000= 1,50 unidade, como US $1,50). - ROAS desejado: defina
target_roascomtarget_roasde0.01para1000.0(3.0= 300% de ROAS). - Maximizar sem meta (somente
APP_CAMPAIGN): defina como vaziomaximize_conversionsoumaximize_conversion_value. Não definamaximize_conversions.target_cpa_micros(rejeitado emMULTI_CHANNEL) oumaximize_conversion_value.target_roas.
- CPI, CPA ou pré-registro desejado: defina
Configure as metas de conversão ou pré-registro:
APP_CAMPAIGNeAPP_CAMPAIGN_FOR_ENGAGEMENT: adicione nomes de recursosConversionActionque correspondam aapp_idaselective_optimization.conversion_actions(nãoCampaignConversionGoalouoptimization_goal_setting; consulte Metas de conversão da campanha). EmAPP_CAMPAIGN, inclua até uma açãoDOWNLOAD, comoGOOGLE_PLAY_DOWNLOADoufirst_opendo Firebase (obrigatório para a interface, opcional para a API, proibido no engajamento).APP_CAMPAIGN_FOR_PRE_REGISTRATION: deixeselective_optimizationsem definição e adicioneAPP_PRE_REGISTRATIONaoptimization_goal_setting.optimization_goal_types.
Opcional: a partir da v24, defina
view_through_conversion_optimization_enabledcomotrueem campanhas para AndroidAPP_CAMPAIGNpara lances de conversão de visualização (VTC) (padrão da interfacetrue, padrão da APIfalse).Opcional: defina
start_date_time(00:00:00, hoje ou depois) eend_date_time(23:59:59) no fuso horário da conta (yyyy-MM-dd HH:mm:ss). ChameMutateCampaignsouGoogleAdsService.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:
- Locais e idiomas: adicione recursos
CampaignCriterioncomCampaignCriterionService.MutateCampaignCriteria, como os critérioslanguageelocation(consulte Critérios). - Listas de palavras-chave negativas: vincule um
CampaignSharedSeta umNEGATIVE_KEYWORDSSharedSet(consulte Conjuntos compartilhados). - Públicos-alvo: anexe os critérios
UserListInfoobrigatórios (APP_CAMPAIGN_FOR_ENGAGEMENT) ou os indicadoresAudienceInfoopcionais (APP_CAMPAIGN) aos grupos de anúncios (consulte Criar um grupo de anúncios de aplicativo e um anúncio).
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:
- Criar um grupo de anúncios de aplicativo e um anúncio: adicione um recurso
AdGroup(com os critériosUserListInfoobrigatórios emAPP_CAMPAIGN_FOR_ENGAGEMENT) e um anúncio de aplicativo. - Exemplo de código de campanha para apps: inspecione o exemplo multilíngue
AddAppCampaignque cria um orçamento, uma campanha, critérios, um grupo de anúncios e um anúncio. - Relatórios de campanhas para apps: consulte métricas de campanhas, recursos, instalações e da SKAdNetwork com a linguagem de consulta do Google Ads.