疑難排解內容傳送

如果頁面未顯示預期的內容,您應執行一些步驟來除錯內容傳送。

  • 請仔細檢查您的活動或促銷活動程式碼。錯字或其他錯誤都可能導致預期的內容無法顯示。
  • 使用mboxTrace或mboxDebug來疑難排解Target要求。
  • 使用Adobe Experience Cloud Debugger(一種簡單易用的工具,提供與mboxDebug相同的大部分資訊)來疑難排解Target要求。

mboxDebug在您設定頁面上的Target,以確定Target請求已觸發且Cookie已設定時特別有用。 但是,這不會深入到偵錯內容傳送時很有用的詳細程度。如果您的活動未顯示在頁面上,或是顯示不想要的內容,請使用 mboxTrace 來詳細檢查和偵錯頁面。

擷取要與除錯工具搭配使用的授權Token

由於 mboxTrace 和 mboxDebug 會公開促銷活動資料和描述檔資料給外部對象,因此需要授權權仗。在TargetUI 中可以擷取授權 Token。授權 Token 的有效期限為六小時。

您必須具備下列其中一個使用者權限才能產生驗證Token:

  • 至少Editor權限(或Approver)

    如需Target Standard客戶的詳細資訊,請參閱​Users​中的指定角色和權限。 如需Target Premium客戶的詳細資訊,請參閱設定企業權限

  • 工作區/產品設定檔層級上的管理員角色

    工作區僅適用於Target Premium客戶。 如需詳細資訊,請參閱設定企業權限

  • Adobe Target產品層級的管理權限(Sysadmin權限)

擷取授權 Token:

  1. 按一下「管理 > 實施」。

  2. 在「除錯工具」區段中,按一下「產生新驗證Token 」。

    產生新的驗證Token

  3. 將產生的 Token 當作參數新增至 URL,以啟用其中一個進階偵錯工具。

    授權 Token

mboxTrace

mboxTrace可讓您接收附加至Target回應的追蹤資訊。 追蹤資訊反映Target呼叫(例如,轉換或印象)的結果,以及任何有助於判斷此特定結果為何發生的額外資料,例如促銷活動中進行選擇的可用分支集。 請使用此資訊來對內容傳送除錯。

以下是可用的參數:

mboxTrace 選項 結果
?mboxTrace=console 列印至控制台記錄做為物件。
針對 at.js,不使用彈出新瀏覽器視窗或輸出至控制台的 mbox.js 中,您需檢查網路請求並查看「預覽」(Chrome) 或「回應」(Firefox)。
?mboxTrace=json 列印至控制台記錄做為常值 JSON 字串
?mboxTrace=window 列印至彈出式視窗做為 JSON 字串
?mboxTrace=disable 關閉追蹤作業模式

範例mboxTrace呼叫

https://www.mysite.com/page.html?mboxTrace=window&authorization=f543abf-0111-4061-9619-d41d665c59a6

輸出會顯示與內容相關的極詳細資訊。mboxTrace 會顯示與您促銷活動或活動以及描述檔相關的詳細資訊,也會提供執行前的描述檔快照,以及執行後的變更項目快照。同時顯示每個位置評估了哪些促銷活動或活動。

有些資訊包括相符和不相符的群體與目標 ID:

  • SegmentId: 群體的 ID,來自可重複使用的群體庫或為特定促銷活動建立的匿名群體。
  • TargetId: 目標的 ID,來自目標運算式庫或來自促銷活動的匿名目標。
  • 不相符: 請求在此呼叫中不符合那些群體或目標的資格。
  • 相符: 請求符合指定的群體或目標的資格。

在建議頁面上使用mboxTrace:將mboxTrace新增為含建議之頁面上的查詢參數,會以mboxTrace詳細資料視窗取代頁面上的Recommendations設計,此視窗會顯示建議的深入資訊,包括:

  • 傳回的建議以較請求的建議
  • 使用的索引鍵,以及是否產生建議
  • 條件產生的建議比較備份建議
  • 條件組態
  • 套用的排除和包含
  • 收集規則

您不需要在查詢參數中加入=console=json=window。使用完 mboxTrace 詳細資料後,請新增 =disable,然後按下 Enter 鍵,即可返回正常顯示模式。

mboxTrace 不會影響您網站的正常功能和外觀。訪客看到的是您的正常 Recommendations 設計。

mboxDebug

若要使用 mboxDebug,請附加 mboxDebug 參數至 URL 結尾。下表包含Target回應相關URL參數的相關資訊。

注意

有些 mboxDebug 參數可以不使用驗證。

URL 參數 用途
mboxDebug=1 除錯程式
將此參數新增至已定義Target請求的任何URL,會開啟具有重要除錯詳細資訊的快顯視窗。 Cookie 資訊、PCid 及作業 ID 值會出現,而且所有的 URL 都會顯示。按一下Target請求URL以顯示該Target請求的回應。 如需詳細資訊,請參閱 mbox_debug.pdf
mboxDebug=x-cookie 修改 Cookie
mboxDisable=1 停用頁面上的 mbox
mboxDebug=x-profile 檢視描述檔集合。
mboxDebug=x-time 顯示每個Target請求的響應時間
mboxOverride.browserIp=<Insert IP address> 測試地理定位
使用這個 URL 參數測試地理定位。輸入 IP 位址作為這個屬性的值,Test&Target 的地理定位功能會評估該 IP 位址,以比對促銷活動中設定的任何定位與群體劃分。
注意

請確定URL片段位於查詢字串參數之後。 第一個#之後的任何項目都是片段識別碼,導致除錯參數無法正常運作。

Adobe Experience Cloud Debugger

Adobe Experience Cloud Debugger 方便您快速且輕鬆地瞭解 Target 實作。您可以快速查看資料庫組態、檢查要求以確定您的自訂參數傳遞正確、開啟主控台記錄功能,以及停用所有 Target 要求。驗證至Experience Cloud,您可以使用功能強大的MboxTrace工具來檢查您的活動、受眾資格以及訪客資料。

如需詳細資訊,請觀看下方的訓練影片:

如需詳細資訊,請參閱「使用Adobe Experience Cloud除錯程式除錯at.js」。

如果在傳送期間 target.js 無法載入

如果在傳送期間 target.js 無法載入,mbox.js 會將 Cookie「em-disabled」傳送給訪客。此 Cookie 可避免使用 Visual Experience Composer 建立的選件在網站上轉譯。具有此 Cookie 的訪客看不到測試內容,也不會算入那些活動報表中。所有其他選件內容 (例如來自 Target Classic 的促銷活動) 會繼續載入。Cookie 從載入失敗起的存留期為 30 分鐘。

最暢銷商品未出現在建議中

SiteCatalyst: purchase​呼叫無法用於購買演算法流量資料。 請改用​orderConfirmPage​呼叫。

檢查活動優先順序

使用Target Standard/Premium建立的表單型活動可能會與在Target Classic UI中建立的具有相同優先順序且使用相同Target請求的活動發生衝突。

自訂程式碼在 Internet Explorer 8 中未產生預期結果。

Target 不再支援 IE 8。

使用mbox.js時,全域Target請求傳送的JavaScript內容不會載入。

升級至 mbox.js 版本 58 或更新版。

mbox.js 58及更新版本會在HTML BODY標籤出現後,立即執行全域Target請求的非JavaScript內容。 全域Target請求的<script>標籤內部的JavaScript內容會在DOMContentLoaded事件引發後執行。 此內容傳送順序可確保傳送並正確呈現全域Target要求的JavaScript內容。

目標Cookie未設定

如果您的網站有子網域,例如 us.domain.com,但您需要將 Target Cookie 設定在 domain.com (而不是 us.domain.com),則必須覆寫 cookieDomain 設定。如需詳細資訊,請參閱 targetGlobalSettings()

如果元素也是 AEM 個人化的一部分,Target 內容會忽隱勿現或未出現。

如果 DOM 元素 Adobe Experience Manager (AEM) 個人化目標鎖定和 Target 活動的一部分,Target 內容可能會忽隱忽現或沒有出現。

若要補救這種情況,您可以在執行 Target 的頁面上停用 AEM 個人化。

無效 URL 導致重新導向與遠端選件無法傳送。

如果重新導向與遠端選件使用無效的 URL,可能會無法傳送。

對於重新導向選件,Target回應可包含/* invalid redirect offer URL */

對於遠程選件,Target響應可以包含/* invalid remote offer URL */

您可以在瀏覽器中檢查Target回應,或使用mboxTrace。 請參閱 https://tools.ietf.org/html/std66 以取得有效 URL 的詳細資訊。

我的網站上未觸發目標請求。

如果您使用無效的doctype,at.js不會觸發Target請求。 at.js 需要 HTML 5 doctype。

訓練影片

以下影片含有本文章探討之概念的詳細資訊。

新增擴充功能 教學課程徽章

基本目標調試教程徽章

Mbox追蹤教學課程標章

本頁內容