애널리틱스 통합

웹사이트에 프라이버시를 존중하는 분석을 추가하는 방법을 알아보세요.

스크립트 설치

만약 이미 스크립트를 설치했다면 이 섹션을 건너뛰세요. 모든 기능은 하나의 통합된 privatestater.js 스크립트로 제공됩니다.

웹사이트의 <head> 섹션에 다음 스크립트를 추가하세요:

<script> window.PrivateStaterConfig = { prstSite: "YOUR_SITE_ID" }; </script>
<script src="https://privatestater.com/privatestater.js"></script>

YOUR_SITE_ID를 대시보드에서 생성한 웹사이트 ID로 교체하세요.

스크립트가 설치되면 분석 기능은 자동으로 활성화됩니다.

자동 수집 데이터

스크립트가 설치되면 다음 데이터가 자동으로 수집됩니다:

데이터	설명	예시
방문자 수	시간별 고유 방문자	시간당 집계
페이지 경로	방문한 URL 경로	`/`, `/about`, `/blog/post-1`
브라우저	사용 브라우저 종류	Chrome, Firefox, Safari
기기 유형	기기 분류	Desktop, Mobile, Tablet
언어	브라우저 언어 설정	ko, en, ja
레퍼러	유입 경로	google.com, twitter.com

프라이버시 보호 방식

IP 해시 처리: IP 주소는 날짜+시간과 결합하여 해시 처리됩니다. 원본 IP는 저장되지 않습니다.
시간별 중복 제거: 같은 시간대에 같은 방문자가 여러 번 방문해도 1회로 집계됩니다.
쿠키 없음: 방문자를 추적하기 위한 쿠키를 사용하지 않습니다.

유입 소스 추적

URL 파라미터를 사용하여 방문자의 유입 소스를 추적할 수 있습니다.

지원 파라미터

다음 파라미터 중 하나를 URL에 추가하면 자동으로 레퍼러로 기록됩니다:

파라미터	용도	예시 URL
`src`	일반 소스	`example.com?src=newsletter`
`source`	일반 소스	`example.com?source=twitter`
`ref`	레퍼럴	`example.com?ref=partner`
`utm_source`	UTM 캠페인	`example.com?utm_source=google`

사용 예시

뉴스레터에서 링크할 때:

https://example.com/landing?src=newsletter

SNS에서 공유할 때:

https://example.com/blog/post?source=mastodon

파트너 웹사이트에서:

https://example.com?ref=partner-website

소스 파라미터가 있으면 HTTP Referer 헤더보다 우선 적용됩니다.

클릭 추적

특정 버튼이나 링크의 클릭을 추적하려면 JavaScript API를 사용합니다.

기본 사용법

window.PrivateStater.statsClick("button_id");

실제 사용 예시

<button onclick="window.PrivateStater.statsClick('signup_button')">
  회원가입
</button>

<a href="/pricing" onclick="window.PrivateStater.statsClick('pricing_link')">
  가격 보기
</a>

이벤트 리스너 방식

document.getElementById('cta-button').addEventListener('click', function() {
    window.PrivateStater.statsClick('cta_main');
});

버튼 ID 규칙

영문, 숫자, 하이픈(-), 언더스코어(_) 사용 가능
공백 사용 불가
최대 100자

대시보드에서 통계 확인

조회 기간

대시보드에서 다음 기간별로 통계를 조회할 수 있습니다:

기간	설명
1시간	최근 1시간~2시간
12시간	최근 12시간
1일	최근 24시간
3일	최근 3일
7일	최근 1주일
14일	최근 2주
30일	최근 1개월
6개월	최근 6개월
1년	최근 1년

통계 유형

통계	설명
방문자	시간별 방문자 비율 및 수
브라우저	브라우저별 방문자 비율 및 수
기기	데스크톱/모바일/태블릿 비율 및 수
언어	방문자 언어 비율 및 수
페이지	유입된 페이지 비율 및 수
레퍼러	유입된 경로 비율 및 수
클릭 횟수	클릭 비율 및 수

봇 감지

PrivateStater는 자동으로 알려진 봇을 감지하고 별도로 분류합니다:

검색엔진 크롤러 (Googlebot, Bingbot 등)
모니터링 도구 (Pingdom, UptimeRobot 등)
SNS 프리뷰 봇 (Mastodon, Twitter 등)

봇 트래픽은 일반 방문자 통계와 구분되어 기기 유형에 봇 이름으로 표시됩니다.

문제 해결

통계가 표시되지 않아요

스크립트가 올바르게 설치되었는지 확인하세요.
YOUR_SITE_ID가 대시보드의 웹사이트 ID와 일치하는지 확인하세요.
브라우저 개발자 도구 콘솔에서 에러가 있는지 확인하세요.
광고 차단기가 스크립트를 차단하지 않는지 확인하세요.

localhost에서 테스트가 안 돼요

로컬 개발 환경 또는 보안되지 않은 연결의 경우에는 통계가 기록되지 않습니다. 프로덕션 환경에서만 실제 통계가 기록됩니다.