[Alpha]{class="badge informative"}

thirdPartyCookiesEnabled (伺服器SDK)

此頁面說明伺服器SDK configure方法中的thirdPartyCookiesEnabled。 若為Web SDK,請參閱thirdPartyCookiesEnabled.

thirdPartyCookiesEnabled屬性決定伺服器SDK是否使用Adobe Audience Manager協力廠商網域adobedc.demdex.net來協助識別訪客。 它也會控制您是否可以要求訪客的核心ID。

此屬性在伺服器上的運作方式 how-it-works

在瀏覽器中,Web SDK會使用協力廠商網域來讀取和設定demdex.net上的Cookie,以協助識別跨網域的訪客。 在伺服器上,請求會直接從您的伺服器傳送到Adobe,因此請求絕不會傳送訪客的demdex.net Cookie,而Adobe在回應中設定的任何demdex.net Cookie都不會傳送到訪客的瀏覽器。

當thirdPartyCookiesEnabled為true (預設)時:

  • 訪客的第一個未驗證要求(來自getIdentity、appendIdentityToUrl或setConsent)會移至adobedc.demdex.net,而非edgeDomain。
  • SDK會向Edge Network要求ECID和核心ID。
  • 您可以使用getIdentity請求CORE名稱空間。 由於請求未隨附訪客的demdex.net Cookie,因此伺服器收到的核心ID可能與訪客瀏覽器中的不相符。

當thirdPartyCookiesEnabled為false時:

  • 所有未驗證的請求都會移至edgeDomain。
  • SDK只會向Edge Network要求ECID。
  • 要求具有getIdentity的CORE名稱空間以錯誤拒絕。

此屬性不影響sendEvent傳送事件的位置。 SDK一律會將事件傳送至已驗證的Edge Network伺服器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
});
recommendation-more-help
experience-platform-help-collection