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"
}
}
]
}