セグメンテーション

Merchant Center のカスタム レポートで利用できるセグメンテーションは、クエリに適切なフィールドを追加することで Reporting API に実装できます。たとえば、segments.program のクエリを実行すると、SELECT 句で指定された指標（インプレッション数、クリック数など）を含む、プログラム（ショッピング広告、無料の商品リスティングなど）ごとの行を含むレポートが返されます。

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

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

SELECT
  segments.program,
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

実行

[実行] をクリックして、API Explorer でサンプルを試します。[実行] をクリックしたら、リクエスト URL で販売者 ID のプレースホルダを自分の販売者 ID に更新します。クエリは変更できます。API Explorer で動作させるには、クエリ全体を 1 行に収める必要があります。

このクエリを reports.search に送信した結果は、次のサンプル JSON 文字列のように、offer_id と program の各組み合わせのクリック数を指定する行になります。

{
  "results": [
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "38"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "125"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "23"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "8"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "3"
      }
    }
  ]
}

カテゴリと商品タイプ

Merchant Center クエリ言語では、在庫を整理するために定義できる 2 つの属性グループで指標をセグメント化できます。

カテゴリレベル（segments.category_l1、segments.category_l2 など）

Google の商品分類のカテゴリ。カテゴリが指定されていない場合は、Google が商品を自動的にカテゴリに割り当てるか、指定されたカテゴリをさらに絞り込みます。

商品カテゴリのレベル（segments.product_type_l1、segments.product_type_l2 など）

独自の分類に基づいて指定する商品カテゴリ。カテゴリレベルとは異なり、サポートされている値の事前定義されたセットはありません。

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

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

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

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

通貨と価格の指標

ReportRow の segments.currency_code フィールドは、metrics.conversion_value_micros などの価格指標が返される通貨を示します。これらの指標を正しく解釈するためには、このことが重要であるため、以下の価格指標のいずれかを選択すると、返される ReportRow に segments.currency_code が自動的に含まれます。

• metrics.conversion_value_micros

• metrics.aov_micros
• metrics.ordered_item_sales_micros
• metrics.returns_micros
• metrics.shipped_item_sales_micros

「Google で購入」の指標

Merchant Center クエリ言語は、「Google で購入」の注文に関する 2 つのカテゴリの指標（商品レベルの指標と注文レベルの指標）をサポートしています。

アイテムレベルの指標

注文内のアイテムに基づいて計算され、各注文のアイテムの商品ディメンションに関連付けられた指標。

• metrics.item_days_to_ship
• metrics.item_fill_rate
• metrics.ordered_items
• metrics.ordered_item_sales_micros
• metrics.rejected_items
• metrics.returned_items
• metrics.return_rate
• metrics.returns_micros
• metrics.shipped_items
• metrics.shipped_item_sales_micros
• metrics.unshipped_items

注文レベルの指標

注文ごとに計算される指標。

• metrics.aos
• metrics.aov_micros
• metrics.days_to_ship
• metrics.orders
• metrics.shipped_orders
• metrics.unshipped_orders

注文レベルの指標は、各注文のアイテムの商品ディメンションに関連付けられていません。

アイテムレベルの指標は、利用可能な任意のセグメントと組み合わせて選択できます。ただし、注文レベルの指標を次のいずれかの商品ディメンション セグメントと組み合わせて選択すると、失敗します。

• segments.brand
• segments.category_l1、segments.category_l2、segments.category_l3、segments.category_l4、segments.category_l5
• segments.custom_label1、segments.custom_label2、segments.custom_label3、segments.custom_label4、segments.custom_label5
• segments.offer_id
• segments.product_type_l1、segments.product_type_l2、segments.product_type_l3、segments.product_type_l4、segments.product_type_l5
• segments.title

関連リソース

セグメントの完全なリストについては、ドキュメントをご覧ください。