Configuration de OneLink Smart Script V2

1. Dans AppsFlyer, rendez-vous dans Expériences et deep linking > Web-to-app > Smart Script
2. Pour les nouveaux utilisateurs
   1. Cliquez sur le bouton Bien démarrer.
   2. Complétez les étapes 4 et suivantes.
3. Cliquez sur le bouton + Nouveau Smart Script en haut de la page.
4. Donnez un nom à votre Smart Script en suivant les instructions.
5. Sélectionnez un template OneLink sur lequel baser le script. Le template contient les paramètres basiques de redirection.
6. Mappez les paramètres que l'URL sortante doit contenir. Ces paramètres sont basés sur les paramètres de l’URL entrante. Remarque : le paramètre (pid) de la source média est obligatoire.
   1. Sélectionnez le paramètre sortant ou la dimension sortante à mapper.
      Souvent, il s’agit d’un nom de paramètre AppsFlyer qui ne peut pas être modifié, mais dans certains cas, vous devez entrer votre nom de paramètre.
   2. Définissez et configurez la valeur du paramètre sortant en fonction des éléments suivants :
      • Paramètres d'URL entrante : listez un ou plusieurs paramètres d'URL entrante que vous souhaitez remplacer par le paramètre d'URL sortante. Les valeurs des paramètres d'URL entrante seront les valeurs de votre paramètre d'URL sortante.
        • Exemple : any_param_name, utm_param_name. Si utm_param_name se trouve dans l’URL entrante, sa valeur sera utilisée comme valeur du paramètre d’URL sortante sélectionné.
        • Smart Script recherche la liste des paramètres en allant de gauche à droite, puis mappe la première correspondance trouvée avec l'URL du paramètre sortant.
        • Les développeurs appellent cette liste de paramètres «les clés».
      • Valeur par défaut : la valeur par défaut souhaitée pour la valeur du paramètre sortant lorsqu’un paramètre d’URL entrante est introuvable, ou si vous ne renseignez aucun paramètre d’URL entrante.
        • Exemple : pour le paramètre sortant, si le paramètre d’URL entrant répertorie any_paramname ou utm_paramname dans le cas où aucun paramètre de la liste n’est trouvé, la valeur par défaut sera utilisée comme valeur du paramètre sortant.
      • Valeurs de remplacement : configurez une ou plusieurs valeurs à partir de l'URL entrante accompagnées des valeurs de l'URL sortante par lesquelles vous souhaitez qu'elles soient remplacées.
        • Exemple : pour le paramètre Campaign (campagne), si la valeur de l'URL entrante est campaignn_name, la valeur de l'URL sortante peut être changée en new_campaign_name.
   3. [Facultatif] Cliquez sur + Nouveau paramètre pour mapper des paramètres supplémentaires. Consultez tous les arguments supplémentaires (configurations des paramètres) que vous pouvez utiliser.
7. Sélectionnez comment implémenter le Smart Script sur votre site web :
   • Intégrer le script à votre site web.
   • Utiliser Google Tag Manager.
8. Cliquez sur Tester pour tester le script sur la page de test Smart Script. Assurez-vous que la bonne URL sortante est générée.
9. Clic
   1. Enregistrer pour enregistrer vos modifications
   2. Enregistrer et générer pour enregistrer et générer le script
      1. Cliquez sur Télécharger le script.
10. Si vous avez choisi d'intégrer le script à votre site web : envoyez le script à votre développeur web pour qu'il l'implémente, et expliquez-lui ce qu'il doit faire avec l'URL sortante générée. Par exemple, placez-la sur un bouton de CTA sur votre site mobile ou affichez un QR code sur votre site pour ordinateur. Instructions pour les développeurs
11. Si vous avez choisi d’utiliser Google Tag Manager :
    1. Dans Google Tag Manager, créez une nouvelle balise, nommez-la, cliquez sur Configuration des balises, puis sélectionnez HTML personnalisé.
    2. Dans la zone HTML, collez le code Smart Script généré.
    3. Cliquez sur Déclenchement, créez un déclencheur, nommez-le et choisissez une configuration de déclencheur (ex : toutes les pages vues). Consultez la documentation GTM pour en savoir plus
    4. Cliquez sur Enregistrer
    5. Indiquez au développeur web ce qu’il doit faire avec l’URL sortante générée. Par exemple, placez-la sur un bouton de CTA sur votre site mobile ou affichez un QR code sur votre site pour ordinateur. Instructions pour les développeurs
12. Les scripts qui ont été enregistrés se trouvent dans le menu déroulant.

1. Cliquez sur la flèche déroulante à côté du nom du Smart Script.
   Vous verrez s'afficher tous vos scripts sauvegardés.
2. Cliquez sur l'icône stylo à côté du script que vous souhaitez modifier.
   1. Suivez les étapes détaillées dans Comment créer un Smart Script OneLink
3. Cliquez sur l'icône corbeille pour supprimer le Smart Script.

1. Accédez au Smart Script que vous souhaitez dupliquer
2. Cliquez sur le bouton dupliquer dans la bannière du haut
3. Suivez les étapes détaillées dans Comment créer un Smart Script OneLink

Le Smart Script OneLink utilise des arguments pour générer une URL sortante en fonction des paramètres de l’URL entrante et des arguments définis dans le script. L’argument afParameters a une structure composée de plusieurs autres arguments (paramètres) utilisés pour l’attribution et le deep linking, chacun contenant une structure (appelée tp par les développeurs en tant qu'objet de configuration) dotée de clés, de valeurs de remplacement et d’une valeur par défaut, comme décrit dans le tableau qui suit.

Le Smart Script OneLink utilise des arguments pour générer une URL sortante en fonction des paramètres de l’URL entrante et des arguments définis dans le script.

Arguments (paramètres et valeurs) pour implémenter le Smart Script

Le tableau suivant décrit les arguments que les marketeurs techniques ou les développeurs peuvent mettre en œuvre dans le Smart Script.

Arguments avancés (paramètres et valeurs) pour implémenter le Smart Script

Pour configurer le script des paramètres UTM :

1. Faites une liste des paramètres UTM pour l'URL entrante (par exemple : utm_source et utm_campaign) et faites-les correspondre aux paramètres de l'URL sortante (par exemple : media_source et campaign).
2. Indiquez ces paramètres dans la liste des arguments pour le développeur web.
   

Résultat : les valeurs des paramètres entrants (utm_source et utm_campaign) sont utilisées pour renseigner les valeurs des paramètres (media_source et campaign) dans le lien sortant. 

Le processus habituel d'attribution des installations des campagnes Google Ads (qui comportent un paramètre GCLID) nécessite que les utilisateurs qui cliquent sur votre publicité soient redirigés vers l'URL de la page de l'app store.

Étant donné que dans ce cas, vous redirigez les prospects de Google Ads vers une page web / d'accueil, le script prend le paramètre GCLID de l’URL de la campagne d’installation de Google Ads et le place dans l’URL sortante dans le paramètre de sortie que vous avez choisi af_sub[1-5].

Important !

• Cela s'applique aux campagnes d'installation. Pour les campagnes de recherche non ACI, c'est-à-dire les campagnes de réengagement, Google peut être attribué comme source média, malgré la sortie Smart Script. 
• Si une GCLID est trouvée, le script recherche le mot-clé de paramètre entrant. Si ce paramètre est identifié, il place la valeur du mot-clé dans l’URL sortante comme valeur de af_keywords.

Conditions requises : dans le tableau de bord Google, activez le balisage automatique.
Lorsque le balisage automatique est activé, l'URL contient le paramètre GCLID.

Pour configurer le script pour Google Ads GCLID :

1. Sélectionnez un paramètre de l’URL sortante qui contiendra la GCLID.
   Recommandation : sélectionnez af_sub[1-5] afin que les données s’affichent dans les rapports de données brutes AppsFlyer.
2. Indiquez ces éléments dans la liste des arguments pour le développeur web.
   

Résultat : dans l'URL sortante, la GCLID est la valeur du paramètre af_sub[1-5].

Pour informer Google Ads de ces installations :

1. Obtenez les données GCLID du param af_sub[1-5] via le CSV ou l'API Push en temps réel pour chaque installation.
2. Téléchargez les données GCLID vers Google manuellement ou via l'API Google Ads.

Les Meta ads contiennent des ID de clics, appelés ID de clic Facebook. Si vous souhaitez que cet ID soit disponible dans les données brutes AppsFlyer, placez l’URL sortante au niveau du paramètre sortant af_sub[1-5] de votre choix.

Pour configurer le script pour l'ID de clic Facebook :

1. Sélectionnez un paramètre qui contiendra l'ID de clic Facebook dans l’URL sortante .
   Recommandation : sélectionnez af_sub[1-5] afin que les données s’affichent dans les rapports de données brutes AppsFlyer.
2. Indiquez ces éléments dans la liste des arguments pour le développeur web.
   

Résultat : dans l'URL sortante, l'ID de clic Facebook est la valeur du paramètre af_sub[1-5].

Les SRN comme Snapchat ou Twitter fonctionnent différemment de Google Ads ou d'une multiplateforme comme Meta ads. Les campagnes de ces SRN dirigent vos utilisateurs vers la page Web / d'accueil, et vous êtes facturé en fonction des clics, sans rapport avec les utilisateurs mobile dérivés. 

Pour ces SRN, la configuration du script est la même que pour les liens provenant de médias propres ou d’autres sources média que vous pouvez utiliser. 

Pour configurer le script :

1. Dressez une liste des noms des sources média et des paramètres de campagne qui se trouvent dans les liens entrants.
2. Indiquez-les dans la  liste des arguments pour le développeur web.
   Le type de SRN / source média doit être la valeur de la source média dans l’URL entrante, pour que le script la trouve et l’utilise comme valeur media_source dans l’URL OneLink sortante du bouton de téléchargement placé sur le site web ou la page d'accueil. Si vous souhaitez modifier le paramètre media_source sortant, indiquez la valeur de la source média entrante et la valeur media_source de remplacement dans la liste des arguments que vous donnez au développeur web.

Résultat : pour ces SRN / sources média, les valeurs de la source média et les paramètres de campagne du lien entrant sont utilisés pour renseigner les valeurs des paramètres de media_source et de campagne dans le lien sortant. 

Les liens d'attribution AppsFlyer peuvent être utilisés lorsque la source média est un réseau publicitaire de clics. Lorsque vous configurez un tel lien dans AppsFlyer, vous avez la possibilité d’ajouter un paramètre de chemin d’URL de redirection (af_r) avec le chemin d’URL souhaité vers votre site web mobile pour l’attribution de campaign-to-app web. Évitez que le script crée une URL OneLink sortante, car certaines des données du clic d’origine pourraient être perdues.

Action : utilisez l’argument urlSkipList pour répertorier le paramètre af_r .

Résultat : lorsque le Smart Script trouve le paramètre af_r dans le lien entrant, il ne produit pas d'URL sortante et le développeur doit décider quel lien placer en tant qu'URL sortante, puis l'implémenter.

Le mappage des référents web vous permet de connaitre la page par où les utilisateurs sont entrés sur votre site web (ex : depuis une recherche organique), et donc d'enrichir les données pour mieux analyser les installations et réengagements issus de votre flux Smart Script web-to-app.

Vous pouvez configurer le Smart Script pour qu'il collecte ces informations à partir du champ Référent de l'en-tête HTTP de votre page d'accueil ou site web.Ce champ indique l'URL de la page qui contient le lien sur lequel les utilisateurs ont cliqué avant d'être orientés vers votre page web.

Configurer le script qui permet de récupérer le référent web

1. Ouvrez la page Smart Script
2. Dans la section mappage du référent web, sélectionnez la clé de paramètre de l'URL sortante pour la valeur du référent web :
   • af_channel - Paramètre disponible dans les tableaux de bord et les données brutes
   • af_sub1-5 - Le paramètre est disponible dans les données brutes, dans les colonnes af_sub1-5 et dans la colonne URL originale.
   • Paramètre personnalisé - Il est constitué du nom et de la valeur du paramètre. Le paramètre s'affiche dans la colonne la colonne URL originale des données brutes.

Pour en savoir plus sur l'attribution des recherches organiques pour les réengagements qui utilisent les liens universels et les liens d'app, rendez-vous ici.

La plupart des cas d’utilisation de cet article concernent des utilisateurs sur appareil mobile. Par conséquent, lorsqu’ils sont dirigés du site web mobile vers un app store, ils peuvent immédiatement télécharger votre app.

Toutefois, les utilisateurs d'ordinateur ne doivent pas être immédiatement redirigés vers un app store, car leur appareil (PC ou portable) n'est pas compatible avec les téléchargements d'apps mobile. 

Pour configurer le script pour les utilisateurs d'ordinateur :

• Dans votre template OneLink, définissez une URL de destination lorsqu'un clic est effectué sur le lien depuis un ordinateur. L'URL doit rediriger vers une page web / d'accueil dédiée. La page d'accueil peut contenir un formulaire web permettant d'indiquer ses coordonnées pour obtenir un SMS ou un e-mail avec un lien pour télécharger l'app. Vous pouvez créer le formulaire web et le fournir à l'URL dans le script. 

Résultat : le script détecte l’appareil ou la plateforme sur laquelle se trouve l’utilisateur. S’il s’agit d’un appareil de bureau, le script génère une URL OneLink sortante qui redirige l’utilisateur vers votre page web/   d'accueil dédiée.

Voir aussi Conversion desktop-to-app.

Les installations sont attribuées aux agences à l’aide du paramètre af_prt .

Pour ajouter ce paramètre d’attribution à l’aide du Smart Script OneLink, demandez à votre développeur de suivre ces instructions.  

Résultat : le script détecte le paramètre supplémentaire dans l’URL entrante avec le nom de l’agence puis ajoute le paramètre af_prt à l’URL sortante.

Smart Script affiche un code QR sur votre page web, au lieu d'un bouton contenant un lien. 

Pour afficher un code QR :

1. Assurez-vous d’utiliser Smart Script 2.1 et + lorsque vous configurez votre Smart Script.
2. Demandez à votre développeur de suivre les instructions disponibles pour créer un code QR avec le résultat Smart Script.
3. [Recommandé] Demandez au développeur de :
   • Personnaliser le code QR en ajoutant le logo de votre app au centre du code et en choisissant une couleur.
   • Afficher le code QR lorsque les utilisateurs sont sur un appareil de bureau, et d’afficher le bouton avec un lien lorsque les utilisateurs sont sur mobile. 

Résultat : le script affiche un code QR au lieu d’un bouton contenant une URL.

Le Smart Script OneLink peut être utilisé pour compter les impressions sur votre site internet. Dans ce cas, le développeur doit appeler la fonction d'impression.Les installations seront alors attribuées en post-vue.

Remarque :

• La comptabilisation des impressions s’ajoute au nombre de clics produits par l’URL issue de Smart Script. Smart Script peut être utilisé pour compter soit les clics, soit les impressions, soit les deux.
• L’attribution post-vue par Smart Script ne fonctionne que sur les appareils de type mobile et non sur les ordinateurs.

Pour attribuer de nouvelles installations à ces impressions (c'est-à-dire l'attribution post vue) : 

1. Veillez à bien utiliser Smart Script 2.3 ou + lorsque vous configurez votre Smart Script.
2. Demandez à votre développeur d’appeler la fonction d’impression dans Smart Script.
3. Vérifiez que l'attribution post vue est bien activée.

L'URL entrante qui sert à générer les liens OneLink peut-elle fonctionner si l'utilisateur navigue vers une autre page du site web ?

Oui. Les paramètres de l'URL entrante sont stockés pour la durée de la session de navigation et ils sont appliqués aux paramètres sortants du lien OneLink généré par Smart Script. Pour plus d'informations sur l'implémentation, consultez notre dev hub.

Pourquoi j'obtiens une erreur lorsque j'implémente Smart Script via Google Tag Manager  ?

Une erreur « JavaScript too long » s'affiche parfois lorsque vous générez le Smart Script dans AppsFlyer et que vous essayez de l'insérer dans Google Tag Manager (GTM). Si cela se produit, supprimez la balise GTM et créez-en une nouvelle.

Est-il possible d'ajouter un paramètre qui ne figure pas dans la liste ?

Oui. Sur votre page Smart Script OneLink, cliquez sur + Nouveau paramètre pour mapper des paramètres supplémentaires.

• Les nouveaux paramètres peuvent être des paramètres personnalisés, ou des paramètres propres à AppsFlyer qui n'apparaissent pas dans le menu déroulant.
  • Consultez tous les arguments supplémentaires (configurations des paramètres) que vous pouvez utiliser.
• Dans l'option Personnalisé du menu déroulant renseignez votre paramètre dans le champ Paramètres de l'URL sortante.

Exemple : pour ajouter is_retargeting comme paramètre, le paramètre Personnalisé sera sélectionné dans le champ mappage pour, puis notre paramètre is_retargeting sera appliqué dans le champ Paramètres de l'URL sortante.

L'adset et les autres paramètres ne s'affichent pas dans la liste déroulante

Nous vous recommandons de désactiver les bloqueurs de publicité installés sur votre navigateur pour créer ou ajouter de nouveaux paramètres. Les bloqueurs de publicité suppriment parfois les options qui contiennent le mot « publicité ».

Quels navigateurs sont compatibles avec Smart Script ?

Smart Script utilise Javascript et fonctionne sur tous les navigateurs.