Configuração do OneLink Smart Script V2

Visão geral: configure o OneLink Smart Script para converter e atribuir os visitantes do seu site mobile, provenientes de qualquer fonte, aos usuários do aplicativo móvel.

7901_Smart_Script_flow_1920x1080_2__1_.png

 Leitura relacionada

Para ter uma visão completa sobre como é trabalhar com os Smart Banners, confira esses artigos:

Configuração

Existem duas versões do OneLink Smart Script:

OneLink Smart Script V2 (recomendado): se você estiver configurando o OneLink Smart Script pela primeira vez, sugerimos que você use essa versão. Ela pode ser gerada na interface da AppsFlyer sem a assistência do desenvolvedor. Se, por algum motivo, for necessário um desenvolvedor, sua parte do trabalho será mais fácil. Além disso, ela também pode ser configurada usando o Google Tag Manager. Veja as instruções do desenvolvedor

OneLink Smart Script V1 (legado): se você já tem o Onelink Smart Script configurado, use a documentação para esta versão para manter e editar este script. Nota: embora não seja obrigatório, considere migrar para a V2. 

 Observação

Clique no botão Seguir no topo do artigo, para ser informado quando houver uma atualização do artigo ou script.

Configurar o OneLink Smart Script

Para configurar o Smart Script, você pode

  • Incorporar o script ao seu site.
  • Usar o Google Tag Manager.

Quem desempenha uma função

  • Anunciante:
    • Decide o que a URL de saída deve conter com base nos argumentos no script que processam a URL de entrada. Isso determina os dados de atribuição e deep linking que são anexados à URL de saída, seja manipulando a URL de entrada ou forçando determinados valores.

    • Gera o Smart Script na interface do usuário da AppsFlyer. 

    • Certifica-se de que todas as campanhas que levam ao site mobile tenham URLs de entrada com parâmetros para os quais o script funciona.
    • Teste o Smart Script
  • Desenvolvedor da web:
    • Verifique se o script é executado no site mobile/páginas nas quais você quer que ele funcione.
    • Use o valor resultante conforme necessário: por exemplo, para colocá-lo como um link em um CTA no seu site.
    • Pode ser necessário criar QR codes usando o script.
    • Pode ser necessário adicionar manualmente argumentos avançados ao script.

Pré-requisitos

Escopo do trabalho

Para criar o OneLink Smart Script:

  1. Na AppsFlyer, vá para Experiences & Deep Linking > Web-to-app > Smart Script.
  2. Selecione um template do OneLink para seu script. O template contém as configurações básicas de redirecionamento.
  3. 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.
  4. Selecione como implementar o Smart Script no seu site:
    • Incorporar o script ao seu site.
    • Usar o Google Tag Manager.
  5. Clique em Gerar.
  6. Clique em Baixar script.
  7. 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
  8. 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
  9. Teste o script na página de teste do Smart Script Certifique-se de que a URL de saída correta seja gerada.

Importante! Toda vez que você atualiza o script, ele precisa ser implementado novamente.

Estrutura do argumento

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.

Argumento Descrição Exemplo
Parâmetros de URL de entrada (chamados de chaves pelos desenvolvedores)
  • Lista de strings
  • Lista de parâmetros possíveis no URL de entrada que o script procura, cujo valor é colocado como o valor no URL de saída.
  • O script pesquisa da esquerda para a direita e para na primeira correspondência.
  • Exemplo: ['in_channel', 'utm_channel']
  • Para o parâmetro do canal no script, o script pesquisa o link de entrada para in_channel e usa o valor como o valor para o canal.
Valor padrão
  • String
  • Indique o que pretende que seja o seu valor "fallback".
  • Se um parâmetro não for encontrado em sua lista de chaves, o valor defaultValue é usado no URL de saída.
  • Você pode forçar um valor padrão, passando uma lista de chaves vazias.

Exemplo: ['web_video']

Para o parâmetro do canal no script, se não for encontrado o parâmetro no_canal, o web_video é usado como o valor do canal.

Substituir valores

  • Dicionário {string: string}
  • Para valores que você deseja alterar no link de saída, liste os valores na URL de entrada, junto com o que você deseja que eles sejam substituídos.
  • O script substitui os valores dos parâmetros do URL de entrada pelos valores que você define. 

Exemplo: {'video': 'video_new'}

Para o parâmetro do canal no script, sempre que o valor de entrada for vídeo, o script o altera para vídeo_novo no link de saída.

Objeto de configuração 

Argumentos

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.

Argumento Observações Registre suas respostas (para que você ou o desenvolvedor as utilize)
oneLinkURL (obrigatório)
  • Forneça o domínio do template do OneLink + ID do template. Nota: não se trata de um URL de link personalizado OneLink!
  • Exemplo: suamarca.onelink.me/A1b2
  • Exemplo de domínio de marca: clique.suamarca.com/A1b2
 

afParameters

(obrigatório)

 

 

 


mediaSource

(obrigatório)

  • Objeto de configuração para fonte de mídia.
  • Exemplo:
    • Chaves: ['incoming_mediasource'' 'utm_source']
    • Valor padrão: ['any_source']
    • Valores de substituição: {twitter: 'twitter_int', orig_src: 'new_src'}

Chaves:

Valor padrão:

Valores de substituição:

campanha

  • Objeto de configuração para campanha.
  • Exemplo:
    • Chaves: ['incoming_campaign', 'utm_campaign']
    • Valor padrão: ['any_campaign_name']
    • Valores de substituição: {campaign_name: 'new_campaign_name'}

Chaves:

Valor padrão:

Valores de substituição:

channel

  • Objeto de configuração para canal.
  • Exemplo:
    • Chaves: ['incoming_channel', 'utm_channel']
    • Valor padrão: ['any_video']
    • Valores de substituição: {video: 'new_video'}

Chaves:

Valor padrão:

Valores de substituição:

ad

  • Objeto de configuração para anúncio.
  • Exemplo:
    • Chaves: ['incoming_ad', 'utm_ad']
    • Valor padrão: ['any_ad_name']
    • Valores de substituição: {ad_name: 'new_ad_name'}

Chaves:

Valor padrão:

Valores de substituição:

adSet
  • Objeto de configuração para conjunto de anúncios.
  • Exemplo:
    • Chaves: ['incoming_adset', 'utm_adset']
    • Valor padrão: ['any_ad_name']
    • Valores de substituição: {adset_name: 'new_adset_name'}

Chaves:

Valor padrão:

Valores de substituição:

deepLinkValue
  • Objeto de configuração para deep_link_value.
  • Exemplo:
    • Chaves: ['product_id', 'page_name']
    • Valor padrão: 'new_offers_page'.
    • Valores de substituição: {twenty_percent_off: 'thirty_percent_off'}

Chaves:

Valor padrão:

Valores de substituição:

afSub1-5

Objeto de configuração para af_sub[1-5].

Chaves:

Valor padrão:

Valores de substituição:

googleClickIdKey

Informe como chamar o parâmetro que leva a GCLID.
Atenção! Para exibir relatórios de dados brutos na AppsFlyer, o parâmetro deve ser um dos af_sub[1-5].

 
Outros parâmetros de consulta (personalizados)
  • Liste quaisquer outros parâmetros que você queira incluir na URL de saída do OneLink para atribuição ou deep link, junto com seus objetos de configuração.
  • O nome do parâmetro personalizado é listado pelo desenvolvedor como um paramKey no objeto de configuração.
  • Exemplo:
    • paramKey: 'deep_link_sub1'
    • Chaves: ['page_id']
    • Valor padrão: 'página1'.
    • Valores de substituição: {page12: 'new_page12'}

Chave do Param:

Chaves:

Valor padrão:

Valores de substituição:

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

Argumentos avançados

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

Argumento Observações Registre suas respostas (para que você ou o desenvolvedor as utilize)
 
referrerSkipList
  • Lista das strings no HTTP referrer para um determinado clique (por exemplo, Twitter ou Facebook) que, se encontrado, faz com que o Smart Script retorne nulo. Isto pode ser útil para SRNs como Twitter e Facebook, para os quais os cliques já são relatados.
  • A implementação desse argumento faz com que o script NÃO gere uma URL do OneLink.

 

urlSkipList
  • Lista das strings no URL para um determinado clique (por exemplo af_r) que, se encontrado, faz com que o Smart Script retorne nulo. Isto pode ser útil se você usar um link de atribuição AppsFlyer com af_r para redirecionar os usuários para seu site mobile, e não quer que os dados do clique original sejam perdidos.
  • A implementação desse argumento faz com que o script NÃO gere uma URL do OneLink.

 

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

Casos de uso

As seções seguintes fornecem casos de uso do Smart Script para alguns cenários de campanhas/meios de comunicação comuns.

Parâmetros UTM

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. 

GCLID do Google Ads

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é-requisitono 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.

 Observação

Esta solução GCLID não é oficialmente apoiada ou recomendada pelo Google. Caso o Google deprecie o parâmetro GCLID, alteraremos o script para que aceite as mudanças. Siga este artigo clicando no botão Seguir no topo do artigo, para ser informado quando houver uma atualização do artigo ou script.

ID de clique no Facebook

O Facebook Ads traz IDs por clique. Se você quiser que esta ID esteja disponível nos dados brutos do AppsFlyer, pegue a ID de clique do Facebook e coloque-a no URL de saída na sua escolha do parâmetro de saída af_sub[1-5].

Para configurar o script para o Facebook, clique em ID:

  1. Selecione um parâmetro no URL de saída para conter a 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, mídia própria e outros links de fonte de mídia

SRNs como Snapchat ou Twitter, funcionam de forma diferente dos anúncios do Google ou de uma plataforma cruzada como o Facebook. As campanhas destas SRNs levam seus usuários à página web/inicial, e você é cobrado de acordo com os cliques, sem 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. 

 Exemplo

URL de entrada: https://hotel.me/incoming_mediasource=twitter&incoming_campaign=big_social

URL de saída: https://hotel.onelink.me/Ac4G?pid=twitter&c=big_social

Link de atribuição da AppsFlyer

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.

 Exemplo

URL de entrada: https://app.appsflyer.com/id123456789?pid=click_ad_network_int&c=orlando&af_r=hotel.me

URL de saída: nenhum URL de saída.

Desktop

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.

Agências

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.

 Exemplo

URL de entrada: https://hotel.me/incoming_campaign=gogo&incoming_media_source=email&partner_name=bigagency

URL de saída: https://hotel.me/pid=email&c=gogo&af_prt=agency

QR codes

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. Certifique-se de usar o Smart Script 2.1+ quando você 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 mostrar o código QR quando os usuários estiverem no desktop e para mostrar 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. Nota: os códigos QR criados através do Smart Script não podem ser personalizados.

 Exemplo

URL de entrada:

https://hotel.me/qr_code.html?incmp=gogo&inmedia=email

URL de saída:

https://hotel.onelink.me/LtRd/?af_js_web=true&af_ss_ver=2_1_0&pid=email&c=gogo

Código QR de saída:

Impressões

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.2+ quando você configurar 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.
  4. [Opcional] Se você deseja alterar a visualização padrão de 1 dia - através do valor da janela de lookback, você ou seu desenvolvedor precisa adicionar o parâmetro af_viewthrough_lookback com o novo valor. Por exemplo, af_viewthrough_lookback=1d .
Este artigo foi útil?

Comentários

0 comentário

Por favor, entrar para comentar.