使用Experience Platform Debugger驗證Web SDK實作

了解如何使用 Adob​​e Experience Platform Debugger 驗證您的 Adob​​e Experience Platform Web SDK 實施。

Experience Platform Debugger是Chrome擴充功能,可協助您檢視在網頁中實作的Adobe技術。 Experience Platform Debugger和瀏覽器的開發人員主控台,是驗證和偵錯Web SDK實作瀏覽器端的最佳方式。 下一個課程將涵蓋Adobe Experience Platform Assurance,提供資料進出平台Edge Network時的最佳檢視。

網頁SDK和Adobe Experience Platform驗證圖表

如果您以前從未使用過Debugger,您可以觀看這段5分鐘的概述影片:

在本課程中,您使用Adobe Experience Platform Debugger擴充功能,將Luma示範網站上以硬式編碼撰寫的標籤屬性取代為您自己的屬性。

此技巧稱為環境切換,您日後在自己的網站上使用標籤時,此技巧將有所幫助。 它可讓您在瀏覽器中載入您的生產網站,但搭配您的​ 開發 ​標籤程式庫。 此功能可讓您安心地變更及驗證標籤,而不受定期程式碼發行的影響。 畢竟,將行銷標籤發行與定期程式碼發行分開,是客戶使用標籤的主要原因之一!

學習目標

在本課程結束時,您將能夠使用除錯工具:

  • 載入替代標籤程式庫
  • 驗證使用者端XDM事件是否如預期般擷取及傳送資料給Platform Edge Network
  • 啟用Edge追蹤以檢視Platform Edge Network傳送的伺服器端請求

先決條件

您熟悉資料收集標籤和Luma示範網站,並已完成教學課程中先前的課程:

使用Debugger載入替代標籤程式庫

Experience Platform Debugger有一種很酷的功能,可讓您使用其他標籤程式庫取代現有的標籤程式庫。 此技巧對於驗證相當實用,可讓我們略過本教學課程中的許多實作步驟。

  1. 確定您已開啟Luma示範網站,並選取Experience Platform Debugger擴充功能圖示

  2. Debugger將會開啟並顯示硬式編碼實作的一些詳細資料(您可能需要在開啟Debugger後重新載入Luma網站)

  3. 確認Debugger為"已連線至Luma" (如下圖所示),然後選取"鎖定"圖示以將Debugger鎖定至Luma網站。

  4. 選取​ 登入 ​按鈕,使用您的Adobe ID登入Adobe Experience Cloud,然後選取您的組織。

    note tip
    TIP
    如果偵錯工具在登入後顯示的是您的使用者名稱,而非您的組織名稱,請登出然後再試一次。

    偵錯工具標籤畫面

  5. 現在,前往左側導覽中的​Experience Platform標籤

  6. 選取​ 組態 ​索引標籤

  7. 在顯示​ 頁面內嵌程式碼 ​的右側,開啟​ 動作 ​下拉式清單,然後選取​取代

    選取動作>取代

  8. 由於您已通過驗證,Debugger將會提取您可用的標籤屬性和環境。 選取您的屬性

  9. 選取您的Development環境
    選取替代標籤屬性

    note tip
    TIP
    如果您無法使用下拉式清單選取您的屬性和環境,請改至標籤 > 環境 > 開發 > 安裝,然後選取圖示以複製內嵌程式碼並將其貼到Debugger中:
    選取替代標籤屬性
  10. 選取​ 套用 ​按鈕

  11. Luma網站現在將使用您自己的標籤屬性​重新載入

    已取代 標籤屬性

繼續進行教學課程的過程中,您會使用此技巧將Luma網站對應至您自己的標籤屬性,以驗證您的Platform Web SDK實施。 在您自己的網站上使用標籤時,您可以使用這種相同的技巧,來驗證生產環境網站上的開發標籤程式庫。

使用Debugger進行驗證

驗證網路請求和XDM

您可以使用Debugger驗證從您的Platform Web SDK實作觸發的使用者端信標,以檢視傳送至Platform Edge Network的資料:

  1. 前往左側導覽中的​摘要,檢視標籤屬性的詳細資料

    摘要標籤

  2. 現在,前往左側導覽中的​Experience Platform Web SDK,檢視​網路要求

  3. 開啟​ 事件 ​列

    Adobe Experience Platform Web SDK請求

  4. 請注意,您如何看到您在web.webPageDetails.pageView更新變數動作中指定的事件型別,以及其他在AEP Web SDK ExperienceEvent欄位群組後面的現成可用變數

    事件詳細資料

  5. 向下捲動至web物件,選取以開啟並檢查webPageDetails.name。 它們應該符合首頁上對應的adobeDataLayer資料層變數

TIP
若要檢視和比較首頁上的adobeDataLayer資料層:
  1. 在Luma首頁上,開啟瀏覽器開發人員工具。 若是Chrome,請選取鍵盤上的按鈕F12
  2. 選取​ 主控台 ​索引標籤
  3. 輸入adobeDataLayer並在鍵盤上選取Enter以開啟資料層值

網路標籤

驗證在產品頁面、購物車頁面及訂單確認頁面上設定的事件和變數。

驗證身分對應

您也可以驗證「身分對應」詳細資料:

  1. 在​Sign In Luma網站上選取。 選取​ Create Account ​並使用認證test@test.com/test建立帳戶

  2. 使用Debugger中的​ 跳至最近的 ​捷徑,快速移至最近的Web SDK事件(這是最後一欄)。 選取​ 事件 ​列以開啟詳細資料強制回應視窗。

  3. 在模組內搜尋​identityMap。 您應該會看見具有authenticatedState、id和主要指定之三個金鑰的lumaCrmId
    Debugger中的 Web SDK

使用瀏覽器開發人員工具進行驗證

許多網頁開發人員可能偏好在瀏覽器的開發人員工具中檢視實作。 這點尤其重要,因為並非所有瀏覽器都支援Debugger擴充功能。 此外,由於架構靈活,您可以檢查其他實施詳細資訊,例如Cookie和回應詳細資訊。

驗證網路要求

Web SDK要求詳細資訊也會顯示在瀏覽器的網頁開發人員工具​ 網路 ​標籤中(假設網站正在載入您的標籤庫)。

  1. 開啟瀏覽器的Web開發人員工具​ 網路 ​標籤,然後重新載入頁面。 篩選具有/ee的呼叫,以找出該呼叫、選取它,然後檢視​ 標題 ​索引標籤和​ 承載 ​索引標籤

    網路標籤

  2. 前往​ 預覽 ​標籤,並記下ECID值如何包含在網路回應中。

    網路標籤

    note note
    NOTE
    ECID值會顯示在網路回應中。 它不會包含在網路要求的identityMap部分中,也不會以此格式儲存在Cookie中。

進入開發人員工具時,讓我們來看看瀏覽器中的Cookie Web SDK設定。 開啟Application > Cookie > https://luma.enablementadobe.com

您應該會看到由Web SDK設定的數個Cookie:

  • kndctr_[IMS_ORGID]_AdobeOrg_identity:這會儲存與ECID相關的資料
  • kndctr_[IMS_ORGID]_AdobeOrg_cluster:這會儲存所使用的資料中心位置,以便後續的網路呼叫路由至相同的Edge伺服器
  • AMCV_[IMS_ORGID]%40AdobeOrg:這是舊版AMCV Cookie,由SDK Experience Cloud前置程式庫所使用,且已設定,因為我們將預設值​ 將ECID移轉至VisitorAPI以移轉至Adobe Experience Platform Web SDK標籤擴充功能中選取的Web SDK ​設定保留下來。 此設定很重要,您必須在將頁面從舊版資料庫移轉至Web SDK時啟用此設定,但在移轉所有頁面一段特定時間後,才能停用此設定。

Cookie索引標籤

如果您清除這些Cookie並重新載入頁面,您可能會注意到在.demdex.net網域上設定了額外的第三方Cookie。 這些設定是因為我們在Adobe Experience Platform Web SDK標籤擴充功能中保留預設的​使用第三方Cookie已啟用​設定。 如果您的瀏覽器不允許協力廠商Cookie,當您重新載入頁面時,系統將會移除這些協力廠商Cookie。

Demdex Cookie

Luma本機儲存體

Luma示範網站僅使用HTML、CSS和JavaScript等使用者端技術。 除了網站預設狀態所使用的Experience Cloud實作之外,沒有任何後端儲存機制。 如使用者名稱詳細資訊等資訊只會使用localStorage儲存在瀏覽器的本機。 因此,如果您刪除此資訊或使用無痕者視窗,您會注意到您可能需要重新建立先前建立的測試使用者帳戶。

本機存放區

接下來,瞭解如何使用Adobe Experience Platform Assurance從Platform Edge Network接收及傳輸這些網路請求時,如何驗證這些網路請求!

NOTE
感謝您花時間學習Adobe Experience Platform Web SDK。 如果您有任何疑問、想分享一般意見或有關於未來內容的建議,請在這篇Experience League社群討論貼文上分享
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4