판매자 API는 실적 보고서(예: ProductPerformanceView)를 제공합니다.
이 페이지에서는 실적 보고서의 구조를 설명합니다.
측정항목
반환하려는 측정항목 (예: clicks 및 impressions)을 쿼리할 수 있습니다. 보고서 서비스에서 성능 데이터를 쿼리하려면 기간에 필터를 추가해야 합니다.
다음은 지정된 기간 내의 총클릭수와 함께 단일 행을 반환하는 샘플 쿼리입니다.
SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'
반환받을 데이터를 지정해야 합니다. 와일드 카드 (예: SELECT
*)는 오류를 반환합니다.
다음 샘플 응답은 2020년 12월 1일부터 2020년 12월 21일까지 모든 마케팅 방법을 통틀어 모든 제품에서 판매자가 총 4,440회의 클릭수를 보았음을 보여줍니다.
{
"results": [
{
"productPerformanceView": {
"clicks": "4,440"
}
}
]
}
세그먼트
MCQL을 사용하여 세그먼트 필드를 쿼리할 수 있습니다. 세그먼트 필드는 제품 속성 (예: offerId, brand, category) 또는 이벤트 속성 (예: date 및 marketingMethod)일 수 있습니다.
세그먼트 필드는 SQL의 GROUP BY와 유사하게 작동합니다. 세그먼트 필드는 선택된 측정항목을 분할하여 SELECT 절의 각 세그먼트별로 그룹화합니다.
다음은 추가된 기간 조건 내에서 일일 클릭수를 clicks 기준으로 내림차순으로 반환하는 샘플 쿼리입니다. 요청된 측정항목 중 1개 이상이 0이 아닌 행만 반환됩니다.
SELECT
date,
clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC
다음 샘플 응답에서는 판매자가 2020년 12월 1일에 모든 마케팅 방법을 통틀어 모든 제품에서 1,546회의 클릭이 발생했고, 2020년 12월 2일에 모든 마케팅 방법을 통틀어 모든 제품에서 829회의 클릭이 발생했음을 보여줍니다. 이 판매자는 2020년 12월 3일에 클릭이 발생하지 않았으므로 해당 날짜에 대한 항목은 반환되지 않습니다.
{
"results": [
{
"productPerformanceView": {
"date": {
"year": 2020,
"month": 12,
"day": 1
},
"clicks": "1546"
}
},
{
"productPerformanceView": {
"date": {
"year": 2020,
"month": 12,
"day": 2
},
"clicks": "829"
}
}
]
}