コマーシャル マーケットプレースの分析データへのプログラムによるアクセスを開始する
このガイドは、コマーシャル マーケットプレースの分析データにプログラムによってアクセスするためのオンボーディングに役立ちます。 コマーシャル マーケットプレースでの売上の監視、パフォーマンスの評価、オファーの最適化を行うために、分析レポートにプログラムでアクセスする方法について説明します。 改善された分析ツールにより、パフォーマンスの結果に基づいて行動し、顧客とリセラーとの優れた関係を維持することができます。
重要
バージョン 1.1 の API が公開されました。 既存の実装を最新バージョンに移行してください
このガイドについて
このガイドを使用して、コマーシャル マーケットプレースの分析データにプログラムによりアクセスすることができます。 このガイドで説明されているメソッドと API を使用して、カスタム レポートをスケジュールし、内部分析システムに重要なデータ セットを取り込むことができます。 効果的に売り上げを監視し、パフォーマンスを評価し、コマーシャル マーケットプレースのプランを最適化することができます。
コマーシャル マーケットプレース レポートにアクセスするための API を使用すると、分析データのカスタム レポートを非同期的にスケジュールできます。 この機能を使用すると、必要に応じてレポートのクエリやテンプレートを定義したり、スケジュールを設定したり、スケジュールされた間隔で、タイムリーかつ信頼できるレポートを取得したりできます。
コマーシャル マーケットプレースの分析データにプログラムによってアクセスすることの重要な価値は、カスタマイズされたレポート作成と、内部の BI システムおよびプラットフォームとの統合です。
Note
パートナーは、API インターフェイスで 1 回限りのオンボードを行うために、専用のエンジニアリング リソースを必要とします。
バージョン 1.1 の変更ログ
繰り返し回数: 繰り返し回数パラメーターが必須になりました。 これは、スケジュールされたすべてのレポートに繰り返しカウントが必要であることを意味します。
実行 GET API: 1.1 バージョンの GET 実行 API は、繰り返し数 (残り)、終了日、および次回の実行開始時刻に関する追加情報を返します。
スケジュールされたレポート PUT API: 1.1 バージョンの API を使用すると、ユーザーは定期的な回数に加えて、スケジュールされたレポートの終了日を更新できます。
繰り返し数の制限は、スケジュールされたレポートの繰り返し間隔に基づいています。
警告
API のバージョン 1.0 は、2024 年 6 月 30 日に終了する 6 か月で非推奨になります。 つまり、この日付以降、このバージョンのサポートや更新プログラムは提供されなくなります。 必要に応じて移行の計画を立ててください。
v1 から v1.1: への移行手順: API のバージョン 1.1 に移行するには、次の手順に従ってください。
API のバージョン 1.1 用の新しいエンドポイントを使用するようにコードを更新します。
バージョン 1.1 で追加または変更されたフィールドを参照するすべての要求または応答を更新します。
コードを十分にテストして、API のバージョン 1.1 と互換性があることを確認します。
アプリケーションを監視して、新しいバージョンの API で正常に機能していることを確認します。