[Descontinuado] Script de atribuição de página inicial em mobile

Descrição:

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

Após a primeira inicialização do aplicativo, a AppsFlyer consulta os anúncios do Meta se o usuário já engajou anteriormente (nos últimos 28 dias) com um anúncio no aplicativo do Facebook. Se sim, o Meta ads faz a auto-atribuiçã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.

Conclusão:

Um lead com o ID do dispositivo disponível, proveniente do aplicativo do Facebook para uma página inicial, é atribuído corretamente ao Meta ads. Isso acontece independentemente do novo clique registrado na página inicial.
No entanto, quando os usuários optam por não compartilhar o ID do dispositivo, como esperado com os usuários do iOS 14 em 2021, a atribuição multiplataforma do Meta ads pode não funcionar mais.

Quando o compartilhamento de ID do dispositivo se tornar opcional, use o comando Outro método de SRNs para Meta ads. 

• Os novos usuários que compartilharem o ID do dispositivo serão atribuídos corretamente ao Meta ads.
• Novos usuários que não compartilham seu ID de dispositivo seriam atribuídos a "Facebook_LP".

Instruções:

1. Na sua conta do Meta ads, crie uma campanha «Tráfego» ou «Conversões» com a atribuição mobile ativada, enviando leads para a sua página inicial.
2. Botão de download do Android da página inicial - link direto para o Google Play.
3. Botão de download do iOS da páginal inicial - link direto para o iTunes (OU link de atribuição sem o ID do dispositivo).

O que o script faz

O script da página inicial não faz alterações. O script foi projetado para detectar um usuário vindo do aplicativo do Facebook. Se sim, ele não faz nada. Ele deixa os links diretos da página inicial para as lojas de aplicativos como estão Isso evita que outro clique seja registrado, o que pode afetar o CTR.

No script, procure um método chamadoisFacebook() para saber mais sobre o que o script faz quando um usuário vem do aplicativo do Facebook.

Descrição:

O processo usual para a atribuição de instalações de campanhas do Google Ads requer que os leads que clicam sejam redirecionados para o URL da página da loja do aplicativo.

Portanto, ao redirecionar leads do Google Ads para uma página inicial, use um mediador para se conectar entre a instalação mobile e o clique original na campanha do Google Ads não mobile.

Conclusão:

A solução para o Google Ads tem 2 partes.

A primeira parte se ocupa de atribuir na AppsFlyer os usuários de mobile que acessam a página inicial do Google e instalam o aplicativo a partir dela. Isso requer a marcação dos URLs de clique do Google, identificando-os na página inicial e criando um OneLink dinâmico com dados do URL.

A segunda parte se ocupa de notificar o Google Ads sobre essas instalações para dispositivos mobile, usando o método de upload de conversões offline do Google.

Instruções:

Parte 1 - Atribuindo para o Google Ads na AppsFlyer

O que o script faz

O Google Ads traz um parâmetro gclid. O script procura esse parâmetro no URL da página inicial. Se ele o vir, ele cria o OneLink de forma que reflita que o usuário vem do Google Ads. O script então coloca o OneLink como o link atrás dos botões de download na página inicial.

No script, procure porgclidValue para saber como o script detecta usuários provenientes do Google Ads e cria o OneLink de acordo.

Descrição:

Outro SRNs, por exemplo, Snapchat ou Twitter, não são multiplataforma como o Meta Ads e exigem um pouco de trabalho para que seus usuários mobile sejam atribuídos a eles.

Suas campanhas com outros SRNs levam seus usuários à página inicial, e você é cobrado de acordo com os cliques, sem nenhuma relação com qualquer usuário mobile derivado. 

Conclusão:

Ao definir o URL da página inicial de uma campanha em SRNs (além do Meta Ads e do Google Ads), adicione um parâmetro de ID do parceiro ao URL, que indica o SRN original.
A página inicial lança um javaScript (veja abaixo) que analisa esse parâmetro e cria um URL do OneLink, que tem o valor de ID do parceiro. Quando os usuários de mobile clicam no OneLink e instalam, eles são atribuídos ao canal de mídia indicado.

Instruções:

Na sua conta SRN -

1. Criar uma campanha não mobile
2. Ao definir o URL da página inicial, adicione um parâmetro de ID de parceiro + página inicial ao URL (que não é um link de atribuição AF). O formato é "&af_pid=srn_lp". (veja o exemplo abaixo)

No carregamento da página inicial -

1. Ative a função Javascript generateUrl
2. A função procura o parâmetro af_pid e cria um URL do OneLink contendo seu valor sob o parâmetro pid
3. O botão de download da página inicial usa o URL do OneLink gerado
4. Novos usuários de mobile são atribuídos ao canal de mídia personalizado "ID do parceiro + página inicial"
5. Nenhum postback é enviado para o canal de mídia

O próprio script contém lógica para evitar que você use esses nomes. Procure var SRNs no script. Você deve ver uma lista de nomes SRN e uma condição que verifica se pidValue é qualquer um desses nomes. Remova essa lógica depois de terminar de testar o script.

O que o script faz

O script vê o parâmetro af_pid na URL da página inicial e conclui que o usuário vem de um SRN ou de alguma outra rede personalizada. O script cria um OneLink de acordo e o define como o link por trás do botão de download na página inicial.

Para saber mais sobre o que o script faz, procure pidValor no script.

Descrição:

Os links de atribuição são usados para qualquer canal de mídia, que não seja uma SRN. Isso inclui milhares de parceiros integrados e qualquer mídia própria que você deseja atribuir.

Felizmente, a solução para atribuição de página inicial ao usar os links de atribuição da AppsFlyer é simples (e semelhante à solução para Meta ads).

Conclusão:

O link de atribuição redireciona o lead para uma página inicial e, com isso, também cuida da atribuição correta (se uma instalação mobile seguir).

Tudo o que resta a fazer é NÃO impedir a atribuição correta com outro último clique.

Instruções:

1. Criar o link de atribuição para o canal de mídia
2. Adicione o parâmetro da página inicial que leva para a sua página inicial para o link de atribuição
3. Adicione &af_redirect=true ao valor da página inicial em quaisquer parâmetros de redirecionamento (ou seja, af_r, af_ios_url e af_android_url) no link de atribuição.
   Exemplo: https://yourapp.onelink.me/abcd?pid=email&c={CAMPAIGN_NAME}&af_r=http://www.yoursite.com/yourlandingpage?af_redirect=true
4. Opcional- adicione o ID do dispositivo (GAID / IDFA) ao link de atribuição para permitir a atribuição por correspondência de ID em vez de modelagem probabilística
5. Botão de download do Android da página inicial - link direto para o Google Play
6. Botão de download do iOS da página inicial - link direto para o iTunes
   
   

    Observação

   O script e a página de exemplo HTML fornecem a opção de definir um botão de download que serve para Android e iOS. Leia os comentários no script para saber como implementá-lo.

O que o script faz

O script procura o parâmetro af_redirect no URL da página inicial. Se ele o vir, ele não fará alterações nos botões de download na página inicial. Isso ocorre porque o parâmetro af_redirect indica que o usuário acessa a página inicial após um clique. Portanto, não há necessidade de links de atribuição adicionais.

Para saber mais sobre o que o script faz para lidar com casos em que os usuários acessam a página inicial depois de clicar em um link de atribuição, veja o método isAFLink() no script.

Descrição

Você pode ter fontes de tráfego, que redirecionam os usuários para sua página inicial usando links com parâmetros UTM.

Conclusão:

Se o URL original NÃO for um link de atribuição da AppsFlyer, o script procura os parâmetros utm_source e utm_campaign no link. Se existirem, o script prepara um URL do OneLink, que os tem como nome do canal de mídia (pid) e nome da campanha (c), respectivamente.

Observe que, com os links de atribuição da AppsFlyer, que também contêm parâmetros UTM, os parâmetros da AppsFlyer estão sendo usados, em vez dos parâmetros UTM.

Instruções:

Sobre o canal de mídia -

1. Certifique-se de que utm_source existe no link.
2. O parâmetro utm_campaign é opcional, mas altamente recomendado.

No carregamento da página inicial -

1. Ative a função Javascript generateUrl
2. A função procura os parâmetros utm_source e utm_campaign e cria um URL do OneLink contendo seus valores
3. O botão de download da página inicial usa o URL do OneLink gerado
4. Novos usuários móveis são atribuídos ao valor deutm_source como canal de mídia
5. Nenhum postback é enviado para o canal de mídia.

O que o script faz

O script procura parâmetros UTM no URL da página inicial. Se ele encontrar algum parâmetros, ele o converte em parâmetros do OneLink. Dessa forma, as informações da campanha são transferidas para a atribuição final.

Descrição

Os visitantes orgânicos em mobile são, por definição, leads diretos da web móvel de fontes desconhecidas. Eles raramente visitam páginas iniciais dedicadas, mas podem ser a grande maioria das instalações em mobile provenientes do site do anunciante.

Conclusão:

Se você tiver uma quantidade significativa de tráfego orgânico em mobile do seu site, é altamente recomendável registrar os dados de atribuição do seu próprio tráfego.

Instruções:

Para atribuir visitantes orgânicos em mobile, o site deve ter botões de download ou instalação, com um link de atribuição do OneLink atrás deles. O OneLink permite diagnosticar o tipo de dispositivo e redirecionar o lead para a loja de aplicativos correta de acordo com ele.

Para saber como definir e criar URLs do OneLink, clique aqui.

O que o script faz

Esgotando todas as outras opções, o script determina que o usuário é um usuário orgânico que não vem de nenhuma campanha. O script cria um OneLink que reflete isso e o coloca como o link por trás do botão de download na página inicial.

Descrição

Todas as opções abordadas acima pressupõem que os usuários usem dispositivos móveis ao interagir com a campanha e a página inicial.

Mas e os usuários de desktop?

Os usuários de desktop podem chegar à sua página inicial/site e, posteriormente, visitar "independentemente" a loja de aplicativos com seus dispositivos móveis e instalar o aplicativo mobile. Sem o engajamento anterior com os dispositivos móveis, é impossível atribuir esses usuários e, portanto, eles são rotulados como "Orgânicos".

Conclusão:

Uma ótima solução para esse problema de atribuição é usar um Formulário de texto para download em sua página inicial, somente para usuários de desktop. Isso deve ser seguido pelo envio ao dispositivo mobile de um SMS/e-mail com URL do OneLink.

Instruções:

1. Identificar que um visitante é um usuário de desktop
2. Quando seu usuário digitar o número de telefone, envie a ele uma mensagem de texto com o link para seu aplicativo, com um URL curto do OneLink. Você também pode solicitar o endereço de e-mail para enviar mensagens de download do aplicativo por e-mail.
3. O uso do OneLink é crucial aqui, pois a plataforma do dispositivo mobile não é conhecida ao enviar a mensagem aos usuários. As funcionalidades de diagnóstico e redirecionamento do OneLink cuidam disso para você.
4. Adicione "&pid=desktop_website" ao URL do OneLink para identificar essa fonte.
5. Adicione "&c={PAGE NAME}" para ajudar a encontrar as páginas de maior e menor conversão em seu site para usuários de desktop.

O que o script faz

O script detecta o dispositivo ou a plataforma em que o usuário está. Se for desktop, o script retornará um link para um URL de formulário da web e o colocará atrás dos botões de download. Quando o usuário clica em download, ele é enviado para um formulário da web onde preenche os 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 o URL para ele no script.  Para saber mais, procureisMobileDevice() no script.

Considere o seguinte antes de implementar o script:

• O script é oferecido apenas como exemplo. Ele abrange a página inicial comum ao fluxo de atribuição. Adapte o script para atender às suas necessidades.
• O script procura parâmetros específicos no URL da página inicial, como canal de mídia, campanha, palavras-chave etc. Se você quiser adicionar outros parâmetros, como ID do site e conjuntos de anúncios, precisará modificar o script de acordo.

//Returns the value of a parameter existing in the page's URL or ' ' if not exists.
function getParameterFromURL(name, url) {
  if (!url) url = window.location.href;
  name = name.replace(/[\[\]]/g, '\\$&');
  var regex = new RegExp('[?&]' + name + '(=([^&#]*)|&|#|$)'),
    results = regex.exec(url);
  if (!results) return null;
  if (!results[2]) return '';
  return decodeURIComponent(results[2].replace(/\+/g, ' '));
}

function isMobileDevice() {
  return (typeof window.orientation !== "undefined") || (navigator.userAgent.indexOf('IEMobile') !== -1);
}

function getMobileOperatingSystem() {
  var userAgent = navigator.userAgent || navigator.vendor || window.opera;
  if (userAgent) {
    if (/android/i.test(userAgent)) {
      return "Android";
    }

    // iOS detection from: http://stackoverflow.com/a/9039885/177710
    if (/iPad|iPhone|iPod/.test(userAgent) && !window.MSStream) {
      return "iOS";
    }
  }
  return "unknown";
}

function isAFLink() {
  return getParameterFromURL('af_redirect');
}


// Note - when device ID sharing becomes optional stop calling this method (or always return false)
function isFacebook() {
  if (document.referrer && document.referrer != "") {
    return document.referrer.toLowerCase().includes('facebook');
  } else {
    return false;
  }
}

// generateUrl returns the URL to use behind the iOS and Android "Download" buttons on a landing page, based on the source of the page visitor.
// By default these buttons should direct to the apps' pages on iTunes and Google Play.
// If these links should be kept with no change, generateUrl returns ' '.
// Otherwise, generateUrl returns the URL to be used under BOTH buttons (a single app download button could also be used in this case).
// Parameters: isDebug - if true, alerts are issued for each of the cases, otherwise not.  	 
function generateUrl(isDebug) {
  var oneLinkURL = 'https://yourapp.onelink.me/abcd';   // **** Replace with your own basic OneLink URL ****
  var webFormURL = 'https://yoursite.com/webform.html'; // **** Replace with your own web form URL for getting the user's email or SMS ****
  var finalURL = "";
  var partnerIDParam = '?pid=';

  var campaignValue;
  if (getParameterFromURL('c')) {
    campaignValue = getParameterFromURL('c');
  } else if (getParameterFromURL('utm_campaign')) {
    campaignValue = getParameterFromURL('utm_campaign');
  } else if (document.getElementsByTagName('title')[0]) {
    campaignValue = document.getElementsByTagName('title')[0].innerText;
  } else {
    campaignValue = 'unknown';
  }
  var campaignParam = '&c=';
  var gclidParam = '&af_sub1=';
  var gclidValue = getParameterFromURL('gclid');
  var kwParam = '&af_keywords=';
  var pidValue;
  var kwValue = getParameterFromURL('keyword');
		
  if (getParameterFromURL('af_pid')) {
    pidValue = getParameterFromURL('af_pid');
  } else if (getParameterFromURL('utm_source')) {
    pidValue = getParameterFromURL('utm_source');
  }
  
  // Prevent the use of real SRN names. Remove this part after you are done testing the script.
    var SRNs = [
    'twitter_int',
    'facebook_int',
    'snapchat_int',
    'doubleclick_int',
    'yahoogemini_int',
    'yahoojapan_int',
  ];

  if (SRNs.includes(pidValue)) {
  	alert("DO NOT USE NAMES OF SRNS IN af_pid or utm_source - use the names listed in Other SRNs: Add Parameter section in the landing page article\nhttps://support.appsflyer.com/hc/en-us/articles/360000677217#other-srns-add-parameter");
    return;
  }

  // Desktop user
  if (!isMobileDevice()) {
    return webFormURL;
  }

  // User was redirected using af_r parameter on an AppsFlyer attribution link
  if (isAFLink()) {
    if (isDebug) {
      alert("This user comes from AppsFlyer by redirection and is ready to be attributed. \nKeep direct app store links.");
    }
    return; // in this case, the original store links in the install buttons stay the same

    /*
    If you want one install button in the landing page that serves both iOS and Android, uncomment the code below
    The code identifies the operating system and returns the relevant direct link to Google Play or iTunes
 
    if (getMobileOperatingSystem() === 'Android') {
      return 'direct link to Google Play';
    } 
 
    if (getMobileOperatingSystem() === 'iOS') {
      return 'direct link to iTunes';
    }
    */
  }

  // Google Ads
  if (gclidValue) {
    partnerIDParam += 'google_lp';
    campaignParam += campaignValue;
    gclidParam += gclidValue
    if (!kwValue) {
      finalURL = oneLinkURL + partnerIDParam + campaignParam + gclidParam;
      if (isDebug) {
        alert("This user comes from Google AdWords\n " + finalURL);
      }
      return finalURL;

    } else { // Google Ads with KW
      kwParam += kwValue;
      finalURL = oneLinkURL + partnerIDParam + campaignParam + gclidParam + kwParam;
      if (isDebug) {
        alert("This user comes from Google AdWords - there is a keyword associated with the ad\n " + finalURL);
      }
      return finalURL;
    }

  // Other SRNs and custom networks  
  } else if (pidValue) {
    campaignParam += campaignValue;
    partnerIDParam += pidValue;
    finalURL = oneLinkURL + partnerIDParam + campaignParam;
    if (isDebug) {
      alert("This user comes the SRN or custom network " + pidValue + "\n" + finalURL);
    }
    return finalURL;
  } else if (isFacebook()) {
    if (isDebug) {
      alert("This user comes from a paid Facebook ad - don't do anything. \nKeep direct app store links.");
    }
    return ' ';
    
  } else { // organic mobile user
    campaignParam += campaignValue;
    partnerIDParam += 'website'; //**** Replace value if you wish organic users to be attributed to another media source than 'website' ****
    finalURL = oneLinkURL + partnerIDParam + campaignParam;
    if (isDebug) {
      alert("This user comes from an unknown mobile source.\n The user would be attributed to media source 'website' and to the campaign " + campaignParam + "\n" + finalURL);
    }
    return finalURL;
  }
}

<html>
<head>
  <title>Landing Page</title>
</head>
<body>
  <h1>Landing Page</h1>
  <!-- By default, the install buttons should have direct links to the stores -->
  <div>
    <a id="andrd_link" href="https://play.google.com/store/apps/details?id=com.appsflyer.sampleapp"><img src="/images/andrd.png"alt=""></a>
  </div>
  <div>
    <a id="ios_link" href="https://itunes.apple.com/us/app/id3********"><img src="/images/ios.png" alt=""></a>
  </div>
  <!-- If you want one button to serve both Android and iOS, use the code below instead
  <a id="store_link" href=""><img src="download.png" alt=""></a>
  -->
  <script type="text/javascript" src="/landing-page-test.js"></script>
  <script type="text/javascript">
    window.onload = function () {
      var url = generateUrl(true);

      // onelink is generated
      if (url) {
        document.getElementById('andrd_link').setAttribute('href', url);
        document.getElementById('ios_link').setAttribute('href', url);
      }

      //otherwise, if onelink is not generated it means that the user is redirected
      // and the store links in the buttons stay the same

      /* for the one button solution for both Android and iOS, use the code below instead

      document.getElementById('store_link').setAttribute('href', url);

      */

    };
  </script>
</body>

</html>