Performance reports

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

指標

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

指定した期間内のクリック数の合計を含む単一行を返すクエリの例を次に示します。

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

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

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

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

セグメント

パフォーマンス レポートのセグメンテーションには、セグメント フィールドを使用できます。たとえば、marketing_method をクエリすると、各マーケティング方法の行と、SELECT 句でそのマーケティング方法に指定した指標を含むレポートが返されます。

セグメント フィールドには、商品属性（offer_id、brand、category など）またはイベント属性（date、marketing_method など）を指定できます。

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

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

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

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

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

Merchant Center のカスタム レポートと同様に、Merchant Reports API を使用すると、同じクエリで複数のセグメントを指定できます。

アカウント内のすべての商品について、30 日間のクリック数を marketing_method と offer_id で分類して返すサンプルクエリを次に示します。

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

このクエリのレスポンスには、offer_id と marketing_method の組み合わせごとに 1 つの行が含まれ、その組み合わせのクリック数が示されます。

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

カテゴリと商品タイプ

Merchant Center Query Language では、在庫を整理するために定義できる 2 つの属性グループで指標を分割できます。

カテゴリレベル
Google の商品分類のカテゴリ。カテゴリが指定されていない場合は、Google が商品にカテゴリを自動的に割り当てるか、指定されたカテゴリをさらに絞り込むことがあります。
商品タイプのレベル
独自の分類に基づいて指定する商品カテゴリ。カテゴリレベルとは異なり、サポートされている値の事前定義されたセットはありません。

カテゴリ属性と商品タイプ属性は、どちらも複数のレベルを持つ階層で構成されています。商品仕様では、各レベルが > 文字で区切られていますが、レポートでは階層の各レベルを個別に選択します。

たとえば、次のような商品タイプ レベルの商品を考えてみましょう。

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

レポートでは、各レベルが独自のフィールドで返されます。

セグメント 値
product_type_l1 Home & Garden
product_type_l2 Kitchen & Dining
product_type_l3 Kitchen Appliances
product_type_l4 Refrigerators

通貨と価格の指標

conversion_value などの価格指標は、Price 型を使用して表されます。指標が複数の通貨で利用可能な場合、各通貨の値は別の行で返されます。たとえば、次のクエリの場合:

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

次の結果が返されます。

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

クエリで価格指標と価格以外の指標の両方をリクエストすると、価格指標は価格以外の指標とは別の結果行で返されます。通貨コードごとに 1 つの結果行が返されます。たとえば、次のクエリの場合:

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

次のレスポンスが返されます。

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

値がデフォルト値またはゼロのままであっても、選択したすべてのフィールドがレスポンスで返されます。

クエリに使用できるフィールドの詳細については、productPerformanceView テーブルのフィールドをご覧ください。