文件 Experience Platform Data Ingestion 指南

串流擷取疑難排解指南

Last update: Thu Jan 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Data Ingestion

建立對象：

Developer

本檔案提供在Adobe Experience Platform上串流擷取相關常見問題的解答。關於其他相關問題和疑難排解 Platform 服務，包括所有使用者遇到的服務 Platform API，請參閱 Experience Platform疑難排解指南.

Adobe Experience Platform Data Ingestion 提供可用於將資料擷取到的RESTful API Experience Platform. 內嵌的資料會用於近乎即時更新個別客戶設定檔，讓您跨多個管道提供個人化的相關體驗。請閱讀資料擷取概觀以取得有關服務和不同擷取方法的詳細資訊。如需使用串流獲取API的相關步驟，請參閱串流擷取概觀.

常見問題集

以下是有關串流擷取的常見問題解答清單。

我如何知道我正在傳送的裝載格式正確？

Data Ingestion 善用 Experience Data Model (XDM)結構描述來驗證傳入資料的格式。傳送不符合預先定義XDM結構描述的資料將會導致擷取失敗。如需有關XDM及其在下列專案中的使用的詳細資訊： Experience Platform，請參閱 XDM系統概覽.

串流擷取支援兩種驗證模式：同步和非同步。每個驗證方法處理失敗資料的方式都不同。

同步驗證 您應在開發程式中使用。未通過驗證的記錄會被捨棄，並傳回失敗原因的錯誤訊息（例如：「無效的XDM訊息格式」）。

非同步驗證 應該用於生產環境中。任何未通過驗證的格式錯誤資料都會傳送至 Data Lake 作為失敗的批次檔案，稍後可從中擷取檔案以供進一步分析。

如需同步和非同步驗證的詳細資訊，請參閱串流驗證概觀. 如需如何檢視驗證失敗的批次的步驟，請參閱以下指南中的說明：擷取失敗的批次.

我可以在將請求裝載傳送至之前先驗證它嗎？ Platform？

請求裝載只能在傳送至後評估 Platform. 執行同步驗證時，有效裝載會傳回填入的JSON物件，而無效裝載會傳回錯誤訊息。在非同步驗證期間，服務會偵測任何格式錯誤的資料並傳送至 Data Lake 稍後可擷取它以供分析。請參閱串流驗證概觀以取得詳細資訊。

在不支援同步驗證的邊緣上請求同步驗證時，會發生什麼情況？

當要求的位置不支援同步驗證時，會傳回501錯誤回應。請參閱串流驗證概觀以取得同步驗證的詳細資訊。

如何確保僅從受信任的來源收集資料？

Experience Platform 支援安全資料收集。啟用已驗證的資料收集時，使用者端必須傳送JSON Web權杖(JWT)及其組織ID作為要求標題。有關如何將已驗證資料傳送至的詳細資訊 Platform，請參閱指南，位置為已驗證的資料彙集.

將資料串流到多長時間後 Real-Time Customer Profile？

串流事件通常反映在 Real-Time Customer Profile 不到60秒。實際延遲可能會因資料量、訊息大小和頻寬限制而異。

我可以在同一API請求中包含多則訊息嗎？

您可以在單一請求裝載中將多個訊息分組，並將它們串流至 Platform. 若正確使用，在單一請求中將多個訊息分組，是最佳化資料作業的絕佳方式。請閱讀上的教學課程在請求中傳送多則訊息以取得詳細資訊。

如何知道是否收到我傳送的資料？

所有傳送至的資料 Platform （無論成功與否）會先儲存為批次檔案，再保留在資料集中。批次的處理狀態會顯示在它們被傳送到的資料集中。

您可以使用檢查資料集活動，確認是否已成功擷取資料 Experience Platform使用者介面. 按一下 資料集 ，顯示資料集清單。從顯示的清單中選取您要串流到的資料集，以開啟其 資料集活動 頁面，顯示在選取的時段內傳送的所有批次。如需關於使用的詳細資訊 Experience Platform 若要監視資料串流，請參閱以下指南中的監控串流資料流程.

如果您的資料擷取失敗，而您想要從復原資料 Platform，您可以將失敗批次的ID傳送至 Data Access API. 請參閱以下指南：擷取失敗的批次以取得詳細資訊。

為什麼我的串流資料無法在資料湖中使用？

批次擷取可能無法達到的原因有很多 Data Lake，例如格式無效、資料遺失或系統錯誤。若要判斷批次失敗的原因，您必須使用 Data Ingestion Service API 並檢視其詳細資訊。如需擷取失敗批次的詳細步驟，請參閱以下指南中的擷取失敗的批次.

如何剖析針對API請求傳回的回應？

您可以先檢查伺服器回應代碼，判斷是否已接受您的要求，以剖析回應。如果傳回成功的回應代碼，您就可以檢閱 responses 陣列物件，用來判斷擷取任務的狀態。

成功的單一訊息API要求會傳回狀態碼200。成功（或部分成功）的批次訊息API請求傳回狀態碼207。

以下JSON是API要求的回應物件範例，其中含有兩條訊息：一條成功一條失敗。成功串流的訊息傳回 xactionId 屬性。無法串流的訊息會傳回 statusCode 屬性和回應 message 以取得更多資訊。

{
    "inletId": "9b0cb233972f3b0092992284c7353f5eead496218e8441a79b25e9421ea127f5",
    "batchId": "1565638336649:1750:244",
    "receivedTimeMs": 1565638336705,
    "responses": [
        {
            "xactionId": "1565650704337:2124:92:3"
        },
        {
            "statusCode": 400,
            "message": "inletId: [9b0cb233972f3b0092992284c7353f5eead496218e8441a
                79b25e9421ea127f5]
                imsOrgId: [{ORG_ID}]
                Message has unknown xdm format"
        }
    ]
}

為什麼我傳送的訊息沒有收到者 Real-Time Customer Profile？

如果 Real-Time Customer Profile 拒絕訊息，很可能是因為不正確的身分資訊。這可能是由於為身分提供無效值或名稱空間所導致。

有兩種型別的身分識別名稱空間：預設和自訂。使用自訂名稱空間時，請確定名稱空間已在中註冊 Identity Service. 請參閱身分名稱空間總覽以取得有關使用預設和自訂名稱空間的詳細資訊。

您可以使用 Experience Platform UI 以檢視訊息擷取失敗原因的詳細資訊。按一下監視在左側導覽中，然後檢視 端對端串流 索引標籤，以檢視在選取的時段內串流的訊息批次。

recommendation-more-help

2ee14710-6ba4-4feb-9f79-0aad73102a9a