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

Performance reports

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

指標

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

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

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 日に販売者のクリック数が 0 だったため、その日付の値は返されません。

{
  "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 の組み合わせごとに行が含まれ、その組み合わせのクリック数が含まれます。

{
  "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 クエリ言語では、次の 2 つの属性グループで指標をセグメント化できます。これらの属性グループは、広告枠を整理するために定義できます。

カテゴリレベル: 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"
        }
      }
    }
  ]
}

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