Adobe隱私權JavaScript資料庫概述

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

Adobe隱私權JavaScript資料庫​可讓資料控管單位自動擷取Experience Cloud解決方案針對特定網域產生的所有資料主體身分。 使用Adobe Experience Platform Privacy Service提供的API，這些身分識別就可以用來針對屬於這些資料主體的私人資料建立存取和刪除請求。

函數

Privacy JS Library提供幾個功能，用於管理Privacy Service中的身分。 這些函式只能用於管理儲存在瀏覽器中特定訪客的身分識別。 它們不能用來直接將資訊提交至Experience Cloud Central Service。

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

由於全部三個函式代表非同步程式，因此必須使用回呼或承諾來處理任何擷取的身分。

安裝

若要開始使用Privacy JS Library，您必須使用下列其中一種方法將其安裝在您的電腦上：

您也可以透過標籤擴充功能安裝程式庫。 如需詳細資訊，請參閱Adobe隱私權標籤擴充功能的概觀。

具現化Privacy JS Library

所有使用Privacy JS Library的應用程式都必須將新的AdobePrivacy物件具現化，而且必須將其設定為特定的Adobe解決方案。 例如，Adobe Analytics的例項化看起來類似以下內容：

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

如需不同Adobe解決方案支援的完整引數清單，請參閱附錄中支援的Adobe解決方案組態引數部分。

程式碼範例 samples

下列程式碼範例示範如何將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會填入擷取的身分清單。

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the Visitor 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會填入擷取的身分清單。

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the Visitor 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 Service API指南。

附錄

本節包含使用Privacy JS Library的補充資訊。

Adobe解決方案設定引數 config-params

以下是支援的Adobe解決方案所接受的設定引數清單，在具現化AdobePrivacy物件時使用。

所有解決方案

Adobe Analytics

Adobe Audience Manager

Adobe訪客ID服務(ECID)

Adobe Target