Skip to content

[GMSS-358]Mixpanel 동작과 결과 이벤트 추가 - #78

Merged
seunghee17 merged 3 commits into
developfrom
feature/mixpanel-action-events
Nov 12, 2026
Merged

seunghee17 merged 3 commits into
developfrom
feature/mixpanel-action-events

Conversation

@soyeonLee126

@soyeonLee126 soyeonLee126 commented Nov 3, 2026 •

Copy link
Copy Markdown
Collaborator

작업 개요

#77에서 추가한 화면 진입 이벤트(screen_view)만으로는 사용자가 화면 안에서 왜 다음 단계로 넘어가지 않았는지 알 수 없습니다. 이 PR에서는 로그인부터 파쇄까지 주요 동작과 그 결과(성공, 실패, 차단, 취소)를 Mixpanel 이벤트로 기록합니다.

#77 위에 올린 PR이라 base를 feature/archive-mixpanel로 두었습니다. #77이 머지되면 base를 develop으로 바꾸겠습니다.

작업 유형

  • feat: 새 기능
  • fix: 버그 수정
  • refactor: 리팩토링 (동작 변경 없음)
  • build: 빌드/의존성 설정
  • chore: 기타 (문서, 설정 등)
  • test: 테스트 추가/수정

변경 사항

  • 이벤트 이름과 속성 키를 domain/.../analytics/AnalyticsEvent.kt의 상수로 정의했습니다. iOS와 같은 이름을 써야 하므로 이 파일을 기준 목록으로 둡니다.
  • 각 ViewModel에 AnalyticsTracker를 주입해 아래 이벤트를 기록합니다. 이벤트 속성에는 사용자가 작성한 정보(메시지, 검색어, 닉네임)와 대화 id, 카드 id를 포함하지 않습니다.
화면 이벤트
로그인 login_click, login_success, login_fail, login_cancel
온보딩 onboarding_next, onboarding_skip (step), onboarding_complete
홈 home_submit, home_submit_blocked, home_submit_fail
대화방 chat_send, chat_send_blocked, chat_send_fail, chat_end_request, chat_end_cancel, chat_end_confirm, card_create_success, card_create_fail, card_fold_step (stage), card_set_aside, card_reopen
대화 목록 chat_list_card_click, chat_search, chat_delete_confirm
보관함 상세 archive_month_change (year_month), archive_card_open, archive_conversation_view, archive_share_click (target), archive_card_discard, archive_clear (모두 emotion 포함)
파쇄 card_shred_tap (tap_count), card_shred_success, card_shred_fail (모두 emotion, scope 포함)
  • 온보딩에는 ViewModel이 없어서 이벤트 기록용 OnboardingViewModel을 추가했습니다.
  • 보관함의 공유 대상 선택은 CardDetailDialog에서 처리하므로, 공유 클릭 콜백을 ArchiveDetailScreen을 거쳐 ViewModel까지 연결했습니다.
  • ChattingListViewModel.runSearch()가 실제로 조회했는지를 Boolean으로 반환하도록 바꿨습니다. 삭제 뒤 목록을 맞추는 재검색은 chat_search로 집계하지 않기 위해서입니다.
  • ScreenView.kt의 속성 키를 AnalyticsProperty 상수로 바꿨습니다.

기록 기준

  • Orbit reduce는 다시 실행될 수 있어서, reduce 안에서는 상태 전이 여부만 지역 변수에 담고 이벤트는 reduce 밖에서 기록합니다.
  • 상태가 실제로 바뀐 경우에만 기록합니다. 예를 들어 카드 치워두기를 두 번 눌러도 card_set_aside는 한 건입니다.
  • home_submit, chat_send는 위험 표현 검사 전에 기록합니다. 막히면 그 뒤에 *_blocked, 전송에 실패하면 *_fail을 기록합니다.
  • onboarding_complete는 시작하기 버튼이 아니라 알림 권한 창에서 허용이나 거절을 선택한 시점에 기록합니다. 권한 창을 닫고 시작하기를 다시 누르는 경우 중복 집계를 막기 위해서입니다.
  • archive_conversation_view는 대화 기록을 불러와 화면에 표시한 경우에만 기록합니다.
  • archive_share_click은 연속 탭 방지 판정을 통과한 뒤에 기록합니다.
  • 이미 끝난 대화의 카드 생성을 다시 시도할 때는 chat_end_request 없이 card_create_success 또는 card_create_fail만 기록합니다.

관련 이슈

  • 없음

관련 작업 (Notion)

  • GMSS-358

스크린샷 / 동작 화면

UI 변경은 없습니다.

체크리스트

  • base 브랜치가 develop으로 설정되어 있다 ([GMSS-358]Mixpanel 연동 및 화면 진입 이벤트 추가 #77 머지 후 변경 예정)
  • 로컬 빌드 및 실행을 확인했다
  • 커밋 메시지가 컨벤션(feat:, fix: 등)을 따른다
  • 불필요한 로그/주석/디버그 코드를 제거했다
  • 리뷰어가 이해할 수 있도록 설명을 작성했다

검증

  • 2026-11-02, 로컬: ./gradlew detekt testDebugUnitTest :app:assembleDebug 성공. 이벤트 테스트를 모듈마다 추가했습니다(chat 98개, home 37개, archive 24개, login 16개, carddelete 7개, onboarding 3개 통과).
  • 2026-11-03, SM-S937N, debug 빌드, LTE: 기기 내부 Mixpanel 큐에서 archive_month_change(emotion=anger, year_month=2026-10)와 chat_search가 기록되는 것을 확인했습니다. chat_search 속성에 검색어가 포함되지 않는 것도 확인했습니다.
  • 테스트 계정에 카드와 대화가 없어서 카드, 대화방, 파쇄 이벤트는 실기기에서 확인하지 못했습니다. 메시지 전송, 공유, 파쇄는 실제 데이터를 만들거나 지우므로 실행하지 않았습니다.

리뷰 요청 사항

  • 이벤트 이름과 기록 시점이 iOS에서도 같은 기준으로 구현 가능한지 확인 부탁드립니다.
  • 다음 버튼, 로그인 버튼, 칸 비우기 확인처럼 기존에 연타 방지가 없는 동작은 빠르게 두 번 누르면 이벤트도 두 건 기록될 수 있을 것 같습니다. 이번 PR에서는 고치지 않았습니다.

@soyeonLee126
soyeonLee126 marked this pull request as ready for review November 6, 2026 01:51

@seunghee17 seunghee17 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

base 브랜치 develop로 변경 부탁드립니다!

@soyeonLee126
soyeonLee126 changed the base branch from feature/archive-mixpanel to develop November 11, 2026 09:44

@seunghee17 seunghee17 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

앞선 merge 때문에 충돌이 발생한것 같습니다 확인 부탁드립니다!

…ction-events

# Conflicts:
#	feature/archive/src/test/java/com/gamss/android/feature/archive/ArchiveDetailViewModelTest.kt
@seunghee17
seunghee17 merged commit 2ddcfe9 into develop Nov 12, 2026
6 checks passed
@seunghee17
seunghee17 deleted the feature/mixpanel-action-events branch November 12, 2026 14:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants