Merchant Center のカスタム レポートで利用できるセグメンテーションは、適切なフィールドをクエリに追加することで、Reporting API に実装できます。たとえば、segments.program
を検索すると、プログラムごとに 1 行を含むレポートが生成されます。この行には、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
レポートでは、次のようにそれぞれのレベルが個別のフィールドで返されます。
分類して表示 | 値 |
---|---|
segments.product_type_l1 |
Home & Garden |
segments.product_type_l2 |
Kitchen & Dining |
segments.product_type_l3 |
Kitchen Appliances |
segments.product_type_l4 |
Refrigerators |
通貨と価格の指標
ReportRow
の segments.currency_code
フィールドは、metrics.order_item_sales_micros
などの価格指標を返す際の通貨を示します。これらの指標を適切に解釈するうえで重要なため、以下の価格指標を選択すると、常に、返される ReportRow
に自動的に segments.currency_code
が含まれます。
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
補足説明
セグメントの完全なリストについては、ドキュメントをご覧ください。