setCustomerIDs 的 SHA256 雜湊支援 hashing-support
訪客ID服務(ECID)支援SHA-256雜湊演演算法,可讓您傳入客戶ID或電子郵件地址,然後傳出雜湊ID。 這是選用的Javascript方法,可將經雜湊處理的識別碼傳送至CX Enterprise。 在傳送客戶 ID 之前,您可以繼續使用自己的雜湊方法。有兩種方法可使用 setCustomerIDs 實作雜湊支援,如下節所述:
在 ECID 中使用 setCustomerIDs 方法 use-setcustomerids-method
第一個方法是使用 setCustomerIDs (customerIDs<object>、hashType<string>) 方法。
在雜湊處理前,ECID 程式庫會對 customerIDs 執行資料標準化。 此程序會修剪 customerIDs 頭尾兩端的空格,並將所有字元轉換為小寫字母。 例如,若是電子郵件地址:「 ecid@adobe.com 」會變成「ecid@adobe.com」
請參閱下面的程式碼範例,瞭解如何使用 SHA-256 雜湊來設定單一客戶 ID (即上述電子郵件地址)。
// Set single customerID with SHA-256 hashing
visitor.setCustomerIDs({email: {id: "ecid@adobe.com", authState: 1}}, "SHA-256");
除了ECID之外,您還可以將其他客戶ID、驗證狀態和雜湊型別(SHA-256)與每個訪客建立關聯。 如果您未提供任何雜湊類型,則會視為無雜湊。
setCustomerIDs 方法接受同一位訪客擁有多個客戶 ID。 這可幫助您識別或鎖定不同裝置上的個別用戶。 例如,您可以將這些ID上傳為客戶屬性至CX Enterprise,並在不同的解決方案中存取這些資料。
客戶 ID、已驗證狀態和雜湊類型 不會 儲存在 Cookie 中以供稍後使用。 客戶 ID、已驗證狀態和雜湊類型而是應該儲存在執行個體變數中,以使用 getCustomerIDs 加以擷取,如下所示:
> visitor.getCustomerIDs();
< {email: {…}}
email: {id: "a6ea4cde5da5ae7cc68baae894d1d6544fca26254433b0fff7c2cb4843b4a097", authState: 1, hashType: "SHA-256"}
__proto__: Object
使用setCustomerIDs方法會呼叫Visitor ID Service,呼叫dpm.demdex.net,並加上d_cid_ic查詢引數(包含雜湊的客戶ID)。 範例呼叫看起來可能如下所示。 已新增分行以避免混淆。
http://dpm.demdex.net/id?d_visid_ver=4.4.0&d_fieldgroup=AAM&d_rtbd=json&d_ver=2&
d_orgid=12A3F3F459CE0AD80A495CBE%40AdobeOrg&d_nsid=0&d_mid=12349850857640731290890207735189050123&
d_blob=6G1ynYcLPuiQxYZrsz_pkqfLG9yMXBpb2zX5dvJdYQJzPXImdj0y&
d_cid_ic=email%a6ea4cde5da5ae7cc68baae894d1d6544fca26254433b0fff7c2cb4843b4a097%011&
ts=1563299964843
請參閱下表,以瞭解 d_cid_ic 參數和驗證狀態的說明。
d_cid_ic將整合代碼、唯一使用者ID (DPUUID)和驗證狀態ID傳遞至訪客ID服務。 以非列印用的控制字元將整合代碼和DPUUID隔開%01:
範例: d_cid_ic=Integration_code%01DPUUID%01Authentication_state
驗證狀態
這是 d_cid_ic 參數中的選用 ID。 以整數方式呈現,而且能根據下列用戶的驗證狀態來識別用戶:
- 0 (未知或從未驗證)
- 1 (目前已針對此執行個體/頁面/應用程式內容驗證)
- 2 (登出)
範例:
- 未知:…d_cid=123%01456%010
- 已驗證:…d_cid=123%01456%011
- 已登出:…d_cid=123%01456%012
在標籤中新增動作 add-action-launch
Adobe Experience Platform Data Collection中的標籤是新一代Adobe標籤管理功能。 請閱讀標籤檔案中的詳細資訊。
若要在標籤中新增動作,請閱讀規則檔案,並檢視下方的熒幕擷取:
確認您的設定後,標籤會將資料包裝進物件中,如下所示:
{
integration_code: {
id: "value",
authState: auth_state,
hashType: "hash_algorithm"
}
}
以下是程式碼範例:
// Set single customer ID with hash type
setCustomerIDs(Ingeration code: {
id: "string_value",
authState: auth_state,
hashType: "hash_algorithm"
});
與第一節所述的setCustomerIDs方法類似,這會產生對訪客ID服務的呼叫,並加上d_cid_ic查詢引數。