部分バッチ取得

部分バッチ取得は、エラーを含むデータを特定のしきい値まで取得する機能です。この機能を使用すると、正しいデータをすべて Adobe Experience Platform に正しく取得し、間違ったデータはその理由の詳細とともにすべて別々にバッチ処理されます。

このドキュメントでは、部分バッチ取得を管理するためのチュートリアルを提供します。

はじめに

このチュートリアルでは、部分バッチ取得に関わる様々な Adobe Experience Platform サービスに関する十分な知識が必要です。このチュートリアルを開始する前に、次のサービスのドキュメントを確認してください。

バッチ取得:メソッド Platform CSV や Parquet などのデータファイルからデータを取得して保存します。
Experience Data Model (XDM)：顧客体験データを編成する際に Platform に使用される標準化されたフレームワーク。

以下の節では、への呼び出しを正しくおこなうために知っておく必要がある追加情報を示します。 Platform API

API 呼び出し例の読み取り

ここでは、リクエストの形式を説明するために API 呼び出しの例を示します。これには、パス、必須ヘッダー、適切な形式のリクエストペイロードが含まれます。また、API レスポンスで返されるサンプル JSON も示されています。ドキュメントで使用される API 呼び出し例の表記について詳しくは、トラブルシューテングガイドのAPI 呼び出し例の読み方に関する節を参照してくださいExperience Platform。

必須ヘッダーの値の収集

Platform API を呼び出すには、まず認証チュートリアルを完了する必要があります。次に示すように、すべての Experience Platform API 呼び出しに必要な各ヘッダーの値は認証チュートリアルで説明されています。

Authorization： Bearer {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%がエラーになる場合があります。