Uso de identityMap en la recopilación de datos

El objeto de carga útil identityMap le indica al Edge Network quién es el visitante que está más allá de su ECID de nivel de dispositivo. Cuando un visitante inicia sesión, completa una compra o se da a conocer de otro modo, puede enviar identificadores de nivel de persona (ID de CRM, correo electrónico con hash, ID de fidelidad, etc.) junto con el ECID. Estos identificadores de nivel de persona proporcionan información valiosa a los servicios descendentes para que puedan:

Esta página cubre cómo construir identityMap cargas útiles, elegir la configuración correcta para cada identidad y manejar escenarios de implementación comunes.

Estructura de carga útil structure

identityMap es un objeto JSON donde cada clave de nivel superior es un área de nombres y el valor es una matriz de descriptores de identidad. Puede incluir una o más áreas de nombres en una sola carga útil, y cada descriptor contiene tres campos: id, authenticatedState y primary.

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

Las secciones siguientes abarcan cada parte de la carga útil en detalle.

Claves de área de nombres namespace-keys

Cada clave de nivel superior de identityMap es un área de nombres de identidad, una cadena que clasifica el tipo de identificador (por ejemplo, CRMID, Email, Phone o LoyaltyId). Deben existir áreas de nombres en el servicio de identidad antes de hacer referencia a ellas en una carga útil. Puede incluir varias claves de área de nombres en el mismo evento cuando tenga más de un identificador para el visitante.

No es necesario incluir el ECID como clave de área de nombres. Edge Network agrega automáticamente el ECID a la carga útil de identidad. Si incluye el ECID explícitamente, no lo marque como primary cuando también haya una identidad de nivel de persona.

id id

El campo id es la propia cadena de identificador, es decir, el valor que indica a Experience Platform a qué persona o dispositivo específico representa esta identidad. Cada área de nombres de identidad espera un formato de valor específico, y al enviar un valor en un formato incorrecto se crea una identidad distinta que no se puede combinar con la versión con formato correcto, lo que da como resultado perfiles fragmentados.

Antes de incluir un valor en identityMap, prepárelo según el formato que espera el área de nombres de destino:

Para obtener la lista completa de áreas de nombres estándar y sus definiciones, vea Descripción general del área de nombres de identidad.

Recopilando id durante la ejecución collect-id

El identificador que necesita rara vez está disponible directamente en la página. Las estrategias de recopilación comunes incluyen:

authenticatedState authenticated-state

El campo authenticatedState indica a los servicios descendentes cuánta confianza depositar en una identidad determinada. Los siguientes valores son válidos para este campo:

primary primary-identity

Cada carga de identityMap debe tener exactamente una identidad marcada como primary: true. La identidad principal determina qué identidad se utiliza como anclaje para el evento en Experience Platform.

Siga estas directrices al configurar la identidad principal:

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

Envío de identityMap en la implementación send-identity

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

Casos comunes 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
      }
    ]
  }
}

Cómo afecta identityMap al gráfico de identidad identity-graph

Cada carga útil de identityMap que llega a Experience Platform la procesa Identity Service, que vincula las identidades que envía a un gráfico de identidades. Las áreas de nombres que incluya, la forma en que establezca authenticatedState y la identidad que marque como primary dan forma directamente a la forma en que el servicio de identidad crea y combina esos gráficos.

Comportamientos clave que hay que tener en cuenta:

Si su implementación usa reglas de vinculación de gráficos de identidad (como la prioridad de área de nombres o el algoritmo de optimización de identidad), revise la guía de implementación para comprender cómo esas reglas interactúan con las identidades que envía a través de identityMap.