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

Segmentation

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

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

次のクエリの例では、アカウント内のすべての商品の 30 日間におけるクリック数を marketingMethod と offerId で分割して返します。

SELECT marketingMethod, offerId, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-11-01' AND '2020-11-30'

このクエリのレスポンスには、offerId と marketingMethod の組み合わせごとの行と、その組み合わせのクリック数が含まれます。

{
  "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`

通貨と価格の指標

価格指標（conversionValue など）は、Price タイプを使用して表されます。指標が複数の通貨で使用できる場合、各通貨の値が別々の行で返されます。たとえば、次のクエリの場合:

SELECT conversionValue
FROM ProductPerformanceView
WHERE date = '2020-11-01'

次の結果が返されます。

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

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

SELECT conversions, conversionValue
FROM ProductPerformanceView
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"
        }
      }
    }
  ]
}

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