판매자 센터
맞춤 보고서에서 사용할 수 있는 세분화는
쿼리에 적절한 필드를 추가하여 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_microsmetrics.ordered_item_sales_microsmetrics.returns_microsmetrics.shipped_item_sales_micros
Google에서 구매 측정항목
판매자 센터 쿼리 언어는 Google에서 구매 주문에 대한 두 가지 카테고리의 측정항목(상품 수준 측정항목 및 주문 수준 측정항목)을 지원합니다.
- 상품 수준 측정항목
주문 내 상품을 기반으로 계산되며 각 주문의 상품 제품 측정기준과 연결된 측정항목입니다.
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
자세히 알아보기
세그먼트의 전체 목록은 문서를 참고하세요.