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,這些身分識別可用於針對屬於這些資料主體的私人資料建立存取和刪除請求。

NOTE
此 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解決方案需要先存取要求才能刪除時(例如必須先擷取唯一識別碼,才能在刪除要求中提供),最好使用此專案。
NOTE
removeIdentitiesretrieveThenRemoveIdentities 僅針對支援身分識別的特定Adobe解決方案,從瀏覽器中將其移除。 例如,Adobe Audience Manager不會刪除儲存在協力廠商Cookie中的Demdex ID,而Adobe Target會刪除所有儲存其ID的Cookie。

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

安裝

若要開始使用 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
包含所有成功擷取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 Service API指南 以取得詳細資訊。

附錄

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

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

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

所有解決方案

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

Adobe Analytics

參數
說明
cookieDomainPeriods
網域中用於Cookie追蹤的句點數(預設為 2,例如 .domain.com)。 除非在JavaScript網路信標中指定,否則請勿在此處定義它。
dataCenter

Adobe資料收集資料中心。 只有在您的JavaScript網路信標中指定此專案時,才應包含此專案。 可能的值包括:

  • d1:聖荷西資料中心
  • d2:達拉斯資料中心
reportSuite
JavaScript網路信標中指定的報表套裝ID (例如: s_code.jsdtm)。
trackingServer
非SSL資料收集網域。 只有在您的JavaScript網路信標中指定此專案時,才應包含此專案。
trackingServerSecure
ssl資料收集網域。 只有在您的JavaScript網路信標中指定此專案時,才應包含此專案。
visitorNamespace
用於對訪客進行分組的名稱空間。 只有在您的JavaScript網路信標中指定此專案時,才應包含此專案。

Adobe Audience Manager

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

Adobe Experience Cloud Identity服務(ECID)

參數
說明
imsOrgID
您的組織 ID。

Adobe Target

參數
說明
clientCode
在Adobe Target系統中識別使用者端的使用者端代碼。
recommendation-more-help
9cbf7061-a312-49f7-aaf8-a10885d53580