애널리틱스
웹 분석, Core Web Vitals, 퍼널, 공유 대시보드와 주간 리포트를 살펴보는 방법입니다.
애널리틱스는 프로젝트에서 수집한 이벤트와 피드백을 운영 관점에서 확인하는 영역입니다. 모니터 상태는 API 모니터링 화면에서, 서버 자원 시계열은 서버 상세 화면에서 확인합니다.
애플리케이션 또는 SDK
↓
프로젝트 키로 이벤트 전송
↓
프로젝트 분석 화면이벤트를 보낼 때는 프로젝트 키를 사용하고, 조직 전체 관리 API를 호출할 때는 관리 API 키를 사용합니다. 키의 scope는 필요한 작업에 맞춰 최소 범위로 발급하세요.
항목 | 확인 위치 |
|---|---|
API 응답 상태 | 모니터 상태와 이벤트 |
지연 시간 | 이벤트의 |
사용자 의견 | 피드백 목록 |
호스트 자원 | 서버 상세의 CPU, memory, disk, network |
모니터의 slug는 이벤트와 연결되는 안정적인 식별자이므로 임의로 바꾸지 않는 것이 좋습니다.
데이터 전송 실패 시 SDK의 오류 로그에 secret을 포함하지 않도록 환경 변수 구성을 점검하세요.
피드백을 자동 수집할 때는 사용자 식별자와 함께 민감한 본문을 무분별하게 보내지 말고, 프로젝트의 데이터 보존 정책을 따르세요.
추적 스크립트에 data-capture-vitals 속성을 추가하면 페이지가 숨겨지거나 종료될 때 지원되는 Core Web Vitals를 /api/event로 보냅니다.
<script defer data-domain="example.com" data-capture-vitals
src="https://crm.theseeker.io/js/script.js"></script>지원하는 지표는 LCP, INP, CLS, FCP, TTFB입니다. 브라우저가 제공한 지표만 전송하며 한 번의 beacon에 지표가 하나 이상 있어야 저장됩니다. 값은 ms 단위이고 CLS는 소수점 네 자리까지 집계됩니다.
지표 | 좋음 | 개선 필요 | 나쁨 |
|---|---|---|---|
LCP | ≤ 2,500 ms | ≤ 4,000 ms | > 4,000 ms |
INP | ≤ 200 ms | ≤ 500 ms | > 500 ms |
CLS | ≤ 0.1 | ≤ 0.25 | > 0.25 |
FCP | ≤ 1,800 ms | ≤ 3,000 ms | > 3,000 ms |
TTFB | ≤ 800 ms | ≤ 1,800 ms | > 1,800 ms |
화면은 기간별 p75와 평가, 경로별 결과를 제공하며 전체·모바일·데스크톱 기기로 나눠 볼 수 있습니다. Web Vitals 원시 이벤트는 90일 보관합니다.
프로퍼티별 퍼널은 이름과 2~8단계로 구성됩니다. 단계는 경로 glob을 사용하는 pageview 또는 이벤트 이름입니다. 예를 들어 /pricing 페이지뷰, /signup 페이지뷰, signup_completed 이벤트를 순서대로 설정하면 단계별 세션, 시작 대비·이전 단계 대비 전환율, 이탈 수를 확인할 수 있습니다. 단계는 같은 세션에서 앞 단계 이후 발생해야 합니다. 퍼널 이름은 프로퍼티 안에서 고유해야 합니다.
개요의 소스·페이지·진입 페이지·종료 페이지·국가·기기·브라우저·운영체제·채널·UTM 브레이크다운 행을 선택하면 해당 값이 필터로 추가됩니다. 필터는 URL에 저장되어 링크 공유와 새로고침 후에도 유지되고, 뒤로·앞으로 이동으로 이전 선택을 되돌릴 수 있습니다. 같은 차원에서는 한 값만 적용되며 새 값을 고르면 기존 값이 바뀝니다. 서로 다른 차원의 필터는 AND로 결합됩니다.
필터가 활성화되면 개요 지표는 선택한 기간에 시작한 세션 중 모든 세션 조건에 맞는 범위를 기준으로 계산합니다. 페이지 필터는 그 세션에서 선택한 경로의 pageview가 기간 안에 발생했는지도 확인합니다. 방문자는 해당 세션의 고유 사용자, 방문은 세션 수, 페이지뷰는 해당 세션의 기간 내 pageview 수입니다. 리드와 매출도 같은 세션에 속한 이벤트만 집계합니다. 필터가 있는 동안 Clicks는 지원되지 않아 대시보드에 —로 표시됩니다.
브레이크다운의 소스·국가·기기·브라우저·운영체제·페이지 수치는 페이지뷰 수이고, 채널·진입 페이지·종료 페이지·UTM 수치는 세션 수입니다. 필터 조건은 서로 AND로 연결됩니다.
애널리틱스 화면의 사이트 선택기에서 프로퍼티를 바꾸면 선택한 사이트의 데이터를 확인할 수 있습니다. 선택은 화면 이동 중에도 유지됩니다. 단축 링크 화면에서는 특정 사이트가 아니라 전체 사이트를 선택할 수도 있습니다.
개요·성능·퍼널에서는 오늘, 7일, 30일, 90일 프리셋이나 사용자 지정 기간을 선택할 수 있습니다. 오늘은 조직 시간대의 자정부터 현재까지이며, 날짜 범위는 조직 시간대 기준 시작일과 종료일을 모두 포함합니다. 사용자 지정 기간은 최근 90일 범위 안에서 최대 90일까지 선택할 수 있습니다. 보존 기간을 넘기거나 미래 날짜를 선택할 수 없습니다. 에러 화면의 기간은 오류 발생 시각을 거르는 필터이며, 세션과 실시간은 실시간 창을 사용합니다. 링크 통계는 링크별 고정 기간을 사용합니다.
개요에서 이전 기간 비교를 켜면 현재 기간과 직전 동일 길이 기간을 함께 확인합니다. CSV는 화면 다운로드 또는 GET /api/analytics/export로 내보낼 수 있습니다. 사용자 지정 기간은 from과 to ISO 날짜로 전달하며 기간은 최대 90일입니다. 필터가 활성화된 동안에는 CSV 내보내기가 비활성화됩니다. 내보내려면 먼저 필터를 지우세요.
report는 timeseries, sources, channels, utm_sources, utm_mediums, utm_campaigns, top_pages, entry_pages, exit_pages, countries, devices, browsers, os, goals, vitals_summary, vitals_pages, vitals_daily, funnel을 지원합니다. Vitals 보고서에는 device=all|mobile|desktop, 퍼널 보고서에는 funnelId를 지정합니다. 결과는 UTF-8 BOM과 RFC 4180 CRLF를 쓰며 Cache-Control: no-store로 제공됩니다. =, +, -, @, 탭 또는 CR로 시작하는 문자열에는 CSV 수식 실행을 막기 위한 작은따옴표가 붙습니다. 요청은 사용자당 분당 30회로 제한됩니다.
관리자는 프로퍼티 하나에 공개 공유 링크를 만들고 폐기할 수 있습니다. 링크는 capability URL이므로 수신자에게만 전달하세요. 공개 화면은 지표, 기간 비교, 시계열, breakdown, 목표와 Web Vitals 요약만 표시합니다. 실시간 방문자, 세션, 오류, 링크 관리 정보와 다른 프로퍼티는 공개하지 않습니다. 폐기한 링크는 즉시 사용할 수 없고, 링크 페이지는 검색 색인과 referrer 전달을 제한합니다.
각 사용자는 프로퍼티별 주간 리포트를 설정할 수 있고, 설정 화면에서 자신에게 테스트 메일을 보낼 수 있습니다. 리포트는 조직 시간대 기준 월요일 09:00 이후에 지난 월요일부터 일요일까지의 한 주를 발송 대상으로 삼습니다. 매주 한 번 발송되며 실패한 발송은 최대 3회까지 재시도합니다.
상태 이벤트 전송은 Status SDK를, 서버 자원 확인은 서버 모니터링 개요를 참고하세요. 에러 수집은 에러 트래킹, 위젯과 설문은 피드백을 참고하세요.
이 페이지가 도움이 되었나요?