疑難排解內容傳送

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

  • 請仔細檢查您的活動或促銷活動程式碼。錯字或其他錯誤都可能導致預期的內容無法顯示。
  • Use mboxTrace or mboxDebug to troubleshoot the Target request.
  • Use the Adobe Experience Cloud Debugger, an easy-to-use tool that provides much of the same information as mboxDebug, to troubleshoot the Target request.

mboxDebug is especially useful when you are setting up Target on your page to make sure the Target request is firing and the cookie is being set. 但是,這不會深入到偵錯內容傳送時很有用的詳細程度。如果您的活動未顯示在頁面上,或是顯示不想要的內容,請使用 mboxTrace 來詳細檢查和偵錯頁面。

Retrieve the authorization token to use with debugging tools

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

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

擷取授權 Token:

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

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

    產生新的驗證Token

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

    授權 Token

mboxTrace

mboxTrace enables you to receive trace information attached to Target responses. Trace information reflects the outcome of a Target call (for example, a conversion or an impression) and any additional data that may help in determining why this particular outcome happened, such as a set of available branches among which the selection was made in a campaign. 請使用此資訊來對內容傳送除錯。

以下是可用的參數:

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 結尾。The following table contains information about Target response-related URL parameters.

注意

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

URL 參數 用途
mboxDebug=1 Debugger
Adding this parameter to any URL with Target requests defined opens a pop-up window with valuable debugging details. Cookie 資訊、PCid 及作業 ID 值會出現,而且所有的 URL 都會顯示。Click on a Target request URL to show the response for that Target request. 如需詳細資訊,請參閱 mbox_debug.pdf
mboxDebug=x-cookie 修改 Cookie
mboxDisable=1 停用頁面上的 mbox
mboxDebug=x-profile 檢視描述檔集合。
mboxDebug=x-time Show response time for each Target request
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 分鐘。

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

The SiteCatalyst: purchase call can't be used for Purchase algorithm traffic data. 請改用 orderConfirmPage 呼叫。

Check activity priority

Form-based activities created with Target Standard/Premium might collide with activities created in the Target Classic UI that have the same priority and use the same Target request.

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

Target 不再支援 IE 8。

JavaScript content delivered by the global Target request doesn't load when using mbox.js.

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

mbox.js version 58 and later executes non-JavaScript content for the global Target request immediately after the HTML BODY tag is present. JavaScript content inside <script> tags for the global Target request executes after the DOMContentLoaded event is fired. This order of content delivery ensures that JavaScript content for the global Target request is delivered and rendered properly.

Target cookie does not get set

如果您的網站有子網域,例如 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,可能會無法傳送。

For redirect offers, the Target response can contain /* invalid redirect offer URL */

For remote offers, the Target response can contain /* invalid remote offer URL */

You can check the Target response in the browser or using mboxTrace. 請參閱 https://tools.ietf.org/html/std66 以取得有效 URL 的詳細資訊。

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

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

訓練影片

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

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

基本目標除錯教 學課程徽章

Mbox追蹤教 學課程徽章

本頁內容