是CoopSafe

選用的布林值設定,可決定 DIL 是否要將資料傳送至 Adobe Experience Cloud Device Co-op。

要求

要使用 isCoopSafe 必須:

  • 使用 DIL v6.11或更高版本。

  • 參與 Experience Cloud Device Co-op。潛在的 Co-op 成員也需審閱此文件,以確定 isCoopSafe 是否解決了關於如何使用資料建立裝置圖形的可能問題。

  • 與 Adobe 顧問,用於在您的設備合作帳戶上設定允許清單或denylist標誌。 沒有可啟用這些標誌的自助服務路徑。

使用個案

isCoopSafe 有助於解決關於 Device co-op 現有或潛在成員資料收集的 2 個使用案例。這些關於網站訪客資料如何傳給 Device co-op 的使用案例有助於建立設備圖形。以下表格說明 isCoopSafe 如何搭配其他使用案例以封鎖或傳送資料給裝置圖形

使用案例 說明

已驗證的訪客

添加 isCoopSafe DIL 用於控制設備合作部如何使用經過驗證的具有或未接受使用期限協定的訪問者的資料來構建設備圖形。

第三方網站上的 DIL

添加 isCoopSafe DIL 用於第三方站點的代碼,您可以:

  • 無法確保已驗證的訪客是否已經接受使用者條款。
  • 需要控制 Device Co-op 使用資料的方式,以建立裝置圖形。

語法與程式碼範例

語法: isCoopSafe: true | false

布林值選項決定 Device Co-op 是否使用客戶資料。

  • isCoopSafe: true: 行動 SDK 或是網站所蒐集的訪客資料​可以​用來協助建立裝置圖形。

  • isCoopSafe: false: 行動 SDK 或是網站所蒐集的訪客資料​不可以​用來協助建立裝置圖形。

程式碼範例

在DIL實例化時設定此設定。

var dilInstance = DIL.create({
     ...
     isCoopSafe: true
});

事件呼叫 POST 參數

根據您設定的標誌( truefalse) DIL 翻譯 isCoopSafe 將這些POST參數發送到 Adobe 在事件呼叫中:

  • d_coop_safe=1
  • d_coop_unsafe=1

POST 參數告知 Experience Cloud Device Co-op 是否能在裝置圖像中包含使用者資料。以下表格定義了在事件呼叫中 isCoopSafe 布林值標幟與所傳遞的 POST 參數之間的關係。如果您沒有使用 isCoopSafe,這些都不會在事件呼叫中傳遞。

設定狀態 POST 參數

isCoopSafe: true

d_coop_safe=1

Device Co-op 可以使用訪客資料來協助建立裝置圖像。

isCoopSafe: false

d_coop_unsafe=1

Device Co-op 不可以使用訪客資料來協助建立裝置圖像。

Post-Instantiation API

這些 API 允許您覆寫 isCoopSafe 狀態。這些都是必要措施,因為它們可以讓您在網站或未重新整理的單頁應用程式中變更訪客實例化之後/登錄之後的狀態。舉例來說,如果用戶向您的網站或應用程式進行身份驗證,並隨後接受使用者條款原則允許 Device Co-op 使用其資料,則您可能需要呼叫這些 API。

API 說明

dilInstance.api.setAsCoopSafe();

設定POST參數 d_coop_safe=1 所有後續事件調用。

dilInstance.api.setAsCoopUnsafe();

設定POST參數 d_coop_unsafe=1 所有後續事件調用。

本頁內容