getIdentity
sendEvent コマンドを実行すると、Web SDKは訪問者のIDがまだ存在しない場合に自動的に取得します。 getIdentity コマンドを使用すると、イベントデータを送信せずに訪問者IDを取得できます。 訪問者IDを生成してデータを送信するために個別の呼び出しが必要な場合は、このコマンドを使用できます。
IMPORTANT
クライアントサイドでID情報が必要な場合は、
getIdentityを使用します。 ECIDをXDMにマッピングする必要がある場合のみ、代わりに データ収集または タグ ECID アクセス ガイダンス を使用してください。getIdentity コマンドは、次のフローを実行してECIDを取得します。
- Web SDKを使用して、
getIdentityまたはappendIdentityToUrlのいずれかを呼び出します。 - Web SDKは、同意情報が提供されるのを待ちます。
- Web SDKは、呼び出しで
ECID名前空間が要求されたかどうかを確認します。 デフォルトでは、ECID名前空間は常に含まれます。 - Web SDKは
kndctrCookieを読み取り、その値が存在する場合はECIDとして返します。 これはECID値のみを返し、regionIdは返しません。 kndctrID Cookieが設定されていないか、"CORE"名前空間が要求された場合、Web SDKはEdge Networkにリクエストを行います。- Edge Networkは、
ECIDとregionId(および必要に応じてCORE ID)の両方を返します。
Web SDKの設定済みインスタンスを呼び出す際に、getIdentity コマンドを実行します。 このコマンドを設定する際には、次のオプションを使用できます。
-
namespaces:名前空間の配列。 デフォルト値は["ECID"]です。サポートされているその他の値は次のとおりです。["CORE"]["ECID","CORE"]nullundefined
"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