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

概要

Reporting API

Reporting API を使用すると、販売者はパフォーマンスデータを操作できる Merchant Center クエリ言語を使ってプログラマティックにクエリできます例: 次の機能をカスタムレポートを作成する直接アップロードできます。Reporting API には次の利点があります。

大規模な販売者様は、商品リスティングのパフォーマンスデータを内部またはサードパーティのレポートシステムです
販売者を管理するユーザー、パートナー事業者、アグリゲータが利用できますセンターアカウントの [レポート] にアクセスできます。

API のユーザーは、取得するパフォーマンスデータを次のような通話レスポンスを検索:

返される指標（クリック数、インプレッション数など）
データを分割するディメンション（例: OfferId、Date）
満たすべき条件（例: クリック数 > 100）

Reporting API のクエリ言語を使用すると、パフォーマンス指標（クリック数、インプレッション数）がさまざまな種類別に分類されているディメンション（プログラムや日付、商品など、レポートされるイベント属性）属性（ブランドやカテゴリなどの属性）を Search Reports サービス。

Reports サービスへのクエリの結果は ReportRow のリストになります。各 ReportRow がリクエストされた指標の値を表すクエリで指定したセグメントの完全な検出は行われませんセグメントを指定しない場合、1 つのすべてのセグメントから集計された指標とともに返されます。それ以外の場合指標とともにリクエストされた場合、レスポンスには分割します複数のセグメントを選択し単一のクエリで複数の指標を使用できます。

指標のクエリ

クエリを実行して、必要な指標（クリック数、インプレッション数、クリック率など）を取得できます。返されます。レポートのデータを取得するには、期間にフィルタを追加する必要があります。提供します次のサンプルクエリは、単一の行（集計金額）を返します。指定した期間内の追加条件で発生したクリック数

SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';

レスポンスの例

以下の JSON コードのレスポンス例は、この販売者がどのようにして 4,440 回のクリックを獲得したかを示しています。すべての目的地の全商品にわたる合計 2020 年 12 月 1 日および 2020 年 12 月 21 日です。

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

セグメントのクエリ

指標に加えて、セグメントをクエリすることもできます。セグメントには、商品（offer_id、brand、category など）または報告されたイベント（date、program）。レポート対象のイベントは、説明します。

セグメントは、SQL の GROUP BY と同様に機能します。選択したセグメントをセグメントに分割 SELECT 句でセグメントごとにグループ化して、指標を収集します。次のサンプルクエリは追加された条件内でクリック数の降順で、1 日あたりのクリック数を返します期間。リクエストされた指標が 1 つ以上ゼロ以外の行のみ返されます。

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;

レスポンスの例

以下の JSON コードのレスポンス例は、この販売者のクリック数が 1,546 回だったことを示しています。全掲載先の全商品を対象に 2020 年 12 月 1 日時点の売り上げを伸ばしました全リンク先の全商品で 829 回のクリックを獲得し 2020 年 12 月 2 日2020 年 12 月 3 日以降はオブジェクトは返されません。クリックが発生しなかった日です

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

クエリ文法