Adobe隱私權JavaScript程式庫概觀

身為資料處理者,Adobe會根據貴公司的權限和指示處理個人資料。 身為資料控管方,您可以決定要由 Adobe 代表您處理和儲存哪些個人資料。根據您選擇透過Adobe Experience Cloud解決方案傳送的資訊,Adobe可儲存適用於隱私權法規的私人資訊,例如 General Data Protection Regulation (GDPR)和 California Consumer Privacy Act (CCPA)。 請參閱 Adobe Experience Cloud的隱私權 如需Experience Cloud解決方案如何收集私人資料的詳細資訊。

Adobe隱私權JavaScript程式庫 可讓資料控制者自動擷取由 Experience Cloud 特定網域的解決方案。 使用由提供的API Adobe Experience Platform Privacy Service,則這些身分接著便可用來針對屬於這些資料主體的私人資料建立存取和刪除請求。

注意

此 Privacy JS Library 通常只需要安裝在隱私權相關頁面上,且不需要安裝在網站或網域的所有頁面上。

函式

此 Privacy JS Library 提供管理 Privacy Service. 這些函式只能用來管理儲存在瀏覽器中的特定訪客身分。 無法用於向 Experience Cloud Central Service 直接。

下表概述程式庫提供的不同函式:

函數 說明
retrieveIdentities 傳回相符身分的陣列(validIds),從 Privacy Service,以及找不到的身分陣列(failedIds)。
removeIdentities 從瀏覽器中移除每個相符(有效)的身分。 傳回相符身分的陣列(validIds),而每個身分包含 isDeletedClientSide 布林值,指出此ID是否已刪除。
retrieveThenRemoveIdentities 擷取相符身分的陣列(validIds),然後從瀏覽器移除這些身分。 此函式類似於 removeIdentities,最好在您使用的Adobe解決方案要求存取請求才能刪除時使用(例如在刪除請求中提供之前必須擷取唯一識別碼)。
注意

removeIdentitiesretrieveThenRemoveIdentities 僅會針對支援的特定Adobe解決方案,從瀏覽器移除身分。 例如,Adobe Audience Manager不會刪除儲存在協力廠商Cookie中的Demdex ID,而Adobe Target會刪除儲存其ID的所有Cookie。

由於這三個函式都代表非同步處理,因此任何擷取的身分識別都必須使用回呼或承諾來處理。

安裝

若要開始使用 Privacy JS Library,您必須使用下列其中一種方法將其安裝至電腦:

您也可以透過資料收集UI中的標籤擴充功能來安裝程式庫。 請參閱 Adobe隱私權標籤擴充功能 以取得更多資訊。

實例化 Privacy JS Library

利用 Privacy JS Library 必須具現化新 AdobePrivacy 物件,必須設定為特定Adobe解決方案。 例如,Adobe Analytics的具現化看起來類似下列:

var adobePrivacy = new AdobePrivacy({
    imsOrgID: "{IMS_ORG}",
    reportSuite: "{REPORT_SUITE_ID}",
    trackingServer: "{SERVER_URL}",
    clientCode: "{TARGET_CLIENT_CODE}"
});

如需不同Adobe解決方案支援的參數完整清單,請參閱附錄中關於支援的部分 Adobe解決方案配置參數.

程式碼範例

下列程式碼範例示範如何使用 Privacy JS Library 若為數個常見案例,前提是您未使用標籤。

擷取身分

此範例示範如何從擷取身分清單 Experience Cloud.

JavaScript

下列程式碼定義函式, handleRetrievedIDs,可作為回呼或Promise,處理由擷取的身分識別 retrieveIdentities.

function handleRetrievedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

// If using callbacks:
adobePrivacy.retrieveIdentities(handleRetrievedIDs);

// If using promises:
adobePrivacy.retrieveIdentities().then(handleRetrievedIDs);
變數 說明
validIds 包含已成功擷取之所有ID的JSON物件。
failedIDs 包含所有未從擷取之ID的JSON物件 Privacy Service,或找不到。

結果

如果代碼執行成功, validIDs 會填入擷取的身分清單。

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the ID Service.",
    "value": "79352169365966186342525781172209986543"
},
{
    "company": "adobe",
    "namespace": "gsurfer_id",
    "namespaceId": 411,
    "type": "standard",
    "value": "WqmIJQAAB669Ciao"
}

移除身分

此範例示範如何從瀏覽器移除身分清單。

JavaScript

下列程式碼定義函式, handleRemovedIDs,可作為回呼或Promise,處理由擷取的身分識別 removeIdentities 從瀏覽器移除後才會執行。

function handleRemovedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

// If using callbacks:
adobePrivacy.removeIdentities(handleRemovedIDs);

// If using promises:
adobePrivacy.removeIdentities().then(handleRemovedIDs)…
變數 說明
validIds 包含已成功擷取之所有ID的JSON物件。
failedIDs 包含所有未從擷取之ID的JSON物件 Privacy Service,或找不到。

結果

如果代碼執行成功, validIDs 會填入擷取的身分清單。

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the ID Service.",
    "value": "79352169365966186342525781172209986543",
    "isDeletedClientSide": false
},
{
    "company": "adobe",
    "namespace": "AMO",
    "namespaceId": 411,
    "type": "standard",
    "value": "WqmIJQAAB669Ciao",
    "isDeletedClientSide": true
}

後續步驟

閱讀本檔案後,您便了解 Privacy JS Library. 使用程式庫來擷取身分清單後,您可以使用這些身分來建立資料存取,以及刪除 Privacy Service API。 請參閱 Privacy ServiceAPI指南 以取得更多資訊。

附錄

本節包含使用 Privacy JS Library.

Adobe解決方案配置參數

以下是支援的Adobe解決方案所接受的設定參數清單,用於 具現化AdobePrivacy物件.

所有解決方案

參數 說明
key 識別使用者或資料主體的唯一ID。 此屬性旨在用於您自己的內部追蹤用途,不供Adobe使用。

Adobe Analytics

參數 說明
cookieDomainPeriods 用於Cookie追蹤的網域中的句點數(預設為 2,例如 .domain.com)。 除非在JavaScript網站信標中指定,否則請勿在此處定義。
dataCenter Adobe資料收集資料中心。 只有在JavaScript Web信標中指定時,才應包含此資訊。 潛在值包括:
  • d1:聖荷西資料中心
  • d2:達拉斯資料中心
reportSuite JavaScript網站信標中指定的報表套裝ID(例如 s_code.jsdtm)。
trackingServer 非SSL資料收集網域。 只有在JavaScript Web信標中指定時,才應包含此資訊。
trackingServerSecure SSL資料收集網域。 只有在JavaScript Web信標中指定時,才應包含此資訊。
visitorNamespace 用於群組訪客的命名空間。 只有在JavaScript Web信標中指定時,才應包含此資訊。

Adobe Audience Manager

參數 說明
aamUUIDCookieName 包含從Adobe Audience Manager傳回之不重複使用者ID的第一方Cookie名稱。

Adobe Experience Cloud Identity Service(ECID)

參數 說明
imsOrgID 您的IMS組織ID。

Adobe Target

參數 說明
clientCode 在Adobe Target系統中識別用戶端的用戶端代碼。

本頁內容