Utilisation d’identityMap dans la collecte de données

L’objet de payload identityMap est la manière dont vous indiquez à Edge Network qui est un visiteur au-delà de son ECID au niveau de l’appareil. Lorsqu’un visiteur se connecte, effectue un achat ou est connu d’une autre manière, vous pouvez envoyer des identifiants au niveau de la personne (identifiant CRM, e-mail haché, identifiant de fidélité, etc.) avec l’ECID. Ces identifiants au niveau de la personne fournissent des informations précieuses aux services en aval afin qu’ils puissent :

Cette page explique comment créer des payloads identityMap, choisir les paramètres appropriés pour chaque identité et gérer les scénarios d’implémentation courants.

Structure de la payload structure

Le identityMap est un objet JSON où chaque clé de niveau supérieur est un espace de noms et la valeur est un tableau de descripteurs d’identité. Vous pouvez inclure un ou plusieurs espaces de noms dans une seule payload et chaque descripteur contient trois champs : id, authenticatedState et primary.

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

Les sections ci-dessous présentent en détail chaque partie de la payload.

Clés d’espace de noms namespace-keys

Chaque clé de niveau supérieur dans identityMap est un espace de noms d’identité — une chaîne qui classe le type d’identifiant (par exemple, CRMID, Email, Phone ou LoyaltyId). Les espaces de noms doivent exister dans Identity Service avant de les référencer dans une payload. Vous pouvez inclure plusieurs clés d’espace de noms dans le même événement lorsque vous disposez de plusieurs identifiants pour le visiteur.

Il n’est pas nécessaire d’inclure l’ECID comme clé d’espace de noms. Edge Network ajoute automatiquement l’ECID à la payload de l’identité. Si vous incluez l’ECID explicitement, ne le marquez pas comme primary lorsqu’une identité au niveau de la personne est également présente.

id id

Le champ id est la chaîne d’identifiant elle-même — la valeur qui indique à Experience Platform quelle personne ou appareil spécifique cette identité représente. Chaque espace de noms d’identité exige un format de valeur spécifique. L’envoi d’une valeur dans un format incorrect crée une identité distincte qui ne peut pas être fusionnée avec la version correctement formatée, ce qui entraîne la fragmentation des profils.

Avant d’inclure une valeur dans identityMap, préparez-la selon le format attendu par votre espace de noms cible :

Pour obtenir la liste complète des espaces de noms standard et leurs définitions, voir ​ Présentation des espaces de noms d’identité ​.

Collecter les id au moment de l’exécution collect-id

L’identifiant dont vous avez besoin est rarement disponible directement sur la page. Les stratégies de collecte courantes sont les suivantes :

authenticatedState authenticated-state

Le champ authenticatedState indique aux services en aval le niveau de confiance à accorder à une identité donnée. Les valeurs suivantes sont valides pour ce champ :

primary primary-identity

Chaque payload identityMap doit comporter exactement une identité marquée comme primary: true. L’identité principale détermine l’identité utilisée comme ancrage de l’événement dans Experience Platform.

Suivez ces instructions lors de la définition de l’identité principale :

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ],
    "Email": [
      {
        "id": "user@example.com",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ]
  }
}

Envoi d’identityMap dans votre implémentation send-identity

alloy("sendEvent", {
  xdm: {
    identityMap: {
      CRMID: [
        {
          id: "abc-123-xyz",
          authenticatedState: "authenticated",
          primary: true
        }
      ]
    },
    eventType: "web.webpagedetails.pageViews"
  }
});

Scénarios courants common-scenarios

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "loggedOut",
        "primary": false
      }
    ]
  }
}

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ],
    "Email_LC_SHA256": [
      {
        "id": "a1b2c3d4e5f6...",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ],
    "LoyaltyId": [
      {
        "id": "LOY-98765",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ]
  }
}

Comment identityMap affecte le graphique d’identités identity-graph

Chaque payload de identityMap qui atteint Experience Platform est traitée par Service d’identités, qui lie les identités que vous envoyez à un graphique d’identités. Les espaces de noms que vous incluez, la manière dont vous définissez les authenticatedState et l’identité que vous marquez comme primary déterminent directement la manière dont Identity Service crée et fusionne ces graphiques.

Comportements clés à connaître :

Si votre implémentation utilise des règles de liaison de graphiques d’identités (telles que la priorité de l’espace de noms ou l’algorithme d’optimisation des identités), consultez le guide d’implémentation pour comprendre comment ces règles interagissent avec les identités que vous envoyez via identityMap.