Configuration du Smart Script pour convertir les visiteurs du site web

1. Dans AppsFlyer, dans le menu latéral, sélectionnez Engage > Web-to-app > Smart Script.
2. Pour les nouveaux utilisateurs
   1. Cliquez sur le bouton Démarrer.
   2. Validez 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 sortant doit contenir. Ces paramètres sont basés sur les paramètres de l’URL entrant. Remarque : Le paramètre (pid) de la source média est obligatoire. 
   1. Sélectionnez le paramètre/dimension sortant à mapper.
      Il s'agit souvent d'un nom de paramètre AppsFlyer qui ne peut pas être modifié, mais dans certains cas, vous devez saisir votre nom de paramètre.
   2. Définissez et configurez la valeur du paramètre sortant en fonction des éléments suivants :
      • Paramètres de l'URL entrante : Listez un ou plusieurs paramètres d'URL entrants possibles que vous souhaitez remplacer par le paramètre d'URL sortant. Les valeurs des paramètres de l'URL entrant seront les valeurs des paramètres de l'URL sortant.
        • 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 de l'URL sortant 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 : Entrez la valeur par défaut souhaitée pour la valeur du paramètre sortant lorsqu’un paramètre d’URL entrant est introuvable, ou si vous ne renseignez aucun paramètre d’URL entrant.
        • 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.
      • Remplacer les valeurs : Configurez une ou plusieursvaleurs de l'URL entrant avec les valeurs de l'URL sortant par lesquelles vous souhaitez qu'elles soient remplacées.
        • Exemple : Pour le paramètre Campaign (campagne), si la valeur de l'URL entrant est campaignn_name, la valeur de l'URL sortant 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 le bon URL sortant soit généré.
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 dans votre site web : Envoyez le script à votre développeur web pour qu'il l’intègre. Vous pouvez lui communiquer les instructions afin qu’il puisse gérer l’URL sortant généré. Par exemple, placez l’URL sortant sur un bouton de CTA sur votre site mobile ou affichez un QR code sur la version desktop de votre site. 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 nouveau 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. Communiquez les instructions au développeur web au sujet de la gestion de l’URL sortant généré. Par exemple, placez l’URL sortant sur un bouton de CTA sur votre site mobile ou affichez un QR code sur la version desktop de votre site. 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 titre du Smart Script.
   Vous verrez s'afficher ici tous vos scripts sauvegardés.
2. Cliquez sur l'icône «Stylo» à côté du script que vous souhaitez modifier.
   1. Suivez les différentes étapes 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 sur la bannière supérieure
3. Suivez les différentes étapes dans Comment créer un Smart Script OneLink

Le Smart Script OneLink utilise des arguments pour générer un URL sortant en fonction des paramètres de l’URL entrant 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 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 un URL sortant en fonction des paramètres de l’URL entrant 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 tech-savvy marketeurs ou les développeurs peuvent intégrer 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 entrant (par exemple : utm_source et utm_campaign) et faites-les correspondre aux paramètres de l'URL sortant (par exemple : media_source et campaign). 
2. Indiquez ces paramètres dans la liste des arguments du 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. 

Dans ce cas, le script récupère le paramètre GCLID de l'URL de la campagne Google Ads pour le réinsérer dans l'URL de destination, lorsque vous redirigez les clients potentiels vers une page web ou une landing page. À partir de la version 2.9.0 de Smart Script, les paramètres GCLID, WBRAID et GBRAID, lorsqu'ils sont disponibles, sont automatiquement transmis "tels quels" dans les URL sortantes générées par Smart Script.

Vous pouvez également associer les identifiants de clics à d'autres paramètres sortants (af_sub[1-5]) afin qu'ils soient disponibles dans les rapports de données brutes d'AppsFlyer.

Remarque!

• 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 un GCLID est trouvé, 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 sortant comme valeur de af_keywords.

Conditions préalables : Dans le tableau de bord Google, activez le tag automatique.
Lorsque le tag automatique est activé, l'URL contient le paramètre GCLID.

Pour configurer le script afin de faire correspondre le GCLID de Google Ads à d'autres paramètres :

1. Sélectionnez un paramètre de l’URL sortant qui contiendra le GCLID.
   Bonne pratique : Sélectionnez af_sub[1-5], pour que les données s'affichent dans les rapports de données brutes d'AppsFlyer.
2. Indiquez ces éléments dans la liste des arguments du développeur web. Le résultat sera que dans l'URL sortant, le GCLID sera 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 métapublicités comportent des identifiants de clics, appelés FBCLID. À partir de la version 2.8.1 de Smart Script, lorsqu'elle sera disponible, FBCLID sera automatiquement transmis "tel quel" sur les URL sortants générés par Smart Script. Vous pouvez également associer les identifiants de Clics à d'autres paramètres sortants afin de les rendre disponibles dans les rapports de données brutes d'AppsFlyer.

Pour configurer le script afin de faire correspondre FBCLID à d'autres paramètres : 

1. Sélectionnez un paramètre dans l'URL sortant qui contiendra le FBCLID. 
   Bonne pratique : Sélectionnez af_sub[1-5], pour que les données s'affichent dans les rapports de données brutes d'AppsFlyer.
2. Indiquez ces éléments dans la liste des arguments du développeur web. Le résultat sera que dans l'URL sortant, le FBCLID sera la valeur du paramètre af_sub[1-5].
   

Les SRN comme les ads Snapchat ou X (Twitter) fonctionnent différemment de Google Ads ou d'une cross-platform comme Meta Ads. Les campagnes de ces SRN dirigent vos utilisateurs vers la page web/landing page, et vous êtes facturé en fonction des clics générés, sans lien avec les utilisateurs mobiles associés. 

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

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 ces paramètres dans la  liste des arguments  du développeur web.
   Le type de SRN/source média doit être la valeur de la source média dans l'URL entrante, et le script la trouve et l'utilise comme valeur media_source dans l'URL OneLink sortant derrière le bouton de téléchargement sur la page web/landing page. 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 redirection d’URL (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 ne crée un URL OneLink sortant, 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 sortant et le développeur doit décider quel lien placer en tant qu'URL sortant, puis l'intégrer.

Le mapping des référents web vous permet de connaître 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 de l'en-tête HTTP Referer 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 Web Referrer Mapping, sélectionnez la clé de paramètre de l'URL sortant 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 d’origine.
   • Paramètre personnalisé - Il est constitué du nom et de la valeur du paramètre. Le paramètre s'affiche dans la colonne URL d’origine 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 présentés dans cet article concernent des utilisateurs provenant d'appareils mobiles. Ainsi, lorsqu'ils sont dirigés du site web mobile vers un app store, ils peuvent immédiatement télécharger votre application.

Toutefois, les utilisateurs desktop 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 des utilisateurs desktop :

• Dans votre template OneLink, définissez un URL de destination lorsqu'un clic est effectué sur le lien depuis un ordinateur. L'URL doit rediriger vers une page web / landing page dédiée. La landing page 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 lequel l'utilisateur se trouve. S’il s’agit d’un appareil desktop, le script génère un URL OneLink sortant qui redirige l’utilisateur vers votre page web / landing page dédiée.

Voir aussi Conversion desktop-to-app.

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

Pour afficher un QR code :

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

Résultat : Le script affiche un QR code au lieu d'un bouton avec un URL derrière.

Le Smart Script OneLink peut être utilisé pour compter les impressions sur votre site web. Pour ce faire, le développeur doit appeler la fonction d'impression. Les installations sont ensuite attribuées aux impressions par le biais de l'attribution des vues.

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 view-through par Smart Script ne fonctionne que sur les appareils de type mobile et non sur les desktop.

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

1. Assurez-vous d’utiliser Smart Script 2.3+ 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 view-through soit bien activée.

Est-ce que l’URL entrant, qui sert à générer les liens OneLink, peut-il fonctionner si l'utilisateur navigue vers une autre page du site web ?

Oui. Oui. Les paramètres de l'URL entrant 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 Custom du menu déroulant renseignez votre paramètre dans le champ Paramètres de l'URL sortant.

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

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é » ( ad).

Quels navigateurs sont compatibles avec Smart Script ?

Smart Script utilise Javascript et fonctionne sur tous les navigateurs.