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 Service. 這些函式只能用於管理針對特定訪客儲存在瀏覽器中的身分識別。 它們不能用來將資訊提交至 Experience Cloud Central Service 直接。

下表概述資料庫提供的不同功能：

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

安裝

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

• 執行下列命令，使用npm安裝： npm install @adobe/adobe-privacy
• 從下載 Experience CloudGitHub存放庫

您也可以透過標籤擴充功能安裝程式庫。 請參閱以下文章的概觀： 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解決方案設定引數.

程式碼範例

下列程式碼範例示範如何使用 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 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 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解決方案設定引數

以下為受支援Adobe解決方案接受的設定引數清單，用於 具現化AdobePrivacy物件.

所有解決方案

Adobe Analytics

Adobe Audience Manager

Adobe Experience Cloud Identity服務(ECID)

Adobe Target