판매자 센터 맞춤 보고서에서 사용할 수 있는 세분화는 쿼리에 적절한 필드를 추가하여 Reporting API에서 구현할 수 있습니다. 예를 들어 segments.program
를 쿼리하면 SELECT
절에 지정된 대로 해당 프로그램의 측정항목 (노출수, 클릭수 등)이 포함된 각 프로그램(쇼핑 광고, 무료 제품 등록정보 등)의 행이 포함된 보고서가 생성됩니다.
판매자 센터의 맞춤 보고서와 마찬가지로 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 탐색기에서 샘플을 사용해 보세요. 실행을 클릭한 후 요청 URL에서 판매자 ID 자리표시자를 자체 판매자 ID로 업데이트합니다. 쿼리를 수정할 수 있습니다. API 탐색기에서 작동하려면 전체 쿼리를 한 줄로 유지해야 합니다.
이 쿼리를 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"
}
}
]
}
카테고리 및 제품 유형
판매자 센터 쿼리 언어는 인벤토리 정리를 위해 정의할 수 있는 두 가지 속성 그룹별로 측정항목을 분류할 수 있습니다.
- 카테고리 수준 (
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_micros
metrics.ordered_item_sales_micros
metrics.returns_micros
metrics.shipped_item_sales_micros
Buy on Google 측정항목
판매자 센터 쿼리 언어는 Buy on Google 주문에 대한 두 가지 측정항목 카테고리인 상품 수준 측정항목과 주문 수준 측정항목을 지원합니다.
- 상품 수준 측정항목
주문 내 항목을 기반으로 계산되며 각 주문 내 항목의 제품 측정기준과 연결된 측정항목입니다.
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
자세히 알아보기
세그먼트의 전체 목록은 문서를 참고하세요.