Classic/VPC 환경에서 이용 가능합니다.
플레이어를 통해 재생을 시도한 사용자의 합계를 차트 형식으로 조회합니다. 조회 시작 시점과 종료 시점 간의 간격에 따라 데이터 인터벌이 달라집니다.
| 시작 시점과 종료 시점 간격 | 인터벌 |
|---|---|
| 1일 이하 | 5분 단위 |
| 2일 이상 | 1일 단위 |
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| GET | /v1/charts/uniqUserCnt |
요청 헤더
Video Player Enhancement API에서 공통으로 사용하는 헤더에 대한 정보는 Video Player Enhancement 요청 헤더를 참조해 주십시오.
요청 쿼리 파라미터
요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
device |
String | Optional | 플레이어 재생 환경
|
videoType |
String | Optional | 재생 소스 구분
|
startDate |
Date | Optional | 조회 시작 일시
|
endDate |
Date | Optional | 조회 종료 일시
|
요청 예시
요청 예시는 다음과 같습니다.
curl --location --request GET 'https://ma-dashboard-api.vpe.naverncp.com/v1/charts/uniqUserCnt?device=PC,Mobile&videoType=VOD,LIVE' \
--header 'x-api-key: {API Key}' \
--header 'x-project-id: {Project id}'
응답
응답 형식을 설명합니다.
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
code |
String | - | 응답 코드 |
message |
String | - | 응답 메시지 |
result |
Object | - | 응답 결과 |
result.uniqUsers |
Integer | - | 유니크 사용자 수 |
result.logDate |
Date | - | 일시 |
응답 상태 코드
Video Player Enhancement API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Video Player Enhancement 응답 상태 코드를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
{
"code": 200,
"message": "uniqUserCnt (1d)",
"result": [
{
"uniqUsers": 1,
"logDate": "2025-10-10 00:00:00"
},
{
"uniqUsers": 2,
"logDate": "2025-10-09 00:00:00"
},
{
"uniqUsers": 1,
"logDate": "2025-10-08 00:00:00"
},
{
"uniqUsers": 1,
"logDate": "2025-10-07 00:00:00"
},
{
"uniqUsers": 0,
"logDate": "2025-10-06 00:00:00"
},
{
"uniqUsers": 0,
"logDate": "2025-10-05 00:00:00"
},
{
"uniqUsers": 2,
"logDate": "2025-10-04 00:00:00"
},
{
"uniqUsers": 2,
"logDate": "2025-10-03 00:00:00"
},
{
"uniqUsers": 4,
"logDate": "2025-10-02 00:00:00"
},
{
"uniqUsers": 2,
"logDate": "2025-10-01 00:00:00"
}
]
}