部分バッチ取得

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

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

はじめに

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

• バッチインジェスト:CSVやParketなどのデータファイルからデータを Platform 取り込んで保存する方法。
• 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}

APIでバッチの部分的な取り込みを有効にする

部分的な取り込みが有効な新しいバッチを作成できます。

新しいバッチを作成するには、『バッチインジェスト開発者ガイド』の手順に従います。 バッチ作成​の手順に達したら、次のフィールドをリクエスト本文に追加します。

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercentage": 5
}

UIでバッチ取り込みの部分を有効にする

Platform UIから部分的な取り込みを可能にするには、ソース接続から新しいバッチを作成するか、既存のデータセットに新しいバッチを作成するか、「CSVをXDMフローにマップ」を使用して新しいバッチを作成します。

新しいソース接続を作成

新しいソース接続を作成するには、ソースの概要に記載されている手順に従ってください。 データフローの詳細​手順に到達したら、部分的な取り込み​と​エラー診断​の各フィールドに注意してください。

「部分取得」切り替えを使用すると、部分バッチ取得の使用を有効または無効にできます。

エラー診断​の切り替えは、部分的な取り込み​の切り替えがオフの場合にのみ表示されます。 この機能を使用すると、Platformが取り込んだバッチに関する詳細なエラーメッセージを生成できます。 部分的な取り込み​の切り替えがオンになっている場合、拡張されたエラー診断が自動的に適用されます。

エラーしきい値​を使用すると、バッチ全体が失敗する前に許容可能なエラーの割合を設定できます。デフォルトでは、この値は 5% に設定されています。

既存のデータセットを使用する

既存のデータセットを使用するには、開始がデータセットを選択します。 右側のサイドバーに、データセットに関する情報が表示されます。

「部分取得」切り替えを使用すると、部分バッチ取得の使用を有効または無効にできます。

エラー診断​の切り替えは、部分的な取り込み​の切り替えがオフの場合にのみ表示されます。 この機能を使用すると、Platformが取り込んだバッチに関する詳細なエラーメッセージを生成できます。 部分的な取り込み​の切り替えがオンになっている場合、拡張されたエラー診断が自動的に適用されます。

エラーしきい値​を使用すると、バッチ全体が失敗する前に許容可能なエラーの割合を設定できます。デフォルトでは、この値は 5% に設定されています。

これで、追加data​ボタンを使用してデータをアップロードでき、部分的な取り込みを使用して取り込むことができます。

「Map CSV to XDMスキーマ」のフローを使用

「CSVをXDMスキーマにマップ」のフローを使用するには、CSVファイルのマップチュートリアルの手順に従います。 追加データ​の手順に到達したら、部分的な取り込み​と​エラー診断​の各フィールドに注意してください。

「部分取得」切り替えを使用すると、部分バッチ取得の使用を有効または無効にできます。

エラー診断​の切り替えは、部分的な取り込み​の切り替えがオフの場合にのみ表示されます。 この機能を使用すると、Platformが取り込んだバッチに関する詳細なエラーメッセージを生成できます。 部分的な取り込み​の切り替えがオンになっている場合、拡張されたエラー診断が自動的に適用されます。

エラーの しきい値を使用すると、バッチ全体が失敗する前に、許容可能なエラーの割合を設定できます。デフォルトでは、この値は 5% に設定されています。

次の手順

このチュートリアルでは、部分バッチ取得を有効にするデータセットの作成または変更方法について説明しました。バッチ取得について詳しくは、『バッチ取得開発者ガイド』を参照してください。

部分的なインジェストエラーの監視については、バッチインジェストエラー診断ガイドを参照してください。