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

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, elles sont transférées à Adobe Analytics. À l’avenir, ce même flux de données transfère les données vers 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 Datastreams.
4. Sélectionnez Nouveau flux de données.
5. Saisissez le nom de votre choix, puis sélectionnez Enregistrer.
6. Une fois le flux de données créé, sélectionnez Ajouter un service.
7. Dans le menu déroulant du 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 l’effort de migration qui se déroulera à l’étape suivante.

1. Cliquez sur l’icône représentant un 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 près de la partie supérieure 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 , puis 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é pour votre propriété de balise.

L’élément de données d’objet de données fournit une structure intuitive pour configurer une charge utile 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 Data Elements.

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, par exemple "Couche de données" ou "Objet de données"
   • Extension : SDK Web Adobe Experience Platform
   • Type d’élément de données : Variable
   • Les cases à cocher peuvent rester inchangées.

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

   • Bouton radio Propriété : Data
   • Solution : Adobe Analytics

5. Sélectionnez Enregistrer.

Votre propriété de balise dispose désormais de tous les éléments nécessaires pour mettre à jour chaque règle.

Cette étape représente l’essentiel des efforts nécessaires pour migrer vers le SDK Web et nécessite des connaissances sur le fonctionnement de votre mise en oeuvre. 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 oeuvre pour remplacer toutes les références à l’extension Adobe Analytics par l’extension SDK Web.

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

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

3. Sélectionnez l’action Adobe Analytics - Set Variables

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

5. Remplacez la configuration de l'action par les paramètres suivants :

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

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

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

   • Les variables définies dans l’interface des balises peuvent directement se traduire par les mêmes valeurs.
   • 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 traduirait en data.__adobe.analytics.eVar1.
   • Les variables de configuration et les appels de méthode Analytics dans le code personnalisé peuvent nécessiter une logique de mise en oeuvre modifiée. Consultez chacune des variables respectives pour déterminer comment atteindre son équivalent à l’aide du SDK Web.

8. Une fois que toute la logique de règle est répliquée à l’aide de l’extension SDK Web, 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 inclut les variables définies à l’aide de l’interface des balises et les variables définies à l’aide du code personnalisé. Les blocs de code personnalisés ne peuvent faire référence à l’objet s nulle part.

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

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

2. Sélectionnez l’action Adobe Analytics - Send Beacon.

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

4. Remplacez la configuration de l'action par les paramètres suivants :

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

5. À droite, définissez les paramètres de l’action sur les éléments suivants :

   • Type : Pour s.t(), utilisez Pages vues Web Webpagedetails. Pour s.tl(), utilisez les clics sur les liens Web-interaction. 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 Additional properties lors de l’exécution de la configuration de l’action Update 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 processus que toute autre modification apportée à la configuration des 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. Donnez à cette balise un nom, par exemple "Mettre à niveau vers le SDK Web".
4. Sélectionnez Ajouter toutes les ressources modifiées.
5. Sélectionnez Enregistrer.
6. Le processus de publication affiche un point orange, indiquant qu’il est en cours de création. Une fois que le point devient vert, vos modifications sont disponibles dans votre environnement de développement.
7. Testez vos modifications dans 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 rempli avec les valeurs attendues.
8. Une fois prête, envoyez la bibliothèque pour approbation, créez-la pour l’évaluation, puis approuvez et publiez-la pour la production.

Une fois l’implémentation de vos balises entièrement sur le SDK Web, 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. À droite, sélectionnez Désactiver.
3. Suivez le même processus 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 à droite, puis sélectionnez Désinstaller.
5. Suivez le même processus de publication ci-dessus pour publier ces modifications en production.