疑難排解內容傳送

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

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

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

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

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

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

  • 至少Editor個許可權(或Approver)

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

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

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

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

擷取授權權杖:

  1. 按一下​ Administration > Implementation

  2. 在[偵錯工具]區段中,按一下​ Generate New Authentication Token

    產生新驗證權杖

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

    授權 Token

mboxTrace section_256FCF7C14BB435BA2C68049EF0BA99E

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,請附加 mboxDebug 參數至 URL 結尾。下列表格含有與 Target 回應相關的 URL 參數的相關資訊。

NOTE
有些 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 位址,以比對促銷活動中設定的任何定位與群體劃分。
NOTE
確保 URL 片段位於查詢字串參數之後。第一個 # 之後的任何項目都是片段識別碼,導致偵錯程式參數無法正常運作。

Adobe Experience Cloud Debugger section_A2798ED3A431409690A4BE08A1BFCF17

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

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

如需詳細資訊,請參閱使用Adobe Experience Cloud Debugger偵錯at.js

最暢銷商品未出現在 Recommendations 中 section_3920C857270A406C80BE6CBAC8221ECD

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

檢查活動優先順序 section_3D0DD07240F0465BAF655D0804100AED

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

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

Target 不再支援 IE 8。

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

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

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

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

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

如果重新導向與遠端選件使用無效的 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。 query-strings

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

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

若要在VEC開啟之後顯示不同的頁面,請按一下「Configure gear icon」>「選取​ Page Delivery」>「在Activity 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,而其他範本規則指定了Query,其中包含type > is (case sensitive) > type=Summers%20Offers,以OR運運算元分隔:

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

Target設定檔屬性值中的逸出雙引號無法如預期運作。 escape

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

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

培訓影片

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

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

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

Mbox 追蹤 教學課程徽章

recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654