Configuration de OneLink Smart Script V2

En bref : configurez OneLink Smart Script pour attribuer les visiteurs de votre site web mobile issus de n'importe quelle source, et les convertir en utilisateurs d'app mobile.

7901_Smart_Script_flow_1920x1080_2__1_.png

 Lectures connexes

Pour une vue d'ensemble de l'utilisation des Bannières intelligentes dans AppsFlyer, veuillez consulter ces articles :

Configuration

Il existe deux versions du Smart Script OneLink :

Smart Script OneLink V2 (recommandé) : si vous configurez le Smart Script OneLink pour la première fois, nous vous conseillons d'utiliser cette version. Il peut être généré dans l’interface utilisateur AppsFlyer sans l’aide du développeur. Si, pour une raison quelconque un développeur est nécessaire, son travail sera plus simple. Et il peut également être configuré à l’aide de Google Tag Manager. Voir les instructions à l'attention des développeurs

OneLink Smart Script V1 (version héritée) : si vous avez déjà configuré le Smart Script Onelink, utilisez la documentation concernant cette version pour maintenir et modifier ce script. Remarque : bien que ce ne soit pas obligatoire, envisagez de migrer vers la version 2 pour profiter pleinement des attributions post-vue via Smart Script OneLink.

 Note

Cliquez sur le bouton Suivre dans l'en-tête de l'article pour être informé(e) lorsqu'une mise à jour est apportée à l'article ou au script.

Configurer OneLink Smart Script

Pour configurer le smart script, vous pouvez :

  • Intégrer le script à votre site web.
  • Utiliser Google Tag Manager.

Mise en application

Personnes concernées

  • Annonceur :
    • Décide ce que l'URL sortante doit contenir en fonction des arguments du script qui traitent l'URL entrante. Ceci détermine les données d’attribution et de deep linking qui sont ajoutées à l’URL sortante, soit en manipulant l’URL entrante, soit en forçant certaines valeurs.

    • Génère le Smart Script dans l’interface utilisateur AppsFlyer. 

    • S'assure que toutes les campagnes menant au site web mobile ont des URL entrantes avec des paramètres pour lesquels le script fonctionne.
    • Teste le Smart Script
  • Développeur web :
    • Vérifie que le script s'exécute sur le site ou les pages mobile où vous souhaitez qu'il fonctionne.
    • Utilise la valeur du résultat au besoin, par exemple pour la placer en tant que lien sur un CTA de votre site web.
    • Peut être nécessaire pour créer des QR codes à l'aide du script.
    • Peut être nécessaire pour ajouter manuellement des arguments avancés au script.

Conditions préalables

Pour configurer le Smart Script OneLink :

  1. Dans AppsFlyer, rendez-vous dans Expériences et deep linking > Web-to-app > Smart Script
  2. Sélectionnez un template OneLink sur lequel baser le script. Le template contient les paramètres de redirection de base.
  3. 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.
  4. Sélectionnez comment implémenter le Smart Script sur votre site web :
    • Intégrer le script à votre site web.
    • Utiliser Google Tag Manager.
  5. Cliquez sur Générer.
  6. Cliquez sur Télécharger le script.
  7. 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
  8. 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
  9. Testez le script sur la page de test Smart Script. Assurez-vous que la bonne URL sortante est générée.

Important ! Le script doit être ré-implémenté à chaque fois qu'il est mis à jour.

Structure des arguments

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.

Argument Description Exemple
Paramètres d'URL entrantes (appelés «clés» par les développeurs)
  • Liste des chaînes
  • Liste des paramètres possibles dans l’URL entrante recherchée par le script, dont la valeur est placée comme valeur dans l’URL sortante.
  • Le script recherche de gauche à droite et s'arrête à la première correspondance.
  • Exemple : ['in_channel', 'utm_channel']
  • Pour le paramètre de canal dans le script, le script recherche le lien entrant in_channel et utilise la valeur comme valeur de canal.
Valeur par défaut
  • Chaîne
  • Indiquez la valeur de secours que vous souhaitez.
  • Si aucun paramètre n'est trouvé dans votre liste de clés, la valeur defaultValue est utilisée dans l'URL sortante.
  • Vous pouvez forcer une valeur par défaut en transmettant une liste de clés vides.

Exemple : ['web_video']

Pour le paramètre de canal dans le script, si vous ne trouvez pas le paramètre in_channel, web_video est utilisé comme valeur de canal.

Remplacer les valeurs

  • Dictionnaire {string: string}
  • Répertoriez les valeurs que vous souhaitez modifier dans le lien sortant dans l’URL entrante, ainsi que ce par quoi vous souhaitez qu’elles soient remplacées.
  • Le script remplace les valeurs de paramètre de l'URL entrante par les valeurs que vous définissez. 

Exemple : {'video': 'video_new'}

Pour le paramètre de canal dans le script, chaque fois que la valeur entrante est « video », le script la remplace par « video_new » dans le lien sortant.

Arguments

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

Argument Remarques Enregistrez vos réponses (pour votre développeur, ou pour vous)
oneLinkURL (obligatoire)
  • Indiquez le domaine du template OneLink + l’ID du template. Note : n'est pas une URL de lien personnalisé OneLink !
  • Exemple : yourbrand.onelink.me/A1b2
  • Exemple de domaine de marque : click.yourbrand.com/A1b2
 

afParameters

(obligatoire)

 

 

 


mediaSource

(obligatoire)

  • Objet de configuration pour la source média.
  • Exemple :
    • Clés : ['incoming_mediasource'' 'utm_source']
    • Valeur par défaut : ['any_source']
    • Remplacer les valeurs : {twitter: 'twitter_int', orig_src: 'new_src'}

Clés :

Valeur par défaut :

Remplacer les valeurs :

campagne

  • Objet de configuration pour la campagne.
  • Exemple :
    • Clés : ['incoming_campaign', 'utm_campaign']
    • Valeur par défaut : ['any_campaign_name']
    • Remplacer les valeurs : {campaign_name: 'new_campaign_name'}

Clés :

Valeur par défaut :

Remplacer les valeurs :

channel

  • Objet de configuration pour le canal.
  • Exemple :
    • Clés : ['incoming_channel', 'utm_channel']
    • Valeur par défaut : ['any_video']
    • Remplacer les valeurs : {video: 'new_video'}

Clés :

Valeur par défaut :

Remplacer les valeurs :

ad

  • Objet de configuration pour la publicité.
  • Exemple :
    • Clés : ['incoming_ad', 'utm_ad']
    • Valeur par défaut : ['any_ad_name']
    • Remplacer les valeurs : {ad_name: 'new_ad_name'}

Clés :

Valeur par défaut :

Remplacer les valeurs :

adSet
  • Objet de configuration pour l'adset.
  • Exemple :
    • Clés : ['incoming_adset', 'utm_adset']
    • Valeur par défaut : ['any_ad_name']
    • Remplacer les valeurs : {adset_name: 'new_adset_name'}

Clés :

Valeur par défaut :

Remplacer les valeurs :

deepLinkValue
  • Objet de configuration pour deep_link_value.
  • Exemple :
    • Clés : ['product_id', 'page_name']
    • Valeur par défaut : 'new_offers_page'
    • Remplacer les valeurs : {twenty_percent_off: 'thirty_percent_off'}

Clés :

Valeur par défaut :

Remplacer les valeurs :

afSub1-5

Objet de configuration pour af_sub[1-5].

Clés :

Valeur par défaut :

Remplacer les valeurs :

googleClickIdKey

Indiquez comment appeler le paramètre qui transporte la GCLID.
Important ! Pour s'afficher dans les rapports de données brutes AppsFlyer, le paramètre doit être l'un de af_sub[1-5].

 
Autres paramètres de requête (personnalisés)
  • Répertoriez tous les autres paramètres que vous souhaitez inclure dans l’URL OneLink sortante pour l’attribution ou le deep linking, ainsi que leurs objets de configuration.
  • Le nom du paramètre personnalisé est inscrit par le développeur en tant que paramKey dans l’objet de configuration.
  • Exemple :
    • paramKey: 'deep_link_sub1'
    • Clés : ['page_id']
    • Valeur par défaut : 'page1'
    • Remplacer les valeurs : {page12: 'new_page12'}

Clé Param :

Clés :

Valeur par défaut :

Remplacer les valeurs :

Arguments avancés

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

Argument Remarques Enregistrez vos réponses (pour votre développeur, ou pour vous)
 
referrerSkipList
  • Liste des chaînes dans le référent HTTP pour un clic particulier (par exemple Twitter ou Facebook) qui, si elles sont trouvées, génèrent le retour null du Smart Script . Cela peut être utile pour les SRN comme Twitter et Facebook, pour lesquels des clics sont déjà signalés.
  • L'implémentation de cet argument entraîne la génération d'une URL OneLink dans le script.

 

urlSkipList
  • Liste des chaînes dans l’URL pour clic particulier (par exemple af_r) qui, si elles sont trouvées, provoquent le retour null du Smart Script . Cela peut être utile si vous utilisez un lien d’attribution AppsFlyer avec af_r pour rediriger les utilisateurs vers votre site web mobile, et que vous ne souhaitez pas que les données du clic d’origine soient perdues.
  • L'implémentation de cet argument entraîne la génération d'une URL OneLink dans le script.

 

CAS D'UTILISATION

Les sections suivantes fournissent des cas d’utilisation Smart Script pour certains scénarios courants de campagne / source média.

Paramètres UTM

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. 

GCLID Google Ads

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.

 Note

Cette solution GCLID n’est pas officiellement prise en charge ou recommandée par Google. Si jamais Google déprécie le paramètre GCLID, nous modifierons le script pour prendre en charge les modifications. Suivez cet article, en cliquant sur le bouton Suivre dans l’en-tête, pour être informé lors d'une mise à jour de l’article ou du script.

ID de clic Facebook

Les publicités Facebook portent des ID de clics. Si vous souhaitez que cet ID soit disponible dans les données brutes d’AppsFlyer, prenez l’ID de clic Facebook et placez-le dans l’URL sortante dans le paramètre de sortie 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 la GCLID ans l’URL sortante .
    Recommandé : 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].

SRN, médias propres et autres liens vers des sources média

Les SRN comme Snapchat ou Twitter fonctionnent différemment de Google Ads ou d'une multiplateforme comme Facebook. 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. 

 Exemple

URL entrante : https://hotel.me/incoming_mediasource=twitter&incoming_campaign=big_social

URL sortante : https://hotel.onelink.me/Ac4G?pid=twitter&c=big_social

Lien d'attribution de base d'AppsFlyer

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.

 Exemple

URL entrante : https://app.appsflyer.com/id123456789?pid=click_ad_network_int&c=orlando&af_r=hotel.me

URL sortante : aucune URL sortante.

Ordinateur

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.

Agences

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.

 Exemple

URL entrante : https://hotel.me/incoming_campaign=gogo&incoming_media_source=email&partner_name=bigagency

URL sortante : https://hotel.me/pid=email&c=gogo&af_prt=agency

Codes QR

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 d’afficher le code QR lorsque les utilisateurs sont sur un appareil de bureau et d’afficher le bouton avec le lien lorsque les utilisateurs sont sur mobile. 

Résultat : le script affiche un code QR au lieu d’un bouton contenant une URL. Remarque : les codes QR créés via le Smart Script ne peuvent pas être personnalisés.

 Exemple

URL entrante :

https://hotel.me/qr_code.html?incmp=gogo&inmedia=email

URL sortante :

https://hotel.onelink.me/LtRd/?af_js_web=true&af_ss_ver=2_1_0&pid=email&c=gogo

Code QR sortant :

Impressions

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 à utiliser Smart Script 2.2 et + 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.
  4. [Facultatif] Si vous souhaitez modifier la valeur par défaut de la fenêtre rétrospective, vous ou votre développeur devez ajouter le paramètre af_viewthrough_lookback avec la nouvelle valeur. Par exemple, af_viewthrough_lookback=1d.

 Important !

À compter du 1er février 2023 (version stable de Chrome 110), les modifications de Google pour réduire les données relatives aux User-Agent seront effectives. Pour obtenir des attributions post-vue via Smart Script OneLink pleinement fonctionnelles, vous devez utiliser la version 2.2.2 et + du Smart Script OneLink.

Spécifications et limitations

Caractéristiques

Remarques

Schéma d'URI

Même si un schéma d’URI est défini dans le template OneLink pour ouvrir l’app aux utilisateurs existants, en ce qui concerne les liens créés à l’aide de Smart Script, le développeur doit ajouter aux URL le paramètre af_dp avec le schéma d’URI en tant que paramètre personnalisé.