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 直接。
下表概述資料庫提供的不同功能:
retrieveIdentities
validIds
)的訪客資料 Privacy Service以及找不到的一系列身分(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
- 從下載 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解決方案設定引數.
程式碼範例 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
failedIDs
結果
如果程式碼執行成功, 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
failedIDs
結果
如果程式碼執行成功, 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
Adobe Analytics
cookieDomainPeriods
2
,例如 .domain.com
)。 除非在JavaScript網路信標中指定,否則請勿在此處定義它。dataCenter
Adobe資料收集資料中心。 只有在您的JavaScript網路信標中指定此專案時,才應包含此專案。 可能的值包括:
d1
:聖荷西資料中心d2
:達拉斯資料中心
reportSuite
s_code.js
或 dtm
)。trackingServer
trackingServerSecure
visitorNamespace
Adobe Audience Manager
aamUUIDCookieName
Adobe Experience Cloud Identity服務(ECID)
imsOrgID
Adobe Target
clientCode