このページでは、Server SDK appendIdentityToUrl メソッドについて説明します。 Web SDKについては、appendIdentityToUrlを参照してください。
appendIdentityToUrl メソッドは、訪問者のIDをadobe_mcという名前のクエリ文字列パラメーターとしてURLに追加します。 訪問者が所有している別のドメインのURLに従うと、そのドメインのWeb SDKまたはServer SDKはパラメーターを読み取り、同じExperience Cloud ID （ECID）を保持します。 これにより、両方のドメインを含むデータセットで訪問者が2回カウントされるのを防ぎます。
サーバーでは、一般的に、訪問者のIDを別のドメインへのリダイレクトに追加します。
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
const { url } = await visitor.appendIdentityToUrl({
url: "https://shop.example.net/checkout"
});
res.writeHead(302, { Location: url });
res.end();
結果のURLは次のようになります。
https://shop.example.net/checkout?adobe_mc=TS%3D1792711449%7CMCMID%3D34567890123456789012345678901234567890%7CMCORGID%3DADB3LETTERSANDNUMBERS%2540AdobeOrg
SDKがまだ訪問者のECIDを持っていない場合は、まずEdge NetworkからECIDをリクエストします。 そのリクエストは未認証です。 データストリーム アクセス タイプの設定を参照してください。
訪問者がオプトアウトした場合、またはdefaultConsentが"out"で、訪問者がオプトインしていない場合、メソッドはURLを変更せずに返します。 また、ネットワークエラーなどのために訪問者のIDを取得できない場合は、拒否の代わりにURLを変更せずに返します。 デバッグ が有効になっている場合、SDKはUnable to append identity to urlを含む警告をログに記録します。
オプション options
appendIdentityToUrl メソッドは、次のプロパティを持つオブジェクトを受け入れます。
url：必須。 訪問者のIDを追加するURL。edgeConfigOverrides：この要求に対して データストリーム設定がオブジェクト を上書きします。
結果オブジェクト result
appendIdentityToUrl メソッドはpromiseを返します。 解決すると、結果オブジェクトに url が含まれ、adobe_mc クエリ文字列パラメーターが追加されたURLが含まれます。