DocumentationAnalyticsGuide de mise en œuvre

Envoyer des données à Adobe Analytics à l’aide de la bibliothèque JavaScript Web SDK

Last update: Fri Sep 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Utilisateur ou utilisatrice
  • Administration

Ce chemin d’implémentation implique une nouvelle installation de Web SDK à l’aide de la bibliothèque JavaScript Web SDK. D’autres chemins d’implémentation sont abordés sur des pages distinctes :

  • Extension de balise Web SDK : nouvelle installation de Web SDK à l’aide de l’extension de balise Web SDK. Similaire à l’approche de la bibliothèque JavaScript Web SDK (cette page), sauf que vous gérez l’implémentation à l’aide de balises dans la collecte de données Adobe Experience Platform. Le groupe de champs Adobe Analytics ExperienceEvent, qui comprend des variables Analytics standard à inclure dans votre schéma XDM, est nécessaire.
  • Extension Analytics vers l’extension Web SDK : adoptez une approche fluide et méthodique pour passer de l’extension de balise Adobe Analytics à l’extension de balise Web SDK. Cette approche supprime la nécessité d’utiliser XDM jusqu’à ce que votre entreprise soit prête à utiliser les services Adobe Experience Platform, tels que Customer Journey Analytics. Utilisez l’objet data au lieu de l’objet xdm pour envoyer des données à Adobe.
  • Bibliothèque JavaScript AppMeasurement vers Web SDK: approche fluide et méthodique de la migration vers Web SDK, sauf qu’elle n’utilise pas de balises. Au lieu de cela, vous pouvez supprimer manuellement la bibliothèque de collecte de données Adobe Analytics (AppMeasurement.js) et la remplacer par la bibliothèque JavaScript Web SDK (alloy.js).

Avantages et inconvénients de ce chemin de mise en œuvre

L’utilisation de la bibliothèque JavaScript Web SDK pour envoyer des données à Adobe Analytics présente à la fois des avantages et des inconvénients. Évaluez soigneusement chaque option pour décider quelle approche est la meilleure pour votre organisation.

Avantages
Inconvénients
  • Approche directe : ce chemin d’implémentation est plus simple que les approches qui déplacent les implémentations Adobe Analytics existantes. Si vous ne devez pas vous soucier d’une implémentation d’Adobe Analytics en cours, renseignez les champs XDM de Web SDK applicables.
  • Schéma prédéfini : si votre organisation n’a pas besoin de votre propre schéma, vous pouvez simplement utiliser celui destiné à Adobe Analytics. Ce concept s’applique même lorsque vous passez à Customer Journey Analytics ; le concept des props et des eVars ne s’applique pas à Customer Journey Analytics, mais vous pouvez continuer à utiliser les props et les eVars comme de simples dimensions personnalisées.
  • Les modifications d’implémentation nécessitent l’intervention d’un développeur : si vous souhaitez apporter des modifications à votre implémentation de Web SDK, vous devez collaborer avec votre équipe de développement pour modifier le code sur votre site. L’approche qui utilise l’extension de balise Web SDK évite cet inconvénient.
  • Verrouillé dans à l’aide d’un schéma spécifique : lorsque votre organisation passe à Customer Journey Analytics, vous devez choisir de continuer à utiliser le schéma Adobe Analytics ou de migrer vers le schéma de votre propre organisation (qui serait un jeu de données distinct). Si votre entreprise souhaite éviter à la fois le schéma Adobe Analytics et la migration vers un jeu de données distinct lors du déplacement vers Customer Journey Analytics, Adobe recommande l’une des deux méthodes suivantes :
    • Utilisez l’objet data : l’objet data permet d’envoyer des données à Adobe Analytics sans se conformer à un schéma XDM. Une fois le schéma de votre organisation créé, vous pouvez utiliser le mappage de flux de données pour mapper data champs d’objet à XDM. L’extension Analytics vers l’extension Web SDK et la bibliothèque JavaScript AppMeasurement vers Web SDK utilisent toutes deux cet objet data.
    • Ignorer entièrement Adobe Analytics : si vous implémentez le SDK Web, vous pouvez envoyer ces données à un jeu de données dans Adobe Experience Platform pour les utiliser dans Customer Journey Analytics. Vous pouvez utiliser le schéma de votre choix ; Adobe Analytics n’est pas du tout impliqué dans ce workflow et ne nécessite donc pas le groupe de champs Adobe Analytics ExperienceEvent. Cette méthode entraîne le minimum de dette technique, mais exclut également entièrement Adobe Analytics.
IMPORTANT
Cette méthode de mise en œuvre nécessite l’utilisation d’un schéma configuré pour Adobe Analytics. Si votre organisation prévoit d’utiliser votre propre schéma avec Customer Journey Analytics à l’avenir, l’utilisation du schéma Adobe Analytics peut prêter à confusion pour les administrateurs de données ou les architectes. Plusieurs options permettent d’atténuer cet obstacle :
  • Vous pouvez utiliser le schéma Adobe Analytics dans CJA. Notez que CJA ne comporte pas de concept de props ou d’eVars ; ils sont traités comme tout autre champ de schéma. Notez également que l’utilisation du schéma Adobe Analytics dans CJA peut rendre plus difficile l’utilisation d’autres services de Platform, tels que Adobe Journey Optimizer ou Real-Time Customer Data Platform.
  • Vous pouvez utiliser l’objet de données, comme pour un processus de migration. Notez que l’utilisation de l’objet de données nécessite de mapper chaque champ d’objet de données à un champ de schéma XDM.
  • Vous pouvez entièrement ignorer l’implémentation d’Adobe Analytics et envoyer des données à Adobe Experience Platform à l’aide de votre propre schéma. Cette approche est idéale à long terme et permet à votre entreprise de commencer à utiliser Customer Journey Analytics.

Procédure d’implémentation de la bibliothèque JavaScript Web SDK

Présentation générale des tâches d’implémentation :

Comment mettre en œuvre Adobe Analytics à l’aide du workflow Web SDK, comme décrit dans cette section.

Tâche
Informations supplémentaires
1
Vérifiez que vous avez défini une suite de rapports.
Gestionnaire de suites de rapports
2
Configurer des schémas. Pour normaliser la collecte de données à utiliser dans les applications qui utilisent Adobe Experience Platform, Adobe a créé la norme ouverte et accessible au public, Modèle de données d’expérience (XDM).
Présentation de l’interface utilisateur des schémas
3
Créez une couche de données pour gérer le suivi des données sur votre site web.
Créer une couche de données
4
Installez la version autonome prédéfinie. Vous pouvez référencer la bibliothèque (alloy.js) sur le CDN directement sur votre page ou la télécharger et l’héberger sur votre propre infrastructure. Vous pouvez également utiliser le package NPM.
Installer la version autonome prédéfinie et utiliser le package NPM
5
Configurez un flux de données. Un flux de données représente la configuration côté serveur lors de l’implémentation du SDK Web Adobe Experience Platform.
Configurer un flux de données
6
Ajoutez un service Adobe Analytics à votre flux de données. Ce service contrôle si et comment les données sont envoyées à Adobe Analytics et à quelle(s) suite(s) de rapports spécifique(s).
Ajoutez un service Adobe Analytics à un flux de données.
7
Configurez le SDK Web. Assurez-vous que la bibliothèque que vous avez installée à l’étape 4 est correctement configurée avec l’identifiant du flux de données (anciennement appelé identifiant de configuration Edge (datastreamId)), l’identifiant de l’organisation (orgId) et les autres options disponibles. Assurez-vous que le mappage des variables est correct.
Configurer le mappage des variables d’objet Web SDK
XDM
8
Exécutez les commandes et/ou suivez des événements. Une fois le code de base implémenté sur votre page web, vous pouvez commencer à exécuter des commandes et à suivre des évènements à l’aide du SDK.
Envoi d’événements
9
Étendez et validez votre implémentation avant de la diffuser en production.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690