isCoopSafe

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

內容:

• 需求
• 使用案例
• 語法與程式碼範例
• 事件呼叫 POST 參數
• Post-Instantiation API

要求

若要使用 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: 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 參數

取決於您設定的標幟 (true 或 false)，ID 服務將 isCoopSafe 轉譯為 POST 參數並在事件呼叫時將參數傳送至 Adobe:

• d_coop_safe=1
• d_coop_unsafe=1

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

Post-Instantiation API

這些 API 允許您覆寫 isCoopSafe 狀態。這是必要的 API，因為它們可讓您變更訪客在頁面未重新整理的網站或單一頁面應用程式中的具現化後/登入後狀態。例如，如果使用者在對您的網站或應用程式進行驗證後，接受了允許 Device Co-op 使用其資料的使用條款原則，您就需要呼叫這些 API。