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

Performance reports

Merchant API は ProductPerformanceView。このページでは、パフォーマンスレポートの構造について説明します。

指標

指定した指標（clicks、impressions など）に対してクエリを実行するには、返すことができますレポートに対してクエリを実行するには、期間にフィルタを追加する必要があります。パフォーマンスデータを保護します

次のサンプルクエリでは、1 行と合計クリック数が返されます次の期間内:

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

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

次のサンプルレスポンスは、販売者の合計が 4,440 件であることを示しています。全マーケティング手法にわたるクリック数、 2020 年 12 月 21 日です

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

セグメント

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

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

次のサンプルクエリでは、1 日あたりのクリック数を降順で返します clicks（指定した期間に追加された条件内）。少なくとも 1 日のリクエストされた指標が 1 つだけ返される場合です。

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

次のサンプルレスポンスは、販売者は Google 広告全体で 1,546 回のクリックがあったことを示しています。すべてのマーケティング手法での商品、2020 年 12 月 1 日、829 件すべてのマーケティング手法にわたる全商品のクリック数（2020 年 12 月 2 日）販売者は 2020 年 12 月 3 日にクリックが発生しなかったため、何も返されません。表示されます。

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