部分批次內嵌

部分批次內嵌是指內嵌包含錯誤的資料的功能,最多可達特定臨界值。 透過此功能,使用者可以將其所有正確資料成功內嵌至Adobe Experience Platform,同時將其所有不正確的資料分別批次處理,並提供其無效原因的詳細資訊。

本檔案提供管理部分批次內嵌的教學課程。

快速入門

本教學課程需要具備部分批次內嵌所涉及各種Adobe Experience Platform服務的實用知識。 開始本教學課程之前,請先檢閱下列服務的檔案:

以下小節提供您需要知道的其他資訊,以便成功對 Platform API。

讀取範例API呼叫

本指南提供範例API呼叫,以示範如何設定請求格式。 這些功能包括路徑、必要標題和格式正確的請求裝載。 也提供API回應中傳回的範例JSON。 如需範例API呼叫檔案中所使用慣例的相關資訊,請參閱 如何閱讀API呼叫範例 在 Experience Platform 疑難排解指南。

收集必要標題的值

若要對 Platform API,您必須先完成 驗證教學課程. 完成驗證教學課程會提供所有 Experience Platform API呼叫,如下所示:

  • 授權:承載 {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

中的所有資源 Experience Platform 與特定虛擬沙箱隔離。 所有請求 Platform API需要標頭,以指定要在中執行操作的沙箱名稱:

  • x-sandbox-name: {SANDBOX_NAME}
注意

如需中沙箱的詳細資訊,請參閱 Platform,請參閱 沙箱概述檔案.

在API中啟用批次以進行部分批次內嵌

注意

本節說明如何使用API啟用批次以進行部分批次內嵌。 有關使用UI的說明,請閱讀 在UI中啟用批次以進行部分批次內嵌 步驟。

您可以建立已啟用部分擷取的新批次。

要建立新批,請按照 批次匯入開發人員指南. 一旦您到達 建立批次 步驟中,在請求內文中新增下列欄位:

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}
屬性 說明
enableErrorDiagnostics 允許 Platform 生成有關批的詳細錯誤消息。
partialIngestionPercent 整個批處理失敗前可接受的錯誤百分比。 因此,在本示例中,最多5%的批可能是錯誤,然後它才會失敗。

在UI中啟用批次以進行部分批次內嵌

注意

本節說明如何使用UI啟用批次以進行部分批次內嵌。 如果您已使用API為部分批次內嵌啟用批次,可跳至下一節。

若要透過啟用批次以進行部分擷取,請 Platform UI中,您可以透過來源連線建立新批次、在現有資料集中建立新批次,或透過「將CSV對應至XDM流量」。

建立新源連接

要建立新源連接,請遵循 來源概觀. 一旦您到達 資料流詳細資訊 步驟,請注意 部分擷取錯誤診斷 欄位。

部分擷取 切換可讓您啟用或停用部分批次內嵌的使用。

錯誤診斷 切換時,僅會在 部分擷取 切換為關閉。 此功能可讓 Platform 生成有關所接收批的詳細錯誤消息。 若 部分擷取 開啟切換開關,自動強制執行增強錯誤診斷。

錯誤閾值 可讓您在整個批次失敗前設定可接受錯誤的百分比。 此值預設為5%。

使用現有資料集

若要使用現有資料集,請先選取資料集。 右側的側欄會填入資料集的相關資訊。

部分擷取 切換可讓您啟用或停用部分批次內嵌的使用。

錯誤診斷 切換時,僅會在 部分擷取 切換為關閉。 此功能可讓 Platform 生成有關所接收批的詳細錯誤消息。 若 部分擷取 開啟切換開關,自動強制執行增強錯誤診斷。

錯誤閾值 可讓您在整個批次失敗前設定可接受錯誤的百分比。 此值預設為5%。

現在,您可以使用 新增資料 按鈕,則會使用部分擷取來擷取。

使用「將CSV對應至XDM結構「流」

若要使用「將CSV對應至XDM結構」流程,請遵循 對應CSV檔案教學課程. 一旦您到達 新增資料 步驟,請注意 部分擷取錯誤診斷 欄位。

部分擷取 切換可讓您啟用或停用部分批次內嵌的使用。

錯誤診斷 切換時,僅會在 部分擷取 切換為關閉。 此功能可讓 Platform 生成有關所接收批的詳細錯誤消息。 若 部分擷取 開啟切換開關,自動強制執行增強錯誤診斷。

錯誤閾值 可讓您在整個批次失敗前設定可接受錯誤的百分比。 此值預設為5%。

後續步驟

本教學課程說明如何建立或修改資料集以啟用部分批次內嵌。 如需批次內嵌的詳細資訊,請參閱 批次匯入開發人員指南.

如需監控部分擷取錯誤的資訊,請參閱 批次匯入錯誤診斷指南.

本頁內容