パフォーマンスの測定

Reports サービスを使用すると、アカウントの パフォーマンス 指標 を取得できます。

使用できる指標の一覧については、metrics ドキュメントをご覧ください。

要件

このレポートを取得するには、レポート マネージャー のロールが必要です。

アカウントにレポート マネージャーのロールを付与するには、 accounts.update を使用して reportingManager フィールドを true に設定します。レポート マネージャーのロールは、Merchant Center のパフォーマンスと分析情報のロールに相当します。

accounts.update は Account リソース全体を置き換えます。accounts.get を使用して Account リソース全体を取得し、情報を失わないように accounts.update リクエストですべてのフィールドを指定してください。

クエリの例

次のクエリは、特定の 30 日間のアカウント内のすべての商品の impressions、clicks、ctr を取得します。リクエストを行うには、 次の Merchant Center Query Language ステートメントを 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