在数据收集中使用identityMap

identityMap有效负载对象是您告知Edge Network哪些访客超出其设备级ECID的方法。 当访客登录、完成购买或以其他方式得知时，您可以随ECID发送人员级别标识符（CRM ID、哈希电子邮件、忠诚度ID等）。 这些人员级别的标识符为下游服务提供了有价值的信息，以便它们可以：

本页介绍如何构建identityMap负载、为每个标识选择正确的设置以及处理常见的实施方案。

有效负荷结构 structure

identityMap是一个JSON对象，其中的每个顶级键都是一个命名空间，该值是一个身份描述符数组。 您可以在单个有效负载中包含一个或多个命名空间，并且每个描述符包含三个字段：id、authenticatedState和primary。

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

以下各部分详细介绍了有效负载的各个部分。

命名空间键 namespace-keys

identityMap中的每个顶级键都是标识命名空间 — 一个对标识符类型进行分类的字符串（例如，CRMID、Email、Phone或LoyaltyId）。 命名空间必须存在于Identity Service中，然后才能在有效负载中引用它们。 当访客具有多个标识符时，可以在同一事件中包含多个命名空间键。

您无需包含ECID作为命名空间密钥。 Edge Network会自动将ECID添加到身份有效负载中。 如果您明确地包含ECID，则当也存在人员级别标识时，请勿将其标记为primary。

id id

id字段是标识符字符串本身，该值用于告知Experience Platform此身份表示的特定人员或设备。 每个标识命名空间都需要特定的值格式，而以错误的格式发送值会创建一个无法与正确格式化的版本合并的不同标识，从而导致配置文件碎片。

在identityMap中包含值之前，请根据目标命名空间期望的格式准备该值：

有关标准命名空间及其定义的完整列表，请参阅身份命名空间概述。

正在运行时收集id collect-id

您需要的标识符很少直接在页面上可用。 常见的收集策略包括：

authenticatedState authenticated-state

authenticatedState字段告知下游服务在给定标识中要放置多少信任。 以下值对此字段有效：

primary primary-identity

每个identityMap有效负载必须正好有一个标记为primary: true的标识。 主标识可确定在Experience Platform中将哪个标识用作事件的锚点。

设置主标识时，请遵循以下准则：

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

在您的实施中发送identityMap send-identity

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

常见应用场景 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
      }
    ]
  }
}

identityMap如何影响身份图 identity-graph

每个到达Experience Platform的identityMap有效负载都由标识服务处理，该服务将您发送的标识链接到标识图。 您包括的命名空间、设置authenticatedState的方式以及标记为primary的身份直接影响Identity Service如何构建和合并这些图形。

要注意的关键行为：

如果您的实施使用身份图链接规则（如命名空间优先级或身份优化算法），请查看实施指南，以了解这些规则如何与您通过identityMap发送的身份进行交互。