getIdentity

sendEvent コマンドを実行すると、Web SDKは訪問者のIDがまだ存在しない場合に自動的に取得します。 getIdentity コマンドを使用すると、イベントデータを送信せずに訪問者IDを取得できます。 訪問者IDを生成してデータを送信するために個別の呼び出しが必要な場合は、このコマンドを使用できます。

IMPORTANT
クライアントサイドでID情報が必要な場合は、getIdentityを使用します。 ECIDをXDMにマッピングする必要がある場合のみ、代わりに​ データ収集または​ タグ ECID アクセス ガイダンス ​を使用してください。

getIdentity コマンドは、次のフローを実行してECIDを取得します。

  1. Web SDKを使用して、getIdentityまたはappendIdentityToUrlのいずれかを呼び出します。
  2. Web SDKは、同意情報が提供されるのを待ちます。
  3. Web SDKは、呼び出しでECID名前空間が要求されたかどうかを確認します。 デフォルトでは、ECID名前空間は常に含まれます。
  4. Web SDKはkndctr Cookieを読み取り、その値が存在する場合はECIDとして返します。 これはECID値のみを返し、regionIdは返しません。
  5. kndctr ID Cookieが設定されていないか、"CORE"名前空間が要求された場合、Web SDKはEdge Networkにリクエストを行います。
  6. Edge Networkは、ECIDregionId (および必要に応じてCORE ID)の両方を返します。

Web SDKの設定済みインスタンスを呼び出す際に、getIdentity コマンドを実行します。 このコマンドを設定する際には、次のオプションを使用できます。

  • namespaces:名前空間の配列。 デフォルト値は ["ECID"] です。サポートされているその他の値は次のとおりです。

    • ["CORE"]
    • ["ECID","CORE"]
    • null
    • undefined

    "ECID""CORE ID"を同時にリクエストできます。 例:"namespaces": ["ECID","CORE"]

  • edgeConfigOverrides: ​ データストリーム設定がオブジェクト ​を上書きします。

alloy("getIdentity",{
  // This command retrieves both ECID and CORE IDs
  "namespaces": ["ECID","CORE"]
});

応答オブジェクト

このコマンドで応答を処理する場合、応答オブジェクトで次のプロパティを使用できます。

  • identity.ECID:訪問者のECIDを含む文字列。
  • identity.CORE:訪問者のCORE IDを含む文字列。
  • edge.regionID: IDの取得時にブラウザーがヒットしたEdge Network リージョンを表す整数。 これは、従来のAudience Managerの場所ヒントと同じです。
// Get the visitor's ECID
alloy('getIdentity').then(result => {
  console.log(result.identity.ECID);
});

Web SDK タグ拡張機能を使用したIDの取得

Web SDK タグ拡張機能では、タグ拡張機能UIを使用してこのコマンドを提供しません。 JavaScript ライブラリの構文を使用して、カスタムコードエディターを使用します。

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1