データ収集でのidentityMapの使用

identityMap ペイロードオブジェクトは、訪問者がデバイスレベル ECIDを超えているEdge Networkを識別する方法です。 訪問者がログインしたり、購入を完了したり、その他の方法で既知になったりすると、個人レベルのID （CRM ID、ハッシュメール、ロイヤルティ IDなど）をECIDと一緒に送信できます。 これらの個人レベルのIDは、下流のサービスに貴重な情報を提供し、次のことを可能にします。

このページでは、identityMap ペイロードを構築し、各IDに適切な設定を選択し、一般的な実装シナリオを処理する方法について説明します。

ペイロード構造 structure

identityMapはJSON オブジェクトです。各トップレベル キーは名前空間で、値はID記述子の配列です。 1つのペイロードに1つ以上の名前空間を含めることができ、各記述子にはid、authenticatedState、primaryの3つのフィールドが含まれます。

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

以下のセクションでは、ペイロードの各部分について詳しく説明します。

名前空間キー namespace-keys

identityMapの各トップレベル キーはID名前空間です。識別子の種類を分類する文字列（CRMID、Email、Phone、またはLoyaltyIdなど）です。 名前空間は、ペイロードで参照する前にID サービスに存在する必要があります。 訪問者に複数の識別子がある場合、同じイベントに複数の名前空間キーを含めることができます。

ECIDを名前空間キーとして含める必要はありません。 Edge Networkは、ECIDをID ペイロードに自動的に追加します。 ECIDを明示的に含める場合は、個人レベルのIDも存在する場合は、primaryとしてマークしないでください。

id id

id フィールドは、識別子文字列自体です。このIDがどの特定の個人またはデバイスを表しているかをExperience Platformに伝える値です。 各ID名前空間には特定の値の形式が必要です。誤った形式で値を送信すると、正しい形式のバージョンと結合できない個別のIDが作成され、プロファイルが断片化されます。

identityMapに値を含める前に、ターゲット名前空間で想定される形式に従って値を準備します。

標準の名前空間とその定義の完全なリストについては、ID名前空間の概要を参照してください。

実行時にidを収集しています collect-id

必要な識別子がページ上で直接利用可能になることはほとんどありません。 一般的な収集戦略には、次のものがあります。

authenticatedState authenticated-state

authenticatedState フィールドは、特定のIDにどの程度の信頼度を割り当てるかをダウンストリームサービスに伝えます。 このフィールドには次の値が有効です。

primary primary-identity

identityMap ペイロードごとに、primary: trueとしてマークされたIDを1つだけ持つ必要があります。 プライマリ IDは、Experience Platformでイベントのアンカーとして使用されるIDを決定します。

プライマリ IDを設定する場合は、次のガイドラインに従ってください。

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

実装でのIDMapの送信 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がID グラフに与える影響 identity-graph

Experience Platformに到達するidentityMap個のペイロードはID サービス ​によって処理され、送信したIDがID グラフ ​にリンクされます。 どの名前空間を含めるか、どのようにauthenticatedStateを設定するか、そしてどのIDをprimaryとしてマークするかは、Identity Serviceがそれらのグラフを構築および結合する方法を直接形作ります。

注意すべき主な行動：

実装でID グラフ リンク ルール ​ （名前空間の優先順位やID最適化アルゴリズムなど）を使用している場合は、実装ガイド ​を参照して、これらのルールがidentityMapを通じて送信するIDとどのように相互作用するかを理解してください。