Resumo: Crie campanhas da web para atribuir conversões web-to-app do Google Ads
Atenção:
esse artigo tem como foco campanhas na web para a divulgação de aplicativos mobile. Se você quiser criar campanhas que dibulguem aplicativos para PC ou console, veja Google Ads Web—Integração para aplicativos de PC e console.
Visão geral
A AppsFlyer é compatível com a integração com o Google Ads (googleads_int) para campanhas baseadas na web e reporta a atribuição da campanha e conversão diretamente por meio da Google Offline Conversion API (OCI).
Nesse artigo, você aprenderá como configurar campanhas da web para dispositivos mobile na AppsFlyer e no Google Ads, segmentando usuários da web que interagem com o Google Ads.
As campanhas são baseadas na jornada do usuário que começa quando ele clica em um anúncio e é redirecionado para uma landing page. Essa página inclui o Smart Script ou Smart Banners da AppsFlyer, que criam links de atribuição.
Depois de receberem um clique, esses links levam o usuário à loja de aplicativos para baixar e instalar o app. A instalação e os eventos subsequentes no aplicativo são registrados na AppsFlyer e reportados ao Google Ads via OCI.
O Google usa esses dados para otimizar a segmentação de anúncios, mensurar a performance e criar públicos-alvo personalizados.
Pré-requisitos
Antes de ativar a integração do Google Ads para campanhas da web, certifique-se de ter o seguinte:
- Um aplicativo mobile
- Uma conta da AppsFlyer
- Usuários de contas com as funções ou permissões necessários e acesso aos aplicativos relevantes
Como criar uma campanha web do Google Ads
Esse artigo contém informações relevantes e etapas para configurar uma campanha web no Google Ads para mobile, PC e apps de console com a AppsFlyer. A configuração envolve definir a integração entre o Google Ads e a AppsFlyer e configurar os links de atribuição da campanha.
- Configurar a integração do Google Ads na AppsFlyer(obrigatório)
- Configurar a integração do Google Ads no Google Ads(obrigatório)
Depois de configurar os links de atribuição na etapa um por meio da integração do Google Ads e da AppsFlyer, a etapa dois se concentra na criação da landing page. Aqui, o OneLink Smart Script ou os Smart Banners usarão os links de atribuição para gerar botões de call-to-action, direcionando os usuários para as lojas de aplicativos.
Criar uma integração do Google Ads na AppsFlyer
Comece ativando a integração com o Google Ads para campanhas web e definindo os postbacks que a AppsFlyer envia para o OCI.
1. Ative a integração do Google Ads para campanhas web
- Na AppsFlyer, no menu lateral, acesse Colaborar > Partner Marketplace.
- Procure por Google Ads Web e selecione-o.
- Clique em Configurar a integração. Você será direcionado para a página de configuração de Integrações ativas.
- Na aba Integração selecione Ativar parceiro. Atenção: o toggle deve permanecer ativo enquanto você trabalhar com o parceiro.
-
Desative a Privacidade Avançada (se estiver configurando uma integração de aplicativo iOS).
Atenção:
A mensagem de erro de "token ausente" deixará de aparecer assim que você fizer o login com o Google e permitir que a AppsFlyer recupere o token na etapa abaixo. Se o erro persistir após o login, verifique se o seu token tem as permissões necessárias.
-
Em ID de conversão da primeira abertura, insira o ID da ação de conversão
First opendefinida no Google Ads. Para encontrar o ID, acesse o Google Ads e abra a aba Detalhes da página Primeira ação de conversão aberta. Copie o valor do parâmetro de consultactid=*da URL da página. Por exemplo, sectid=123456789, insira123456789na caixa First open conversion action ID.Dica
Se você ainda precisar definir a ação "Primeira abertura" no Google Ads, poderá inserir um valor de espaço reservado temporariamente até que a ação esteja totalmente configurada.
- Insira seu Customer ID. Você pode encontrá-lo em seu Google Ads Manager:
- faça login na sua conta do Google Ads.
- No canto superior direito, clique no ícone da conta do Google e role para baixo até encontrar o Customer ID.
- Se você tiver várias contas do Google Ads executando campanhas para seu aplicativo, será necessário usar o ID do cliente de um gerente (MCC) para o rastreamento de conversões entre contas. Veja as Instruções do Google sobre como configurar uma conta MCC.
- Para permitir que a AppsFlyer envie conversões para o Google Ads, clique em Login com o Google.
- Selecione a conta de administrador da conta MCC da qual você recuperou o customer ID na etapa 7.
- Clique em Permitir
2. Ativar a atribuição de view-through
A AppsFlyer oferece suporte para a atribuição de view-through através de campanhas Google Web usando um Smart Script ou uma landing page habilitada para Smart Banner. Isso permite a atribuição de instalação de aplicativos por modelagem probabilística (PMOD), que é acionada por impressões de anúncios, mesmo quando os usuários não clicam diretamente no anúncio.
Quando um usuário vê um anúncio do Google e acessa uma landing page habilitada para Smart Script ou Smart Banner, a AppsFlyer pode atribuir a instalação resultante de volta à impressão original da web, com um acompanhamento cross-platform.
Quando disponível, a AppsFlyer inclui o gclid no postback para o Google.
Para ativar a atribuição de view-through:
- Na AppsFlyer, no menu lateral, abra Integrações Ativas > Google Ads Web.
- Na aba Integração, vá até a seção Atribuição de instalação.
- Ative a Atribuição de instalação por view-through.
- [opcional] Ative a Prioridade de atribuição equitativa entre plataformas e defina sua janela de lookback. Para mais informações, veja o artigo Ativar prioridade equitativa para impressões entre plataformas.
- Abra a aba Atribuição.
- Vá até a seção Atribuição de view-through e defina a janela de lookback de view-through desejada (de até 24 horas).
- Clique em Salvar integração para aplicar as alterações.
3. Configurar postbacks de eventos in-app
Atualmente, instalações são os únicos eventos que acionam postbacks padrão automáticos para o Google Ads para web via API OCI. Para outros tipos de eventos, você pode criar postbacks personalizados mapeando eventos da AppsFlyer para IDs de ação de conversão do Google Ads (“Ação de conversão” é o termo que o Google Ads usa para eventos de atribuição). Consulte o Gerenciador de Anúncios do Google para saber mais sobre o evento da web do Google Ads que você precisa mapear para eventos do AF.
- Ative Postbacks de eventos in-app.
- Se necessário, defina a janela de postback de eventos in-app (leia mais sobre a configuração da janela de postback de eventos in-app em geral neste artigo).
- Clique em Adicionar evento para adicionar um SDK ou evento de servidor para servidor à lista.
- Na coluna Evento da AppsFlyer, selecione o nome do evento na caixa suspensa. A AppsFlyer recebe o nome do evento do SDK integrado ao seu aplicativo ou dos eventos de servidor para servidor.
-
Na coluna mapeado para evento de parceiro, você deve mapear o evento AppsFlyer para um ID de ação de conversão do Google correspondente. Antes de fazer isso, você precisa configurar as ações de conversão necessárias do Google no Google Ads. Para saber como definir ações de conversão no Google Ads, consulte Criar ações de conversão personalizadas.
Para encontrar o conversion action ID no Google Ads:
- Vá para o Google Ads.
- Abra a página de conversion action que você quer mapear.
- Abra a aba Detalhes.
- Copie o valor do parâmetro de consulta
ctid=*da URL da página. - Volte para a AppsFlyer.
- Cole-o na coluna do evento mapeado para o parceiro. Por exemplo, se
ctid=123456789, cole123456789.
- Na coluna Para usuários de, selecione Somente esse parceiro.
- Na coluna de Incluindo, selecione se todos os parâmetros do evento, incluindo o valor da receita (se existir no evento), serão enviados no postback.
- [Opcional] Clique no ícone Adicionar condição para definir condições para um evento.
- Clique em Salvar integração.
- [Opcional] Após salvar a integração, você pode integrar mais aplicativos com o parceiro em questão:
- No canto superior esquerdo clique no nome do aplicativo para abrir a lista de aplicativos.
- Selecione um aplicativo diferente na lista suspensa.
- Repita as etapas de integração para o aplicativo selecionado.
4. Configurar o template do OneLink
Antes de criar um link de atribuição do OneLink para sua campanha do Google Ads, você precisa definir seu template. Em seguida, você pode criar uma URL de atribuição do OneLink com base no template e usá-lo como o URL do template de rastreamento do Google.
Atenção:
As instruções abaixo se concentram na criação de um template do OneLink para campanhas da web do Google com o Smart Script. Para obter um guia completo sobre como configurar templates do OneLink, consulte a seção Como criar modelos do OneLink do artigo Templates do OneLink .
- Na seção Redirecionamento da página Novo template ou Editar template, defina as seguintes configurações:
-
Quando o app não estiver instalado > Redirecionar para: Selecione sua opção preferida. O valor de redirecionamento definido aqui é substituído pelo valor
{lpurl}dos parâmetros de redirecionamento (af_android_url,af_ios_url) que você coloca no template de Rastreamento do Google; veja aqui. - Quando o app está instalado: Certifique-se denãoconfigurar Universal Links, Esquema de URI ou Todos os Links para iniciar o aplicativo, pois o Google não permite nenhum redirecionamento além do redirecionamento para o URL Final.
-
Quando o link recebe um clina na página web em desktop > Redirecionar para: Selecione sua opção preferida. O valor de redirecionamento definido aqui é substituído pelo valor
{lpurl}dos parâmetros de redirecionamento (af_web_dp) que você coloca no template de Rastreamento do Google; veja aqui.
-
Quando o app não estiver instalado > Redirecionar para: Selecione sua opção preferida. O valor de redirecionamento definido aqui é substituído pelo valor
- Clique em Criar template.
Crie uma campanha web no Google Ads
Execute as seguintes etapas no Google Ads.
1. Defina o tipo, objetivo e metas da campanha.
O Google Ads usa o objetivo e as metas do tipo de campanha que você selecionar aqui para definir a estratégia de bidding correta e otimizar a performance da campanha.
- Entre no Google Ads e crie uma campanha.
-
Selecione um objetivo para a campanha.
- Todos os objetivos são aplicáveis, exceto “Promoção de aplicativos” (que só pode ser usada para campanhas de apps mobile).
- Recomendamos que você configure o objetivo da campanha de “Vendas” para otimização com base em eventos específicos no aplicativo.
-
Selecione as metas de conversão.
- Por padrão, as metas de campanha predefinidas são exibidas no nível da conta. Você pode mantê-los ou remover aqueles que não são relevantes para sua campanha.
-
Se você não vê o objetivo que deseja que o Google otimize,
- Você também pode editar seus objetivos predefinidos na página de conversões.
-
Selecione o tipo de campanha.
- Todos os tipos de campanha são aplicáveis, exceto “Compras”, que exige um catálogo de produtos e se limita a domínios verificados.
2. Crie ações de conversão personalizadas
Em seguida, para cada evento in-app definido na AppsFlyer, você deve criar uma ação de conversão correspondente no Google Ads. Depois de concluir a criação da ação de conversão, você precisará copiar o ID da ação recém-criada e mapeá-la para o evento in-app da AppsFlyer.
Para criar ações e metas de conversão personalizadas do Google Ads:
- Na página de visão geral da sua conta do Google Ads, no menu lateral, selecione Metas > Conversões > Resumo.
- Clique em + Nova ação de conversão.
-
Selecione Importar na lista de tipos de conversão e selecione:
- Importação manual usando API ou uploads > Rastrear conversões de cliques.
OU
- CRM, arquivos ou outras fontes de dados > Rastrear conversões de cliques e, em Fonte de dados, selecione Ignorar esta etapa e configurar a fonte de dados mais tarde.
- Clique em Continuar.
- Em Meta de conversão, selecione uma categoria de ação de conversão.
-
Em Insira um nome de conversão, digite o nome da ação de conversão.
Importante!
Para usar a Offline Conversions API com GBRAID/WBRAID (além de GCLID), certifique-se de que o campo Count na ação de conversão esteja definido como Every (padrão) e NÃO One.
- Insira um Nome para a conversão e clique em Adicionar. Atenção: Se você quiser que suas campanhas sejam otimizadas para uma única ação, inclua somente essa ação para essa categoria. Por exemplo, se você quiser que sua campanha seja otimizada para a ação de conversão Primeira abertura , certifique-se de que ela seja a única em sua categoria. Em seguida, você poderá selecionar essa categoria como a meta de conversão para otimização do desempenho ao criar a campanha.
- Clique em Salvar e continuar e depois em Concluído, sem configurar fontes de dados. Sua nova ação de conversão pode aparecer inicialmente como "Inactive", mas ela mudará para "Active" assim que dados reais forem recebidos.
-
Para mapear a nova ação de conversão para o evento de postback da AppsFlyer, recupere o novo ID da ação de conversão. Na página Resumo das metas de conversão, clique na ação de conversão que você criou e copie o valor do parâmetro de consulta
ctid=*dA URL da página de ação de conversão. - No AppsFlyer, cole o
ctidvalor na coluna mapeada para o evento do parceiro do evento de postback que você deseja que o Google otimize; veja: Configurar postbacks de eventos in-app.
3. Defina as URLs da campanha
As campanhas do Google Web Ads utilizam dois URLs para cada engajamento: a URL final e a URL do template de rastreamento. Esses URLs são ativados simultaneamente quando o anúncio é clicado, um recurso que o Google chama de Rastreamento Paralelo. Mais informações sobre o Rastreamento Paralelo estão disponíveis na documentação do Google.
Defina a URL final
O Google define a URL final como "o endereço URL da página da web no seu site que as pessoas acessam depois de clicar no seu anúncio. Também conhecido como "página de destino".
Para definir a URL final
- No Google Ads, abra a página Campanhas > anúncios .
-
Na linha de anúncios, clique no ícone de edição.
-
Em URL final, insira a URL da landing page da web.
Importante!
A URL final não pode ser uma URL da AppsFlyer-OneLink ou uma URL de atribuição de plataforma única, pois isso pode fazer com que a sua campanha seja rejeitada. Use apenas um endereço web direto, sem redirecionamentos, como a URL de uma página web, a URL da Google Play Store ou a URL da App Store.
Este deve ser o local final da web para o qual você deseja redirecionar seus usuários. Pode ser:
-
Um URL de página inicial apontando para uma página que solicita que o usuário clique em um botão CTA para baixar o aplicativo do Google Play, App Store ou qualquer outra loja de aplicativos. A landing page inclui Smart Script ou Smart Banners, que geram automaticamente as URLs dos botões CTA. Para aprender a criar a página inicial com Smart Script ou Smart Banners.
Você pode adicionar parâmetros de atribuição da AF à URL final e mapeá-los para os parâmetros do Google ValueTrack, por exemplo,
af_c_id={campaignid}. Depois que o anúncio do Google é clicado e a página inicial é carregada, o Smart Script ou os Smart Banners podem copiar os parâmetros para a URL de saída da landing page. Para saber mais sobre os parâmetros ValueTrack disponíveis, consulte a documentação do Google.Por exemplo,
https://example.com?product=1234&af_c_id={campaignid} -
Uma URL de loja, como App Store ou Google Play.
Importante!
Suponha que você use a URL da loja como sua URL final. A única maneira de enviar informações de atribuição e parâmetros personalizados para a AppsFlyer é inserir e mapear parâmetros AF para a URL do template de rastreamento.
https://play.google.com/store/apps/details?id=.com.app.id&hl=en&gl=US&referrer={gclid}&gclid={gclid}&campaignid={campaignid} - Um link de download direto para o arquivo APK do aplicativo se você quiser que os usuários baixem o aplicativo diretamente sem serem redirecionados para uma loja.
-
Defina a URL do template de rastreamento
Como o Google Ads, por padrão, usa o Rastreamento Paralelo, a URL do template de rastreamento — um link de atribuição da AppsFlyer no nosso caso — é carregado em segundo plano, e o clique é registrado na AppsFlyer. Não é obrigatório usar URLs de template de rastreamento, especialmente ao usar Smart Banners ou Smart Script - veja a seção Usando a URL do template de rastreamento com Smart Script nesse artigo.
-
No Google Ads, abra a página Campanhas > Campanhas . Na linha da campanha, clique no ícone de configurações
-
Expanda as Configurações > Configurações adicionais > Opções de URL da campanha
-
No Template de rastreamento, use o seguinte (BaseURL + parâmetros de redirecionamento):
-
URL base: Defina a URL base de acordo com o destino do clique no anúncio:
- Link de atribuição de plataforma única se o destino do clique no anúncio for o Google Play ou a App Store (veja o exemplo abaixo).
- Um link de atribuição OneLink se o destino do clique no anúncio for uma página web (veja o exemplo abaixo).
-
O parâmetro PID: Adicione o parâmetro
pid=googleads_intobrigatório. -
Parâmetro de site ID: Adicione o parâmetro obrigatório
af_siteid. Você pode atribuir manualmente qualquer valor a ele. - Parâmetro do nome da campanha: Adicione o parâmetro c obrigatório e atribua manualmente seu valor (não há parâmetro ValueTrack para esse parâmetro).
-
Parâmetro force transparent: Adicione o parâmetro obrigatório
af_force_transparent=true. Esse parâmetro foi projetado para aumentar a segurança no comportamento de redirecionamento, garantindo conformidade com os requisitos do Google. Por favor, observe que se você não adicionar o parâmetro necessário, o Google pode reprovar seu anúncio. -
Parâmetros de redirecionamento para link de atribuição do OneLink: Para que o rastreamento paralelo funcione conforme esperado, configure os parâmetros de redirecionamento da AF em uma das seguintes combinações:
- Os parâmetros
af_android_url,af_ios_urleaf_web_dpdevem ser configurados para o parâmetro Google ValueTrack{lpurl}. Importante: Certifique-se de que todos os três estejam preenchidos para garantir que o link de atribuição funcione em todos os cenários.
Ou - O parâmetro
af_rdeve ser configurado para o parâmetro Google ValueTrack{lpurl}.
- Os parâmetros
-
Parâmetro de redirecionamento para link de atribuição de plataforma única: Para que o rastreamento paralelo funcione conforme o esperado, configure o parâmetro
af_rpara o parâmetro Google ValueTrack{lpurl}.Importante!
Para cumprir com os requisitos do Google, certifique-se de que o valor {lpurl} seja uma URL de redirecionamento válida:
- Ela usa o protocolo HTTPS.
- Deve ser codificada.
- O domínio da URL deve fazer parte da sua lista de redirect allowlist.
-
Parâmetros de atribuição da AppsFlyer mapeados para parâmetros do Google ValueTrack, por exemplo,
af_c_id={campaignid}. Para saber mais sobre os parâmetros ValueTrack disponíveis, consulte a documentação do Google. - Não inclua o parâmetro
af_dp. - Não inclua nenhum parâmetro que altere o valor do parâmetro de redirecionamento {lpurl}. Isso inclui
af_base_params_forwardeaf_param_forwarding.
Atenção:
Para limitações adicionais relacionadas à URL do template de rastreamento, consulte a seção Características e limitações neste artigo.
-
URL base: Defina a URL base de acordo com o destino do clique no anúncio:
Exemplos de URL do template de rastreamento do Google
Um exemplo de um OneLink em uma URL de template de rastreamento do Google:
https://subdomain.onelink.me/aAB1?pid=googleads_int&af_force_transparent=true&af_android_url={lpurl}&af_ios_url={lpurl}&af_web_dp={lpurl}&c=summer_sale24&af_siteid=123456&af_c_id={campaignid}&af_adset=sum24A&af_adset_id={adgroupid}&af_sub1={gclid}&af_sub2={gbraid}
Um exemplo de um link de plataforma única em uma URL de template de rastreamento do Google:
https://app.appsflyer.com/id1510557250?pid=googleads_int&af_force_transparent=true&c=examplecamp&af_siteid=123456&af_adset=exampleadset&af_adset_id={adgroupid}&af_c_id={campaignid}&af_ad_id={creative}&af_click_lookback=7d&af_r={lpurl}
Usando a URL do template de rastreamento com Smart Script ou Smart Banners
Não é necessário preencher a URL do template de rastreamento com um link de atribuição da AppsFlyer quando o anúncio redireciona para uma landing page que usa um Smart Script ou Smart Banners. Isso ocorre porque essas ferramentas criam automaticamente um link de atribuição que é registrado na AppsFlyer quando o usuário clica no botão CTA da página inicial No entanto, há considerações a favor e contra deixar o campo URL do template de rastreamento vazio:
- Se você não preencher a URL do template de rastreamento com um link de atribuição, corre o risco de perder instalações que ocorrem quando o usuário clica no anúncio, mas não clica em nenhum dos botões de CTA da página inicial. Se o usuário for diretamente à loja de aplicativos para baixar o aplicativo dentro da janela de lookback, a instalação subsequente não será atribuível.
- Se você preencher a URL do template de rastreamento com um link de atribuição e o usuário clicar no anúncio e, posteriormente, clicar nos botões de CTA da landing page, dois cliques serão registrados em vez de um, o que pode afetar os dados de conversão.
Crie uma landing page com o OneLink Smart Script
Jornada do usuário: O usuário clica em um anúncio do Google e é direcionado para seu site para dispositivos mobile. Ele chegam a uma página com botões de CTA, solicitando que ele faça download do seu aplicativo. Clicar no botão redirecionará o usuário para a loja.
Fluxo de dados de ponta a ponta
O caso de uso do W2A Smart Script é composto pelas seguintes fases:
- O usuário clica em um anúncio do Google, o Google automaticamente adiciona à URL Final o seguinte:
- um parâmetro
gclidpara dispositivos Android e para usuários que consentem em dispositivos iOS. - um
gbraidewbraidpara usuários que não permitem o rastreamento em dispositivos iOS. - todos os parâmetros de query definidos na URL do template de rastreamento do Google, exceto os parâmetros de redirecionamento.
- um parâmetro
- A URL Final redireciona o usuário para a landing page.
- Simultaneamente, a URL do template de rastreamento do Google, que também contém os parâmetros adicionados automaticamente
gclid,gbraid,wbraidepid=googleads_int, é acionada em segundo plano, e o clique é registrado com a AppsFlyer. - Quando a landing page é carregada, o Smart Banner envia um evento de impressão para a AppsFlyer contendo os parâmetros da URL de entrada. Essa impressão permite a atribuição de visualização para a página inicial. Para saber mais sobre impressões e atribuição de visualizações, clique aqui.
- O Smart Script gera as URLs de saída para os botões de CTA na página com base nos parâmetros da URL de entrada, incluindo os parâmetros
gclid,gbraidewbraid. Os botões podem levar a:- Google Play e App Store por meio de um link de atribuição OneLink.
- Lojas de múltiplas plataformas (por exemplo, CTV, Epic e Steam). Nesse caso de uso, o Smart Script gera um único link de saída de atribuição de plataforma para cada plataforma, levando à loja da plataforma especificada.
- Baixando um arquivo APK para o dispositivo do usuário.
- Quando o usuário clica no botão CTA, o clique é acionado e registrado na AppsFlyer.
- O usuário é redirecionado para a loja e baixa o aplicativo.
- O evento de instalação é registrado na AppsFlyer quando o usuário abre o app.
- A AppsFlyer atribui a instalação com base em modelagem probabilística ou deterministicamente se um install referrer estiver disponível.
- Um postback contendo o
gclidou parâmetros adicionais do eventogbraidewbraidé gerado e enviado ao Google por meio da OCI API. O Google usa o parâmetrogclidougclidegbraidpara identificar o clique específico, enquanto os outros parâmetros ajudam a otimizar a campanha.
Configurar uma landing page de Smart Script
Para configurar o smart script das suas campanhas web do Google, faça o seguinte:
-
Crie um smart script.
Atenção:
As instruções abaixo se concentram nas etapas necessárias para configurar uma campanha web do Google com o Smart Script. Para obter um guia abrangente sobre como configurar campanhas de Smart Script, você pode consultar a seção Como criar um Smart Script do OneLink do artigo de configuração do OneLink Smart Script V2.
- Certifique-se de que todos os parâmetros de URL relevantes (que serão posteriormente capturados pelo Smart Script) sejam anexados à URL de entrada. Para revisar os parâmetros anexados à URL de entrada, abra o Google Ads e verifique os parâmetros de URL definidos como parte da criação da URL final ou da URL do template de rastreamento; consulte: Configure as URLs da campanha.
- Mapeie os parâmetros de URL de entrada necessários para a campanha do Meta Ads com os parâmetros de URL de saída que serão enviados à AppsFlyer quando o usuário clicar no botão CTA:
-
PID: Certifique-se de que o Smart Script pegue o valor do parâmetro
pid=googleads_intda URL de entrada e o mapeie para os parâmetros correspondentes na URL de saída. -
GCLID: O parâmetro
gclidé essencial para enviar com sucesso os postbacks de eventos in-app para o Google Ads. O mapeamento do parâmetro GCLID da URL de saída depende da sua versão do Smart Script:- SDK versão 2.8.1 em diante: O parâmetro
gclidé encaminhado automaticamente para o parâmetro de URL de saída quando presente na URL de entrada, eliminando a necessidade de mapeamento manual. - Versão 2.8.0 e inferior: O parâmetro
gcliddeve ser mapeado manualmente na seção de mapeamento de parâmetros de URL da página do Smart Script:- Em Mapeamento para, selecione parâmetro personalizado.
- Em parâmetro de URL de saída e parâmetros de URL de entrada, insira gclid.
- SDK versão 2.8.1 em diante: O parâmetro
-
GBRAID e WBRAID: Os parâmetros
gbraidewbraidsão essenciais para enviar com sucesso postbacks de eventos in-app para o Google Ads para usuários de dispositivos iOS que não permitem o rastreamento. O mapeamento dos parâmetrosgbraidewbraidna URL de saída depende da sua versão do Smart Script:- SDK versão 2.9.0 em diante: Os parâmetros
wbraidegbraidsão encaminhados automaticamente para o parâmetro de URL de saída quando presente na URL de entrada, eliminando a necessidade de mapeamento manual. - Versão 2.8.1 e inferior: Os parâmetros
wbraidegbraiddevem ser mapeados manualmente na seção de mapeamento de parâmetros da URL na página do Smart Script:- Em Mapeamento para, selecione parâmetro personalizado.
- Em parâmetro de URL de saída e parâmetros de URL de entrada, insira wbraid.
- Repita os passos acima para o parâmetro
wbraid.
Atenção:
Para exibir nos relatórios de dados brutos da AppsFlyer, os parâmetros de entrada
gclid,gbraidewbraidtambém devem ser mapeados para o parâmetro de saídaaf_sub[1-5](além dos parâmetros de saídagclid,gbraidewbraid). - SDK versão 2.9.0 em diante: Os parâmetros
-
PID: Certifique-se de que o Smart Script pegue o valor do parâmetro
Configurar uma landing page multiplataforma do Smart Script
Para páginas iniciais não multiplataforma, o profissional de marketing normalmente é responsável por gerar automaticamente o Smart Script por meio da página Smart Script da AppsFlyer. No entanto, quando se trata de páginas iniciais multiplataforma, o desenvolvedor cria o script com base nos parâmetros enviados pelo profissional de marketing.
Para configurar o smart script das suas campanhas web do Google, faça o seguinte:
- Ative seu template do OneLink para atribuição multiplataforma, veja aqui.
- Certifique-se de que todos os parâmetros de URL relevantes sejam anexados à URL de entrada. Para revisar os parâmetros anexados à URL de entrada, abra o Google Ads e verifique os parâmetros de URL definidos como parte da criação da URL final ou da URL do template de rastreamento; consulte: Configure as URLs da campanha.
- Decida para cada parâmetro de entrada o parâmetro de saída para o qual ele será mapeado. Por exemplo,
af_site_idna URL de entrada será mapeado paraaf_site_idno URL de saída. - Decida o valor padrão para os parâmetros de saída obrigatórios que não podem estar vazios.
- Envie ao seu desenvolvedor as seguintes informações:
- Seu mapeamento de parâmetros de entrada e saída. O desenvolvedor criará um script que gera uma URL direta de saída com base no mapeamento de parâmetros de entrada e saída.
- Os valores padrão dos parâmetros. O script preencherá os parâmetros de URL de saída com os valores padrão sempre que não houver valores de parâmetros de URL de entrada correspondentes.
- Se você estiver usando um link de atribuição do OneLink, envie o ID do domínio e do template para seu desenvolvedor. O desenvolvedor usa isso para criar a URL de saída do OneLink. Por exemplo,:
your_brand.onelink.me/A1b2ou exemplo de domínio de marca:click.yourbrand.com/A1b2 - Envie ao seu desenvolvedor os seguintes links do Dev Hub:
- Exemplos de instruções e códigos sobre como criar URLs diretos de saída para plataformas não móveis.
- Uma demonstração e instruções para criar uma página inicial multiplataforma.
- Quando presente na URL de entrada, o parâmetro
gclidé encaminhado automaticamente para o parâmetro de URL de saída eliminando a necessidade de mapeamento manual (a partir da versão 2.8.1 do Smart Script). Seu desenvolvedor ainda tem a opção de mapear ogclidpara um dos parâmetrosaf_sub, disponibilizando-os em relatórios de dados brutos; consulte Google Ads GCLID.
Crie uma página inicial com os Smart Banners do OneLink
Jornada do usuário: O usuário clica em um anúncio do Google e é direcionado para seu site para dispositivos mobile. Eles chegam a uma página e um Smart Banner é exibido com um CTA para baixar o aplicativo na loja de aplicativos.
Fluxo de dados de ponta a ponta
- O usuário clica em um anúncio do Google, o Google automaticamente adiciona à URL Final o seguinte:
- um parâmetro
gclidpara dispositivos Android e para usuários que consentem em dispositivos iOS. - um
gbraidewbraidpara usuários que não permitem o rastreamento em dispositivos iOS. - todos os parâmetros de query definidos na URL do template de rastreamento do Google, exceto os parâmetros de redirecionamento.
- um parâmetro
- Simultaneamente, a URL do template de rastreamento do Google por trás do anúncio, que contém o parâmetro
gclide o parâmetropid=googleads_int, é disparado em segundo plano e o clique é registrado na AppsFlyer. - Quando a página inicial é carregada, o Smart Banner envia um evento de impressão para a AppsFlyer contendo os parâmetros da URL de entrada. Essa impressão permite a atribuição de visualização para a página inicial. Para saber mais sobre impressões e atribuição de visualizações, clique aqui.
- O Smart Banner gera a URL de saída para o botão CTA no banner com base nos parâmetros de entrada, incluindo o parâmetro
gclid. O Smart Banner pode gerar apenas links baseados no OneLink. - Quando o usuário clica no botão CTA do Smart Banner, o clique é acionado e registrado na AppsFlyer.
- O usuário é redirecionado para a loja e baixa o aplicativo.
- O evento de instalação é registrado na AppsFlyer quando o usuário abre o app.
- A AppsFlyer atribui a instalação com base em modelagem probabilística ou deterministicamente se um install referrer estiver disponível.
- Um postback contendo o
gclide outros parâmetros adicionais do evento é gerado e enviado ao Google Ads por meio da API OCI. O Google usa o parâmetrogclidpara identificar o clique específico, enquanto os outros parâmetros ajudam a otimizar a campanha.
Configurar uma landing page do Smart Banner
Atenção:
As instruções abaixo se concentram nas etapas necessárias para configurar uma campanha web do Google com o Smart Banner. Para obter um guia abrangente sobre como configurar campanhas de Smart Banners, consulte a seção de configuração do artigo Smart Banners —mobile web-to-app (para profissionais de marketing).
Para configurar os Smart Banners das suas campanhas web do Google, faça o seguinte:
- Como criar um Smart Banner Para mais instruções, consulte a seção de configuração do artigo Smart Banners — mobile web-to-app (para profissionais de marketing) .
- Certifique-se de que a URL de entrada inclua o seguinte:
- O
pid=googleads_intestá disponível na URL de entrada. - O parâmetro
gclidestá disponível na URL de entrada. Os Smart Banners encaminham automaticamente o parâmetrogclidpara a URL de saída do banner. O parâmetrogclidé necessário para o envio bem-sucedido de postbacks in-app para o Google OCI. - Os parâmetros
gbraidewbraidestão disponíveis na URL de entrada ao enviar postbacks para usuários de dispositivos iOS que não permitem o rastreamento. Os Smart Banners encaminham automaticamente esses parâmetros para a URL de saída do banner. Nesse caso, os parâmetrosgbraidewbraidpermitem que o Google acesse dados agregados de eventos na ausência do parâmetrogclid. - Certifique-se de que todos os parâmetros de URL relevantes sejam anexados à URL de entrada. Para revisar os parâmetros anexados à URL de entrada, abra o Google Ads e verifique os parâmetros de URL definidos como parte da criação da URL final ou da URL do template de rastreamento; consulte: Configurar as URLs da campanha.
- O
- (Opcional) Na página de configuração do grupo de banners, na seção de parâmetros de atribuição dinâmica, selecione a primeira opção. Essa configuração garante que todos os parâmetros no link de entrada sejam adicionados ao link no Smart Banner.
Solução de problemas: postbacks de eventos in-app
Se os dados de eventos in-app não forem exibidos no Google Ads ou Google Analytics, ou se você receber o erro de token ausente, certifique-se de que as seguintes configurações estão corretas antes de entrar em contato com o suporte:
Configurar permissões de token
No Google Ads, certifique-se de que seu token de acesso tenha as permissões necessárias para enviar conversões offline:
- Vá para o Google Developers Console.
- Certifique-se de que
uploadClickConversionstenha o seguinte escopo OAuth:https://www.googleapis.com/auth/adwords - Na AppsFlyer, na aba de integração, clique em Login com o Google.
- Selecione a conta de administrador da conta MCC.
- Clique em Permitir
MCC Customer ID
Se você tiver várias contas do Google Ads executando campanhas para o seu app, deve usar o Customer ID de uma conta MCC. Veja as Instruções do Google sobre como configurar uma conta MCC.
Conversion Action ID
Certifique-se de que os eventos de postback no aplicativo estejam mapeados para o conversion action ID certo. Para encontrar o conversion action ID no Google Ads, acesse aqui.
Parâmetros GCLID, GBRAID, WBRAID
A URL de saída do Smart Script ou do Smart Banner deve incluir gclid, wbraid, ou gbraid para que o postback para o Google OCI seja registrado corretamente no Google Ads.
Características e limitações
| Caraterística | Observações |
|---|---|
| Dashboard | Os dados de atribuição para campanhas baseadas na web do Google no iOS são visualizados e analisados no dashboard clássico da AppsFlyer. Na maioria dos casos, o dashboard da SKAN não é relevante para campanhas web-to-app. |
| Atribuição de reengajamento |
Os usuários podem observar instalações atribuídas a
|
| Dados de custo | Os dados de custo para a rede Web do Google Ads (pid=googleads_int) não são recuperados automaticamente. Em vez disso, eles devem ser importado manualmente usando um dos dois métodos disponíveis: upload de arquivo via e-mail ou upload manual via interface da AppsFlyer. Isso se aplica a todos os usuários, incluindo assinantes do ROI360. |
| Tracking template URLs |
Tracking template URLs devem estar de acordo com as limitações abaixo. Caso esse não seja o caso, você terá um link quebrado.
|
| Atribuição de SRN inesperada | Em alguns casos, as instalações de campanhas baseadas na web do Google Ads podem ser atribuídas a googleadwords_int via SRN (rede de auto-relato), mesmo em campanhas baseadas na web. Isso ocorre quando o Google reivindica a instalação. A AppsFlyer atribui a instalação de acordo quando o Google faz a reivindicação. Esse comportamento é esperado e pode se tornar mais comum à medida que o Google expande o suporte para atribuição de instalação de campanhas na web. |
| Disponibilidade do plano | A integração googleads_int está disponível apenas para planos Growth e Enterprise. Clientes dos planos Zero e Welcome não podem ativar essa integração. |