將歷程中的傳入動作進行疑難排解 troubleshooting-inbound-actions

在此頁面上:​瞭解如何在聯絡支援人員之前,對歷程中的傳入動作(例如應用程式內、網頁和程式碼型體驗)進行偵錯和解決常見問題。

傳入動作(例如應用程式內、Web和程式碼型體驗)是Journey Optimizer的重要元件,因為這些動作會在使用者歷程期間與其啟用個人化參與。 但可能會發生非預期的行為,例如遺失傳入內容,或設定檔退出歷程後繼續傳送。

本指南逐步說明如何偵錯歷程中入站動作的相關問題,協助您在聯絡支援人員之前獨立識別並解決問題。

先決條件 prerequisites

開始疑難排解之前,請先確定下列事項:

  1. 設定​ Assurance ​工作階段。 在Adobe Experience Platform Assurance檔案中進一步瞭解。

  2. 導覽至包含傳入動作的歷程,以擷取歷程名稱和版本ID。

    note
    NOTE
    您可以在'journey/'之後的URL中找到歷程版本ID (例如: 86232fb1-2932-4036-8198-55dfec606fd7)。

    歷程URL或屬性面板中的歷程ID位置

  3. 按一下傳入動作以檢視其詳細資訊。 擷取傳入動作標籤和ID。

    活動設定面板程式碼檢視中的動作ID

  4. 取得設定檔名稱空間和ID,以識別設定檔遇到的問題。 根據您的設定,例如名稱空間可以是ECID、電子郵件或客戶ID。 在Experience Platform檔案中瞭解如何查詢設定檔。

案例1:使用者尚未收到傳入內容 scenario-1

在此案例中,設定檔已在歷程中輸入入站動作,但即使在30分鐘後,對應的入站內容也不會在設定觸發步驟顯示在裝置/使用者端中。

預先檢查 pre-checks

  1. 已針對設定檔擷取啟用歷程傳入資料集

    傳入動作在執行期間使用​ 歷程傳入 ​資料集進行設定檔更新。 確保目前沙箱中的設定檔已啟用此資料集。 進一步瞭解資料集

  2. 已在平台身分中定義​’joai’身分

    傳入動作使用設定檔segmentMembership中的​ joai ​名稱空間來啟動傳入步驟的設定檔。 確定已在沙箱的Platform身分中定義它。 深入瞭解Experience Platform Identity服務

偵錯步驟 debugging-steps

下圖顯示您可以遵循的偵錯步驟順序:

未顯示傳入訊息的疑難排解工作流程:檢查歷程、邊緣傳遞及設定檔 {align="center" width="70%"}

步驟1:檢查裝置/使用者端是否正從Edge網路接收內容 step-1

首先,檢查裝置/使用者端是否取得預期的內容。

應用程式內頻道
  1. 前往Assurance工作階段,然後從左側面板選取​ 應用程式內傳訊 ​區段。

  2. 在​ 裝置 ​上的訊息,按一下​ 訊息 ​下拉式清單。

    Adobe Assurance檢視顯示應用程式內訊息傳遞事件和資料 {width="80%"}

  3. 尋找歷程名稱后接「 — 應用程式內訊息」的訊息。 如果存在,表示裝置/使用者端上存在應用程式內訊息,而問題可能和應用程式內觸發器有關。

  4. 如果找不到訊息,裝置/使用者端就不會收到應用程式內訊息。

網路頻道
造訪頁面並檢查網路標籤,或在Edge工作階段的​ Edge Delivery ​區段中檢查Assurance回應裝載。
程式碼型體驗管道
使用Adobe的API執行curl要求,並在Edge工作階段的​ Edge Delivery ​區段中檢查Assurance回應裝載。

步驟2:檢查Edge網路是否傳回內容 step-2

此步驟旨在確保Edge Network傳回預期要在裝置/使用者端上轉譯的輸入內容。

當設定檔進入歷程中的傳入動作時,會自動符合傳入動作對應的特殊受眾區段(在​ joai ​名稱空間中)。

當使用者端向Edge Network提出特定設定檔和介面的要求時,該設定檔符合接收針對該介面的傳入歷程動作內容的資格,前提是該設定檔目前是相對應​ joai ​區段的成員。

若要針對Edge Network行為除錯,請遵循下列步驟。

  1. 在Assurance工作階段中開啟​ Edge Delivery ​檢視。 此檢視提供在Edge Network伺服器上執行輸入動作的相關資訊。 進一步瞭解 Experience Platform 文件

  2. 驗證與輸入動作相對應的Edge活動是否已列在​ 合格活動 ​或​ 不合格活動 ​區段中。

    Edge傳遞記錄檔,顯示傳送至設定檔 的訊息建議

    • 如果在​ 合格活動 ​區段中,設定檔符合傳入歷程動作的資格,則應傳回內容。
    • 如果在​ 不合格活動 ​區段中,設定檔不符合傳入歷程動作的資格。 如需詳細資訊,請參閱排除原因。
    • 如果在​ 兩個區段 ​中都沒有發生,可能是將傳入歷程動作發佈到Edge Network時發生問題,或是要求的表面URI不符合傳入動作的管道組態設定。
    note
    NOTE
    若要在​ Assurance ​工作階段中尋找Edge活動,請尋找​ audienceNamespace ​為​joaiaudienceSegmentId​為<JourneyVersionID>_<JourneyActionID>的活動(例如: 86232fb1-2932-4036-8198-55dfec606fd7_708f718d-8503-4427-ad8d-8e28979b554c)。

    Edge傳送錯誤,顯示設定檔不符合訊息資格 {width="70%"}

  3. 如果您的活動在​ 不合格活動 ​區段中,且排除原因為​’區段非作用中’,表示Edge Network傳遞伺服器認為設定檔不屬於相關​ joai ​對象區段。

    您可以開啟「設定檔」區段的​ segmentsMap ​元素,並尋找​ joai ​區段ID是否存在,來仔細檢查​ joai ​區段是否存在於設定檔的Edge Network傳遞伺服器檢視中。

  4. 如果Edge Network傳遞伺服器未檢視設定檔為位於相關的​ joai ​區段中,請移至下一個步驟。

步驟3:檢查「joai」對象會籍是否已傳播至Edge網路 step-3

此步驟是驗證當設定檔進入傳入歷程動作,且該設定檔符合對應​ joai ​區段的資格時,Edge設定檔是否已正確更新。

當設定檔符合​ joai ​區段的資格時,設定檔會先在中心更新,然後區段會投射到Edge設定檔中,以供Edge Network傳送伺服器使用。

NOTE
從集線器更新設定檔起,傳輸到Edge最多可能需要15到30分鐘。

若要檢查Edge設定檔的segmentMembership屬性中是否存在​ joai ​區段,請遵循下列步驟。

  1. 導覽至Journey Optimizer左側導覽窗格中的​客戶 > 設定檔​功能表,並使用名稱空間和ID瀏覽至設定檔。 深入瞭解即時客戶設定檔

  2. 選取「屬性」標籤,然後選擇「Edge」檢視。

  3. 按一下​ 檢視JSON ​以開啟設定檔的JSON檢視。

    JSON格式的設定檔屬性檢視,顯示對象成員資格狀態 {width="80%"}

  4. 移至segmentMembership屬性並檢查區段識別碼<JourneyVersionID>_<JourneyActionID>是否出現在​ joai ​名稱空間中,以及是否在​realized 狀態中。

    設定檔JSON顯示已實現的對象成員資格,時間戳記為 {width="90%"}

    • 如果存在,則與傳入歷程動作相對應的​ joai ​區段已正確傳播至Edge設定檔。

    • 如果未顯示在Edge Network傳送伺服器的設定檔檢視中,則傳送伺服器載入Edge設定檔的方式可能會發生問題。

  5. 如果​ joai ​區段ID不存在或處於​ 已退出 ​狀態,表示它(尚)未傳播至Edge。

    請等待15到30分鐘,讓segmentMembership值從中樞傳播至Edge。 如果仍不存在,請前往下一步。

步驟4:檢查集線器上的設定檔中是否存在「joai」對象會籍 step-4

此步驟是驗證當設定檔進入入站歷程動作,且該設定檔符合對應​ joai ​區段的資格時,中心設定檔是否已正確更新。

NOTE
將​ joai ​區段會籍擷取到中心設定檔中,從設定檔進入傳入歷程動作的那一刻起,最多可能需要15至30分鐘的時間。

若要檢查集線器設定檔的segmentMembership屬性中是否存在​ joai ​區段,請遵循下列步驟。

  1. 導覽至Journey Optimizer左側導覽窗格中的​客戶 > 設定檔​功能表,並使用名稱空間和ID瀏覽至設定檔。 深入瞭解即時客戶設定檔

  2. 選取​ 屬性 ​標籤,然後選擇​ 中心 ​檢視。

  3. 按一下​ 檢視JSON ​以開啟設定檔的JSON檢視。

  4. 移至​ segmentMembership ​屬性,並檢查區段識別碼<JourneyVersionID>_<JourneyActionID>是否在​ joai ​名稱空間中,以及是否在​realized 狀態中。

    • 如果存在,則與傳入歷程動作相對應的​ joai ​區段已正確擷取到集線器設定檔中。

    • 若在至少30分鐘後仍無法在Edge設定檔中找到,Edge投影系統可能會發生問題。

  5. 如果​ 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 ​區段的區段會籍狀態,以及使用者端是否不再接收傳入內容。

AI知識參考

本節包含結構化知識,用於支援與本主題相關的解譯、擷取和問答。

如需完整瞭解,此資訊應結合本頁的檔案。 兩者皆非獨立來源;頁面說明功能,本節提供額外內容,以協助去除術語、意圖、適用性和限制條件的歧義。

  • 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檢視。
recommendation-more-help
journey-optimizer-help