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 JS Library提供在Privacy Service中管理身份的幾種功能。 這些函式只能用來管理儲存在瀏覽器中的特定訪客身分。 它們無法用於直接將資訊提交到Experience Cloud Central Service。

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

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

removeIdentities 並且 retrieveThenRemoveIdentities 只會從瀏覽器中移除支援其的特定Adobe解決方案的身分。例如,Adobe Audience Manager不會刪除儲存在第三方Cookie中的Demdex ID,而Adobe Target會刪除儲存其ID的所有Cookie。

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

安裝

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

  • 運行以下命令,使用npm進行安裝:npm install @adobe/adobe-privacy
  • 使用名稱AdobePrivacy下的Adobe啟動副檔名
  • Experience CloudGitHub資料庫下載

實例化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,但您不使用Launch或DTM。

擷取身分

此示例演示如何從Experience Cloud檢索身份清單。

JavaScript

以下代碼定義一個函式handleRetrievedIDs,用作回呼或承諾處理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 JSON物件,包含已成功擷取的所有ID。
failedIDs JSON物件包含所有未從Privacy Service擷取或找不到其他ID。

結果

如果代碼成功執行,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,當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 JSON物件,包含已成功擷取的所有ID。
failedIDs JSON物件包含所有未從Privacy Service擷取或找不到其他ID。

結果

如果代碼成功執行,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開發人員指南

附錄

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

Adobe解配置參數

以下是支援Adobe解決方案的接受組態參數清單,當執行個體化AdobePrivacy物件時,會使用這些參數。

Adobe Analytics

參數 說明
cookieDomainPeriods 用於Cookie追蹤的網域中的句號數(預設為2)。
dataCenter Adobe資料收集資料中心。 只有在JavaScript網站信標中指定時,才應包含此項。 潛在值為:
  • "d1":聖荷西資料中心。
  • "d2":達拉斯資料中心。
reportSuite 報表套裝ID,如JavaScript網站信標中所指定(例如「s_code.js」或「dtm」)。
trackingServer 資料收集網域(非SSL)。 只有在JavaScript網站信標中指定時,才應包含此項。
trackingServerSecure 資料收集網域(SSL)。 只有在JavaScript網站信標中指定時,才應包含此項。
visitorNamespace 用於群組訪客的命名空間。 只有在JavaScript網站信標中指定時,才應包含此項。

Adobe Target

參數 說明
clientCode 用於識別Adobe Target系統中客戶機的客戶機代碼。

Adobe Audience Manager

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

Adobe ID服務(ECID)

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

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now