Configuração do OneLink Smart Script V2

1. Na AppsFlyer, vá para Experiences & Deep Linking > Web-to-app > Smart Script.
2. Para novos usuários
   1. Clique no botão Comece.
   2. Siga os passos 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 do canal de mídia (pid) é obrigatório.
   1. Selecione o parâmetro/dimensão de saída a ser mapeado.
      Muitas vezes, este é um nome de parâmetro da AppsFlyer, que não pode ser alterado, mas, em alguns casos, você precisa digitar o nome do seu parâmetro.
   2. Decida e 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 de seu parâmetro de URL de saída.
        • Exemplo: qualquer_nome_de_parametro, utm_do_nome_do_parametro. Se utm_do_nome_do_parametro é encontrado no URL de entrada, seu valor será usado como o valor do parâmetro do URL de saída que você selecionou.
        • O Smart Script pesquisa a lista de parâmetros da esquerda para a direita e mapeia a primeira correspondência para o parâmetro URL de saída.
        • • Os desenvolvedores se referem a esta lista de parâmetros como chaves.
      • Valor padrão: digite seu valor padrão desejado para o valor do parâmetro de saída para quando 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_nome_de_parâmetro, utm_do_nome_do_parâmetro, 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 no URL recebido for campaign_name, o valor no 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 o URL de saída correto seja gerado.
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 no seu site: envie o script para seu desenvolvedor web para implementação e indique o que eles devem 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 gatilho, nomeie-o e escolha uma Configuração de gatilho (por exemplo, todas as visualizações de página). 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 na faixa 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 no URL de entrada (por exemplo: utm_source e utm_campaign) e compare-os com os parâmetros do URL de saída (por exemplo: media_source e campanha). 
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 de anúncios do Google (que carregam um parâmetro GCLID) requer que os usuários que clicam em seu anúncio sejam redirecionados para o URL da página da loja do aplicativo.

Como neste caso você está redirecionando leads do Google Ads para uma página web/inicial, o script pega o parâmetro GCLID do URL da campanha de instalação do Google Ads e o coloca no URL de saída na sua escolha do parâmetro de saída af_sub[1-5].

Atenção!

• Isto 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 fonte de mídia, apesar da saída 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 no URL de saída como o valor de af_keywords.

Pré-requisito: no painel de controle do Google, habilite a marcação automática.
Com a marcação automática ativada, a URL contém o parâmetro GCLID.

Para configurar o script para o GCLID do Google Ads:

1. Selecione um parâmetro no URL de saída para conter o GCLID.
   Prática recomendada: selecione af_sub[1-5], para que os dados sejam exibidos nos relatórios de dados brutos da AppsFlyer.
2. Forneça isso na lista de argumentos para o desenvolvedor da web.
   

Resultado: no URL de saída, a GCLID é o valor do param af_sub[1-5]

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

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

Os anúncios do Meta carregam IDs de clique chamados de ID de clique do Facebook. Se você deseja que esse ID esteja disponível nos dados brutos da AppsFlyer, certifique-se de colocar a URL de saída em sua escolha de parâmetro de saída af_sub[1-5].

Para configurar o script para o ID de clique do Facebook:

1. Selecione um parâmetro no URL de saída para conter o ID de clique do Facebook.
   Prática recomendada: selecione af_sub[1-5] para que os dados sejam exibidos nos relatórios de dados brutos da AppsFlyer.
2. Forneça isso na lista de argumentos para o desenvolvedor da web.
   

Resultado: No URL de saída, o ID de clique do Facebook é o valor do parâmetro af_sub[1-5] .

SRNs como Snapchat ou Twitter 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/inicial, e você é cobrado de acordo com os cliques, sem nenhuma relação com qualquer usuário mobile derivado. 

Para estas SRNs, a configuração do script é a mesma que para links de mídia própria, ou outras fontes de mídia que você possa usar. 

Para configurar o script:

1. Faça uma lista da fonte da mídia e dos nomes dos parâmetros de campanha que estão nos links de entrada.
2. Forneça esses argumentos na lista de argumentos para o desenvolvedor da web.
   O tipo de SRN/fonte de mídia deve ser o valor da fonte da mídia no URL de entrada, e o script o encontra e o usa como o valor do media_source no URL de saída OneLink atrás do botão de download na página inicial/página web. Se você quiser mudar o media_source de saída, forneça o valor da fonte 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 estas SRNs/fontes da mídia, os valores na fonte 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 a fonte de mídia é uma ad network de clique. Ao configurar tal link na AppsFlyer, você tem a opção de adicionar um parâmetro Redirecionamento do caminho URL (af_r) com o caminho URL desejado para seu site mobile para atribuição de campanha na web. Talvez você não queira que o Script crie um URL OneLink de saída, pois, então, 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 o seu site.

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 em 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 neste artigo são de usuários vindos de dispositivos móveis. Portanto, quando direcionados do site mobile para uma loja de aplicativos, eles podem baixar imediatamente seu aplicativo.

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

Para configurar o script para usuários de desktop:

• Em seu template do OneLink, defina um URL de destino para Quando o link for clicado em desktop. O URL deve ser redirecionado para uma página inicial/página web. A página inicial pode conter um formulário web onde eles 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 web e fornecer o URL para ele no script. 

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

Consulte também Conversão de desktop para aplicativo.

As instalações são atribuídas a agências usando o parâmetro af_prt.

Para adicionar este parâmetro de atribuição usando o OneLink Smart Script, diga a seu desenvolvedor que siga estas instruções.  

Resultado: o script detecta o parâmetro adicional no URL de entrada com o nome da agência e adiciona o parâmetro af_prt à URL de saída.

Smart Script exibe um código QR em sua página web, ao invés de um botão com um link atrás dele. 

Para exibir um código QR:

1. Lembre-se de usar o Smart Script 2.6+ ao configurar seu Smart Script.
2. Diga a seu desenvolvedor para seguir as instruções para criar um código QR 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 computador e exibir o botão com o link quando os usuários estiverem no celular. 

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

O OneLink Smart Script pode ser usado para contar impressões em seu site. Para fazer 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 visualização.

Observação:

• A contagem de impressões se soma ao URL normal produzido pelo Smart Script que conta os cliques. O Smart Script pode ser usado para contar cliques, impressões, ou ambos.
• A atribuição de exibição via Smart Script só funciona em dispositivos móveis, não em desktops.

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

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

O URL de entrada para a geração de link do OneLink funcionará 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 OneLink gerado por Smart Script. Para mais informações sobre implementação, consulte nosso hub do desenvolvedor.

Por que recebo um 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 "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 Personalizado 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 mapeamento para e, em seguida, nosso parâmetro is_retargeting no campo Parâmetros de URL de saída.

Conjunto de anúncios 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 removerão 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.