Merchant API는 실적 보고서(예: product_performance_view)를 제공합니다.
이 페이지에서는 실적 보고서의 구조를 설명합니다.
측정항목
반환할 측정항목 (예: clicks 및 impressions)을 쿼리할 수 있습니다. 실적 데이터에 대한 보고서 서비스를 쿼리하려면 기간에 필터를 추가해야 합니다.
다음은 지정된 기간 내의 총 클릭수와 함께 단일 행을 반환하는 샘플 쿼리입니다.
SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'
반환할 데이터를 지정해야 합니다. 와일드 카드 (예: SELECT
*)는 오류를 반환합니다.
다음 샘플 응답은 2023년 12월 1일부터 2023년 12월 21일 사이에 판매자가 모든 제품, 모든 마케팅 방법에서 총 4,440회의 클릭수를 기록했음을 보여줍니다.
{
"results": [
{
"productPerformanceView": {
"clicks": "4440"
}
}
]
}
세그먼트
실적 보고서에서 세분화에 세그먼트 필드를 사용할 수 있습니다.
예를 들어 marketing_method를 쿼리하면 각 마케팅 방법의 행과 SELECT 절에서 해당 마케팅 방법에 지정한 측정항목이 포함된 보고서가 반환됩니다.
세그먼트 필드는 제품 속성 (예: offer_id, brand, category) 또는 이벤트 속성 (예: date, marketing_method)일 수 있습니다.
세그먼트 필드는 SQL의 GROUP BY와 유사하게 작동합니다. 세그먼트 필드는 선택한 측정항목을 분할하여 SELECT 절의 각 세그먼트로 그룹화합니다.
다음은 기간의 추가 조건 내에서 clicks을 기준으로 내림차순으로 일일 클릭수를 반환하는 샘플 쿼리입니다. 요청된 측정항목 중 하나 이상이 0이 아닌 행만 반환됩니다.
SELECT
date,
clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC
다음 샘플 응답은 판매자가 2023년 12월 1일에 모든 마케팅 방법에서 모든 제품에 대해 1,546회의 클릭을, 2023년 12월 2일에 모든 마케팅 방법에서 모든 제품에 대해 829회의 클릭을 기록했음을 보여줍니다. 판매자는 2023년 12월 3일에 클릭수가 없으므로 해당 날짜에 아무것도 반환되지 않습니다.
{
"results": [
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 1
},
"clicks": "1546"
}
},
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 2
},
"clicks": "829"
}
}
]
}
판매자 센터의 맞춤 보고서와 마찬가지로 Merchant Reports API를 사용하여 동일한 쿼리에 여러 세그먼트를 지정할 수 있습니다.
다음은 30일 동안 계정의 모든 제품에 대한 클릭수를 marketing_method 및 offer_id로 분류하여 반환하는 샘플 쿼리입니다.
SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'
이 쿼리의 응답에는 offer_id 및 marketing_method의 각 조합에 대한 행이 포함되며, 해당 조합의 클릭수가 표시됩니다.
{
"results": [
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12345",
"clicks": "38"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12346",
"clicks": "125"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12346",
"clicks": "23"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12347",
"clicks": "8"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12347",
"clicks": "3"
}
}
]
}
카테고리 및 제품 유형
판매자 센터 쿼리 언어는 인벤토리를 구성하기 위해 정의할 수 있는 두 가지 속성 그룹으로 측정항목을 분류하는 것을 지원합니다.
- 카테고리 수준 Google의 상품 분류에 따른
- 카테고리입니다. 카테고리가 제공되지 않은 경우 Google에서 제품에 카테고리를 자동으로 할당하거나 제공된 카테고리를 추가로 미세 조정할 수 있습니다.
- 제품 유형 수준
- 카테고리 지정을 기준으로 할당한 제품 유형입니다. 카테고리 수준과 달리 사전 정의된 지원 값 집합이 없습니다.
카테고리 및 제품 유형 속성은 모두 여러 수준의 계층 구조로 구성됩니다. 제품 사양은 각 수준을 > 문자로 구분하지만 보고서에서는 계층 구조의 각 수준을 개별적으로 선택합니다.
예를 들어 다음과 같은 제품 유형 수준의 제품을 생각해 보세요.
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
보고서는 각 수준을 자체 필드로 반환합니다.
| 세그먼트 | 값 |
|---|---|
product_type_l1 |
Home & Garden |
product_type_l2 |
Kitchen & Dining |
product_type_l3 |
Kitchen Appliances |
product_type_l4 |
Refrigerators |
통화 및 가격 측정항목
conversion_value와 같은 가격 측정항목은 Price 유형을 사용하여 표시됩니다. 측정항목을 여러 통화로 사용할 수 있는 경우 각 통화의 값이 별도의 행에 반환됩니다. 예를 들면 다음 쿼리와 같습니다.
SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'
다음 결과를 반환합니다.
{
"results": [
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
쿼리에서 가격 및 비가격 측정항목을 모두 요청하면 가격 측정항목은 비가격 측정항목과 별도의 결과 행에 통화 코드당 하나의 결과 행으로 반환됩니다. 예를 들면 다음 쿼리와 같습니다.
SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'
다음 응답을 반환합니다.
{
"results": [
{
"productPerformanceView": {
"conversions": "27",
"conversionValue": {
"amountMicros": "0",
"currencyCode": ""
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
선택한 모든 필드는 값이 여전히 기본값 또는 0인 경우에도 응답에 반환됩니다.
쿼리에 사용할 수 있는 필드에 대한 자세한 내용은 productPerformanceView 테이블의 필드를 참고하세요.