パフォーマンス レポート

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

セグメント

パフォーマンス レポートのセグメンテーションには、セグメント フィールドを使用できます。たとえば、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 テーブルのフィールドをご覧ください。

前へ
Evaluate your products
次へ
Understand the market