Configuration d’un jeu de données pour capturer les données de consentement et de préférence

Pour que Adobe Experience Platform traite 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 du workflow complet de traitement des données de consentement/préférence dans Platform, reportez-vous à la présentation du traitement du consentement.

Conditions préalables

Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :

Détails du consentement et des préférences structure de groupe de champs structure

Le groupe de champs Détails du consentement et de la préférence 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 seul champ de type objet, 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 des 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"
  }
}

Ajout des groupes de champs requis à votre schéma Profile add-field-group

Pour collecter des données de consentement à l’aide de la norme Adobe, vous devez disposer d’un schéma activé par Profile qui contient les deux groupes de champs suivants :

Dans l’interface utilisateur de Platform, sélectionnez Schémas dans le volet de navigation de gauche, puis sélectionnez l’onglet Parcourir pour afficher une 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 comme exemple le schéma "Loyalty Members" créé dans le tutoriel de création de schéma.

Le Schema Editor apparaît, indiquant la structure du schéma dans la zone de travail. Sur le côté gauche du canevas, 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 de la préférence 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.

Le canevas 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 qui ne sont pas 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.

Si 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 SDK Web Platform, ce jeu de données inclura désormais les nouveaux champs de consentement. Vous pouvez maintenant revenir au guide de traitement du consentement pour continuer le processus de configuration de l’Experience Platform pour 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éation d’un jeu de données basé sur votre schéma de consentement dataset

Une fois que vous avez créé un schéma avec des champs de consentement, vous devez créer un jeu de données qui assimilera en fin de compte 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 du schéma.

Le workflow Créer un jeu de données à partir du schéma s’affiche, en commençant à 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 faciliter la localisation de 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. Attribuez un nom et une description uniques et facilement identifiables au jeu de données avant de sélectionner Terminer.

La page des détails du nouveau jeu de données 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, la dernière étape du processus consiste à activer le jeu de données à utiliser dans Real-Time Customer Profile.

Dans le rail de droite, sélectionnez la bascule Profile .

Enfin, sélectionnez Activer dans la fenêtre contextuelle de confirmation pour activer le schéma pour Profile.

Le jeu de données est maintenant enregistré et activé pour une utilisation dans Profile. Si vous envisagez d’utiliser le SDK Web de Platform pour envoyer des données de consentement à Profile, vous devez sélectionner ce jeu de données comme ​ jeu de données de profil lors de la configuration de votre jeu de données.

Étapes suivantes

En suivant ce tutoriel, vous avez ajouté des champs de consentement à un schéma compatible Profile, dont le jeu de données sera utilisé pour ingérer des données de consentement à l’aide du SDK Web Platform ou de l’ingestion XDM directe.

Vous pouvez maintenant revenir à la présentation du traitement du consentement pour continuer à configurer l’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 consentement et de préférence personnalisés au schéma custom-consent

Si vous devez capturer des signaux de consentement supplémentaires en dehors de ceux représentés par le groupe de champs Détails du consentement et de la préférence standard, vous pouvez utiliser des composants XDM personnalisés pour améliorer votre schéma de consentement en fonction de vos besoins professionnels spécifiques. 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.

Il est vivement recommandé d’utiliser le groupe de champs Détails du consentement et des préférences comme ligne de base 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 entièrement la structure.

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 de la préférence 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é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 (+) en regard de l’objet consents.

Un nouveau champ s’affiche dans l’objet consents. Puisque vous ajoutez un champ personnalisé à un objet XDM standard, le nouveau champ est créé sous un objet dont l’espace de noms est associé à votre ID de tenant.

Dans le rail de droite sous Propriétés du champ, indiquez un nom et une description pour le champ. Lorsque vous sélectionnez le 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 création d’un jeu de données.