[Obsolète] Script d'attribution de la page de renvoi mobile

Description :

Meta ads est un SRN qui n'utilise pas de liens d'attribution externes.

Lors du premier lancement de l'app, AppsFlyer demande à Meta ads si l'utilisateur s'est déjà engagé (au cours des 28 derniers jours) avec une publicité de l'annonceur sur l'app Facebook. Si c'est le cas, les publicités Meta ads s'auto-attribuent.

Les publicités Meta ads sont également multiplate-formes, ce qui signifie que l'utilisateur peut interagir avec n'importe quel type de campagne, mobile ou non, sur n'importe quelle plate-forme, afin d'être auto-attribué par Meta ads.

Conclusion :

Un utilisateur potentiel avec l'ID d'appareil disponible, provenant de l'app Facebook vers une page de renvoi, est correctement attribué à Meta ads. Cela se produit indépendamment du nouveau clic enregistré sur la page de renvoi.
Toutefois, lorsque les utilisateurs choisissent de ne pas partager leur ID d’appareil, comme cela devrait être le cas pour les utilisateurs d'iOS 14 au cours de l'année 2021, l'attribution multiplate-forme de Meta ads risque de ne plus fonctionner.

Lorsque le partage de l'ID d'appareil devient facultatif, utilisez la méthode Autres SRN pour Meta ads. 

• Les nouveaux utilisateurs qui partagent leur ID d’appareil se verront attribuer correctement les publicités Meta ads.
• Les nouveaux utilisateurs qui ne partagent pas leur ID d’appareil seront attribués à "Facebook_LP".

Instructions :

1. Sur votre compte Meta ads, créez une campagne Trafic ou Conversions avec l'attribution mobile activée, en envoyant les prospects sur votre page de renvoi.
2. Bouton de téléchargement de la page de renvoi Android - lien direct vers Google Play.
3. Bouton de téléchargement iOS de la page de renvoi - lien direct vers iTunes (OU lien d'attribution sans l'ID d’appareil).

Ce que fait le script

Le script de la page de renvoi n'apporte aucune modification. Le script est conçu pour détecter un utilisateur venant de l'app Facebook. Si c'est le cas, il ne fait rien. Les liens directs de la page de renvoi vers les app store restent inchangés. Cela empêche l'enregistrement d'un autre clic, ce qui pourrait affecter le CTR.

Dans le script, recherchez une méthode appelée isFacebook() pour en savoir plus sur ce que fait le script pour les utilisateurs venant de l'app Facebook.

Description :

Le processus habituel d'attribution de l'installation pour les campagnes Google Ads exige que les clients potentiels qui cliquent soient redirigés vers l'URL de la page de vente de l'app.

Par conséquent, lorsque vous redirigez des prospects de Google Ads vers une page de renvoi, utilisez un médiateur pour faire le lien entre l'installation mobile et le clic original de la campagne Google Ads non mobile.

Conclusion :

La solution pour Google Ads se compose de 2 parties.

La première partie permet d'attribuer à AppsFlyer les utilisateurs mobiles qui arrivent sur la page de renvoi depuis Google et qui installent l'app à partir de là. Il faut marquer les URL de clics à partir de Google, les identifier sur la page de renvoi et créer un OneLink dynamique avec les données de l'URL.

La deuxième partie consiste à informer Google Ads de ces installations mobiles, en utilisant la méthode de téléchargement des conversions hors ligne de Google.

Instructions :

Partie 1 - Attribution à Google Ads sur AppsFlyer

Ce que fait le script

Google Ads comportent un paramètre gclid. Le script recherche ce paramètre dans l'URL de la page de renvoi. S'il le voit, il crée le OneLink de manière à indiquer que l'utilisateur provient de Google Ads. Le script place ensuite le OneLink comme lien derrière les boutons de téléchargement sur la page de renvoi.

Dans le script, recherchez gclidValue pour savoir comment le script détecte les utilisateurs provenant de Google Ads et crée le OneLink en conséquence.

Description :

D'autres SRN, par exemple Snapchat ou Twitter, ne sont pas multiplate-formes comme Meta ads, et nécessitent un peu de travail pour que vos utilisateurs mobiles leur soient attribués.

Vos campagnes avec d'autres SRN conduisent vos utilisateurs à la page de renvoi, et vous êtes facturé en fonction des clics, sans rapport avec les utilisateurs mobiles dérivés.

Conclusion :

Lorsque vous définissez l'URL de la page de renvoi d'une campagne sur les SRN (en plus de Meta ads et Google ads), ajoutez un paramètre ID partenaire à l'URL, qui indique le SRN d'origine.
La page de renvoi lance un JavaScript (voir ci-dessous) qui analyse ce paramètre et crée une URL OneLink qui contient la valeur de l'ID du partenaire. Lorsque les utilisateurs mobiles cliquent sur ce OneLink et l'installent, ils sont attribués à la source média indiquée.

Instructions :

Sur votre compte SRN -

1. Créer une campagne non mobile
2. Lors de la définition de l'URL de la page de renvoi, ajoutez un paramètre ID partenaire + page de renvoi à l'URL (qui n'est pas un lien d'attribution AF). Le format est le suivant : "&af_pid=srn_lp" (voir l'exemple ci-dessous).

Sur votre page de renvoi -

1. Activer la fonction Javascript generateUrl
2. La fonction recherche le paramètre af_pid et construit une URL OneLink contenant sa valeur dans le paramètre pid.
3. Le bouton de téléchargement de la page de renvoi utilise l'URL OneLink générée
4. Les nouveaux utilisateurs mobiles sont attribués à la source média personnalisée ID partenaire + page de renvoi.
5. Aucun postback n'est envoyé à la source média

Le script lui-même contient une logique qui vous empêche d'utiliser ces noms. Recherchez var SRNs dans le script. Vous devriez voir une liste de noms SRN et une condition qui vérifie si pidValue est l'un de ces noms. Supprimez cette logique après avoir testé le script.

Ce que fait le script

Le script voit le paramètre af_pid dans l'URL de la page de renvoi et en conclut que l'utilisateur provient d'un SRN ou d'un autre réseau personnalisé. Le script crée un OneLink en conséquence et le définit comme le lien derrière le bouton de téléchargement sur la page de renvoi.

Pour en savoir plus sur l'action du script, recherchez pidValue dans le script.

Description :

Des liens d'attribution sont utilisés pour toute source média qui n'est pas un SRN. Cela inclut des milliers de partenaires intégrés et tout média propre que vous souhaitez attribuer.

Heureusement, la solution pour l'attribution de la page de destination lors de l'utilisation des liens d'attribution AppsFlyer est simple (et similaire à la solution pour Meta ads).

Conclusion :

le lien d'attribution redirige le prospect vers une page de renvoi, ce qui permet d'assurer une attribution correcte (si une installation mobile suit).

Il ne reste plus qu'à NE PAS empêcher l'attribution correcte avec un dernier clic.

Instructions :

1. Créez le lien d'attribution de la source média
2. Ajoutez au lien d'attribution le paramètre de la page de renvoi menant à votre page de renvoi.
3. Ajoutez &af_redirect=true à la valeur de la page de renvoi sous tous les paramètres de redirection (c'est-à-dire af_r, af_ios_url et af_android_url) dans le lien d'attribution.
   Example : https://yourapp.onelink.me/abcd?pid=email&c={CAMPAIGN_NAME}&af_r=http://www.yoursite.com/yourlandingpage?af_redirect=true
4. Facultatif - ajoutez l'ID d’appareil (GAID / IDFA) au lien d'attribution pour permettre l'attribution par correspondance d'ID au lieu de la modélisation probabiliste.
5. Bouton de téléchargement de la page de renvoi Android - lien direct vers Google Play
6. Bouton de téléchargement de la page de renvoi iOS - lien direct vers iTunes
   
   

    Remarque

   Le script et la page d'exemple HTML offrent la possibilité de définir un seul bouton de téléchargement pour Android et iOS. Lisez les commentaires du script pour savoir comment le mettre en œuvre.

Ce que fait le script

Le script recherche le paramètre af_redirect dans l'URL de la page de renvoi. S'il le voit, il ne modifie pas les boutons de téléchargement de la page de renvoi. Le paramètre af_redirect indique que l'utilisateur atteint la page de renvoi après un clic. Il n'est donc pas nécessaire d'ajouter des liens d'attribution.

Pour en savoir plus sur ce que fait le script pour traiter les cas où les utilisateurs atteignent la page de renvoi après avoir cliqué sur un lien d'attribution, voir la méthode isAFLink() dans le script.

Description

Vous pouvez avoir des sources de trafic qui redirigent les utilisateurs vers votre page de renvoi en utilisant des liens avec des paramètres UTM.

Conclusion :

Si l'URL d'origine n'est PAS un lien d'attribution AppsFlyer, le script recherche les paramètres utm_source et utm_campaign dans le lien. S'ils existent, le script prépare une URL OneLink qui les contient respectivement en tant que nom de la source média (pid) et nom de la campagne (c).

Notez que pour les liens d'attribution AppsFlyer, qui contiennent également des paramètres UTM, ce sont les paramètres AppsFlyer qui sont utilisés, et non les paramètres UTM.

Instructions :

Dans la source média -

1. Assurez-vous que l'option utm_source existe dans le lien.
2. utm_campaign est facultatif mais fortement recommandé.

Sur votre page de renvoi -

1. Activer la fonction Javascript generateUrl
2. La fonction recherche les paramètres utm_source et utm_campaign et construit une URL OneLink contenant leurs valeurs
3. Le bouton de téléchargement de la page de renvoi utilise l'URL OneLink générée
4. Les nouveaux utilisateurs de téléphones mobiles sont attribués à la valeur de utm_source en tant que source média
5. Aucun postback n'est envoyé à la source média.

Ce que fait le script

Le script recherche les paramètres UTM dans l'URL de la page de renvoi. S'il en trouve, il les convertit en paramètres OneLink. De cette manière, les informations relatives à la campagne sont reportées sur l'attribution finale.

Description

Les visiteurs organiques mobiles sont, par définition, des prospects web mobiles directs provenant de sources inconnues. Ils visitent rarement des pages de renvoi dédiées, mais peuvent constituer la grande majorité des installations mobiles provenant du site web de l'annonceur.

Conclusion :

Si votre site web génère un volume important de trafic organique mobile, il est fortement recommandé d'enregistrer les données d'attribution de votre propre trafic.

Instructions :

Afin d'attirer les visiteurs organiques mobiles, le site web doit comporter les boutons Télécharger ou Installer incluant un lien d'attribution OneLink. OneLink permet de diagnostiquer le type d'appareil et de rediriger l'utilisateur vers l’app store approprié.

Pour savoir comment créer des URL OneLink, cliquez ici.

Ce que fait le script

Après avoir épuisé toutes les autres options, le script détermine que l'utilisateur est un utilisateur organique qui ne provient d'aucune campagne. Le script crée un OneLink qui le reflète et le place comme lien derrière le bouton de téléchargement sur la page de renvoi.

Description

Toutes les options décrites ci-dessus supposent que les utilisateurs se servent d'appareils mobiles pour s'engager dans la campagne et la page de renvoi.

Mais qu'en est-il des utilisateurs d'ordinateurs de bureau ?

Les utilisateurs d'ordinateurs de bureau peuvent arriver sur votre page de renvoi/site web, puis visiter indépendamment l’app store avec leurs appareils mobiles et installer l'app mobile. Sans l'engagement précédent avec les appareils mobiles, il est impossible d'attribuer ces utilisateurs, et ils sont donc étiquetés comme organiques.

Conclusion :

Pour résoudre ce problème d'attribution, vous pouvez utiliser un formulaire de téléchargement de texte sur votre page de renvoi, uniquement pour les utilisateurs d'ordinateurs de bureau. Il faut ensuite envoyer à l'appareil mobile un SMS ou un e-mail contenant l'URL OneLink.

Instructions :

1. Identifier les utilisateur d’ordinateurs de bureau
2. Lorsque votre utilisateur tape son numéro de téléphone, envoyez-lui par SMS un lien vers votre app, avec une URL courte OneLink. Vous pouvez également lui demander son e-mail pour lui envoyer des messages de téléchargement d'app.
3. L'utilisation de OneLink est cruciale ici, car la plate-forme de l'appareil mobile n'est pas connue lors de l'envoi du message aux utilisateurs. Les fonctionnalités de diagnostic et de redirection de OneLink s'en chargent pour vous.
4. Ajoutez &pid=desktop_website à l'URL OneLink pour identifier cette source.
5. Ajoutez &c={PAGE NAME} pour vous aider à trouver les pages les plus et les moins performantes de votre site web pour les utilisateurs d'ordinateurs de bureau.

Ce que fait le script

Le script détecte l'appareil ou la plate-forme sur lequel l'utilisateur se trouve. S'il s'agit d'un ordinateur de bureau, le script renvoie un lien vers l'URL d'un formulaire web et le place derrière les boutons de téléchargement. Lorsque l'utilisateur clique sur télécharger, il est envoyé vers un formulaire web où il remplit ses coordonnées afin de recevoir un SMS ou un e-mail contenant un lien pour télécharger l'app.

Vous pouvez créer le formulaire web et le fournir à l'URL dans le script.  Pour en savoir plus, recherchez isMobileDevice() dans le script.

Tenez compte des éléments suivants avant de mettre en œuvre le script :

• Le texte est proposé à titre d'exemple uniquement. Il couvre le flux commun de la page de renvoi à l'attribution. Adaptez le script à vos besoins.
• Le script recherche des paramètres spécifiques dans l'URL de la page de renvoi, comme la source média, la campagne, les mots-clés, etc. Si vous souhaitez ajouter d'autres paramètres tels que l'identifiant du site et les ad sets, vous devez modifier le script en conséquence.

//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>