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

Dernière mise à jour : 22 juillet 2024

Créé pour :

  • Utilisateur ou utilisatrice
  • Administration

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

  • Extension de balise du SDK Web : nouvelle installation du SDK Web à l’aide de l’extension de balise du SDK Web. Similaire à l’approche de la bibliothèque JavaScript du SDK Web (cette page), à la différence que vous gérez l’implémentation à l’aide de balises dans la collecte de données Adobe Experience Platform. Il nécessite que le groupe de champs ExperienceEvent d’Adobe Analytics, qui inclut des variables Analytics standard à inclure dans votre schéma XDM.
  • Extension Analytics vers l’extension SDK Web : adoptez une approche fluide et méthodique pour passer de l’extension de balise Adobe Analytics à l’extension de balise SDK Web. Cette approche élimine 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.
  • AppMeasurement à la bibliothèque JavaScript du SDK Web : approche douce et méthodique de la migration vers le SDK Web, sauf qu’elle n’utilise pas de balises. Vous pouvez plutôt supprimer manuellement la bibliothèque de collecte de données Adobe Analytics (AppMeasurement.js) et la remplacer par la bibliothèque JavaScript SDK Web (alloy.js).

Avantages et inconvénients de ce chemin de mise en oeuvre

L’utilisation de la bibliothèque JavaScript du SDK Web pour envoyer des données à Adobe Analytics présente des avantages et des inconvénients. Pesez soigneusement chaque option pour choisir la méthode qui convient le mieux à votre entreprise.

AvantagesInconvé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 souhaitez pas vous soucier d’une mise en oeuvre Adobe Analytics actuelle, renseignez les champs XDM du SDK Web applicables.
  • Schéma prédéfini : si votre organisation n’a pas besoin de votre propre schéma, vous pouvez simplement utiliser le schéma adapté à Adobe Analytics. Ce concept s’applique même lorsque vous passez au Customer Journey Analytics ; le concept de props et d’eVars ne s’applique pas à Customer Journey Analytics, mais vous pouvez continuer à utiliser les props et eVars comme dimensions personnalisées simples.
  • Les modifications de mise en oeuvre nécessitent une intervention du développeur : si vous souhaitez apporter des modifications à votre mise en oeuvre du SDK Web, vous devez travailler 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.
  • Connecté à 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 le schéma Adobe Analytics et la migration vers un jeu de données distinct lors du passage à Customer Journey Analytics, Adobe recommande l’une des deux méthodes suivantes :
    • Utilisez l’objet data : l’objet data vous permet d’envoyer des données à Adobe Analytics sans respecter 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 les champs d’objet data à XDM. Les extensions Analytics vers l’extension SDK Web et AppMeasurement vers la bibliothèque JavaScript SDK Web utilisent tous deux cet objet data.
    • Ignorer entièrement Adobe Analytics : si vous mettez en oeuvre le SDK Web, vous pouvez envoyer ces données à un jeu de données dans Adobe Experience Platform en vue de les utiliser dans Customer Journey Analytics. Vous pouvez utiliser n’importe quel 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 engendre le moins de dettes techniques possible, mais elle ne tient pas compte d’Adobe Analytics.
IMPORTANT
Cette méthode de mise en oeuvre nécessite l’utilisation d’un schéma configuré pour Adobe Analytics. Si votre entreprise prévoit d’utiliser votre propre schéma avec Customer Journey Analytics à l’avenir, l’utilisation du schéma Adobe Analytics peut créer une confusion pour les administrateurs ou les architectes de données. Plusieurs options permettent d’atténuer cet obstacle :
  • Vous pouvez utiliser le schéma Adobe Analytics dans CJA. Notez que CJA n’a pas de concept de props ou 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 plateforme, tels que Adobe Journey Optimizer ou Real-Time Customer Data Platform.
  • Vous pouvez utiliser l’objet de données, comme un workflow de migration. Notez que l’utilisation de l’objet de données nécessite que vous mappez chaque champ d’objet de données à un champ de schéma XDM.
  • Vous pouvez ignorer entièrement 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 de mise en oeuvre de la bibliothèque JavaScript SDK Web

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

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

TâcheInformations supplémentaires
1Vérifiez que vous avez défini une suite de rapports.Gestionnaire de suites de rapports
2Configuration de 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
3Cré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
4Installez la version autonome prédéfinie. Vous pouvez référencer la bibliothèque (alloy.js) sur le réseau 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
5Configurez 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
6Ajoutez 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 en particulier.Ajoutez un service Adobe Analytics à un flux de données.
7Configurez le SDK Web. Assurez-vous que la bibliothèque que vous avez installée à l’étape 4 est correctement configurée avec l’identifiant de la banque de données (anciennement appelé id de configuration Edge (datastreamId), l’identifiant de l’organisation (orgId) et d’autres options disponibles. Assurez-vous que la correspondance des variables est correcte.Configuration du SDK Web
Mappage de variable d’objet XDM
8Exé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.

Analytics