このページは Cloud Translation API によって翻訳されました。

Performance reports

Merchant API では、ProductPerformanceView などのパフォーマンスレポートを利用できます。このページでは、パフォーマンスレポートの構成について説明します。

指標

取得する指標（clicks や impressions など）をクエリできます。パフォーマンスデータを Reports サービスにクエリするには、日付範囲のフィルタを追加する必要があります。

次のサンプルクエリでは、指定した期間内のクリック数の合計を含む 1 つの行が返されます。

SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'

返されるデータを指定する必要があります。ワイルドカード（SELECT * など）はエラーを返します。

次のサンプルレスポンスは、2020 年 12 月 1 日から 2020 年 12 月 21 日までの間に、すべてのマーケティング手法で商品が合計 4,440 回クリックされたことを示しています。

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

セグメント

MCQL を使用して、セグメントフィールドをクエリできます。セグメントフィールドには、商品属性（offerId、brand、category など）またはイベント属性（date、marketingMethod など）を使用できます。

セグメントフィールドは、SQL の GROUP BY と同様に機能します。セグメントフィールドは、選択した指標を SELECT 句の各セグメント別にグループ化して分割します。

次のサンプルクエリでは、追加された条件内で 1 日あたりのクリック数を clicks の降順で返します。少なくとも 1 つのリクエストされた指標がゼロ以外の行のみが返されます。

SELECT
  date,
  clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC

次のサンプルレスポンスは、2020 年 12 月 1 日にすべての商品ですべてのマーケティング手法で 1,546 回のクリックが発生し、2020 年 12 月 2 日にすべての商品ですべてのマーケティングで 829 回のクリックがあったことを示しています。2020 年 12 月 3 日にはクリックが発生しなかったため、その日付については何も返されません。

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}