使用Platform Web SDK除錯Target

驗證Target活動並偵錯Web SDK,以疑難排解實作、內容傳送或對象資格問題。 此移轉指南頁面說明使用at.js和Platform Web SDK進行偵錯的差異。

下表總結了測試和偵錯方法的功能和支援。

特徵或工具
at.js支援
平台Web SDK支援
活動QA URL
mboxDisable URL引數
請參閱下列資訊以停用Target功能🔗
mboxDebug URL引數
使用alloy_debug引數取得類似的偵錯資訊
mboxTrace URL引數
使用Experience Platform Debugger瀏覽器擴充功能
Adobe Experience Platform Debugger延伸模組
alloy_debug URL引數
不適用
Adobe Experience Platform Assurance
不適用

Adobe Experience Platform Debugger瀏覽器擴充功能

Chrome和Firefox的Adobe Experience Platform Debugger擴充功能會檢查您的網頁,協助您驗證Adobe Experience Cloud實作。

您可以在任何網頁上執行Platform Debugger,而擴充功能可存取公開資料。 若要使用擴充功能存取非公開資料(例如Target追蹤資訊),您必須透過​ 登入 ​連結驗證Experience Cloud。

取得並安裝Adobe Experience Platform Debugger

Adobe Experience Platform Debugger可安裝在Google Chrome或Mozilla Firefox瀏覽器中。 請依照下列適當的連結,在您的偏好瀏覽器上安裝擴充功能:

安裝Chrome擴充功能或Firefox附加元件後,圖示( )會新增至擴充功能列。 選取此圖示以開啟擴充功能。

請參閱專屬指南,以取得有關Adobe Experience Platform Debugger擴充功能以及如何偵錯所有AdobeWeb應用程式的詳細資訊。

使用QA URL預覽Target活動

at.js和Platform Web SDK都可讓您使用Target QA URL來預覽Target活動,而且這兩種實作方法都支援相同的QA功能。

透過指示at.js或Platform Web SDK將特定Cookie寫入名為at_qa_mode的瀏覽器,Target QA URL可運作。 此Cookie用於強制特定活動和體驗的資格。

CAUTION
Platform Web SDK 2.13.0版或更新版本支援Target QA模式功能。 已根據sendEvent呼叫中傳遞的xdm.web.webPageDetails.URL值啟用目標QA模式。 對此值所做的任何修改(例如將所有字元設為小寫),都可能導致Target QA模式無法正常運作。

請參閱專用指南,以取得有關Target活動QA的詳細資訊。

Debug Target實作

下表概述at.js與Platform Web SDK除錯策略之間的差異:

at.js功能
Platform Web SDK對等函式
Mbox停用 — 停用Target擷取和轉譯功能,以檢查頁面是否損毀,而不進行Target互動

使用URL引數載入頁面: mboxDisable=true
沒有直接的對等方法。 您可以使用瀏覽器的開發人員工具封鎖所有Platform Web SDK請求。
Mbox偵錯 — 記錄瀏覽器主控台中的每個at.js動作,以協助疑難排解轉譯問題

載入具有URL引數的頁面: mboxDebug=true
Alloy Debug — 記錄SDK的詳細動作,包括但不限於Target個人化動作。

載入包含URL引數的頁面: alloy_debug=true

或在您的開發人員主控台中執行alloy("setDebug", { "enabled": true });
目標追蹤 — 若在Target UI中產生mbox追蹤權杖,window.___target_trace物件下會提供包含參與決策程式之詳細資料的追蹤物件。

載入包含URL引數的頁面: mboxTrace=window&authorization={TOKEN}
使用Adobe Experience Platform Debugger擴充功能或平台保證。
NOTE
以上列出的所有at.js偵錯功能都可與Adobe Experience Platform Debugger的增強功能搭配使用。

停用Target功能

Platform Web SDK目前沒有選擇性地抑制Target回應的功能。 不過,您可以使用瀏覽器的開發人員工具、各種瀏覽器擴充功能或協力廠商應用程式來隱藏Platform Web SDK請求。 例如,若要使用Google Chrome封鎖Platform Web SDK:

  1. 以滑鼠右鍵按一下頁面上的任何位置,然後選取​ Inspect
  2. 選取​ 網路 ​標籤
  3. 依字串//ee//篩選,僅檢視Platform Web SDK呼叫
  4. 重新載入頁面
  5. 用滑鼠右鍵按一下其中一個已篩選的網路要求,並選取​ 封鎖要求網域
  6. 重新載入頁面,並注意網路要求遭到封鎖
  7. 完成偵錯後,用滑鼠右鍵按一下封鎖的網路要求,然後選取​ 解除封鎖,或關閉[開發人員工具]面板

檢視偵錯記錄

使用mboxDebug=true URL引數針對at.js進行除錯記錄,會顯示有關每個Target請求、回應及嘗試將內容轉譯至頁面的詳細資訊。 Platform Web SDK有類似的偵錯記錄,使用alloy_debug=true URL引數。

資訊已記錄
at.js (mboxDebug=true)
Platform Web SDK (alloy_debug=true)
篩選的記錄前置詞
AT:
[alloy]
頁面載入請求詳細資料
Mbox或範圍要求詳細資料
請求狀態
回應詳細資料
呈現狀態
成功和錯誤
僅限錯誤
演算詳細資料
NOTE
at.js和Platform Web SDK的除錯記錄檔提供類似層級的詳細資訊,但值得注意的例外是,Web SDK只會通知由於無效的選取器而發生轉譯錯誤。 除錯記錄目前不會確認轉譯成功。

檢視目標追蹤

Target追蹤提供關於活動資格和訪客Target設定檔的詳細資訊。 由於Target追蹤包含無法公開取得的資訊,檢視這些追蹤需要授權權杖或在Adobe Experience Platform Debugger瀏覽器擴充功能視窗中進行驗證。

Target追蹤方法
at.js
Platform Web SDK
mboxTrace URL引數
Adobe Experience Platform Debugger瀏覽器擴充功能
Adobe Experience Platform Assurance

若要使用Adobe Experience Platform Debugger檢視Platform Web SDK Target追蹤,請執行下列動作:

  1. 導覽至網站上已使用Platform Web SDK實作Target的頁面
  2. 選取瀏覽器導覽列中的圖示( ),開啟Adobe Experience Platform Debugger擴充功能
  3. 選取​ 登入 ​連結
  4. 使用您的Adobe Experience Cloud登入憑證進行驗證
  5. 選取左側的​ 記錄檔 ​索引標籤
  6. 選取頂端的​ Edge ​索引標籤
  7. 選擇性地為您的偵錯工作階段命名,然後按一下​ 連線 ​按鈕
  8. 重新載入頁面,且日誌應填入邊緣網路互動的詳細資訊
  9. 將焦點放在描述中以「目標追蹤」開頭的記錄專案,並選取​ 檢視 ​以檢視Target追蹤詳細資料

如何使用Adobe Experience Platform Debugger {modal="regular"}檢視Target追蹤

選取​ 檢視 ​後,會出現一個覆蓋圖,讓您檢視與請求相關的下列資訊:

  • 符合的活動
  • 不符的活動
  • 請求詳細資料
  • 設定檔快照

如需有關Target追蹤的詳細資訊,請參閱有關偵錯Target內容傳遞的專用指南。

疑難排解保證

可在Adobe Experience Platform Debugger瀏覽器擴充功能和Assurance應用程式(先前稱為Project Griffon)中檢視Target追蹤資訊。 若要在Assurance中檢視Target追蹤,請執行下列動作:

  1. 開啟Adobe Experience Platform Debugger瀏覽器擴充功能,並依上述步驟連線遠端偵錯工作階段
  2. 選取工作階段名稱位於偵錯記錄上方的連結
  3. 平台保證會針對您在實作資料流中設定的所有Adobe應用程式,載入並顯示其詳細記錄
  4. adobe.target篩選記錄檔
  5. 選取型別為com.adobe.target.trace的記錄專案
  6. 展開承載的詳細資訊並檢視context > targetTrace下的資訊

如何使用保證檢視Target追蹤 {modal="regular"}

檢查網路要求與回應

Platform Web SDK sendEvent呼叫的要求裝載和回應與at.js不同。 使用瀏覽器的開發人員工具檢查網路呼叫時,以下概述應可協助您瞭解要求與回應的結構。

內容請求承載

Platform Web SDK承載的目標特定元素 {modal="regular"}

  • 設定檔、實體和其他非mbox引數是在data.__adobe.target下的事件陣列中傳遞
  • 決定範圍位於query.personalization.decisionScopes下的事件陣列中
  • 對應到下游mbox引數的XDM資料位於xdm下的事件陣列中

內容回應內文

Platform Web SDK回應本文的目標特定元素 {modal="regular"}

  • Platform Web SDK會針對handle物件下的所有Adobe應用程式傳回動作
  • personalization:decisions動作表示來自Target或offer decisioning的回應
  • 目標主張以陣列形式呈現,每個都具有以AT:為前置詞的唯一主張ID
  • 決定範圍和活動詳細資訊位於主張陣列中
  • 選件詳細資料位於data下的items陣列中
  • 回應Token位於meta下的items陣列中

主張事件裝載

目標主張事件範例 {modal="regular"}

  • Target特定SDK事件在曝光時為decisioning.propositionDisplay,或在互動(例如點按)時為decisioning.propositionInteract
  • 主張事件的詳細資訊位於xdm._experience.decisioning下的事件陣列中
  • 顯示或互動事件的主張ID應符合從Target傳回的內容主張ID

恭喜,您已結束本教學課程! 祝您順利將Adobe Target實作移轉至Web SDK!

NOTE
我們致力協助您成功將Target從at.js移轉至Web SDK。 如果您在移轉時遇到問題,或覺得本指南中缺少重要資訊,請在此社群討論中張貼以告知我們。
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110