部分バッチ取得

部分バッチ取得は、エラーを含むデータを特定のしきい値まで取得する機能です。この機能を使用すると、正しいデータをすべて 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: {ORG_ID}

Experience Platform のすべてのリソースは、特定の仮想サンドボックスに分離されています。Platform API へのすべてのリクエストには、操作がおこなわれるサンドボックスの名前を指定するヘッダーが必要です。

  • x-sandbox-name:{SANDBOX_NAME}
NOTE
Platform のサンドボックスについて詳しくは、サンドボックスの概要に関するドキュメントを参照してください。

API での部分バッチ取り込み用のバッチの有効化 enable-api

NOTE
この節では、API を使用した部分バッチ取得のバッチの有効化について説明します。 UI の使用手順については、 UI での部分バッチ取り込み用のバッチの有効化 手順

部分取得を有効にした新しいバッチを作成できます。

新しいバッチを作成するには、 バッチ取得開発者ガイド. 次に バッチを作成 ステップで、リクエスト本文内に次のフィールドを追加します。

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}
プロパティ
説明
enableErrorDiagnostics
許可するフラグ Platform :バッチに関する詳細なエラーメッセージを生成します。
partialIngestionPercent
バッチ全体が失敗する前の許容エラー率。したがって、この例では、失敗する前に、バッチの最大 5%がエラーになる場合があります。

UI での部分バッチ取り込み用のバッチの有効化 enable-ui

NOTE
この節では、UI を使用した部分バッチ取り込みのバッチの有効化について説明します。 API を使用して部分バッチ取得のバッチを既に有効にしている場合は、次の節に進んでください。

バッチで Platform UI では、ソース接続を使用して新しいバッチを作成したり、既存のデータセットで新しいバッチを作成したり、「CSV を XDM フローにマッピング".

新しいソース接続を作成 new-source

新しいソース接続を作成するには、 ソースの概要. 次に データフローの詳細 ステップ、メモ 部分取り込み および エラー診断 フィールド。

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

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

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

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

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

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

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

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

これで、 データを追加 ボタンに貼り付け、部分取り込みを使用して取り込まれます。

「CSV を XDM スキーマにマッピング`フロー map-flow

「CSV を XDM スキーマにマッピング"フロー、 CSV ファイルのマッピングのチュートリアル. 次に データを追加 ステップ、メモ 部分取り込み および エラー診断 フィールド。

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

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

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

次の手順 next-steps

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

部分取り込みエラーの監視について詳しくは、 バッチ取得エラー診断ガイド.

recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a