文件Experience PlatformWeb SDK 指南

defaultConsent

Last update: Tue Jul 23 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員

defaultConsent屬性決定您在呼叫setConsent命令之前如何處理資料收集同意。 如果您不想不小心從居住於收集資料前需要同意之區域的個人收集資料，此屬性就十分實用。

根據預設，使用者會選擇加入所有用途，而Web SDK獲准執行下列工作：

  • 傳送資料至Adobe的伺服器並從中傳送。
  • 讀取和寫入Cookie或Web儲存專案。

如果使用者選擇退出所有用途，Web SDK不會執行任何這些工作。

defaultConsent屬性支援三個值：

  • in：資料收集會正常進行，直到使用者選擇退出為止。
  • out：資料會永久捨棄，直到使用者選擇加入為止。
  • pending：資料會儲存在本機，直到使用者使用setConsent命令選擇加入為止。 當一般用途的預設同意設定為pending時，嘗試執行任何依賴使用者選擇加入偏好設定的命令（例如sendEvent命令）會導致命令在Web SDK中排入佇列。 只有在您將使用者的選擇加入偏好設定傳達給Web SDK後，才會處理佇列的命令。
NOTE
同意資料不會在頁面載入之間持續存在。

如果您的訪客不在一般資料保護規範(GDPR)的管轄範圍內，則預設同意可設為in。 GDPR管轄區內的訪客可將其預設同意設定為pending。 您的同意管理平台(CMP)可以偵測客戶的區域，並向IAB TCF 2.0提供標幟gdprApplies。此旗標可用於設定預設同意。

如果您不想收集在設定使用者的選擇加入偏好設定之前發生的事件，您可以在Web SDK設定期間傳遞"defaultConsent": "out"。 在您將使用者的選擇加入偏好設定傳達給Web SDK之前，嘗試執行任何取決於使用者選擇加入偏好設定的命令將不會生效。

NOTE
目前，Web SDK僅支援單一「全有」或「全無」用途。 雖然我們計畫建立更強大的用途或類別集，以便對應不同的Adobe功能和產品方案，但目前的實作方式是全有或全無選擇加入。 這僅適用於Web SDK，不適用於其他AdobeJavaScript資料庫。

Web SDK提供兩種互補的同意設定命令：

  • defaultConsent：這個命令的用意是擷取使用Web SDK的Adobe客戶的同意偏好設定。
  • setConsent：這個命令的用意是擷取網站訪客的同意偏好設定。

搭配使用時，這些設定可能會產生不同的資料收集和Cookie設定結果，具體取決於其設定的值。

請參閱下表以瞭解何時進行資料收集，以及何時根據同意設定設定Cookie。

defaultConsent
setConsent
發生資料收集
Web SDK會設定瀏覽器Cookie
in
in
是
是
in
out
無
是
in
未設定
是
是
pending
in
是
是
pending
out
無
是
pending
未設定
無
無
out
in
是
是
out
out
無
是
out
未設定
無
無

同意設定允許時，將會設定下列Cookie：

名稱
最大年齡
說明
AMCV_###@AdobeOrg
34128000 （395天）
idMigrationEnabled啟用時出現。 當網站某些部分仍在使用visitor.js時，轉換為Web SDK會有所幫助。
Demdex Cookie
15552000 （180天）
在啟用ID同步時顯示。 Audience Manager設定此Cookie以指派唯一ID給網站訪客。 demdex Cookie可協助Audience Manger執行基本功能，例如：訪客身分識別、ID同步化、分割、模型、報告等。
kndctr_orgid_cluster
1800 （30分鐘）
儲存Edge Network區域，為目前使用者的請求提供服務。 URL路徑會使用地區，這樣Edge Network就能將請求路由至正確的地區。 如果使用者使用不同的IP位址或在不同的工作階段中連線，則請求會再次路由到最近的區域。
kndct_orgid_identity
34128000 （395天）
儲存ECID以及與ECID相關的其他資訊。
kndctr_orgid_consent
15552000 （180天）
儲存網站的使用者同意偏好設定。
s_ecid
63115200 （2年）
包含Experience CloudID (ECID)或MID的復本。 MID 儲存在遵循下列語法的機碼-值組中：s_ecid=MCMID|<ECID>。

使用Web SDK標籤擴充功能設定預設同意

在設定標籤延伸模組時，在​ 預設同意 ​下選取所需的選項按鈕。

  1. 使用您的Adobe ID憑證登入experience.adobe.com。
  2. 導覽至​ 資料彙集 > 標籤。
  3. 選取所需的標籤屬性。
  4. 導覽至​ 擴充功能，然後按一下Adobe Experience Platform Web SDK卡片上的​ 設定。
  5. 向下捲動至隱私權區段，然後選取所需的​ 預設同意。
  6. 按一下​ 儲存，然後發佈您的變更。

使用Web SDK JavaScript資料庫設定預設同意

執行configure命令時，將defaultConsent字串屬性設定為所需的同意等級。 此屬性區分大小寫，僅支援下列三個值： "in"、"out"及"pending"。 如果您嘗試使用任何其他值，程式庫會擲回錯誤。

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  defaultConsent: "pending"
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636