在此頁面上:瞭解如何在聯絡支援人員之前,對歷程中的傳入動作(例如應用程式內、網頁和程式碼型體驗)進行偵錯和解決常見問題。
傳入動作(例如應用程式內、Web和程式碼型體驗)是Journey Optimizer的重要元件,因為這些動作會在使用者歷程期間與其啟用個人化參與。 但可能會發生非預期的行為,例如遺失傳入內容,或設定檔退出歷程後繼續傳送。
本指南逐步說明如何偵錯歷程中入站動作的相關問題,協助您在聯絡支援人員之前獨立識別並解決問題。
先決條件 prerequisites
開始疑難排解之前,請先確定下列事項:
-
設定 Assurance 工作階段。 在Adobe Experience Platform Assurance檔案中進一步瞭解。
-
導覽至包含傳入動作的歷程,以擷取歷程名稱和版本ID。
note NOTE 您可以在'journey/'之後的URL中找到歷程版本ID (例如: 86232fb1-2932-4036-8198-55dfec606fd7)。
-
按一下傳入動作以檢視其詳細資訊。 擷取傳入動作標籤和ID。
-
取得設定檔名稱空間和ID,以識別設定檔遇到的問題。 根據您的設定,例如名稱空間可以是ECID、電子郵件或客戶ID。 在Experience Platform檔案中瞭解如何查詢設定檔。
案例1:使用者尚未收到傳入內容 scenario-1
在此案例中,設定檔已在歷程中輸入入站動作,但即使在30分鐘後,對應的入站內容也不會在設定觸發步驟顯示在裝置/使用者端中。
預先檢查 pre-checks
-
已針對設定檔擷取啟用歷程傳入資料集
傳入動作在執行期間使用 歷程傳入 資料集進行設定檔更新。 確保目前沙箱中的設定檔已啟用此資料集。 進一步瞭解資料集
-
已在平台身分中定義’joai’身分
傳入動作使用設定檔
segmentMembership中的 joai 名稱空間來啟動傳入步驟的設定檔。 確定已在沙箱的Platform身分中定義它。 深入瞭解Experience Platform Identity服務
偵錯步驟 debugging-steps
下圖顯示您可以遵循的偵錯步驟順序:
步驟1:檢查裝置/使用者端是否正從Edge網路接收內容 step-1
首先,檢查裝置/使用者端是否取得預期的內容。
步驟2:檢查Edge網路是否傳回內容 step-2
此步驟旨在確保Edge Network傳回預期要在裝置/使用者端上轉譯的輸入內容。
當設定檔進入歷程中的傳入動作時,會自動符合傳入動作對應的特殊受眾區段(在 joai 名稱空間中)。
當使用者端向Edge Network提出特定設定檔和介面的要求時,該設定檔符合接收針對該介面的傳入歷程動作內容的資格,前提是該設定檔目前是相對應 joai 區段的成員。
若要針對Edge Network行為除錯,請遵循下列步驟。
-
在Assurance工作階段中開啟 Edge Delivery 檢視。 此檢視提供在Edge Network伺服器上執行輸入動作的相關資訊。 進一步瞭解 Experience Platform 文件。
-
驗證與輸入動作相對應的Edge活動是否已列在 合格活動 或 不合格活動 區段中。
的訊息建議
- 如果在 合格活動 區段中,設定檔符合傳入歷程動作的資格,則應傳回內容。
- 如果在 不合格活動 區段中,設定檔不符合傳入歷程動作的資格。 如需詳細資訊,請參閱排除原因。
- 如果在 兩個區段 中都沒有發生,可能是將傳入歷程動作發佈到Edge Network時發生問題,或是要求的表面URI不符合傳入動作的管道組態設定。
note NOTE 若要在 Assurance 工作階段中尋找Edge活動,請尋找 audienceNamespace 為joai,audienceSegmentId為<JourneyVersionID>_<JourneyActionID>的活動(例如: 86232fb1-2932-4036-8198-55dfec606fd7_708f718d-8503-4427-ad8d-8e28979b554c)。 {width="70%"}
-
如果您的活動在 不合格活動 區段中,且排除原因為’區段非作用中’,表示Edge Network傳遞伺服器認為設定檔不屬於相關 joai 對象區段。
您可以開啟「設定檔」區段的 segmentsMap 元素,並尋找 joai 區段ID是否存在,來仔細檢查 joai 區段是否存在於設定檔的Edge Network傳遞伺服器檢視中。
-
如果Edge Network傳遞伺服器未檢視設定檔為位於相關的 joai 區段中,請移至下一個步驟。
步驟3:檢查「joai」對象會籍是否已傳播至Edge網路 step-3
此步驟是驗證當設定檔進入傳入歷程動作,且該設定檔符合對應 joai 區段的資格時,Edge設定檔是否已正確更新。
當設定檔符合 joai 區段的資格時,設定檔會先在中心更新,然後區段會投射到Edge設定檔中,以供Edge Network傳送伺服器使用。
若要檢查Edge設定檔的segmentMembership屬性中是否存在 joai 區段,請遵循下列步驟。
-
導覽至Journey Optimizer左側導覽窗格中的客戶 > 設定檔功能表,並使用名稱空間和ID瀏覽至設定檔。 深入瞭解即時客戶設定檔
-
選取「屬性」標籤,然後選擇「Edge」檢視。
-
按一下 檢視JSON 以開啟設定檔的JSON檢視。
{width="80%"}
-
移至
segmentMembership屬性並檢查區段識別碼<JourneyVersionID>_<JourneyActionID>是否出現在 joai 名稱空間中,以及是否在realized 狀態中。 {width="90%"}
-
如果存在,則與傳入歷程動作相對應的 joai 區段已正確傳播至Edge設定檔。
-
如果未顯示在Edge Network傳送伺服器的設定檔檢視中,則傳送伺服器載入Edge設定檔的方式可能會發生問題。
-
-
如果 joai 區段ID不存在或處於 已退出 狀態,表示它(尚)未傳播至Edge。
請等待15到30分鐘,讓
segmentMembership值從中樞傳播至Edge。 如果仍不存在,請前往下一步。
步驟4:檢查集線器上的設定檔中是否存在「joai」對象會籍 step-4
此步驟是驗證當設定檔進入入站歷程動作,且該設定檔符合對應 joai 區段的資格時,中心設定檔是否已正確更新。
若要檢查集線器設定檔的segmentMembership屬性中是否存在 joai 區段,請遵循下列步驟。
-
導覽至Journey Optimizer左側導覽窗格中的客戶 > 設定檔功能表,並使用名稱空間和ID瀏覽至設定檔。 深入瞭解即時客戶設定檔
-
選取 屬性 標籤,然後選擇 中心 檢視。
-
按一下 檢視JSON 以開啟設定檔的JSON檢視。
-
移至 segmentMembership 屬性,並檢查區段識別碼<JourneyVersionID>_<JourneyActionID>是否在 joai 名稱空間中,以及是否在realized 狀態中。
-
如果存在,則與傳入歷程動作相對應的 joai 區段已正確擷取到集線器設定檔中。
-
若在至少30分鐘後仍無法在Edge設定檔中找到,Edge投影系統可能會發生問題。
-
-
如果 joai 區段ID不存在或處於 已退出 狀態,這表示設定檔在進入對應的傳入歷程動作時(尚)未正確符合特殊 joai 對象區段的資格。
請等待15到30分鐘,以將
segmentMembership值擷取到集線器上的設定檔。 如果仍不存在,請前往下一步。
步驟5:如果使用者端/裝置仍未取得預期的內容 step-5
如果您已執行上述所有步驟,但在等候區段成員資格傳播至Edge Network 30到60分鐘後仍未看到預期行為,請聯絡Adobe客戶服務或您的Adobe代表。
在偵錯步驟中儘可能加入詳細資訊,例如:
- 看到非預期行為的步驟;
- 歷程版本ID;
- 歷程動作ID;
- 完整的Assurance追蹤;
- Edge設定檔的JSON檢視;
- 中樞設定檔的JSON檢視;
- 等
案例2:使用者仍在接收傳入內容 scenario-2
此情境與情境1相反:設定檔已退出歷程,但使用者仍在接收傳入內容。
不過,當設定檔退出歷程時,應該不再符合歷程中傳入動作相對應的 joai 受眾區段。
執行與案例1相同的偵錯步驟,以檢查Hub設定檔、Edge設定檔及Edge Network傳遞伺服器是否正確反映相關 joai 區段的區段會籍狀態,以及使用者端是否不再接收傳入內容。
本節包含結構化知識,用於支援與本主題相關的解譯、擷取和問答。
如需完整瞭解,此資訊應結合本頁的檔案。 兩者皆非獨立來源;頁面說明功能,本節提供額外內容,以協助去除術語、意圖、適用性和限制條件的歧義。
- TL;DR:此頁面針對Adobe Journey Optimizer歷程中的兩個輸入動作情境提供逐步自助偵錯指南:進入輸入步驟但未接收內容的設定檔,以及退出歷程後繼續接收內容的設定檔。
意圖:
- 在偵錯傳入動作問題之前,先設定Assurance工作階段為先決條件
- 確認裝置或使用者端是否正使用Assurance從Edge Network接收傳入內容
- 檢查Edge Network符合資格和不符合資格的活動,以判斷設定檔是否符合傳入歷程動作的資格
- 確認工作對象區段會籍已從Hub設定檔傳播至Edge設定檔
- 在設定檔進入入站動作後,診斷集線器設定檔上新增區段擷取的延遲
- 當自助服務步驟無法解決問題時,請使用正確的診斷資訊呈報給Adobe客戶服務
字彙表:
- 傳入動作:將個人化內容傳送到使用者裝置或瀏覽器的歷程活動,包括應用程式內、網頁和程式碼型體驗管道(產品專屬)
- joai名稱空間:在設定檔
segmentMembership中使用的特殊身分名稱空間,以啟動傳入歷程動作步驟 (產品特定) 的設定檔 - joai區段:對應至特定傳入歷程動作的joai名稱空間中自動建立的對象區段;設定檔必須在此區段中處於已實現狀態,才能接收內容(產品特定)
- 歷程傳入資料集:用來儲存設定檔進入傳入歷程動作 (產品特定) 時所進行設定檔更新的AEP資料集
- 中心設定檔: Adobe Experience Platform中的中心設定檔存放區已用作設定檔屬性和區段會籍的信任來源
- Edge設定檔: Edge Network傳遞伺服器用來即時評估內容適用性的中心設定檔預計復本
- Assurance:Adobe Experience Platform工具,用於使用者端SDK行為和Edge Network回應的即時偵錯
護欄:
- 傳入動作正常運作之前,必須先在目前沙箱中啟用歷程傳入資料集以擷取設定檔
- 必須在沙箱的Platform身分中定義工作名稱空間
- 從Hub將Joai區段會籍傳播至Edge最多可能需要15至30分鐘
- 在設定檔進入入站動作後,將Joai區段會籍擷取至中心設定檔最多可能需要15至30分鐘
- 如果在30-60分鐘後仍然缺少內容,請透過歷程版本ID、動作ID、Assurance追蹤以及Edge和中心設定檔JSON檢視,向上呈報至Adobe客戶服務
術語:
- 正式名稱:joai名稱空間 — 縮寫:joai — 變體:joai身分,joai區段名稱空間
- 正式名稱:傳入動作 — 首字母縮寫:none — 變體:傳入頻道、傳入內容
- 同義字: “Hub profile” = “central profile” (AEP);“Edge profile” = “projected profile” (由Edge Network使用)
- 請勿混淆: Edge Delivery檢視中的「合格活動」≠「不合格活動」 — 合格表示設定檔已接收內容;不合格表示未接收,並顯示排除原因
常見問題集:
- 問:本指南涵蓋的兩個主要輸入動作失敗案例為何? — 案例1:設定檔進入入站步驟,但使用者從未看到內容。 案例2:設定檔已退出歷程,但使用者仍會收到傳入內容。
- 問:我使用什麼工具來偵錯傳入動作傳送? —Adobe Experience Platform Assurance。 先設定Assurance工作階段,然後使用應用程式內傳訊和Edge Delivery檢視來檢查內容傳遞和Edge Network回應。
- 問:什麼是Joai區段,它為什麼重要? — 當設定檔進入入站動作時,會自動符合該特定動作範圍的歷程對象區段的資格。 只有在設定檔處於該歷程區段的已實現狀態時,Edge Network才會傳送傳入內容。
- 問:joai區段會籍需要多久才會出現在Edge設定檔中? — 更新集線器設定檔後,從Hub傳輸至Edge最多需要15至30分鐘。
- 問:如果Edge設定檔上的joai區段ID處於已退出狀態,怎麼辦? — 設定檔已離開歷程區段,這表示其已退出傳入歷程動作。 如果這是意外狀況,請透過集線器設定檔擷取回溯,然後檢查設定檔是否已正確進入輸入動作步驟。
- 問:當向Adobe客戶服務提出申請時,應提供哪些資訊? — 歷程版本ID、歷程動作ID、發生非預期行為的步驟、完整Assurance追蹤,以及Edge和Hub設定檔的JSON檢視。