setCustomerIDs 的 SHA256 雜湊支援 hashing-support

Experience Cloud ID Service (ECID) 支援 SHA-256 雜湊演算法，可讓您傳入客戶 ID 或電子郵件地址，然後傳出雜湊 ID。這是選用的 JavaScript 方法，可將經雜湊處理的識別碼傳送至 Experience Cloud。在傳送客戶 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");

除了 Experience Cloud 訪客 ID 之外，您還可以將其他客戶 ID、驗證狀態和雜湊類型 (SHA-256) 與每個訪客建立關聯。如果您未提供任何雜湊類型，則會視為無雜湊。

setCustomerIDs 方法接受同一位訪客擁有多個客戶 ID。這可幫助您識別或鎖定不同裝置上的個別用戶。例如，您可以將這些 ID 當做客戶屬性上傳到 Experience Cloud，並在不同解決方案中存取此資料。

客戶 ID、已驗證狀態和雜湊類型​ 不會 ​儲存在 Cookie 中以供稍後使用。客戶 ID、已驗證狀態和雜湊類型而是應該儲存在執行個體變數中，以使用 getCustomerIDs 加以擷取，如下所示：

> visitor.getCustomerIDs();
< {email: {…}}
    email: {id: "a6ea4cde5da5ae7cc68baae894d1d6544fca26254433b0fff7c2cb4843b4a097", authState: 1, hashType: "SHA-256"}
    __proto__: Object

使用 setCustomerIDs 方法會呼叫 Experience Cloud 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 參數和驗證狀態的說明。

在 Adobe Experience Platform Launch 中新增動作 add-action-launch

Experience Platform Launch 是新一代 Adobe 標籤管理功能。請在 Launch 產品文件中進一步了解 Platform Launch。

若要在 Launch 中新增動作，請閱讀 Adobe Launch 中的規則文件，並查看下方的螢幕擷圖：

確認您的設定後，Launch 會將資料包裝進物件中，如下所示:

{
    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 方法相似，這會產生對 Experience Cloud ID Service 的呼叫，並加上 d_cid_ic 查詢參數。