Configurer les scripts intelligents

Si vous exécutez des campagnes web qui incitent un utilisateur à installer l'application via un bouton ou une bannière de votre site web mobile, vous pouvez perdre des informations sur la source de référence d'origine. Avec des scripts intelligents exécutés sur votre site web mobile, vous recevez des informations d'attribution complètes.

Avant de commencer

Voici ce que vous devez savoir avant de commencer.

Prérequis

• Autorisations Administrateur et Éditeur
• (Facultatif) Configurer les deep links dans le SDK Adjust iOS | Android

Disponibilité

Créer un script

1. Sous Campaign Lab, sélectionnez Smart Scripts .
2. Sélectionnez Nouveau script intelligent .

Choisir un lien de base

Le lien de base fonctionne comme un token de fallback auquel toute l'attribution sera attribuée s'il n’y a pas de source de trafic entrante ; autrement dit, si l'utilisateur arrive de manière organique sur la landing page web, sans passer par une campagne.

1. Sélectionnez l'application de votre choix dans la liste déroulante.
2. Choisissez un lien de base.
3. Si vous choisissez un lien pour une seule plateforme (Android, par exemple), alors vous pouvez l'associer à un autre lien de plateforme unique (iOS, par exemple). Cela garantit que vous avez un seul script intelligent qui fonctionne pour les deux plateformes de votre application.

Configurer la logique d'attribution de fallback

Choisissez comment attribuer les utilisateurs interagissant avec votre lien suite à un clic antérieur. Vous pouvez choisir entre deux options.

• À l'annonce précédente
• À la smart banner

Si vous choisissez d'attribuer l'utilisateur à l'annonce précédente, le paramètre fallback_click s'ajoute à votre lien. Adjust considère les liens avec le paramètre fallback_click pour l'attribution uniquement si aucun autre lien n'est disponible. Cela signifie que les utilisateurs qui seraient autrement attribués en organique le sont aux liens fallback_click. Pour plus d'informations, consultez la section sur le fonctionnement de l'attribution de fallback.

Mapper les paramètres

Mappez les paramètres extraits de l'URL entrante à ceux de l'URL de destination, c'est-à-dire le lien Adjust. Par exemple, si utm_campaign est présent, sa valeur sera mappée au paramètre de campagne Adjust. S'il n'existe pas, la valeur de fallback par défaut, que vous avez définie, sera utilisée.

Il existe 3 types de paramètres que vous pouvez mapper :

1. Paramètres de campagne - Ils se rapportent à la structure des campagnes d'Adjust, par exemple channel , campaign , adgroup, creative

1. Destinations utilisateur / Paramètres de deep linking - Vous pouvez transmettre des chemins de deep linking ou tirer parti du routage basé sur les URL web.

1. Paramètres supplémentaires - Vous pouvez ajouter des données supplémentaires en transmettant des paires personnalisées clés-valeurs ou en exploitant le paramètre label d'Adjust.

Mapper les partenaires

• Mappez les partenaires et leurs tokens de lien respectifs afin que l'attribution leur soit accordée lorsque le trafic provient de ces sources. Par exemple, si la source de trafic est une campagne web Facebook (Meta), déterminée par la présence de fbclid ou fbpid dans l'URL entrante, alors le token de lien du réseau correspondant reçoit l'attribution.

• Vous pouvez soit :

1. Faire un choix dans une liste préparée de partenaires : Dans ce cas, vous avez simplement besoin de choisir le token de lien, car la condition du trafic est préconfigurée (par exemple, IF ttclid exists -> Partner = Tiktok).
2. Choisir de configurer un partenaire / canal personnalisé : Dans ce cas, vous devez spécifier la condition du trafic (par exemple, utm_source contains social) et le token de lien correspondant. Cela est particulièrement utile pour configurer les canaux de médias owned/earned où les ID de clic uniques ne sont pas disponibles dans l'URL entrante.

Remarque : Si vous utilisez de scripts intelligents pour attribuer le trafic web-to-app pour un partenaire, alors vous n'avez pas à configurer le lien de tracking dans le dashboard du partenaire (dans les champs d'URL finale ou de modèle de tracking) . Il vous suffit de configurer la campagne pour rediriger l'utilisateur vers l'URL de la landing page avec les paramètres appropriés (par exemple, les UTM) ajoutés. En effet, le lien Adjust avec le token de lien correct est maintenant généré par le script et placé derrière le CTA sur la landing page. Configurer les deux méthodes de tracking peut entraîner la duplication des clics et des divergences dans le reporting.

Déployer le script

1. Copier le script

Lorsque le script est généré, vous êtes dirigé vers la page « Vue du script », où vous pouvez cliquer sur le bouton « Copier le script » .

2. Déployer le script

1. Intégrer le script à votre site web

1. Envoyez le script à votre développeur web pour implémentation.
2. Notez que Smart Script fournit deux fonctions pour générer un lien Adjust (URL sortante) : waitForEnrichedLink est une fonction asynchrone qui renvoie un Promise. La résolution génère un lien enrichi Adjust avec le Facebook Pixel ID, si disponible. createLink renvoie un lien Adjust immédiatement, mais dans la plupart des cas, il ne peut pas lire le Facebook Pixel ID.

Si le Facebook Pixel ID est important dans votre cas d'utilisation, nous conseillons d'utiliser waitForEnrichedLink.

Si vous souhaitez que le lien Adjust soit disponible sans délai, vous pouvez utiliser createLink ou même les deux fonctions ensemble. Par exemple, générez le bouton/CTA « Télécharger l'application » avec le lien renvoyé d'abord par createLink, puis remplacez-le plus tard avec le lien enrichi une fois waitForEnrichedLink résolu.

1. Dites-lui quoi faire avec le lien Adjust (URL sortante) généré par les scripts intelligents. Par exemple, les placer derrière le bouton/CTA « Télécharger l'application » ET/OU présenter un code QR sur le site web Desktop.

2. Déployez le script via Google Tag manager

1. Accédez à Google Tag Manager.
2. Sélectionnez Tags -> New.
3. Sélectionnez Tag Configuration, puis sélectionnez Custom HTML et ajoutez <script>. Placez dans le tag du script le code que vous avez copié depuis la Suite. N'oubliez pas le /script de fermeture.

    <script>
      // Collez la configuration Smart Script que vous avez copiée dans la Suite
      // Le code contient le script intelligent, le mappage et la requête pour la création du lien
    </script>

1. Le script retournera l'URL sortante / le lien Adjust et vous pouvez intégrer ce lien derrière votre bouton de téléchargement. Au besoin, collaborez avec votre équipe de développement pour savoir comment lier le lien Adjust généré avec le bouton/CTA « Télécharger l'application ».

Dans l'exemple ci-dessous, on suppose qu'il existe un bouton « Télécharger » avec l'ID download_button sur la page, et qu'une action est ajoutée pour ouvrir le lien lors du clic sur le bouton. Après que la fonction waitForEnrichedLink renvoie le lien Adjust avec le Facebook Pixel ID, le gestionnaire du bouton est mis à jour pour ouvrir le lien enrichi. Si le Facebook Pixel ID n'est pas important dans votre cas d'utilisation, vous pouvez supprimer l'appel waitForEnrichedLink en toute sécurité, ainsi que tout le code qui s'y rapporte plus bas, jusqu'à la fermeture de la balise </script>.

Code d'intégration issu de l'exemple

// Création de lien
var link = AdjustSmartScript.createLink(mapping);

var downloadButton = document.getElementById('download_button');
var openLinkFn = function () { window.open(link) };

// Ouvre le lien lors du clic sur le bouton de téléchargement
downloadButton.addEventListener('click', openLinkFn);
  
// Création du lien asynchrone
// Attend la résolution du Facebook Pixel ID. Vous pouvez supprimer cette ligne sur le Facebook Pixel ID
// n'est pas important dans votre cas d'utilisation
AdjustSmartScript.waitForEnrichedLink(mapping)
  .then(function (enrichedLink) {
    // Le lien enrichi a été créé
    // Ouvre le lien enrichi lors du clic sur le bouton de téléchargement
    downloadButton.addEventListener('click', function () { window.open(enrichedLink) });

    downloadButton.removeEventListener('click', openLinkFn);
  })
  .catch(function (error) {
    // Une erreur s'est produite et le lien enrichi n'a pas été créé
    console.log(error);
  });
  

1. Vous pouvez avoir besoin de configurer les options Tag firing/Initialization pour déclencher uniquement sur des pages landing web-to-app spécifiques (c'est-à-dire pas sur toutes les pages de votre site web).

2. Après l'implémentation, lorsque l'utilisateur cliquera sur le bouton de téléchargement sur la landing page du site web, le lien Adjust redirigera l'utilisateur et réattribuera les conversions d'application à la source d'origine du trafic web.

Facultatif - Mettre à jour le script

Si vous choisissez de modifier le script intelligent après son déploiement sur votre site web, votre développeur doit le redéployer/mettre à jour manuellement pour que les modifications prennent effet. Cette opération n'est pas automatique.

Tester les scripts intelligents

Les scripts intelligents génèrent leurs journaux dans la console du navigateur. Nous vous conseillons de tester la façon dont le script fonctionne avec le mappage spécifié et veiller à ce que les liens corrects soient générés.

1. Dans votre navigateur, accédez à la console des outils de développement.
2. Accédez à la page web où vous avez mis en place les scripts intelligents.
3. S'il n'existe aucun journal avec le préfixe [adjust-smart-script], actualisez la page. Si vous ne voyez toujours pas de journaux, vérifiez que :
   • Votre code ne prend pas en charge la journalisation en appelant AdjustSmartScript.setLogLevel('error') ou AdjustSmartScript.setLogLevel('none').
   • Votre code appelle la fonction AdjustSmartScript.createLink(params)

Avec différentes valeurs de la propriété inputUrl, vous pouvez tester différents cas d'utilisation. Par exemple, si vous exécutez une campagne Meta et que vous attendez également que les utilisateurs organiques visitent votre landing page, vous pouvez avoir une URL avec les paramètres de campagne et Meta et une autre URL sans paramètre additionnel.

Exemple de journaux :

[adjust-smart-script]: No networks configured
[adjust-smart-script]: Use defaultLinkToken to create adjust link
[adjust-smart-script]: Found value for campaign is new_campaign
[adjust-smart-script]: Found value for adgroup is some_adset
[adjust-smart-script]: Found value for creative is logo_image
[adjust-smart-script]: Transformed value for ref_code is id+my_product
[adjust-smart-script]: Misconfigured deep link: no valid androidAppSchema provided

Outil de test des scripts intelligents

L'outil de test SmartScript est une interface de test pour SmartScript qui simule la manière dont SmartScript traite une URL de page de destination entrante et génère l’URL sortante (lien Adjust). Après avoir suivi ce guide, vous pouvez utiliser l'outil de test SmartScript pour vérifier que la logique des partenaires, la gestion des paramètres et la logique des tokens de lien se comportent comme prévu, avant ou pendant l'implémentation sur un site web.

À quoi sert cette fonctionnalité ?

L'outil de test SmartScript simule l’exécution de SmartScript pour une URL de page de destination donnée et affiche l'URL sortante résultante (lien Adjust) générée par la configuration SmartScript.

L'outil de test SmartScript prend en charge deux options d'entrée :

• Saisie manuelle d'une URL de test personnalisée.
• Sélection dans un ensemble d'URL prédéfinies (par exemple, URL contenant des UTM et des ID de clic provenant de sources courantes comme Meta, Google et TikTok).

L'outil de test SmartScript aide à valider le comportement de la configuration SmartScript, notamment :

• Logique de partenaire (par exemple, sélection d'un partenaire basée sur la configuration SmartScript).
• Gestion des paramètres (par exemple, quels paramètres entrants sont repris dans le lien sortant Adjust).
• Comportement des conditions du trafic (par exemple, si une condition s'applique à l'URL d'entrée).
• Logique de token de lien utilisée dans le lien sortant Adjust.

Cas d'utilisation habituels :

• Déterminer si les paramètres partenaires et les paramètres entrants de campagne sont repris dans le lien sortant Adjust.
• Confirmer que la configuration SmartScript gère les ID de clic et les paramètres spécifiques à la source comme attendu.
• Comparer le lien généré par Adjust à la logique de campagne attendue avant qu'un site web soit mis en ligne.
• Savoir si un problème provient de la configuration ou de l'implémentation du site web.

Fonctionnement

L'outil de test SmartScript simule la façon dont SmartScript traite l'URL d'une landing page.

1. Vous indiquez l'URL d'une landing page (une URL personnalisée ou une URL d'exemple prédéfinie).

2. L'outil de test SmartScript simule l'exécution SmartScript à l'aide de la configuration SmartScript.

3. L'outil de test SmartScript génère une URL sortante (lien Adjust) sur la base de la configuration SmartScript, comprenant ce qui suit :

   • Logique de partenaire
   • Gestion des paramètres
   • Conditions de trafic
   • Logique de token de lien

4. Vous vérifiez le lien sortant Adjust pour confirmer que le résultat correspond au comportement attendu de la configuration.