疑難排解內容傳送
如果頁面未顯示預期的內容,您應執行一些步驟來除錯內容傳送。
- 請仔細檢查您的活動或促銷活動程式碼。錯字或其他錯誤都可能導致預期的內容無法顯示。
- 使用 mboxTrace 或 mboxDebug 來針對 Target 請求進行疑難排解。
- 使用 Adobe Experience Cloud Debugger,與 mboxDebug 提供的資訊大多相同的易用工具,來針對 Target 請求進行疑難排解。
如果您在頁面上設定 Target 以確保引發 Target 要求以及設定 Cookie,mboxDebug 會很有用。但是,這不會深入到偵錯內容傳送時很有用的詳細程度。如果您的活動未顯示在頁面上,或是顯示不想要的內容,請使用 mboxTrace 來詳細檢查和偵錯頁面。
擷取授權權杖以與偵錯工具一起使用 section_BED130298E794D1FA229DB7C3358BA54
由於 mboxTrace 和 mboxDebug 會公開促銷活動資料和描述檔資料給外部對象,因此需要授權權仗。在TargetUI 中可以擷取授權 Token。權杖的有效期限為六小時。
您必須具備下列其中一個使用者權限才能產生驗證權杖:
擷取授權權杖:
-
按一下 Administration > Implementation。
-
在[偵錯工具]區段中,按一下 Generate New Authentication Token。
-
將產生的 Token 當作參數新增至 URL,以啟用其中一個進階偵錯工具。
mboxTrace section_256FCF7C14BB435BA2C68049EF0BA99E
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,請附加 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 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。
未設定 Target cookie section_77AFEB541C0B495EB67E29A4475DF960
如果您的網站有子網域,例如 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」。
但如果 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設定檔屬性值中的逸出雙引號無法如預期運作。 escape
當您在Target設定檔屬性中傳送包含雙引號的值時,您必須將其雙重逸出,如下所示。
adobe.target.trackEvent({
"mbox": "data-collection",
"params": {
"profile.tagLine": "Escape \\\"Double Quotes\\\" like this."
}
});
培訓影片
以下影片含有本文章探討之概念的詳細資訊。