Menú
Use when adding or changing Firebase Analytics events, AnalyticsEvent definitions, AnalyticsLogger calls, screen view logs, click logs, filter logs, or completion logs in this Android repository.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
| name | implementing-analytics |
| description | Use when adding or changing Firebase Analytics events, AnalyticsEvent definitions, AnalyticsLogger calls, screen view logs, click logs, filter logs, or completion logs in this Android repository. |
analytics 구현은 core:analytics의 이벤트 정의와 feature ViewModel의 로깅 호출을 함께 맞춘다.
이벤트는 FirebaseAnalyticsLogger를 통해 Firebase Analytics로 전달한다.
core/analytics/src/main/kotlin/com/neki/android/core/analytics/event/*AnalyticsEvent.ktcore/analytics/src/main/kotlin/com/neki/android/core/analytics/logger/FirebaseAnalyticsLogger.ktfeature/<feature-name>/impl/src/main/.../*ViewModel.ktfeature/<feature-name>/impl/src/main/.../*Screen.ktapp/src/main/java/com/neki/android/app/MainActivity.kt*AnalyticsEvent를 고른다.data object, parameter 있는 이벤트는 data class로 추가한다.name과 parameter key는 snake_case로 둔다. 클래스명이 곧 이벤트명은 아니므로(Logout → "mypage_logout") 도메인별 기존 네이밍 관례를 따른다.AnalyticsLogger를 주입한다.analyticsLogger.log(...)를 둔다.LaunchedEffect(Unit)에서 ViewModel의 log<이벤트명>() 함수만 호출한다(logMapView, logPoseView, logArchivingView). ViewModel 생성 기준이면 init 블록에서 로깅한다(PhotoDetailView).setUserId(...), setUserProperty(...)를 쓴다.GA4_EVENTS.md가 있으면 명세도 함께 갱신한다.FirebaseAnalyticsLogger는 AnalyticsEvent를 Firebase Analytics의 logEvent(...)로 전달한다.
feature ViewModel은 AnalyticsLogger를 주입받아 호출한다.
sealed interface FeatureAnalyticsEvent : AnalyticsEvent {
data object FeatureView : FeatureAnalyticsEvent {
override val name = "feature_view"
}
data class ConfirmClick(
val source: String,
val selectedCount: Int,
) : FeatureAnalyticsEvent {
override val name = "confirm_click"
override val params = mapOf(
"source" to source,
"selected_count" to selectedCount,
)
}
}
Firebase Analytics parameter value는 String, Int, Long, Double, Boolean을 쓴다.
그 외 타입은 컴파일 타임에 걸러지지 않고 toString() 문자열로 변환되어 전송되므로 위 5개 타입만 넣는다.
| 구분 | 예시 |
|---|---|
| 화면 진입 | MapView, PoseView, ArchivingView, PhotoDetailView |
| 앱 진입 | AppOpen, NotificationClick(MainActivity에서 로깅) |
| 버튼/CTA | MapRouteClick, PoseBookmark, Logout, Withdraw |
| 검색/필터/선택 | MapReSearch, MapBrandFilterToggle, PoseFilterToggle, BoothSelect |
| 작업 완료 | PhotoUpload, AlbumCreate, AlbumAddFromDetail, AlbumAddFromMulti, PhotoMemoCreate |
| 이동/복사 | PhotoMove, PhotoCopy |
@HiltViewModel
internal class FeatureViewModel @Inject constructor(
private val analyticsLogger: AnalyticsLogger,
) : ViewModel()
when (intent) {
FeatureIntent.ClickConfirmButton -> {
analyticsLogger.log(FeatureAnalyticsEvent.ConfirmClick(...))
...
}
}
repository.request(...)
.onSuccess {
analyticsLogger.log(FeatureAnalyticsEvent.FeatureComplete)
...
}
setUserId와 platform은 로그인 성공 시, app_version은 스플래시 진입 시 설정한다. 비로그인 이벤트는 user_id가 빈 상태로 수집된다.
analyticsLogger.setUserId(userId.toString())
analyticsLogger.setUserProperty("platform", "android")
analyticsLogger.setUserProperty("app_version", currentAppVersion)
Use when naming branches, writing commit messages, creating or editing GitHub issues, or creating or editing GitHub pull requests in this repository.
Use when a project decision changes or the codebase drifts from what a skill or agent documents, and this repository's harness (skills, agents, AGENTS.md, discussions.md) needs to be updated to match.
Use after implementing an Android code change, when verifying an existing implementation, or before declaring development complete. Select project skills, run risk-based verification, coordinate Reviewer and QA agents, and repeat only when evidence requires a fix.
Use when adding or changing behavior in an existing feature screen, including MVI State, Intent, Effect, ViewModel reducers, one-shot effects, API result handling, or UI event wiring in this Android repository.
Use when adding a new Compose feature screen with Contract, ViewModel, Route, Screen, Preview, or MVI store in this Android repository.
Use when adding or changing DataStore Preferences, local flags, token/auth/user persistence, preference keys, or local repository methods in this Android repository.