feat: Firebase Analytics 연동 (앱 사용자 행동 분석)

[ychany]

작업 요약

• Firebase Analytics (GA4) 연동 — 앱/웹뷰 통합 추적
• 핵심 funnel + 사용자 행동 9개 이벤트 부착
• webBridge 로 웹 → 앱 메시지 타입 추가 (LOG_ANALYTICS_EVENT)

작업 세부 내용

인프라

• packages/core 에 WEB_REQ_LOG_ANALYTICS_EVENT 메시지 타입 정의
• apps/app 에 @react-native-firebase/analytics 설치 + 헬퍼 (utils/analytics.ts)
• 앱 진입 시 logAppOpen() 호출
• webBridge onMessage 핸들러에 케이스 추가 → analytics().logEvent 위임
• apps/web 에 이벤트 상수 / 헬퍼 (consts/analytics.ts, utils/analytics.ts)
• 웹 → 앱 통합으로 사용자 1명 = 1 ID, 일관된 측정

부착된 이벤트 (9종)

• funnel: sign_up_complete, wish_add, tournament_create, tournament_start, tournament_complete
• 사용자 행동: friend_invite_send, friend_join, receipt_share, play_link_share, invite_expiry_change

PII 처리

• 모든 params 는 ID(number) 또는 enum-like 상수만 전송
• 닉네임/이메일/실명 등은 일절 전달하지 않음

검증

• TypeScript (web + app) 통과
• ESLint (변경 영역) 에러 0
• 네이티브 모듈이라 pnpm expo prebuild --clean 후 iOS/Android 빌드 필요

연관 이슈

closes #257

Summary by CodeRabbit

릴리스 노트

• Chores
  • Firebase/GA4 기반 사용자 행동 분석이 도입/확장되었습니다.
  • 앱 진입 시 분석 세션이 시작되고, 웹뷰에서는 분석 이벤트가 네이티브로 전달되어 중복 집계를 방지합니다.
  • 웹에서는 설정된 경우에만 GA4가 활성화됩니다.
  • 회원가입, 토너먼트 생성/시작/완료, 친구 초대·조인, 영수증/플레이 링크 공유, 위시 추가, 초대 만료 변경 등 주요 흐름의 이벤트가 기록됩니다.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
depromeet	Ready	Preview, Comment	Jun 19, 2026 7:45am

[github-actions]

No description provided.

[coderabbitai]

Warning

Review limit reached

@ychany, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 49 minutes and 28 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 928eca80-311f-401b-85c2-982cd2e0ec3e

📥 Commits

Reviewing files that changed from the base of the PR and between c60c237 and ecb5309.

⛔ Files ignored due to path filters (1)

• pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (3)

• apps/app/package.json
• apps/web/src/app/layout.tsx
• apps/web/src/app/tournament/[id]/result/_components/ResultClient.tsx

Walkthrough

packages/core에 WebBridge 분석 메시지 타입과 WEB_REQ_LOG_ANALYTICS_EVENT 상수를 추가하고, apps/app에 Firebase Analytics 유틸(logAnalyticsEvent, logAppOpenEvent)과 브릿지 핸들러를 구현하며, apps/web에 이벤트 상수·웹 유틸을 신규 작성하고 GA4 웹 스트림을 설정한 후 주요 사용자 행동 훅/컴포넌트 13곳에 이벤트 로깅 호출을 추가한다.

Changes

Firebase Analytics WebBridge 연동

Layer / File(s)	Summary
공유 타입 및 WebBridge 메시지 상수 packages/core/src/types/analytics.ts, packages/core/src/consts/webBridge.ts, packages/core/src/types/webBridge.ts, packages/core/src/index.ts	AnalyticsEventParamT, AnalyticsEventParamsT, LogAnalyticsEventPayloadT, WebReqLogAnalyticsEventMessageT 타입 4종을 신규 정의하고, WEBBRIDGE_MESSAGE_TYPE.WEB_REQ_LOG_ANALYTICS_EVENT 상수를 추가하며, WebBridgeMessageT 유니온에 새 메시지 타입을 포함시켜 core에서 재노출한다.
네이티브 앱 Analytics 유틸 및 브릿지 핸들러 apps/app/package.json, apps/app/utils/analytics.ts, apps/app/app/index.tsx	@react-native-firebase/analytics 의존성을 추가하고, 예외 비전파 방식의 logAnalyticsEvent/logAppOpenEvent 유틸을 신규 작성한다. 앱 진입 시 logAppOpenEvent를 호출하고, WebBridge switch에 WEB_REQ_LOG_ANALYTICS_EVENT 케이스를 추가해 웹에서 전달된 이벤트를 Firebase Analytics로 기록한다.
웹 Analytics 유틸 및 이벤트 상수 apps/web/src/consts/analytics.ts, apps/web/src/utils/analytics.ts	ANALYTICS_EVENT 상수 객체(13개 이벤트명)와 AnalyticsEventNameT 타입을 신규 정의하고, logAnalyticsEvent 유틸을 작성해 웹뷰에서는 WebBridge.postMessage로 네이티브에, 일반 브라우저에서는 window.gtag로 이벤트를 전달한다.
GA4 웹 스트림 설정 및 의존성 apps/web/package.json, apps/web/src/app/layout.tsx	@next/third-parties 의존성을 추가하고 RootLayout에서 GoogleAnalytics 컴포넌트를 조건부 렌더링한다: 웹뷰(!isWebview) 환경에서는 중복 집계를 방지하고, 일반 브라우저 환경에서만 NEXT_PUBLIC_GA_ID가 설정된 경우 GA4 웹 스트림을 활성화한다.
웹 훅·컴포넌트 이벤트 호출 추가 apps/web/src/app/auth/callback/.../usePostSocialLogin.ts, apps/web/src/app/home/_hooks/usePostCreateTournament.ts, apps/web/src/hooks/usePostWishLink.ts, apps/web/src/hooks/usePostWishOCR.ts, apps/web/src/app/tournament/[id]/create/..., apps/web/src/app/tournament/[id]/result/..., apps/web/src/app/tournament/join/_hooks/...	소셜 로그인 완료(SIGN_UP_COMPLETE), 위시 추가(WISH_ADD), 토너먼트 생성/시작/완료(TOURNAMENT_*), 친구 초대 전송/합류/공유(FRIEND_*, RECEIPT_SHARE, PLAY_LINK_SHARE), 초대 만료 변경(INVITE_EXPIRY_CHANGE) 등 13개의 사용자 행동 시점에 logAnalyticsEvent 호출을 추가한다. ResultClient에는 COMPLETED 상태 진입 시 1회 실행되는 useEffect도 신설된다.

Sequence Diagram(s)

sequenceDiagram
  rect rgba(135, 206, 235, 0.5)
    note over 웹훅,WebBridge: 웹뷰 (apps/web)
    participant 웹훅 as 웹 훅/컴포넌트
    participant logEvent_web as logAnalyticsEvent (web util)
    participant WebBridge as WebBridge.postMessage
  end
  rect rgba(144, 238, 144, 0.5)
    note over AppIndex,FirebaseSDK: 네이티브 앱 (apps/app)
    participant AppIndex as app/index.tsx
    participant logEvent_app as logAnalyticsEvent (app util)
    participant FirebaseSDK as Firebase Analytics SDK
  end

  웹훅->>logEvent_web: logAnalyticsEvent(ANALYTICS_EVENT.X, params)
  logEvent_web->>WebBridge: postMessage({type: WEB_REQ_LOG_ANALYTICS_EVENT, payload: {name, params}})
  WebBridge->>AppIndex: onMessage 수신
  AppIndex->>logEvent_app: logAnalyticsEvent(name, params)
  logEvent_app->>FirebaseSDK: analytics().logEvent(name, params)

Loading

sequenceDiagram
  rect rgba(176, 224, 230, 0.5)
    note over 사용자,분석: 일반 브라우저 (apps/web)
    participant 사용자 as 사용자
    participant 웹페이지 as 웹 페이지
    participant logEvent as logAnalyticsEvent
    participant gtag as window.gtag
    participant GA4 as Google Analytics 4
  end

  사용자->>웹페이지: 사용자 행동 (로그인/토너먼트 생성)
  웹페이지->>logEvent: logAnalyticsEvent(ANALYTICS_EVENT.X, params)
  logEvent->>gtag: gtag('event', name, params)
  gtag->>GA4: 이벤트 전송

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• depromeet/PIKI-Client#164: apps/app/app/index.tsx의 WebView→네이티브 switch 메시지 처리 로직을 확장하는데, 본 PR은 WEB_REQ_LOG_ANALYTICS_EVENT 케이스를 추가하고 retrieved PR은 WEB_REQ_LOGOUT 케이스를 추가해 같은 디스패처를 다른 이벤트 로직으로 업데이트한다.
• depromeet/PIKI-Client#166: packages/core/src/consts/webBridge.ts의 WEBBRIDGE_MESSAGE_TYPE 및 packages/core/src/types/webBridge.ts의 WebBridgeMessageT 유니온을 확장해 웹↔앱 브리지 메시지 인프라를 같은 지점에서 수정하므로 코드 레벨상 연관된다.

Suggested reviewers

• iOdiO89
• kanghaeun

Poem

🐰 토끼가 발자국을 남기기 시작했어요~
로그인하고, 위시 담고, 토너먼트 만들고,
친구 초대하고 영수증도 공유하면~
Firebase가 모든 걸 살짝 기록해요! 📊
이제 어디서 이탈하는지 훤히 보인다네요 ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	PR 제목이 Firebase Analytics 연동이라는 주요 변경사항을 명확하게 요약하고 있으며, 부제목으로 '앱 사용자 행동 분석'을 통해 목적을 명확히 함.
Linked Issues check	✅ Passed	PR이 연결된 이슈 #257의 모든 주요 코딩 요구사항을 충족함: Firebase 모듈 설치, analytics 유틸 작성, 앱 진입 시 logAppOpen 호출, webBridge 통합, 9개 이벤트 추적 구현, TypeScript/ESLint 검증 완료.
Out of Scope Changes check	✅ Passed	모든 변경사항이 Firebase Analytics 연동과 이벤트 추적이라는 명확한 범위 내에 있으며, 관련 없는 기능이나 리팩토링이 없음.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/257-firebase-analytics

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/app/package.json`:
- Around line 18-20: The `@react-native-firebase` packages in package.json have
inconsistent versions which violates React Native Firebase's "One True Version"
policy. Update all `@react-native-firebase/`* packages (analytics, app, and
messaging) to use exactly the same version number. Choose either ^24.1.1 for all
packages or downgrade analytics to ^24.1.0 to match app and messaging, then
ensure every `@react-native-firebase` dependency throughout the file uses the
selected unified version.

In `@apps/web/src/app/tournament/`[id]/result/_components/ResultClient.tsx:
- Around line 46-52: The useEffect hook in the completion event logging is
missing tournamentId in its dependency array despite using it in the
logAnalyticsEvent call. Add tournamentId to the dependency array alongside
tournamentData.status so that the analytics event is properly triggered whenever
either the tournament ID or the status changes to COMPLETED. This ensures that
if the same component instance is reused with a different tournament ID, the
completion event will be logged correctly for the new tournament rather than
being skipped or recorded with stale data.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: eb17079d-7169-413a-bece-4ba984a7a701

📥 Commits

Reviewing files that changed from the base of the PR and between aec1fa5 and 196ffe6.

⛔ Files ignored due to path filters (1)

• pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (20)

• apps/app/app/index.tsx
• apps/app/package.json
• apps/app/utils/analytics.ts
• apps/web/src/app/auth/callback/[provider]/_hooks/usePostSocialLogin.ts
• apps/web/src/app/home/_hooks/usePostCreateTournament.ts
• apps/web/src/app/tournament/[id]/create/_components/invite-friends/InviteFriendsDialog.tsx
• apps/web/src/app/tournament/[id]/create/_hooks/usePatchInviteExpiry.ts
• apps/web/src/app/tournament/[id]/create/_hooks/usePostTournamentStart.ts
• apps/web/src/app/tournament/[id]/result/_components/ResultClient.tsx
• apps/web/src/app/tournament/[id]/result/_components/plate-share-dialog/PlateShareDialog.tsx
• apps/web/src/app/tournament/join/_hooks/usePostJoin.ts
• apps/web/src/app/tournament/join/_hooks/usePostJoinGuest.ts
• apps/web/src/consts/analytics.ts
• apps/web/src/hooks/usePostWishLink.ts
• apps/web/src/hooks/usePostWishOCR.ts
• apps/web/src/utils/analytics.ts
• packages/core/src/consts/webBridge.ts
• packages/core/src/index.ts
• packages/core/src/types/analytics.ts
• packages/core/src/types/webBridge.ts