API Reference · 리포트

페이지 뷰 리포트

콘텐츠사가 자기 콘텐츠의 페이지 뷰 / 진입 / 완료 수를 집계 조회합니다.

GET/api/v1/reports/views

요청 파라미터

from (query, date, required) — 조회 시작일.
to (query, date, required) — 조회 종료일 (inclusive).
group_by (query, string, default day) — day / week / month / content / publisher.
content_id (query, uuid, optional) — 특정 콘텐츠로 필터.
publisher_id (query, uuid, optional) — 특정 매체사로 필터.

요청예시

shell

curl -H "Authorization: Bearer {provider_secret}" \
     "https://added.blomics.net/api/v1/reports/views?from=2026-04-01&to=2026-04-30&group_by=content"

응답 필드

items (array)
- bucket (string) — 그룹 키.
- views (int) — 페이지 뷰 수.
- entries (int) — 진입 (gateway redirect) 수.
- completes (int) — 완료 이벤트 수.
summary (object) — 전체 합계.
- views (int)
- entries (int)
- completes (int)

응답예시

json

{
  "items": [
    { "bucket": "2026-04-01", "views": 5000, "entries": 4823, "completes": 1240 },
    { "bucket": "2026-04-02", "views": 5210, "entries": 5012, "completes": 1330 }
  ],
  "summary": { "views": 10210, "entries": 9835, "completes": 2570 }
}

에러처리

400 INVALID_PARAM — 기간 형식 오류·범위 초과.
401 UNAUTHORIZED — 인증 실패.
500 INTERNAL_ERROR — 서버 오류.