Reports サービスを使用して、アカウントのパフォーマンス指標を取得できます。
使用可能な指標の完全なリストについては、metrics のドキュメントをご覧ください。
要件
このレポートを取得するには、レポート マネージャーのロールが必要です。
アカウントにレポート マネージャーのロールを付与するには、accounts.update を使用して reportingManager フィールドを true に設定します。
accounts.update は Account リソース全体を置き換えます。情報が失われないように、accounts.get を使用して Account リソース全体を取得し、次に accounts.update リクエスト内のすべてのフィールドを指定します。
クエリの例
次のクエリは、特定の 30 日間のアカウント内のすべての商品の impressions、clicks、ctr を取得します。リクエストを行うには、次の Merchant Center クエリ言語ステートメントを reports.search メソッドに渡します。
SELECT
metrics.impressions,
metrics.clicks,
metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'
[実行] をクリックして、API Explorer でサンプルを試します。[実行] をクリックしたら、リクエスト URL 内の販売者 ID プレースホルダを販売者 ID に更新します。クエリを変更できます。API Explorer で作業するには、クエリ全体を 1 行のままにする必要があります。
クエリ内の指標をセグメント化して、より詳細なパフォーマンス レポートを作成することもできます。
Reports サービスを使用して商品を取得およびフィルタする方法については、プロダクト ガイドをご覧ください。