Show Menu
主題×

isCoopSafe

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

要求

To use isCoopSafe you must:
  • 使 DIL 用v6.11或更新版本。
  • 參與 Experience Cloud Device Co-op 。潛在的 Co-op 成員也需審閱此文件,以確定 isCoopSafe 是否解決了關於如何使用資料建立裝置圖形的可能問題。
  • 請和您的 Adobe 顧問合作,在您的 Device co-op 帳戶上設定白名單或是黑名單標幟。沒有自助路徑可啟用這些標誌。

使用個案

isCoopSafe 有助於解決關於 Device co-op 現有或潛在成員資料收集的 2 個使用案例。這些關於網站訪客資料如何傳給 Device co-op 的使用案例有助於建立設備圖形。以下表格說明 isCoopSafe 如何搭配其他使用案例以封鎖或傳送資料給裝置圖形
使用案例 說明
已驗證的訪客
Add isCoopSafe to your DIL code to control how data for authenticated visitors who have or have not accepted term-of-use agreements is used by the Device Co-op to build the device graph.
第三方網站上的 DIL
Add isCoopSafe to your DIL code for use on third-party sites where you:
  • 無法確保已驗證的訪客是否已經接受使用者條款。
  • 需要控制 Device Co-op 使用資料的方式,以建立裝置圖形。

語法與程式碼範例

語法: isCoopSafe: true | false
布林值選項決定 Device Co-op 是否使用客戶資料。
  • isCoopSafe: true : 行動 SDK 或是網站所蒐集的訪客資料​ 可以 ​用來協助建立裝置圖形。
  • isCoopSafe: false : 行動 SDK 或是網站所蒐集的訪客資料​ 不可以 ​用來協助建立裝置圖形。
程式碼範例
當DIL執行個體化時設定此值。
var dilInstance = DIL.create({ 
     ... 
     isCoopSafe: true 
});

事件呼叫 POST 參數

Depending on the flag you set ( true or false ), DIL translates isCoopSafe into these POST parameters and sends them to Adobe in an event call:
  • 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