このページでは、Server SDK configure メソッドのthirdPartyCookiesEnabledについて説明します。 Web SDKについては、thirdPartyCookiesEnabledを参照してください。
thirdPartyCookiesEnabled プロパティは、Server SDKがAdobe Audience Manager サードパーティ ドメイン adobedc.demdex.netを使用して訪問者を識別するかどうかを決定します。 また、訪問者のCORE IDをリクエストできるかどうかも制御します。
このプロパティがサーバー上でどのように機能するか how-it-works
ブラウザーでは、Web SDKはサードパーティのドメインを使用してdemdex.netにCookieを読み取り、設定します。これは、ドメイン間で訪問者を識別するのに役立ちます。 サーバー上では、リクエストはサーバーから直接Adobeに送信されるため、訪問者のdemdex.net Cookieと、レスポンスでAdobeが設定したdemdex.net Cookieが訪問者のブラウザーに届くことはありません。
thirdPartyCookiesEnabledがtrueの場合、これはデフォルトです。
- 訪問者の最初の未認証のリクエスト（
getIdentity、appendIdentityToUrl、またはsetConsent）は、edgeDomainではなくadobedc.demdex.netに送信されます。 - SDKは、Edge NetworkにECIDとCORE IDの両方を要求します。
CORE名前空間をgetIdentityでリクエストできます。 リクエストには訪問者のdemdex.netCookieが含まれていないため、サーバーが受信するCORE IDが訪問者のブラウザーのIDと一致しない可能性があります。
thirdPartyCookiesEnabledがfalseの場合：
- 未認証のリクエストはすべて
edgeDomainに送信されます。 - SDKは、Edge NetworkにECIDのみを要求します。
getIdentityを含むCORE名前空間を要求すると、エラーが発生して拒否されます。
このプロパティは、sendEventがイベントを送信する場所には影響しません。 SDKは、常に認証済みのEdge Network Server APIにイベントを送信します。
CORE IDが必要でない限り、thirdPartyCookiesEnabledをfalseに設定して、すべてのリクエストが設定したedgeDomainに送信されるようにしてください。
コード例
configureを呼び出すときにthirdPartyCookiesEnabled ブール値を設定します。 省略すると、デフォルトはtrueになります。
await alloy.configure({
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
edgeCredentials: {
clientId: process.env.ADOBE_CLIENT_ID,
clientSecret: process.env.ADOBE_CLIENT_SECRET,
scopes: process.env.ADOBE_SCOPES.split(",")
},
thirdPartyCookiesEnabled: false
});