驗證擴充功能

Identity Service擴充功能是少數標籤擴充功能的其中之一,不必使用規則動作即可提出請求。 擴充功能會自動在網站第一個造訪的第一個頁面載入時,向 Identity Service 提出請求。請求 ID 之後,會儲存在開頭為「AMCV_」的第一方 Cookie 中。

驗證 Identity Service 擴充功能的方式

  1. 開啟 Luma 網站

  2. 先前的課程所述,確認Debugger將標籤屬性對應至​ 您的 ​開發環境。

  3. 在Debugger的「摘要」標籤上,「標籤」區段應會顯示已實施Adobe Experience Platform Identity Service擴充功能。

  4. 此外,在「摘要」標籤上,「Identity Service」區段應該會填入「資料收集」介面的擴充功能設定畫面上顯示的相同組織ID:

    檢查 Adobe Experience Platform Identity Service 擴充功能是否已實施

  5. 擷取訪客 ID 的初始請求可能會顯示在 Debugger 的「Identity Service」標籤中。不過可能已請求過此項目,因此如果您沒有看到該請求,請不要擔心:
    檢查是否有使用您的組織 ID 向 Identity Service 提出的請求

  6. 在擷取 Visitor ID 的初始請求之後,ID 會儲存在名稱開頭為 AMCV_ 的 Cookie 中。您可以執行下列操作,確認是否已設定 Cookie:

    1. 開啟瀏覽器的開發人員工具

    2. 前往 Application 標籤

    3. 展開左側的 Cookies

    4. 按一下 https://luma.enablementadobe.com 網域

    5. 尋找右側的 AMCV_ Cookie。您可能會看到自那時起已使用硬式編碼標籤屬性及對映至您自己的屬性載入Luma網站的數個。

      驗證 AMCV_ Cookie

完成了!您已新增第一個擴充功能!有關 Identity Service 設定選項的詳細資訊,請參閱本文件

傳送客戶 ID

接下來要將客戶 ID 傳送至 Identity Service。這可讓您整合 CRM 與 Experience Cloud,且可跨裝置追蹤訪客。

在先前的新增資料元素、規則和程式庫課程中,您已建立資料元素並將其用於規則中。現在,您將使用這些相同的技巧,在訪客通過驗證時傳送客戶 ID。

建立客戶 ID 的資料元素

首先,請建立兩個資料元素:

  1. Authentication State:擷取訪客是否已登入
  2. Email (Hashed):從資料層擷取雜湊版本的電子郵件地址 (用來作為客戶 ID)

為 Authentication State 建立資料元素的方式

  1. 按一下左側導覽中的​ 資料元素

  2. 按一下​ 新增資料元素 ​按鈕

    按一下「新增資料元素」

  3. 將資料元素命名為 Authentication State

  4. 針對​ 資料元素型別,選取​ 自訂程式碼

  5. 按一下​ 開啟編輯器 ​按鈕

    開啟編輯器以新增資料元素的自訂程式碼

  6. 在編輯程式碼視窗中,使用以下程式碼,根據 Luma 網站資料層中的屬性,傳回「logged in」或「logged out」值:

    if (digitalData.user[0].profile[0].attributes.loggedIn)
        return "logged in"
    else
        return "logged out"
    
  7. 按一下​ 儲存 ​以儲存自訂程式碼

    儲存自訂程式碼

  8. 將所有其他設定保留為其預設值

  9. 按一下​ 儲存至資料庫 ​以儲存資料元素並返回資料元素頁面。 完成所有變更並準備好進行驗證之前,我們不需要執行「建置」。

    儲存資料元素

知道使用者的驗證狀態後,您就可以知道客戶 ID 何時應存在於頁面上以傳送至 Identity Service。下一個步驟是建立客戶 ID 本身的資料元素。在 Luma 示範網站上,使用雜湊版本的訪客電子郵件地址。

為雜湊電子郵件新增資料元素的方式

  1. 按一下​ 新增資料元素 ​按鈕

    新增資料元素

  2. 將資料元素命名為 Email (Hashed)

  3. 針對​ 資料元素型別,選取​ JavaScript變數

  4. 做為​ JavaScript變數名稱,使用以下指向Luma網站資料層中變數的指標: digitalData.user.0.profile.0.attributes.username

  5. 將所有其他設定保留為其預設值

  6. 按一下​ 儲存至資料庫 ​以儲存資料元素

    儲存資料元素

新增規則以傳送客戶 ID

Adobe Experience Platform Identity Service 會使用「設定客戶 ID」動作,在規則中傳遞客戶 ID。現在需建立一個規則,以便在訪客通過驗證時觸發此動作。

新增規則以傳送客戶 ID 的方式

  1. 在左側導覽列中,按一下​ 規則

  2. 按一下​ 新增規則 ​以開啟規則產生器

    新增規則

  3. 將規則命名為 All Pages - Library Loaded - Authenticated - 10

    秘訣
    此命名慣例表示您會在使用者通過驗證時,在所有頁面頂端引發此規則,而且順序為「10」。 使用類似的命名慣例 (而非為動作中觸發的解決方案命名),可讓您將實施所需的規則總數降到最低。
  4. 在​ 事件 ​底下,按一下​ 新增

    新增事件

    1. 針對​ 事件型別,選取​ 載入的程式庫(頁面頂端)
    2. 展開​ 進階選項 ​區段,並針對​ 順序 ​輸入10。 「順序」會控制相同事件所觸發的規則順序。順序較低的規則會在順序較高的規則之前引發。在此情況下,您會想在引發 Target 請求之前設定客戶 ID,您將在下一個課程中使用順序為 50 的規則進行此操作。
    3. 按一下​ 保留變更 ​按鈕以返回規則產生器

    儲存事件

  5. 在​ 條件 ​下,按一下​ 新增

    為規則新增條件

    1. 針對​ 條件型別,選取​ 值比較

    2. 按一下 資料元素圖示 圖示,開啟資料元素強制回應視窗

      開啟資料元素強制回應視窗

    3. 在資料元素強制回應視窗中,按一下​ 驗證狀態,然後按一下​ 選取

      設定驗證狀態

  6. 確定運算子是 Equals

  7. 在文字欄位中輸入「logged in」,會導致每當資料元素「Authentication State」的值為「logged in」時,就會引發規則。

  8. 按一下​ 保留變更

    儲存條件

  9. 在​ 動作 ​底下,按一下​ 新增

    新增動作

    1. 為​ 擴充功能 ​選取​ Experience Cloud ID服務

    2. 針對​ 動作型別 ​選取​ 設定客戶ID

    3. 對於​ 整合代碼,請輸入crm_id

    4. ​請開啟資料元素選取器強制回應視窗,並選取Email (Hashed)

    5. 為​ 驗證狀態 ​選取​ 已驗證

    6. 按一下​ 保留變更 ​按鈕以儲存動作並返回規則產生器

      設定動作並儲存變更

  10. 按一下​ 儲存至程式庫並建置 ​按鈕以儲存規則

    儲存規則

您現在已建立規則,當訪客通過驗證時,系統會將客戶 ID 作為 crm_id 變數傳出。由於您指定順序為 10,因此這個規則會先引發,再引發您於新增資料元素、規則和程式庫課程中建立的 All Pages - Library Loaded 規則 (其預設順序值為 50)。