Guide de mise en oeuvre des règles de liaison de graphiques d’identités

Lisez ce document pour obtenir un guide détaillé que vous pouvez suivre lors de l’implémentation de vos données avec Adobe Experience Platform Identity Service.

Composition détaillé :

Conditions préalables à la mise en oeuvre prerequisites-for-implementation

Cette section décrit les étapes préalables à la mise en oeuvre des règles de liaison de graphiques d’identités à vos données.

Espace de noms unique

Exigences d’espace de noms pour une seule personne single-person-namespace-requirement

Vous devez vous assurer que l’espace de noms unique ayant la priorité la plus élevée est toujours présent dans chaque profil. Cela permet à Identity Service de détecter l’identifiant de personne approprié dans un graphique donné.

Configuration de la priorité des espaces de noms

Si vous utilisez le connecteur source Adobe Analytics pour ingérer des données, vous devez accorder à vos ECID une priorité plus élevée que l’Adobe Analytics ID (AAID), car Identity Service bloque AAID. En établissant la priorité d’ECID, vous pouvez indiquer à Real-Time Customer Profile de stocker les événements non authentifiés dans ECID au lieu d’AAID.

Événements d’expérience XDM

Pendant votre processus de prémise en oeuvre, vous devez vous assurer que les événements authentifiés que votre système enverra à l’Experience Platform contiennent toujours un identifiant de personne, tel que CRMID.

{
  "_id": "test_id",
  "identityMap": {
      "ECID": [
          {
              "id": "62486695051193343923965772747993477018",
              "primary": false
          }
      ],
      "CRMID": [
          {
              "id": "John",
              "primary": true
          }
      ]
  },
  "timestamp": "2024-09-24T15:02:32+00:00",
  "web": {
      "webPageDetails": {
          "URL": "https://business.adobe.com/",
          "name": "Adobe Business"
      }
  }
}

{
    "_id": "test_id",
    "identityMap": {
        "ECID": [
            {
                "id": "62486695051193343923965772747993477018",
                "primary": false
            }
        ]
    },
    "timestamp": "2024-09-24T15:02:32+00:00",
    "web": {
        "webPageDetails": {
            "URL": "https://business.adobe.com/",
            "name": "Adobe Business"
        }
    }
}

N’envoyez pas de chaîne vide en tant que valeur d’identité lors de l’envoi d’événements à l’aide d’événements d’expérience XDM. Si la valeur d’identité de l’espace de noms ayant la priorité la plus élevée est une chaîne vide, l’enregistrement est ignoré de Real-Time Customer Profile. Cela s’applique à la fois à identityMap et aux champs marqués comme une identité.

    "identityMap": {
        "ECID": [
            {
                "id": "24165048599243194405404369473457348936",
                "primary": false
            }
        ],
        "Phone": [
            {
                "id": "",
                "primary": true
            }
        ]
    }

Vous devez vous assurer que vous disposez d’une identité complète lors de l’envoi d’événements à l’aide d’événements d’expérience XDM.

    "identityMap": {
        "ECID": [
            {
                "id": "24165048599243194405404369473457348936",
                "primary": false
            }
        ]
    }

Définition des autorisations set-permissions

La première étape du processus de mise en oeuvre d’Identity Service consiste à s’assurer que votre compte Experience Platform est ajouté à un rôle doté des autorisations nécessaires. Votre administrateur peut configurer les autorisations de votre compte en accédant à l’interface utilisateur Autorisations de Adobe Experience Cloud. À partir de là, votre compte doit être ajouté à un rôle avec les autorisations suivantes :

Pour plus d’informations sur les autorisations, consultez le guide des autorisations.

Création des espaces de noms d’identité namespace

Si vos données en ont besoin, vous devez d’abord créer les espaces de noms appropriés pour votre organisation. Pour savoir comment créer un espace de noms personnalisé, consultez le guide sur la création d’un espace de noms personnalisé dans l’interface utilisateur.

Utiliser l'outil de simulation graphique graph-simulation

Ensuite, accédez à l’outil de simulation graphique dans l’espace de travail de l’interface utilisateur d’Identity Service. Vous pouvez utiliser l’outil de simulation graphique pour simuler des graphiques d’identités, créés avec différentes configurations de priorité d’espace de noms et d’espace de noms uniques.

En créant différentes configurations, vous pouvez utiliser l’outil de simulation graphique pour découvrir et mieux comprendre comment l’algorithme d’optimisation des identités et certaines configurations peuvent affecter le comportement de votre graphique.

Configuration des paramètres d’identité identity-settings

Une fois que vous avez une meilleure idée du comportement de votre graphique, accédez à l’ interface utilisateur des paramètres d’identité dans l’espace de travail de l’interface utilisateur d’Identity Service. Pour accéder à l’interface utilisateur des paramètres d’identité, sélectionnez Identités dans le volet de navigation de gauche, puis sélectionnez Paramètres.

Utilisez l’interface utilisateur des paramètres d’identité pour désigner vos espaces de noms uniques et configurer vos espaces de noms par ordre de priorité. Une fois que vous avez terminé d’appliquer vos paramètres, vous devez attendre au moins six heures avant de pouvoir procéder à l’ingestion des données, car au moins six heures sont nécessaires pour que les nouveaux paramètres soient reflétés dans Identity Service.

Pour plus d’informations, consultez le guide de l’interface utilisateur des paramètres d’identité.

Créer un schéma XDM schema

Une fois vos espaces de noms uniques et vos priorités d’espace de noms établies, vous pouvez procéder à la configuration requise pour ingérer vos données. Tout d’abord, vous devez créer un schéma XDM. En fonction de vos données, vous devrez peut-être créer un schéma pour XDM Individual Profile et XDM ExperienceEvent.

Pour ingérer des données dans Real-time Customer Profile, vous devez vous assurer que votre schéma contient au moins un champ qui a été désigné comme identité principale. En définissant une identité principale, vous pouvez activer un schéma donné pour l’ingestion de profils.

Pour plus d’informations sur la création d’un schéma, consultez le guide sur la création d’un schéma XDM dans l’interface utilisateur.

Créer un jeu de données dataset

Créez ensuite un jeu de données afin de fournir une structure pour les données que vous allez ingérer. Un jeu de données est une structure de stockage et de gestion pour une collection de données, généralement sous la forme d’un tableau, qui contient un schéma (des colonnes) et des champs (des lignes). Les jeux de données fonctionnent en tandem avec les schémas. Pour ingérer des données dans Real-time Customer Profile, votre jeu de données doit être activé pour l’ingestion de Profile. Pour que votre jeu de données soit activé pour Profile, il doit référencer un schéma activé pour l’ingestion de Profile.

Pour plus d’informations sur la création d’un jeu de données, consultez le guide de l’interface utilisateur du jeu de données.

Ingestion de données ingest

À ce stade, vous devriez disposer des éléments suivants :

Une fois que tous les éléments sont répertoriés ci-dessus, vous pouvez commencer à ingérer vos données dans Experience Platform. Vous pouvez procéder à l’ingestion des données de plusieurs manières différentes. Vous pouvez utiliser les services suivants pour importer vos données dans Experience Platform :

Pour tout commentaire, utilisez l’option Commentaires Beta dans l’espace de travail de l’interface utilisateur d’Identity Service.

Validation des graphiques validate

Utilisez le tableau de bord des identités pour obtenir des informations sur l’état de vos graphiques d’identités, tels que le nombre total d’identités et les tendances du nombre de graphiques, le nombre d’identités par espace de noms et le nombre de graphiques par taille de graphique. Vous pouvez également utiliser le tableau de bord des identités pour afficher les tendances sur les graphiques comportant plusieurs identités, organisées par espace de noms.

Sélectionnez les points de suspension (...), puis Afficher plus pour plus d’informations et pour vérifier qu’il n’existe aucun graphique réduit.

Utilisez la fenêtre qui s’affiche pour afficher des informations sur vos graphiques réduits. Dans cet exemple, le courrier électronique et le téléphone sont marqués comme un espace de noms unique. Il n’existe donc pas de graphiques réduits dans votre environnement de test.

Annexe appendix

Lisez cette section pour plus d’informations sur la mise en oeuvre de vos paramètres d’identité et espaces de noms uniques.

Scénario loginID dangereux dangling-loginid-scenario

Le graphique suivant simule un scénario loginID "dangling". Dans cet exemple, deux loginID différents sont liés au même ECID. Cependant, {loginID: ID_C} n’est pas lié au CRMID. Par conséquent, il n’existe aucun moyen pour Identity Service de détecter que ces deux loginID représentent deux entités différentes.

Étapes suivantes

Pour plus d’informations sur les règles de liaison des graphiques d’identités, consultez la documentation suivante :