在資料收集中使用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傳送的身分如何互動。