Analytics Setup

설정 · 운영

개발자용이다. 분석만 한다면 읽지 않아도 된다.

키 설정

apps/mobile/.env.local에 한 줄을 둔다. 이 파일은 git에 올라가지 않는다.

PUBLIC_POSTHOG_KEY=phc_<프로젝트 API 키>

• 값은 PostHog Project settings → Project API Key(phc_로 시작)다.
• 개인 API 키(phx_로 시작)는 넣지 않는다. 앱이 거부한다.
• 키가 없으면 아무것도 보내지 않는다. 앱은 똑같이 동작한다.
• 키는 빌드할 때 들어간다. 바꾸면 다시 빌드한다(pnpm dev, 호스트 앱이면 pnpm bundle:host).
• 배포 번들을 만드는 곳에도 이 파일이 있어야 운영 앱이 보낸다.

권장 설정

설정	권장	이유
개발 · 운영 프로젝트	나눈다(키 둘)	개발 중 조작이 운영 수치에 섞이지 않게
Discard client IP data	켠다	요청의 IP가 PostHog에 닿는다. 저장하지 않으려면 이 설정

테스트 데이터

운영 프로젝트에 들어간 테스트 이벤트다. 분석할 때 뺀다.

날짜 · 시각 (KST)	건수	무엇
2026-09-29 10:35–10:41	7	시뮬레이터 수신 확인(설정 · 알림 이벤트)

확인 이력

날짜	환경	결과
2026-09-29	iOS 시뮬레이터 · 키 없음	앱 정상 · 전송 0건
2026-09-29	iOS 시뮬레이터 · 실제 키	이벤트 7건 모두 수신(응답 200) · 재실행하면 익명 ID가 바뀜
2026-09-29	iOS 시뮬레이터 · 로컬 서버(인터넷 끊김 흉내)	끊긴 동안의 이벤트가 연결 뒤 스스로 도착 · 앱을 껐다 켜도 도착

절차는 저장소 docs/e2e/analytics.md에 있다(#152 머지 뒤 main에서 열린다).