Migration de l’extension de balise Adobe Analytics vers l’extension de balise Web SDK

Créez un flux de données dans la collecte de données Adobe Experience Platform. Lorsque vous envoyez des données à ce flux de données, il transfère les données vers Adobe Analytics. À l’avenir, ce même flux de données transfèrera des données à Customer Journey Analytics.

1. Accédez à experience.adobe.com et connectez-vous à l’aide de vos informations d’identification.
2. Utilisez la page d’accueil ou le sélecteur de produits en haut à droite pour accéder à Collecte de données.
3. Dans le volet de navigation de gauche, sélectionnez Flux de données.
4. Sélectionnez Nouveau flux de données.
5. Saisissez le nom souhaité, puis sélectionnez Enregistrer.
6. Une fois le flux de données créé, sélectionnez Ajouter un service.
7. Dans le menu déroulant Service, sélectionnez Adobe Analytics.
8. Saisissez le même identifiant de suite de rapports que le site auquel vous envoyez actuellement des données d’analyse. Cliquez sur Enregistrer.

Votre flux de données est maintenant prêt à recevoir et à transmettre des données à Adobe Analytics.

Cette section prépare votre balise pour l’essentiel de la migration effectuée à l’étape suivante.

1. Cliquez sur l’icône hamburger en haut à gauche de l’interface de Adobe Experience Platform, puis sélectionnez Balises.

2. Sélectionnez la propriété de balise de votre choix.

3. Dans le volet de navigation de gauche de la propriété de balise, sélectionnez Extensions.

4. Sélectionnez Catalogue en haut pour afficher la liste de toutes les extensions disponibles.

5. Recherchez et sélectionnez l’extension Adobe Experience Platform Web SDK, puis cliquez sur Installer à droite.

   

6. Les paramètres de configuration de l’extension s’affichent. Recherchez la section Flux de données et sélectionnez le flux de données que vous avez créé à l’étape précédente.

   

7. Sélectionnez Enregistrer.

Le SDK Web est désormais installé sur la propriété de balise.

L’élément de données d’objet de données fournit un cadre intuitif pour configurer une payload que le SDK Web utilise pour envoyer à un flux de données. La plupart des règles que vous mettez à jour à l’étape suivante interagissent avec cet élément de données.

1. Dans le volet de navigation de gauche de l’interface des balises, sélectionnez Éléments de données.

2. Sélectionnez Ajouter un élément de données

3. Définissez les paramètres suivants pour l’élément de données :

   • Nom : tout ce que vous souhaitez, tel que « Couche de données » ou « Objet de données ».
   • Extension : Adobe Experience Platform Web SDK
   • Type d’élément de données : Variable
   • Les cases à cocher peuvent rester en l’état

4. Sur la droite, sélectionnez les paramètres suivants :

   • Bouton radio de propriété : Data
   • Solution : Adobe Analytics

5. Sélectionnez Enregistrer.

Votre propriété de balise dispose désormais de tout ce dont vous avez besoin pour mettre à jour chaque règle.

Cette étape contient l’essentiel de l’effort requis pour migrer vers Web SDK et nécessite des connaissances sur le fonctionnement de votre implémentation. Vous trouverez ci-dessous un exemple de modification d’une règle de balise standard. Mettez à jour toutes les règles de balise dans votre mise en œuvre pour remplacer toutes les références à l’extension Adobe Analytics par l’extension Web SDK.

1. Dans le volet de navigation de gauche de l’interface des balises, sélectionnez Règles.

2. Sélectionnez une règle à modifier.

3. Sélectionnez l’action Adobe Analytics - Définir les variables

4. Notez toutes les variables Analytics définies dans cette règle. Incluez les variables définies dans les menus déroulants et les variables définies dans le code personnalisé.

5. Modifiez la Configuration de l’action pour les paramètres suivants :

   • Extension : Adobe Experience Platform Web SDK
   • Type d’action : Mettre à jour la variable

6. Assurez-vous que votre objet de données est sélectionné dans la liste déroulante de droite.

7. Définissez les variables Analytics sur leurs mêmes valeurs respectives telles qu’elles ont été configurées dans l’extension Analytics.

   • Les variables définies dans l’interface des balises peuvent être traduites directement en valeurs identiques.
   • Les variables de chaîne définies dans le code personnalisé nécessitent des ajustements minimaux. Au lieu d’utiliser l’objet s, utilisez data.__adobe.analytics à la place. Par exemple, s.eVar1 se traduirait par data.__adobe.analytics.eVar1.
   • Les variables de configuration Analytics et les appels de méthode dans le code personnalisé peuvent nécessiter une logique d’implémentation modifiée. Voir chaque variable respective pour déterminer comment obtenir son équivalent à l’aide de Web SDK.

8. Une fois toute la logique des règles répliquée à l’aide de l’extension Web SDK, sélectionnez Conserver les modifications.

9. Répétez ces étapes pour chaque configuration d’action qui utilise l’extension Adobe Analytics pour définir des valeurs. Cette étape comprend à la fois des variables définies à l’aide de l’interface des balises et des variables définies à l’aide de code personnalisé. Les blocs de code personnalisé ne peuvent pas référencer l’objet s où que ce soit.

Les étapes ci-dessus s’appliquent uniquement aux règles qui définissent des valeurs. Les étapes suivantes remplacent toutes les actions qui utilisent l’Configuration de l’action Envoyer la balise.

1. Sélectionnez une règle qui envoie une balise.

2. Sélectionnez l’action Adobe Analytics - Envoyer la balise.

3. Notez la valeur actuelle du bouton radio Tracking à droite (s.t() ou s.tl()).

4. Modifiez la Configuration de l’action pour les paramètres suivants :

   • Extension : Adobe Experience Platform Web SDK
   • Type d’action : Envoyer l’événement

5. Sur la droite, modifiez les paramètres d’action comme suit :

   • Type : par s.t(), utilisez Pages vues de détails sur la page web. Par s.tl(), utilisez Clics sur les liens d’interaction web. Si vous utilisez s.tl(), vous devez également inclure les champs suivants dans votre objet de données. Ces champs sont répertoriés sous Propriétés supplémentaires lors de l’exécution de la configuration d’action Mettre à jour la variable :

     • Nom du lien
     • Type de lien ​
     • URL du lien

6. Sélectionnez Conserver les modifications.

7. Répétez ces étapes pour chaque configuration d’action qui utilise Adobe Analytics pour envoyer une balise.

La publication des règles mises à jour suit le même workflow que toute autre modification de votre configuration de balises.

1. Dans le volet de navigation de gauche de l’interface des balises, sélectionnez Flux de publication.
2. Sélectionnez Ajouter une bibliothèque.
3. Attribuez un nom à cette validation de balise, par exemple « Mettre à niveau vers Web SDK ».
4. Sélectionnez Ajouter toutes les ressources modifiées.
5. Sélectionnez Enregistrer.
6. Le workflow de publication affiche un point orange, indiquant qu’il est en cours de création. Une fois le point vert affiché, vos modifications sont disponibles dans votre environnement de développement.
7. Testez les modifications apportées à votre environnement de développement pour vous assurer que toutes les règles se déclenchent correctement et que l’objet de données est renseigné avec les valeurs attendues.
8. Une fois prête, envoyez la bibliothèque pour approbation, créez-la vers l’évaluation, puis approuvez-la et publiez-la en production.

Une fois que votre implémentation de balise est entièrement sur le Web SDK, vous pouvez désactiver l’extension Adobe Analytics.

1. Dans le volet de navigation de gauche de l’interface des balises, sélectionnez Extensions.
2. Recherchez et sélectionnez l’extension Adobe Analytics. Sur la droite, sélectionnez Désactiver.
3. Suivez le même workflow de publication ci-dessus pour publier la suppression de l’extension Adobe Analytics.
4. Une fois l’extension désactivée en production, vous pouvez la désinstaller entièrement. Sélectionnez l’extension, sélectionnez le menu à trois points sur la droite, puis sélectionnez Désinstaller.
5. Suivez le même workflow de publication ci-dessus pour publier ces modifications en production.