Configuration d’un jeu de données pour capturer les données de consentement et de préférence
- Rubriques :
- Consentement
- Jeux de données
Créé pour :
- Développeur
Pour que Adobe Experience Platform puisse traiter vos données de consentement/préférence client, ces données doivent être envoyées à un jeu de données dont le schéma contient des champs liés aux consentements et à d’autres autorisations. Plus précisément, ce jeu de données doit être basé sur la classe XDM Individual Profile et activé pour une utilisation dans Real-Time Customer Profile.
Ce document décrit les étapes de configuration d’un jeu de données pour traiter les données de consentement dans Experience Platform. Pour une présentation complète du workflow de traitement des données de consentement/préférence dans Experience Platform, reportez-vous à la section présentation du traitement du consentement.
IMPORTANT- Groupe de champs de consentement normalisé
- Un groupe de champs de consentement personnalisé créé par votre organisation
- Combinaison du groupe de champs de consentement normalisé et des champs supplémentaires fournis par un groupe de champs de consentement personnalisé
Conditions préalables
Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :
- Modèle de données d’expérience (XDM) : cadre normalisé selon lequel Experience Platform organise les données d’expérience client.
- Notions de base de la composition du schéma : en savoir plus sur les blocs de création de base des schémas XDM.
- Real-Time Customer Profile : consolide les données client provenant de sources disparates en une vue complète et unifiée tout en offrant un compte horodaté et exploitable de chaque interaction client.
IMPORTANTStructure du groupe de champs Détails du consentement et des préférences
Le groupe de champs Détails du consentement et des préférences fournit des champs de consentement normalisés à un schéma. Actuellement, ce groupe de champs n’est compatible qu’avec les schémas basés sur la classe XDM Individual Profile.
Le groupe de champs fournit un champ de type objet unique, consents, dont les sous-propriétés capturent un ensemble de champs de consentement normalisés. Le fichier JSON suivant est un exemple du type de données attendu par consents lors de l’ingestion de données :
{
"consents": {
"collect": {
"val": "y",
},
"share": {
"val": "y",
},
"personalize": {
"content": {
"val": "y"
}
},
"marketing": {
"preferred": "email",
"any": {
"val": "y"
},
"push": {
"val": "n",
"reason": "Too Frequent",
"time": "2019-01-01T15:52:25+00:00"
}
},
"idSpecific": {
"email": {
"jdoe@example.com": {
"marketing": {
"email": {
"val": "n"
}
}
}
}
}
},
"metadata": {
"time": "2019-01-01T15:52:25+00:00"
}
}
NOTEconsents, consultez la présentation du groupe de champs Détails du consentement et des préférences.Ajouter les groupes de champs obligatoires à votre schéma de Profile
Pour collecter des données de consentement à l’aide de la norme Adobe, vous devez disposer d’un schéma activé pour Profile contenant les deux groupes de champs suivants :
- Détails relatifs au consentement et aux préférences
- IdentityMap (obligatoire si vous utilisez Experience Platform Web ou Mobile SDK pour envoyer des signaux de consentement)
Dans l’interface utilisateur d’Experience Platform, sélectionnez Schémas dans le volet de navigation de gauche, puis sélectionnez l’onglet Parcourir pour afficher la liste des schémas existants. À partir de là, sélectionnez le nom du schéma Profile auquel vous souhaitez ajouter des champs de consentement. Les captures d’écran de cette section utilisent le schéma « Membres du programme de fidélité » créé dans le tutoriel sur la création de schémasà titre d’exemple.
TIPLa Schema Editor s’affiche et indique la structure du schéma dans la zone de travail. Sur le côté gauche de la zone de travail, sélectionnez Ajouter sous la section Groupes de champs.
La boîte de dialogue Ajouter un groupe de champs s’affiche. À partir de là, sélectionnez Détails du consentement et des préférences dans la liste. Vous pouvez éventuellement utiliser la barre de recherche pour affiner les résultats afin de localiser plus facilement le groupe de champs.
Recherchez ensuite le groupe de champs IdentityMap dans la liste et sélectionnez-le également. Une fois que les deux groupes de champs sont répertoriés dans le rail de droite, sélectionnez Ajouter des groupes de champs.
La zone de travail réapparaît, indiquant que les champs consents et identityMap ont été ajoutés à la structure du schéma. Si vous avez besoin de champs de consentement et de préférence supplémentaires, non capturés par le groupe de champs standard, reportez-vous à la section de l’annexe sur l’ajout de champs de consentement et de préférence personnalisés au schéma. Sinon, sélectionnez Enregistrer pour finaliser les modifications apportées au schéma.
IMPORTANTSi le schéma que vous avez modifié est utilisé par le jeu de données de profil spécifié dans votre flux de données Experience Platform Web SDK, ce jeu de données inclut désormais les nouveaux champs de consentement. Vous pouvez maintenant revenir au guide de traitement du consentement pour poursuivre le processus de configuration d’Experience Platform afin de traiter les données de consentement. Si vous n’avez pas créé de jeu de données pour ce schéma, suivez les étapes de la section suivante.
Créer un jeu de données en fonction de votre schéma de consentement
Une fois que vous avez créé un schéma avec des champs de consentement, vous devez créer un jeu de données qui ingérera à terme les données de consentement de vos clients. Ce jeu de données doit être activé pour Real-Time Customer Profile.
Pour commencer, sélectionnez Jeux de données dans le volet de navigation de gauche, puis sélectionnez Créer un jeu de données dans le coin supérieur droit.
Sur la page suivante, sélectionnez Créer un jeu de données à partir d’un schéma.
Le workflow Créer un jeu de données à partir d’un schéma s’affiche, en commençant par l’étape Sélectionner un schéma. Dans la liste fournie, recherchez l’un des schémas de consentement que vous avez créés précédemment. Vous pouvez éventuellement utiliser la barre de recherche pour affiner les résultats et localiser plus facilement votre schéma. Sélectionnez le bouton radio en regard du schéma souhaité, puis sélectionnez Suivant pour continuer.
L’étape Configurer le jeu de données apparaît. Fournissez un nom et une description uniques et facilement identifiables pour le jeu de données avant de sélectionner Terminer.
La page de détails du jeu de données nouvellement créé s’affiche. Si le jeu de données est basé sur votre schéma de série temporelle, le processus est terminé. Si le jeu de données est basé sur votre schéma d’enregistrement, l’étape finale du processus consiste à activer le jeu de données pour une utilisation dans Real-Time Customer Profile.
Dans le rail de droite, sélectionnez le bouton (bascule) Profil.
Enfin, sélectionnez Activer dans la fenêtre contextuelle de confirmation pour activer le schéma à Profile.
Le jeu de données est maintenant enregistré et activé pour une utilisation dans Profile. Si vous prévoyez d’utiliser Experience Platform Web SDK pour envoyer des données de consentement au profil, vous devez sélectionner ce jeu de données comme jeu de données de profil lors de la configuration de votre flux de données.
Étapes suivantes
En suivant ce tutoriel, vous avez ajouté des champs de consentement à un schéma activé pour Profile, dont le jeu de données sera utilisé pour ingérer des données de consentement à l’aide du SDK Web Experience Platform ou de l’ingestion XDM directe.
Vous pouvez maintenant revenir à la présentation du traitement du consentement pour continuer à configurer Experience Platform pour traiter les données de consentement.
Annexe
La section suivante contient des informations supplémentaires sur la création d’un jeu de données pour ingérer les données de consentement et de préférence du client.
Ajout de champs de préférence et de consentement personnalisés au schéma
Si vous devez capturer des signaux de consentement supplémentaires en dehors de ceux représentés par le groupe de champs standard Détails du consentement et des préférences, vous pouvez utiliser des composants XDM personnalisés pour améliorer votre schéma de consentement en fonction des besoins spécifiques de votre entreprise. Cette section décrit les principes de base de la personnalisation de votre schéma de consentement afin d’ingérer ces signaux dans Profile.
IMPORTANTIl est vivement recommandé d’utiliser le groupe de champs Détails du consentement et des préférences comme référence pour la structure de vos données de consentement et d’ajouter des champs supplémentaires si nécessaire, plutôt que d’essayer de créer l’ensemble de la structure à partir de zéro.
Pour ajouter des champs personnalisés à la structure d’un groupe de champs standard, vous devez d’abord créer un groupe de champs personnalisé. Après avoir ajouté le groupe de champs Détails du consentement et des préférences au schéma, sélectionnez l’icône plus (+) dans la section Groupes de champs, puis sélectionnez Créer un groupe de champs. Attribuez un nom et une description facultative au groupe de champs, puis sélectionnez Ajouter un groupe de champs.
Le Schema Editor réapparaît avec le nouveau groupe de champs personnalisés sélectionné dans le rail de gauche. Dans la zone de travail, des contrôles s’affichent pour vous permettre d’ajouter des champs personnalisés à la structure du schéma. Pour ajouter un nouveau champ de consentement ou de préférence, sélectionnez l’icône plus (+) à côté de l’objet consents.
Un nouveau champ apparaît dans l’objet consents. Puisque vous ajoutez un champ personnalisé à un objet XDM standard, le nouveau champ est créé sous un objet d’espace de noms associé à votre identifiant client.
Dans le rail de droite sous Propriétés du champ, indiquez un nom et une description pour le champ. Lors de la sélection du Type du champ, vous devez utiliser le type de données standard approprié pour un champ de préférence ou de consentement personnalisé :
Lorsque vous avez terminé, sélectionnez Appliquer.
Le champ de consentement ou de préférence est ajouté à la structure du schéma. Notez que le Chemin affiché dans le rail de droite contient l’espace de noms _tenantId. Cet espace de noms doit être inclus chaque fois que vous référencez le chemin d’accès à ce champ dans vos opérations de données.
Suivez les étapes ci-dessus pour continuer à ajouter les champs de consentement et de préférence dont vous avez besoin. Lorsque vous avez terminé, sélectionnez Enregistrer pour confirmer vos modifications.
Si vous n’avez pas créé de jeu de données pour ce schéma, passez à la section sur la création d’un jeu de données.