疑難排解內容傳送

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

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

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

擷取授權權杖以與偵錯工具一起使用

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

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

  • 至少有 編輯者權限 (或核准者權限)

    如需有關 Target Standard 客戶的詳細資訊,請參閱​使用者​中的指定角色與權限。如需有關 Target Premium 客戶的詳細資訊,請參閱設定企業權限

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

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

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

擷取授權權杖:

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

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

    產生新驗證權杖

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

    授權 Token

mboxTrace

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

以下是可用的參數:

mboxTrace 選項 結果
?mboxTrace=console 列印至控制台記錄做為物件。
對於 at.js,您必須檢查網路請求並查看「預覽」(Chrome) 或「回應」(Firefox),而不是像 mbox.js (現已被取代) 一樣彈出新瀏覽器視窗或輸出至主控台。
?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,來自目標運算式庫或來自促銷活動的匿名目標。
  • 不相符:請求在此呼叫中不符合那些群體或目標的資格。
  • 相符:請求符合指定的群體或目標的資格。

在 Recommendations 頁面上使用 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
mboxDisable=1 停用頁面上的 mbox
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 Debugger除錯at.js.

最暢銷商品未出現在 Recommendations 中

SiteCatalyst: purchase 呼叫無法用於「購買」演算法流量資料。改為使用 orderConfirmPage 呼叫。

檢查活動優先順序

以 Target Standard/Premium 建立的表單式活動,可能與 Target Classic UI 中建立的活動發生衝突,兩者有相同的優先順序且使用相同的 Target 請求。

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

Target 不再支援 IE 8。

未設定 Target cookie

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

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

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

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

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

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

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

若為遠端選件,可包含 Target 回應/* invalid remote offer URL */

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

我的網站未觸發 Target 請求。

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

確保 Target 活動可正確處理含有查詢字串參數的 URL。

活動 URL 決定了符合活動訪客資格的頁面,並向用戶呈現活動體驗。在活動建立期間出現提示時,輸入完整 URL 並不一定能確保在該網站頁面上傳遞內容,尤其是包含查詢字串參數的 URL。

根據預設,可視化體驗撰寫器 (VEC) 會開啟可視化體驗撰寫器設定中指定的頁面。您也可以在活動建立期間指定不同的頁面。

若要在 VEC 開啟之後顯示不同的頁面,請按一下​設定齒輪圖示 > 選取「頁面傳送」 > 然後在「活動 URL」欄位中指定所需 URL。

設定頁面傳送設定 UI

但如果 URL 包含查詢字串參數,該怎麼辦?它是否可運作並顯示個人化內容?在這個案例中,無論目標對象為何,除了可定義查詢參數的基底 URL 外,還可以包含範本規則。

下列選項可用來包含其他範本規則:

選項1:複製URL,並使用「包含」選項將其保留在範本規則中。

此選項可確保此 URL 符合活動的資格,但請注意,其相關邊角案例是,透過對包含基底 URL 的 URL 新增其他記錄來影響您的報告資料。

在這個案例中,URL 為 https://shopping.mycart.com?type=Summers%20Offers,而其他範本規則「包含」相同的 URL (以 OR 運算子分隔):

在範本規則中複製 URL

選項2:限制URL僅「包含」查詢字串的條件。

上一個選項中討論的邊角案例適用於這個選項,但此處的條件設定僅限於查詢字串。

在這個案例中,URL 為 https://shopping.mycart.com?type=Summers%20Offers,而其他範本規則僅「包含」查詢字串 (以 OR 運算子分隔):

範本規則僅包含查詢字串

選項 3:利用 URL 的特定部分,而非鎖定完整目標 URL。

在這個案例中,URL 為 https://shopping.mycart.com?type=Summers%20Offers,而其他範本規則透過類型 > 為 (區分大小寫) > type=Summers%20Offers,指定了查詢 (以 OR 運算子分隔):

範本規則利用 URL 的特定部分

逸出雙引號 Target 設定檔屬性值未按預期運作。

當您傳送包含雙引號的值於 Target 設定檔屬性,您必須將其雙重逸出,如下所示。

adobe.target.trackEvent({
    "mbox": "data-collection",
    "params":    {
        "profile.tagLine": "Escape \\\"Double Quotes\\\" like this."
    }
});

培訓影片

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

新增擴充功能 Tutorial badge

基本 Adobe Target 偵錯教學課程徽章

Mbox 追蹤教學課程徽章

本頁內容