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

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

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

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

安裝

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

實例化 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 未使用或DTM的情況下,將它用於數種常見 Launch 的案例。

擷取身分

此示例演示如何從中檢索身份清單 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 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。

本頁內容