疑難排解內容傳送
- 主題:
- 活動
如果頁面未顯示預期的內容,您應執行一些步驟來除錯內容傳送。
- 請仔細檢查您的活動或促銷活動程式碼。錯字或其他錯誤都可能導致預期的內容無法顯示。
- 使用 mboxTrace 或 mboxDebug 來針對 Target 請求進行疑難排解。
- 使用 Adobe Experience Cloud Debugger,與 mboxDebug 提供的資訊大多相同的易用工具,來針對 Target 請求進行疑難排解。
如果您在頁面上設定 Target 以確保引發 Target 要求以及設定 Cookie,mboxDebug 會很有用。但是,這不會深入到偵錯內容傳送時很有用的詳細程度。如果您的活動未顯示在頁面上,或是顯示不想要的內容,請使用 mboxTrace 來詳細檢查和偵錯頁面。
擷取授權權杖以與偵錯工具一起使用
由於 mboxTrace 和 mboxDebug 會公開促銷活動資料和描述檔資料給外部對象,因此需要授權權仗。在TargetUI 中可以擷取授權 Token。權杖的有效期限為六小時。
您必須具備下列其中一個使用者權限才能產生驗證權杖:
擷取授權權杖:
-
按一下 Administration > Implementation。
-
在[偵錯工具]區段中,按一下 Generate New Authentication Token。
-
將產生的 Token 當作參數新增至 URL,以啟用其中一個進階偵錯工具。
mboxTrace
mboxTrace 可讓您接收附加至 Target 回應的追蹤資訊。追蹤資訊可反映 Target 呼叫的結果 (例如,轉換或印象) 以及可協助判斷為何發生此特定結果的任何其他資料,例如在行銷活動中所進行選擇內的一組可用分支。請使用此資訊來對內容傳送除錯。
以下是可用的參數:
?mboxTrace=console
對於 at.js,您必須檢查網路請求並查看「預覽」(Chrome) 或「回應」(Firefox),而不是像 mbox.js (現已被取代) 一樣彈出新瀏覽器視窗或輸出至主控台。
?mboxTrace=json
?mboxTrace=window
?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=1
將此參數新增至任何已定義 Target 請求的 URL 會開啟快顯視窗,其中含有重要的偵錯詳細資訊。Cookie 資訊、PCid 及工作階段 ID 值會出現,而且所有的 URL 都會顯示。按一下 Target 請求 URL 可顯示該 Target 請求的回應。如需詳細資訊,請參閱 mbox_debug.pdf。
mboxDisable=1
mboxOverride.browserIp=<Insert IP address>
使用這個 URL 參數測試地理定位。輸入 IP 位址作為這個屬性的值,Test&Target 的地理定位功能會評估該 IP 位址,以比對促銷活動中設定的任何定位與群體劃分。
#
之後的任何項目都是片段識別碼,導致偵錯程式參數無法正常運作。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。
Activity URL決定符合活動訪客資格的頁面,並向使用者呈現活動體驗。 在活動建立期間出現提示時,輸入完整 URL 並不一定能確保在該網站頁面上傳遞內容,尤其是包含查詢字串參數的 URL。
根據預設,Visual Experience Composer (VEC)會開啟視覺化體驗撰寫器設定中指定的頁面。 您也可以在活動建立期間指定不同的頁面。
若要在VEC開啟之後顯示不同的頁面,請按一下「Configure gear icon」>「選取 Page Delivery」>「在Activity URL欄位中指定所要的URL」。
但如果 URL 包含查詢字串參數,該怎麼辦?它是否可運作並顯示個人化內容?在這個案例中,無論目標客群為何,除了可定義查詢參數的基底 URL 外,還可以包含範本規則。
下列選項可用來包含其他範本規則:
選項1:複製URL,並使用「包含」選項將其保留在範本規則中。
此選項可確保此 URL 符合活動的資格,但請注意,其相關邊角案例是,透過對包含基底 URL 的 URL 新增其他記錄來影響您的報告資料。
在這個案例中,URL 為 https://shopping.mycart.com?type=Summers%20Offers
,而其他範本規則「包含」相同的 URL (以 OR 運算子分隔):
選項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運運算元分隔:
Target設定檔屬性值中的逸出雙引號無法如預期運作。
當您在Target設定檔屬性中傳送包含雙引號的值時,您必須將其雙重逸出,如下所示。
adobe.target.trackEvent({
"mbox": "data-collection",
"params": {
"profile.tagLine": "Escape \\\"Double Quotes\\\" like this."
}
});
培訓影片
以下影片含有本文章探討之概念的詳細資訊。
新增擴充功能

基本 Adobe Target 偵錯

Mbox 追蹤
