Configure o Smart Script para converter visitantes da web

1. Na AppsFlyer, no menu lateral, vá para Engajar > Web-to-app > Smart Banners.
2. Para novos usuários
   1. Clique no botão Começar.
   2. Siga os passos de 4 em diante.
3. Clique no botão + Novo Smart Script na parte superior da página.
4. Siga as instruções na tela para nomear seu Smart Script.
5. Selecione um template do OneLink para seu script. O template contém as configurações básicas de redirecionamento.
6. Mapeie os parâmetros que a URL de saída deve conter. Esses parâmetros se baseiam nos parâmetros da URL de entrada. Observação: O parâmetro fonte de mídia (pid) é obrigatório. 
   1. Selecione o parâmetro/dimensão de saída a ser mapeado.
      Muitas vezes, esse é um nome de parâmetro da AppsFlyer que não pode ser alterado, mas, em alguns casos, você precisa inserir um novo nome para o parâmetro.
   2. Configure em qual valor o parâmetro de saída deve se basear:
      • Parâmetros de URL de entrada: Liste um ou mais parâmetros de URL de entrada possíveis que você deseja substituir pelo parâmetro de URL de saída. Os valores dos parâmetros de URL de entrada serão os valores do parâmetro de URL de saída.
        • Exemplo: any_param_name, utm_param_name. Se utm_param_name for encontrado na URL de entrada, seu valor será usado como o valor do parâmetro de URL de saída selecionado.
        • O Smart Script pesquisa a lista de parâmetros da esquerda para a direita e mapeia a primeira correspondência para o parâmetro da URL de saída.
        • Os desenvolvedores se referem a essa lista de parâmetros como chaves (keys).
      • Valor padrão: digite o valor padrão desejado para o parâmetro de saída para casos em que um parâmetro de URL de entrada não for encontrado ou caso você não liste nenhum parâmetro de URL de entrada.
        • Exemplo: para o parâmetro de saída, se o parâmetro de URL de entrada listar qualquer any_paramname, utm_paramname, quando nenhum dos parâmetros da lista for encontrado, o valor padrão será usado como o valor do parâmetro de saída.
      • Substituir valores: configure um ou mais valores da URL de entrada ao lado dos valores da URL de saída que você deseja substituir.
        • Exemplo: para o parâmetro da campanha, se o valor na URL recebida for campaign_name, o valor na URL de saída poderá ser alterado para new_campaign_name.
   3. [Opcional] Clique em + New parameter para mapear parâmetros adicionais. Veja todos os argumentos adicionais (configurações de parâmetros) que você pode usar.
7. Selecione como implementar o Smart Script no seu site:
   • Incorporar o script ao seu site.
   • Usar o Google Tag Manager.
8. Clique em Testar para testar o script na página de teste Smart Script. Certifique-se de que a URL de saída correta seja gerada.
9. Clique
   1. Clique em Salvar para salvar suas alterações
   2. Clique em Salvar e gerar para salvar e gerar o script
      1. Clique em Baixar script.
10. Se você optou por incorporar o script em seu site: Envie o script para o desenvolvedor da web para implementar e dizer a ele o que fazer com a URL de saída gerada. Por exemplo, você pode colocá-la em um botão de CTA em seu site mobile ou em um QR code em seu site desktop. Instruções para o desenvolvedor
11. Se você optou por usar o Google Tag Manager:
    1. No Google Tag Manager, crie uma nova tag, nomeie-a, clique em Tag configuration, e selecione Custom HTML.
    2. Na caixa HTML, cole o código Smart Script gerado.
    3. Clique em Triggering, crie um novo trigger, nomeie-o e escolha uma Configuração de trigger (por exemplo, todos os page views). Veja a documentação do GTM para saber mais
    4. Clique em Salvar.
    5. Diga ao desenvolvedor web o que fazer com a URL de saída gerada. Por exemplo, você pode colocá-la em um botão de CTA em seu site mobile ou em um QR code em seu site desktop. Instruções para o desenvolvedor
12. Os scripts salvos podem ser visualizados no menu suspenso.

1. Clique na seta suspensa ao lado do nome do Smart Script.
   Aqui você pode ver todos os seus scripts salvos
2. Clique no ícone de caneta ao lado do script que deseja editar
   1. Siga as etapas em Como criar um OneLink Smart Script
3. Clique no ícone de lixeira para excluir o Smart Script

1. Vá para o Smart Script que você deseja duplicar
2. Clique no botão duplicar no banner superior
3. Siga as etapas em Como criar um OneLink Smart Script

O OneLink Smart Script usa argumentos para gerar uma URL de saída baseada nos parâmetros da URL de entrada e nos argumentos definidos no script. O argumento afParameters têm uma estrutura composta por vários outros argumentos (parâmetros) utilizados para a atribuição e o deep linking, sendo que cada um contém uma estrutura (chamada pelos desenvolvedores de objeto de configuração) que possui chaves, valores de sobreposição e um valor padrão, conforme descrito na tabela a seguir.

O OneLink Smart Script usa argumentos para gerar uma URL de saída baseada nos parâmetros da URL de entrada e nos argumentos definidos no script.

Argumentos (parâmetros e valores) para implementar o Smart Script

A tabela a seguir descreve os argumentos que os profissionais de marketing ou desenvolvedores experientes podem implementar no Smart Script.

Argumentos avançados (parâmetros e valores) para implementar o Smart Script

Para configurar o script para os parâmetros UTM:

1. Faça uma lista de parâmetros UTM na URL de entrada (por exemplo: utm_source e utm_campaign) e compare-os com os parâmetros da URL de saída (por exemplo: media_source e campaign).  
2. Forneça-os na lista de argumentos para o desenvolvedor da web.
   

Resultado: os valores nos parâmetros de entrada (utm_source e utm_campaign) são usados para preencher os valores dos parâmetros (media_source e campanha) no link de saída.  

O processo usual para a atribuição de instalações de campanhas do Google Ads (que carregam um parâmetro GCLID) requer que os usuários que clicam em seu anúncio sejam redirecionados para a URL da página da loja do aplicativo. 

Nesse caso, como você está redirecionando leads do Google Ads para um destino/página da web, o script pega o parâmetro GCLID da URL da campanha de instalação do Google Ads e o coloca na URL de saída. A partir da versão 2.9.0 do Smart Script, os parâmetros GCLID, WBRAID e GBRAID, quando disponíveis, são encaminhados automaticamente "no estado em que se encontram" nas URLs de saída gerados pelo Smart Script.

Você também pode mapear Click IDs para outros parâmetros de saída (af_sub[1-5]) para disponibilizá-los nos relatórios de dados brutos da AppsFlyer.

Atenção!

• Isso se aplica às campanhas de instalação. Para campanhas de pesquisa não-ACI, ou seja, campanhas de reengajamento, o Google pode ser atribuído como canal de mídia, apesar do output do Smart Script.  
• Se um GCLID for encontrado, o script procurará a palavra-chave do parâmetro de entrada. Se encontrado, ele coloca o valor da palavra-chave na URL de saída como o valor de af_keywords.

Pré-requisito: No dashboard do Google, ativar auto-tagging.
Com o auto-tagging ativado,a URL contém oparâmetro GCLID.

Para configurar o script para mapear o GCLID do Google Ads para outros parâmetros:

1. Selecione um parâmetro na URL de saída para conter o GCLID.
   Recomendação: selecione af_sub[1-5], para que os dados sejam exibidos nos relatórios de dados brutos da AppsFlyer.
2. Forneça esse item na lista de argumentos para o desenvolvedor da web. O resultado será que, na URL de saída, o GCLID será o valor do parâmetro af_sub[1-5] .
   

Para notificar o Google Ads sobre essas instalações:

1. Obtenha os dados do GCLID no parâmetro af_sub[1-5] via CSV, ou Push API em tempo real para cada instalação.
2. Faça upload dos dados de GCLID para o Google manualmente ou via Google Ads API.

O Meta Ads tem click IDs, chamados de FBCLID. A partir da versão 2.8.1 do Smart Script, quando disponível, o FBCLID será encaminhado automaticamente "no estado em que se encontra" nas URLs de saída geradas pelo Smart Script. Você também pode mapear Click IDs para outros parâmetros de saída para disponibilizá-los nos relatórios de dados brutos da AppsFlyer.

Para configurar o script para mapear FBCLID para outros parâmetros: 

1. Selecione um parâmetro na URL de saída para conter o FBCLID. 
   Recomendação: selecione af_sub[1-5], para que os dados sejam exibidos nos relatórios de dados brutos da AppsFlyer.
2. Forneça esse item na lista de argumentos para o desenvolvedor da web. O resultado será que, na URL de saída, o FBCLID será o valor do parâmetro af_sub[1-5] .
   

SRNs como Snapchat ou X Ads funcionam de maneira diferente do Google Ads ou de uma plataforma cruzada como o Meta Ads. As campanhas dessas SRNs levam seus usuários à página web/landing page, e você é cobrado de acordo com os clicking leads, sem nenhuma relação com qualquer usuário mobile derivado.  

Para essas SRNs, a configuração do script é a mesma que para links de mídias próprias, ou outros canais de mídia que você possa usar.  

Para configurar o script:

1. Faça uma lista dos canais de mídia e dos nomes dos parâmetros de campanha que estão nos links de entrada.
2. Forneça-os na lista de argumentos para o desenvolvedor da web.
   O tipo de SRN/canal de mídia deve ser o valor do canal de mídia na URL de entrada, e o script o localiza e o usa como o media_source na URL de saída do OneLink por trás do botão de download na página da web/landing page. Se você quiser mudar o media_source de saída, forneça o valor do canal de mídia de entrada e o valor da fonte_source de substituição na lista de argumentos que você fornece ao desenvolvedor da web.

Resultado: para essas SRNs/canais de mídia, os valores no canal da mídia e os parâmetros da campanha no link de entrada são usados para preencher os valores para os parâmetros media_source e campaign  no link de saída.  

Os links de atribuição da AppsFlyer podem ser usados quando o canal de mídia é uma ad network de clique. Ao configurar esse link na AppsFlyer, você tem a opção de adicionar um parâmetro de Redirection URL path (af_r) com o caminho da URL desejado para seu site mobile para atribuição de web campaign-to-app. Talvez você não queira que o Script crie uma URL de saída do OneLink, pois alguns dos dados do clique original podem ser perdidos.

Ação: use o argumento urlSkipList para listar o parâmetro af_r.

Resultado: quando o Smart Script encontra o parâmetro af_r no link de entrada, o Smart Script não produz uma URL de saída e o desenvolvedor deve decidir qual link colocar como URL de saída e implementá-lo.

O mapeamento de web referrer permite que você entenda como os usuários chegaram até o seu site (por exemplo, a partir de resultados de uma pesquisa orgânica). Assim, você pode enriquecer seus dados, analisando instalações e reengajamentos que se originaram do seu fluxo web-to-app do Smart Script.

Você pode configurar o Smart Script para coletar essas informações da sua landing page ou campo Referer do cabeçalho HTTP do site. Esse campo contém a URL base da página na qual os usuários clicaram antes de serem direcionados para a sua página na web.

Para configurar o script e ativar a coleta do web referrer

1. Abra a página do Smart Script
2. Em mapeamento de web referrer, selecione a chave do parâmetro da URL de saída para o valor do web referrer:
   • af_channel – o parâmetro está disponível nos dashboards e dados brutos
   • af_sub1-5 – o parâmetro está disponível nos dados brutos nas colunas af_sub1-5 e na coluna da URL original .
   • Parâmetro personalizado - é composto pelo nome e valor do parâmetro. O parâmetro é exibido nos dados brutos e na coluna da URL original.

Para saber mais sobre a atribuição de pesquisa orgânica para reengajamentos usando Universal Links e App Links, clique aqui.

A maioria dos casos de uso nesse artigo são de usuários provenientes de dispositivos mobile. Portanto, quando direcionados do site mobile para uma loja de aplicativos, eles podem baixar seu aplicativo imediatamente.

No entanto, os usuários de desktop não devem ser enviados imediatamente para uma loja de aplicativos, pois seu dispositivo (desktop ou laptop) não é compatível com downloads de aplicativos mobile.  

Para configurar o script para usuários de desktop:

• Em seu template do OneLink, defina uma URL de destino para Quando o link for clicado em desktop. A URL deve redirecionar para uma página inicial/landing page. A landing page pode conter um formulário web onde os usuários preenchem seus dados para receber um SMS ou um e-mail com um link para baixar o aplicativo. Cabe a você criar o formulário da web e fornecer a URL para ele no script.  

Resultado: O script detecta o dispositivo ou a plataforma em que o usuário está. Se for desktop, o script gera uma URL de saída do OneLink que redireciona o usuário para sua página web/landing page dedicada.

Consulte também Conversão de desktop-to-app.

O Smart Script exibe um QR code em sua página web, ao invés de um botão com um link por trás dele. 

Para exibir um QR code:

1. Lembre-se de usar o Smart Script 2.6+ ao configurar seu Smart Script.
2. Diga ao seu desenvolvedor para seguir as instruções para criar um QR code com o resultado do Smart Script.
3. [Prática recomendada] Diga ao desenvolvedor para:
   • Personalizar o QR code adicionando o logotipo do aplicativo no centro do QR code e personalizando a cor.
   • Mostrar o QR code quando os usuários estiverem no desktop e exibir o botão com o link quando os usuários estiverem no mobile. 

Resultado: o script exibe um QR code em vez de um botão com uma URL por trás dele.

O Smart Script do OneLink pode ser usado para contar impressões no seu site. Para isso, o desenvolvedor precisa chamar a função de impressão. As instalações são atribuídas às impressões por meio de atribuição de view-through.

Atenção:

• A contagem de impressões se soma à URL normal produzida pelo Smart Script, que conta os cliques. O Smart Script pode ser usado para contar cliques, impressões, ou ambos.
• A atribuição de view-through via Smart Script só funciona em dispositivos mobile, não em desktops.

Para atribuir novas instalações a essas impressões (que são atribuição de view-through): 

1. Certifique-se de usar o Smart Script 2.3+ quando você configurar seu Smart Script.
2. Peça ao seu desenvolvedor para chamar a função de impressão no Smart Script.
3. Certifique-se de que a atribuição de view-through está habilitada.

A URL de entrada para criar um link do OneLink funciona se o usuário navegar para uma página diferente no site?

Sim. Os parâmetros de URL de entrada são armazenados durante a sessão de navegação e aplicados aos parâmetros de saída do link do OneLink gerado por Smart Script. Para mais informações de implementação, consulte nosso developer hub.

Por que recebo uma mensagem de erro ao implementar o Smart Script por meio do Google Tag Manager?

Às vezes, quando você gera o Smart Script na AppsFlyer e tenta inseri-lo no Google Tag Manager (GTM), um erro de "JavaScript muito longo" é exibido. Se isso ocorrer, exclua a tag GTM e crie uma nova.

Posso adicionar parâmetros que não estão listados?

Sim. Na página OneLink Smart Script, clique em + Novo parâmetro para mapear parâmetros adicionais.

• Novos parâmetros podem ser parâmetros personalizados ou parâmetros reservados da AppsFlyer que não estão listados no menu suspenso.
  • Veja todos os argumentos adicionais (configurações de parâmetros) que você pode usar.
• Use a opção personalizada no menu suspenso e seu parâmetro no campo Parâmetros de URL de saída.

Por exemplo, para adicionar is_retargeting como um parâmetro, o parâmetro personalizado seria selecionado no campo mapping for e, em seguida, nosso parâmetro is_retargeting no campo Outgoing URL parameters.

Adset e outros parâmetros não estão aparecendo no menu suspenso

Recomendamos desativar todos os bloqueadores de anúncios que você possui em seu navegador ao criar ou adicionar novos parâmetros. Às vezes, os bloqueadores de anúncios removem uma opção se ela contiver a palavra "Anúncio".

Em quais navegadores o Smart Script funciona?

O Smart Script usa Javascript e deve funcionar em todos os navegadores.