Performance reports

Merchant API には、パフォーマンス レポートが用意されています。たとえば product_performance_view です。 このページでは、パフォーマンス レポートの構造について説明します。

指標

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

指定した期間内のクリック数の合計を 1 行で返すサンプルクエリを次に示します。

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

セグメント

セグメント フィールドを使用して、パフォーマンス レポートをセグメント化できます。たとえば、marketing_method をクエリすると、マーケティング方法ごとに 1 行のレポートが返され、そのマーケティング方法に指定した指標が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"
      }
    }
  ]
}
SELECT

カテゴリと商品タイプ

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