isCoopSafe

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

要求

若要使用isCoopSafe,您必須:

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

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

  • 請與您的Adobe顧問合作,在您的Device co-op帳戶上設定允許清單或封鎖清單標幟。 沒有自助路徑可啟用這些標幟。

使用個案

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

使用案例 說明

已驗證的訪客

isCoopSafe 新增至您的DIL程式碼,以控制Device Co-op如何使用已驗證且接受或未接受使用條款的訪客資料來建立裝置圖形。

第三方網站上的 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

本頁內容