How can we help?

Pesquisa

[Legacy] Configuração do OneLink Smart Script V1

  • Atualizado

Visão geral: configure o OneLink Smart Script para converter e atribuir os visitantes do seu site mobile, provenientes de qualquer canal, em usuários do aplicativo mobile. Nota: Embora não seja obrigatório, considere migrar para OneLink Smart Script V2. 

7901_Smart_Script_flow_1920x1080_2__1_.png

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, essa é a versão ideal. A parte do trabalho de desenvolvimento é mais fácil e também pode ser configurada usando o Google Tag Manager. Nota: Embora não seja obrigatório, considere migrar para a V2. 

OneLink Smart Script V1 (legado): Se você já tem o OneLink Smart Script configurado, use a documentação desta versão para manter e editar este script. 

Responsabilidades

Quem está envolvido

  • Anunciante: 

    • Decide o que a URL de saída deve conter. Isso inclui quais dados de atribuição anexar ao link e os dados necessários para deep linking. Seja manipulando a URL de entrada ou forçando determinados valores. 

    • Certifica-se de que todas as campanhas que levam ao site mobile tenham URLs de entrada com parâmetros que funcionem para o script. 
  • Desenvolvedor da web:
    • Configura os dados para inicializar o script. 
    • Insere os setters necessários para gerar as URLs de saída do OneLink com base nos parâmetros da URL de entrada fornecidos pelo profissional de marketing. Isto inclui parâmetros obrigatórios e opcionais.  
    • Incorpora o script ao site ou página/s específica(s). 

Pré-requisitos

Para implementar o script na página web:

  1. Decida quais parâmetros/valores a URL de saída do OneLink gerada automaticamente deve conter. Consulte a lista de parâmetros que você pode usar. 
    • Certifique-se de que todas as campanhas com URLs de entrada tenham parâmetros com os quais o script funcione (e que possa usar como os parâmetros pid e c). 
  2. Forneça a lista de parâmetros ao desenvolvedor da web.
  3. Diga ao desenvolvedor para seguir as instruções do dev e implementar o script para que o link de saída correto seja gerado.

Parâmetros

Parâmetros/valores fornecidos ao desenvolvedor para implementar o Smart Script

Parâm./valor Considerações Registre suas respostas (para que o desenvolvedor as utilize)
oneLinkURL (obrigatório)
  • Forneça o domínio do template do OneLink + ID do template. Observação: Não é uma URL de link personalizada do OneLink!
  • Exemplo: suamarca.onelink.me/A1b2
  • Exemplo de domínio de marca: clique.suamarca.com/A1b2
 
pidKeysList (canais de mídia)
  • Liste todos os parâmetros de canal de mídia na URL de entrada que serão usados como parâmetro de canal de mídia (pid) na URL de saída.
  • Exemplo: ['af_pid', 'utm_source']
  

pidOverrideList
  • Para os canais de mídia que você quer alterar no link de saída, liste os valores de canal de mídia na URL de entrada junto com os valores pelos quais deseja substituí-los.
  • Exemplo: {
    'twitter': 'twitter_int',
    'snapchat': 'snapchat_int',
    'some_social_net': 'some_social_net_int'
    }

 

pidStaticValue
  • Indique qual será o seu "fallback" de canal de mídia.
  • Se um parâmetro de canal de mídia não for encontrado na sua pidKeysList, o pidStaticValue será usado como o canal de mídia (pid) na URL de saída.
  • Exemplo: 'website' ou 'landing_page'

 
campaignKeysList (campanhas)
  • Liste todos os parâmetros de campanha na URL de entrada que serão inseridos como o parâmetro de campanha (c) na URL de saída.
  • Exemplo: ['af_campaign', 'utm_campaign']

 
campaignStaticValue
  • Indique qual será a sua campanha "fallback".
  • Se um parâmetro de campanha não for encontrado na sua campaignKeysList, o campaignStaticValue será usado como a campanha (c) na URL de saída.
  • Exemplo: 'website' ou 'landing_page'

 
gclIdParam
  • Informe como o parâmetro que leva a GCLID será chamado.
    Nota! Para exibir relatórios de dados brutos na AppsFlyer, o parâmetro deve ser um dos af_sub[1-5].
 
skipList
  • Liste as strings no referenciador HTTP que desativam o Smart Script para um clique específico (por exemplo, Twitter ou Facebook). Se as strings forem encontradas, o Smart Script não será executado. Isso pode ser útil para SRNs como X Ads e Meta ads, para os quais os cliques já são relatados.
  • Se você quiser que o Smart Script sempre seja executado, inclusive para SRNs, diga ao desenvolvedor para passar uma lista de exclusão vazia.
  
Outros parâmetros de consulta
  • Liste quaisquer outros parâmetros que você queira incluir na URL de saída do OneLink para atribuição ou deep linking.
  • Adicione um deep_link_value para deep linking.
    • Além de adicionar o parâmetro, você e seu desenvolvedor precisam implementar a lógica de deep linking. Saiba mais.
  • Você pode usar parâmetros da URL de entrada ou forçar um valor estático. 
 

casos de uso

As seções a seguir trazem alguns casos de uso do Smart Script para cenários de campanhas/canais de mídia comuns.

Meta ads—atribuição multiplataforma

O Meta ads é um SRN que não usa links de atribuição externa.

Na primeira abertura do aplicativo, a AppsFlyer consulta os anúncios da Meta para verificar se o usuário já interagiu anteriormente (nos últimos 7 dias) com um anúncio do aplicativo. Se o usuário tiver se engajado com um anúncio do Facebook do anunciante, os anúncios da Meta fazem a autoatribuição. O Meta ads também faz atribuição multiplataforma, o que significa que o usuário pode interagir com qualquer tipo de campanha, mobile ou não, em qualquer plataforma, para ser autoatribuído pelo Meta ads.

Ação: informe ao seu desenvolvedor para usar o método skipList para desabilitar o Smart Script para anúncios da Meta (ou quaisquer outras strings que você quiser). Se os anúncios da Meta ou qualquer uma das strings na skip list aparecer no referenciador HTTP do clique, o Smart Script retornará null.

Observação: a atribuição entre plataformas dos anúncios da Meta pode ser afetada quando os usuários optam por não compartilhar o Device ID, como era esperado para usuários do iOS 14 durante 2021.

Google Ads—parâmetros GCLID e UTM

O processo usual para a atribuição de instalação de campanhas do Google Ads (que carregam um parâmetro GCLID) exige que os cliques sejam redirecionados para a URL da página da loja do aplicativo.

Como, neste caso, você está redirecionando leads do Google Ads para uma página web/landing page, o script extrai o parâmetro GCLID da URL da campanha de instalação do Google Ads e o insere na URL de saída, no parâmetro de saída de sua escolha af_sub[1-5]. 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. 

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

Para configurar o script para o Google Ads:

  1. Faça uma lista dos nomes dos parâmetros de canal de mídia e de campanha que estão nos links de entrada.
    Por exemplo: utm_source e utm_campaign.
  2. 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.
  3. Forneça-os na lista de parâmetros ao desenvolvedor web.

Resultado:

  • Os valores dos parâmetros de canal de mídia e de campanha (utm_source e utm_campaign) no link de entrada são usados para preencher os valores dos parâmetros pid e c no link de saída. 
  • Na URL de saída, o GCLID é 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 por meio da API do Adwords.

 Nota

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

Links de SRNs, mídias próprias e de outros canais de mídia

SRNs como Snapchat ou X Ads funcionam de maneira diferente do Google Ads ou de uma plataforma entre plataformas, como os anúncios da Meta. 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 parâmetros ao desenvolvedor web.
    O t    ipo de SRN/canal de mídia deve ser o valor do canal de mídia na URL de entrada, e o script o encontra e o usa como o valor de pid na URL de saída do OneLink por trás do botão de download na página web/landing page. Se você quiser alterar o pid de saída, forneça o valor do canal de mídia de entrada e o valor de substituição de pid na lista de substituição de pid. 

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

 Exemplo

URL recebida: https://hotel.me/af_pid=twitter&af_c=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 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 Redirection URL path (af_r)  com o caminho de URL desejado para seu site web mobile, para atribuição de campanha web para aplicativo. 

Resultado: Se os parâmetros af_r e af_redirect=true estiverem no link de entrada, o script da landing page não fará alterações. Ele deixa os links diretos da web/página de destino para as lojas de aplicativos como estão. 

 Exemplo

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

URL de saída: Igual

Desktop

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 para aplicativo.

Limitações

Limitação Considerações
Gerenciador de tags

O Smart Script não pode ser implementado por meio de um gerenciador de tags. Consulte OneLink Smart Script V2 ou Smart Banners como uma solução alternativa de atribuição web-to-app.

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.

Share article: