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
レポートでは、各レベルが次のように独自のフィールドで返されます。
| セグメント | 値 |
|---|---|
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.conversion_value_micros
などの価格指標が返される通貨を示します。これらの指標を適切に解釈するにはこれが重要であるため、以下の価格指標のいずれかを選択すると、返される
ReportRow に segments.currency_code が自動的に含まれます。
metrics.conversion_value_micros
metrics.aov_microsmetrics.ordered_item_sales_microsmetrics.returns_microsmetrics.shipped_item_sales_micros
「Google で購入」の指標
Merchant Center クエリ言語では、「Google で購入」の注文に関する 2 種類の指標(アイテム単位の指標と注文単位の指標)がサポートされています。
- アイテム単位の指標
注文内のアイテムに基づいて計算され、各注文のアイテムの商品ディメンションに関連付けられた指標。
metrics.item_days_to_shipmetrics.item_fill_ratemetrics.ordered_itemsmetrics.ordered_item_sales_microsmetrics.rejected_itemsmetrics.returned_itemsmetrics.return_ratemetrics.returns_microsmetrics.shipped_itemsmetrics.shipped_item_sales_microsmetrics.unshipped_items
- 注文単位の指標
注文ごとに計算される指標。
metrics.aosmetrics.aov_microsmetrics.days_to_shipmetrics.ordersmetrics.shipped_ordersmetrics.unshipped_orders
注文単位の指標は、各注文のアイテムの商品ディメンションに関連付けられていません。
アイテム単位の指標は、使用可能な任意のセグメントと組み合わせて選択できます。 ただし、注文単位の指標を次のいずれかの商品ディメンション セグメントと組み合わせて選択すると、失敗します。
segments.brandsegments.category_l1、segments.category_l2、segments.category_l3、segments.category_l4、segments.category_l5segments.custom_label1、segments.custom_label2、segments.custom_label3、segments.custom_label4、segments.custom_label5segments.offer_idsegments.product_type_l1、segments.product_type_l2、segments.product_type_l3、segments.product_type_l4、segments.product_type_l5segments.title
詳細
セグメントの完全なリストについては、 ドキュメントをご覧ください。