Web Analytics API 공개 제공
Vercel 프로젝트의 페이지뷰, 방문자, 커스텀 이벤트를 조회하는 Web Analytics API가 공개됐다.
교안에 영향
Web Analytics 수치를 API로도 제공하므로, 기존 문서의 대시보드만으로 확인한다는 안내는 더 이상 완전하지 않다.
요약
- Web Analytics API를 공개해 Vercel 프로젝트의 페이지뷰, 방문자, 커스텀 이벤트를 프로그램 방식으로 조회할 수 있게 했다. - API 응답은 Web Analytics 대시보드와 같은 집계 데이터 모델을 사용해 UI와 수치가 일치한다. - visits와 events 두 리소스를 제공하며, count와 aggregate 엔드포인트로 단일 합계나 그룹별 집계를 받을 수 있다. - OData 문법의 필터와 by 그룹화를 지원하고, 원시 이벤트 스트림은 Drains로 전달할 수 있다.
바뀐 것
새 기능
- Web Analytics API를 공개했다.
- 페이지뷰와 방문자를 위한 visits 리소스를 제공한다.
- track()으로 보낸 커스텀 이벤트를 위한 events 리소스를 제공한다.
- count 엔드포인트에서 단일 합계를 반환한다.
- aggregate 엔드포인트에서 시간, 경로, 국가, referrer, device, feature flag, 커스텀 이벤트 데이터 기준으로 그룹 집계를 제공한다.
- OData 문법의 필터와 by 그룹화를 지원한다.
- Drains로 원시, 비집계 이벤트 스트림을 자체 인프라로 전달할 수 있다.
기타
- Web Analytics API guide에서 인증 설정, 필터 문법, 응답 스키마를 안내한다.