Conditions préalables

Ce tutoriel utilise l’interface utilisateur de collecte de données pour créer un schéma, configurer un flux de données et installer le SDK Web. Pour effectuer ces actions dans l’interface utilisateur, vous devez avoir accès à au moins une propriété Web avec les droits de propriété suivants :

  • Développer
  • Gérer les extensions

Consultez le guide sur la gestion des autorisations pour la collecte de données pour savoir comment accorder l’accès aux propriétés et aux droits de propriété.

Pour utiliser les différents produits de collecte de données mentionnés dans ce guide, vous devez également avoir accès aux flux de données et la possibilité de créer et de gérer des schémas. Si vous avez besoin d’accéder à l’une de ces fonctionnalités, contactez l’équipe en charge de votre compte Adobe pour obtenir l’accès nécessaire. Si vous n’avez pas acheté Adobe Experience Platform, Adobe vous donnera l’accès nécessaire pour utiliser le SDK sans frais supplémentaires.

Si vous avez déjà accès à Experience Platform, vous devez vous assurer que toutes les autorisations dans les catégories ci-dessous sont activées :

  • Modélisation des données
  • Identités

Consultez la présentation de l’interface utilisateur du contrôle d’accès pour savoir comment accorder des autorisations pour les fonctionnalités d’Experience Platform aux utilisateurs.

Résumé du processus

Le processus de configuration de la collecte de données pour votre site Web peut être résumé comme suit :

  1. Créez un schéma afin de déterminer la structure de vos données lors de leur envoi à Edge Network.
  2. Créez un flux de données pour configurer les destinations vers lesquelles vos données doivent être envoyées.
  3. Installez et configurez le SDK Web de façon à envoyer des données aux flux de données lorsque certains événements se produisent sur votre site Web.

Une fois que vous avez la possibilité d’envoyer des données à Edge Network, vous pouvez également configurer le transfert d’événement si votre entreprise dispose d’une licence pour ce transfert.

Création d’un schéma

Le modèle de données d’expérience (XDM) est une spécification open source qui fournit des structures et des définitions communes pour les données sous la forme de schémas. En d’autres termes, XDM constitue un moyen de structurer et de mettre en forme vos données d’une manière exploitable par Edge Network et d’autres applications Adobe Experience Cloud.

La première étape de la configuration de vos opérations de collecte de données consiste à créer un schéma XDM pour représenter vos données. À une étape ultérieure de ce tutoriel, vous allez mapper les données que vous souhaitez envoyer à la structure de ce schéma.

NOTE
Les schémas XDM sont hautement personnalisables. Plutôt que d’être trop directives, les étapes décrites ci-dessous portent spécifiquement sur les exigences de schéma pour le SDK Web. En dehors de ces paramètres, vous êtes libre de définir la structure restante de vos données comme vous le souhaitez.

Dans l’interface utilisateur d’, sélectionnez Schémas dans le volet de navigation de gauche. À partir de là, vous pouvez voir une liste des schémas créés précédemment et appartenant à votre organisation. Pour continuer, sélectionnez Créer un schéma, puis XDM ExperienceEvent dans le menu déroulant.

Espace de travail des schémas

Une boîte de dialogue s’affiche pour vous inviter à commencer à ajouter des groupes de champs au schéma. Pour envoyer des événements à l’aide du SDK Web, vous devez ajouter le groupe de champs AEP Web SDK ExperienceEvent Mixin. Ce groupe de champs contient des définitions pour les attributs de données qui automatiquement collectées par la bibliothèque SDK Web.

Utilisez la barre de recherche pour affiner la liste afin de faciliter la recherche de ce groupe de champs. Une fois que vous l’avez trouvé, sélectionnez-le dans la liste avant de sélectionner Ajouter des groupes de champs.

Espace de travail des schémas

La zone de travail des schémas s’affiche ; il s’agit d’une arborescence de votre schéma XDM comprenant les champs fournis par le groupe de champs SDK Web.

Structure d’un schéma

Sélectionnez le champ racine dans l’arborescence pour ouvrir les propriétés du schéma dans le rail de droite, où vous pouvez fournir un nom et une description facultative du schéma.

Nommer le schéma

Si vous souhaitez ajouter d’autres champs au schéma, vous pouvez le faire en sélectionnant Ajouter sous la section Groupes de champs dans le rail de gauche.

Ajouter des groupes de champs

NOTE
Pour obtenir des instructions détaillées sur la recherche de différents groupes de champs en fonction de vos cas d’utilisation, consultez le guide sur l’ajout de groupes de champs dans la documentation XDM.
La bonne pratique consiste à ajouter uniquement des champs pour les données que vous prévoyez d’envoyer par le biais de Edge Network. Une fois que vous avez ajouté des champs à un schéma et que vous l’avez enregistré, seules des modifications supplémentaires peuvent être apportées au schéma par la suite. Pour plus d’informations, reportez-vous à la section règles d’évolution des schémas.

Une fois que vous avez ajouté les champs dont vous avez besoin, sélectionnez Enregistrer pour enregistrer le schéma.

Enregistrement du schéma

Création dʼun flux de données

Un flux de données est une configuration qui indique à Edge Network où vous souhaitez que vos données soient envoyées. Plus précisément, un flux de données indique à quels produits Experience Cloud vous souhaitez envoyer les données et comment vous souhaitez que les données soient traitées et stockées dans chaque produit.

NOTE
Si vous souhaitez utiliser le transfert d’événement (en supposant que votre organisation dispose d’une licence pour cette fonctionnalité), vous devez l’activer pour un flux de données de la même manière que vous activez les produits Adobe. Les détails de ce processus sont traités dans une section ultérieure.

Sélectionnez Flux de données dans le volet de navigation de gauche. À partir de là, vous pouvez sélectionner un flux de données existant à modifier dans la liste ou créer une configuration en sélectionnant Nouveau flux de données.

Flux de données

Les exigences de configuration d’un flux de données dépendent des produits et fonctionnalités auxquels vous envoyez des données. Pour plus d’informations sur les options de configuration de chaque produit, consultez la présentation des flux de données.

Installation et configuration du SDK Mobile

Une fois que vous avez créé un schéma et un flux de données, l’étape suivante consiste à installer et à configurer Experience Platform Web SDK pour commencer à envoyer des données à Edge Network.

NOTE
Cette section utilise l’interface utilisateur de collecte de données pour configurer l’extension de balise du SDK Web, mais vous pouvez également l’installer et la configurer à l’aide du code brut. Consultez les guides suivants pour plus d’informations :
Notez également que même si vous souhaitez uniquement utiliser le transfert d’événement, vous devez tout de même installer et configurer le SDK comme décrit précédemment avant de configurer le transfert d’événement à une étape ultérieure.

Le processus peut se résumer comme suit :

  1. Installez le SDK Web d’Adobe Experience Platform sur une propriété de balise pour accéder à ses fonctionnalités.
  2. Créez un élément de données d’objet XDM pour mapper les variables de votre site Web à la structure du schéma XDM que vous avez créé précédemment.
  3. Créez une règle pour indiquer au SDK quand il doit envoyer des données à Edge Network.
  4. Créez et installez une bibliothèque pour mettre en œuvre la règle sur votre site Web.

Installation du SDK sur une propriété de balise

Sélectionnez Balises dans le volet de navigation de gauche pour afficher une liste des propriétés de balise. Si vous le souhaitez, vous pouvez choisir une propriété existante à modifier ou sélectionner Nouvelle propriété à la place.

Propriétés

Si vous créez une propriété, nommez-la de manière descriptive et définissez Plateforme sur Web. Indiquez le domaine complet de la propriété Web, puis sélectionnez Enregistrer.

Création d’une propriété

La page d’aperçu de la propriété s’affiche. À partir de là, sélectionnez Extensions dans le volet de navigation de gauche, puis sélectionnez Catalogue. Recherchez la liste d’Experience Platform Web SDK (éventuellement à l’aide de la barre de recherche pour limiter les résultats) et sélectionnez Installer.

Installation du SDK Web

La page de configuration du SDK s’affiche. La plupart des valeurs requises sont automatiquement renseignées avec des valeurs par défaut que vous pouvez modifier si vous le souhaitez.

Configuration du SDK Web

Toutefois, avant de pouvoir installer le SDK, vous devez sélectionner un flux de données pour savoir où envoyer vos données. Sous Flux de données, utilisez le menu déroulant pour sélectionner le flux de données que vous avez configuré à une étape précédente. Une fois que vous avez défini le flux de données, sélectionnez Enregistrer pour terminer l’installation du SDK sur la propriété.

Définition d’un flux de données et enregistrement

Création d’un élément de données XDM

Pour que le SDK envoie des données à EdgeNetwork, il faut que ces données soient mappées au schéma XDM que vous avez créé lors d’une étape précédente. Ce mappage est effectué via l’utilisation d’un élément de données.

Dans l’interface utilisateur, sélectionnez Éléments de données, puis sélectionnez Créer un élément de données.

Créer un élément de données

À l’écran suivant, sélectionnez SDK Web Adobe Experience Platform dans la liste déroulante Extension, puis sélectionnez Objet XDM pour le type d’élément de données.

Type d’objet XDM

La boîte de dialogue de configuration s’affiche pour le type d’objet XDM. La boîte de dialogue sélectionne automatiquement votre sandbox Experience Platform. Vous pouvez voir tous les schémas qui ont été créés dans cette sandbox. Sélectionnez le schéma XDM que vous avez créé précédemment dans la liste.

Type d’objet XDM

La structure du schéma apparaît. Tous les champs avec un astérisque (*) sont des champs qui seront automatiquement renseignés lorsque les événements se déclenchent. Pour tous les autres champs, vous pouvez explorer la structure du schéma et renseigner le reste des données.

Mappage des données aux champs XDM

NOTE
La capture d’écran ci-dessus montre comment mapper une variable accessible globalement du côté client de votre site Web (cartAbandonsTotal) à un champ XDM en référençant son nom dans le champ Valeur, entouré de signes de pourcentage (%).
Vous pouvez également utiliser d’autres éléments de données créés précédemment pour remplir ces champs. Pour plus d’informations, voir la référence sur les éléments de données dans la documentation sur les balises.

Une fois que vous avez terminé de mapper vos données au schéma, attribuez un nom à l’élément de données avant de sélectionner Enregistrer.

Nommer et enregistrer l’élément de données