isCoopSafe

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

內容:

要求

若要使用 isCoopSafe,您必須:

  • 使用 2.4 版或更新版本的 ID 服務程式碼。

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

  • 請和您的 Adobe 顧問合作,在您的 Device co-op 帳戶上設定白名單或是黑名單標幟。沒有啟用可這些標幟的自助式路徑。

使用案例

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

使用案例 說明

已驗證的訪客

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

第三方網站上的 DIL

新增 isCoopSafe 至您的 ID 服務程式碼,以便在第三方網站上使用;因此,您可能會:

  • 無法確定已驗證的訪客是否已接受使用條款合約。
  • 需要控制 Device Co-op 使用該資料來建立裝置圖形的方式。

語法與程式碼範例

語法: isCoopSafe: true | false

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

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

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

程式碼範例

當您的 ID 服務程式碼實例化時,請進行此設定:

var visitor = Visitor.getInstance("Insert Experience Cloud organization ID here",{ 
     ... 
     isCoopSafe: true 
});

事件呼叫 POST 參數

取決於您設定的標幟 (truefalse),ID 服務將 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 狀態。這是必要的 API,因為它們可讓您變更訪客在頁面未重新整理的網站或單一頁面應用程式中的具現化後/登入後狀態。例如,如果使用者在對您的網站或應用程式進行驗證後,接受了允許 Device Co-op 使用其資料的使用條款原則,您就需要呼叫這些 API。

API 說明

visitor.setAsCoopSafe();

在後續事件呼叫中,設定 POST 參數 d_coop_safe=1

visitor.setAsCoopUnsafe();

在後續事件呼叫中,設定 POST 參數 d_coop_unsafe=1

本頁內容