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 :
- Créez un schéma afin de déterminer la structure de vos données lors de leur envoi à Edge Network.
- Créez un flux de données pour configurer les destinations vers lesquelles vos données doivent être envoyées.
- 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.
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.
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.
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.
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.
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.
Une fois que vous avez ajouté les champs dont vous avez besoin, sélectionnez Enregistrer pour enregistrer le 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.
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.
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.
Le processus peut se résumer comme suit :
- Installez le SDK Web d’Adobe Experience Platform sur une propriété de balise pour accéder à ses fonctionnalités.
- 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.
- Créez une règle pour indiquer au SDK quand il doit envoyer des données à Edge Network.
- 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.
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.
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.
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.
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é.
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.
À 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.
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.
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.
cartAbandonsTotal
) à un champ XDM en référençant son nom dans le champ Valeur, entouré de signes de pourcentage (%
).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.