Show Menu
主題×

Adobe隱私權JavaScript程式庫概觀

身為資料處理者,Adobe會根據您公司的許可和指示處理個人資料。 身為資料控管方,您可以決定要由 Adobe 代表您處理和儲存哪些個人資料。根據您選擇透過Adobe Experience Cloud解決方案傳送的資訊,Adobe可儲存適用於隱私權法規(例如通用資料保護規則(GDPR)和加州消費者隱私法(CCPA))的私人資訊。 如需Experience Cloud解決方 案如何收集私人資料的詳細資訊,請參閱Adobe Experience Cloud中的隱私權檔案
Adobe隱 私權JavaScript程式庫 ,讓資料掌控者自動擷取Experience Cloud解決方案針對特定網域產生的所有資料主體身分。 然後,使用 Adobe Experience Platform Privacy Service提供的API ,這些身分識別可用於建立屬於這些資料主體的私人資料的存取和刪除要求。
隱私權JS程式庫通常只需要安裝在隱私權相關頁面,也不需要安裝在網站或網域的所有頁面上。

函數

「隱私權JS庫」提供數種在隱私權服務中管理身分的功能。 這些函式只能用來管理儲存在瀏覽器中的特定訪客身分。 無法用來直接將資訊送出至Experience Cloud Central Service。
下表概述程式庫提供的不同功能:
函數
說明
retrieveIdentities
傳回從隱私權服務擷取的相符身分識別( validIds )陣列,以及找不到( failedIds )的身分識別。
removeIdentities
從瀏覽器移除每個相符(有效)的識別。 傳回符合身分的陣列( validIds ),每個身分包含一個布林值,指 isDeleteClientSide 出此ID是否已刪除。
retrieveThenRemoveIdentities
擷取符合身分的陣列( validIds ),然後從瀏覽器移除這些身分。 雖然此函式類似 removeIdentities ,但您使用的Adobe解決方案在可能刪除之前需要存取請求時,最好使用此函式(例如在刪除請求中提供唯一識別碼之前必須先擷取此唯一識別碼)。
而且 removeIdentities retrieveThenRemoveIdentities 會從瀏覽器移除支援特定Adobe解決方案的身分識別。 例如,Adobe Audience Manager不會刪除儲存在第三方Cookie中的Demdex ID,而Adobe Target會刪除儲存其ID的所有Cookie。
由於這三個函式都代表非同步進程,所以必須使用回呼或承諾來處理任何擷取的身分。

安裝

若要開始使用「隱私權JS程式庫」,您必須使用下列其中一種方法,將它安裝在您的電腦上:
  • 運行以下命令,使用npm進行安裝: npm install @adobe/adobe-privacy
  • 使用名稱下的Adobe Launch Extension AdobePrivacy
  • 從https://github.com/Adobe-Marketing-Cloud/adobe-privacy下

實例化隱私權JS庫

所有使用隱私權JS資料庫的應用程式都必須執行個 AdobePrivacy 體化新物件,此物件必須設定為特定的Adobe解決方案。 例如,Adobe Analytics的執行個體化看起來類似下列:
var adobePrivacy = new AdobePrivacy({
    imsOrgID: "{IMS_ORG}",
    key: "{DATA_SUBJECT_ID}",
    reportSuite: "{REPORT_SUITE_ID}",
    trackingServer: "{SERVER_URL}",
    clientCode: "{TARGET_CLIENT_CODE}"
});

如需不同Adobe解決方案支援參數的完整清單,請參閱附錄章節中有關支援的 Adobe解決方案組態參數

程式碼範例

下列程式碼範例示範如何針對數個常見案例使用隱私權JS程式庫,但您不使用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
包含所有未從隱私權服務擷取或找不到其他ID的JSON物件。

結果

如果代碼成功執行, 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
包含所有未從隱私權服務擷取或找不到其他ID的JSON物件。

結果

如果代碼成功執行, 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
}

後續步驟

閱讀本檔案後,您便瞭解隱私權JS資料庫的核心功能。 使用程式庫擷取身分清單後,您可以使用這些身分來建立資料存取和刪除隱私權服務API的要求。 如需詳細 資訊,請參閱隱私服務開發人員指南

附錄

本節包含使用隱私權JS程式庫的補充資訊。

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。