Share via

コマーシャル マーケットプレースの分析データへのプログラムによるアクセスを開始する

  • [アーティクル]

このガイドは、コマーシャル マーケットプレースの分析データにプログラムによってアクセスするためのオンボーディングに役立ちます。 コマーシャル マーケットプレースでの売上の監視、パフォーマンスの評価、オファーの最適化を行うために、分析レポートにプログラムでアクセスする方法について説明します。 改善された分析ツールにより、パフォーマンスの結果に基づいて行動し、顧客とリセラーとの優れた関係を維持することができます。

重要

バージョン 1.1 の API が公開されました。 既存の実装を最新バージョンに移行してください

このガイドについて

このガイドを使用して、コマーシャル マーケットプレースの分析データにプログラムによりアクセスすることができます。 このガイドで説明されているメソッドと API を使用して、カスタム レポートをスケジュールし、内部分析システムに重要なデータ セットを取り込むことができます。 効果的に売り上げを監視し、パフォーマンスを評価し、コマーシャル マーケットプレースのプランを最適化することができます。

コマーシャル マーケットプレース レポートにアクセスするための API を使用すると、分析データのカスタム レポートを非同期的にスケジュールできます。 この機能を使用すると、必要に応じてレポートのクエリやテンプレートを定義したり、スケジュールを設定したり、スケジュールされた間隔で、タイムリーかつ信頼できるレポートを取得したりできます。

コマーシャル マーケットプレースの分析データにプログラムによってアクセスすることの重要な価値は、カスタマイズされたレポート作成と、内部の BI システムおよびプラットフォームとの統合です。

Note

パートナーは、API インターフェイスで 1 回限りのオンボードを行うために、専用のエンジニアリング リソースを必要とします。

バージョン 1.1 の変更ログ

  • 繰り返し回数: 繰り返し回数パラメーターが必須になりました。 これは、スケジュールされたすべてのレポートに繰り返しカウントが必要であることを意味します。

  • 実行 GET API: 1.1 バージョンの GET Execution 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 で正常に機能していることを確認します。

次のステップ