[FEAT/#1628] 앰플리튜드 이벤트 개편-1 (#1634)

seungjunGong · web-flow · commit cb17a2ec5407 · 2026-07-16T20:55:37.000+09:00
* [FEAT/#1628] 솝레터 앰플리튜드 추가 * [FEAT/#1628] 메인 화면 탭 및 플러스 버튼 클릭 로깅 추가 - `MainTab`에 `Appjamtamp` 로깅 이름("navi_appjamtamp") 및 클릭 이벤트 타입 정의. - `MainScreen`에서 탭 선택 및 플러스(+) 버튼 클릭 시 `trackViewType`을 통한 분석 로그 전송 로직 추가. - `TrackerExt`에 이벤트 타입과 이름을 직접 전달받아 `view_type`을 트래킹하는 `trackViewType` 확장 함수 오버로딩 추가. * [MOD/#1628] Sopletter merge conflict 해결 - Move `CLICK_SOPTLETTER_START_BUTTON` analytics event from `SopletterOnboardingScreen` to `SopletterNameScreen`. - Remove unused `viewType` parameter from `SopletterEntryRoute` and its navigation call. - Update `sopletterGraph` and `SopletterNavHost` to accept and handle `userStatus`. * [CHORE/#1628] SopletterOnboardingScreen navigateToNickname 람다 제거
diff --git a/core/analytics/src/main/java/org/sopt/official/analytics/TrackerExt.kt b/core/analytics/src/main/java/org/sopt/official/analytics/TrackerExt.kt
@@ -4,15 +4,45 @@ fun Tracker.track(event: AnalyticsEvent, properties: Map<String, Any?> = emptyMa
     track(type = event.type, name = event.eventName, properties = properties)
 }
 
+/**
+ * view_type 프로퍼티를 포함해 이벤트를 전송하는 함수
+ *
+ * @param type 이벤트 타입
+ * @param name 이벤트 이름
+ * @param viewType 유저 상태 값
+ * @param properties 추가 프로퍼티
+ */
 fun Tracker.trackViewType(
-    event: AnalyticsEvent,
+    type: EventType,
+    name: String,
     viewType: String,
     properties: Map<String, Any?> = emptyMap(),
 ) {
     track(
-        event = event,
+        type = type,
+        name = name,
         properties = mapOf(
             AnalyticsPropertyKey.VIEW_TYPE to viewType,
         ) + properties,
     )
 }
+
+/**
+ * view_type 프로퍼티를 포함해 이벤트를 전송하는 함수
+ *
+ * @param event 이벤트 객체
+ * @param viewType 유저 상태 값
+ * @param properties 추가 프로퍼티
+ */
+fun Tracker.trackViewType(
+    event: AnalyticsEvent,
+    viewType: String,
+    properties: Map<String, Any?> = emptyMap(),
+) {
+    trackViewType(
+        type = event.type,
+        name = event.eventName,
+        viewType = viewType,
+        properties = properties,
+    )
+}
diff --git a/feature/main/src/main/java/org/sopt/official/feature/main/MainScreen.kt b/feature/main/src/main/java/org/sopt/official/feature/main/MainScreen.kt
@@ -83,8 +83,8 @@ import androidx.navigation.compose.NavHost
 import kotlinx.collections.immutable.ImmutableList
 import kotlinx.collections.immutable.toImmutableList
 import kotlinx.collections.immutable.toPersistentList
-import org.sopt.official.analytics.EventType
 import org.sopt.official.analytics.compose.LocalTracker
+import org.sopt.official.analytics.trackViewType
 import org.sopt.official.common.navigator.DeepLinkType
 import org.sopt.official.common.navigator.NavigatorProvider
 import org.sopt.official.common.view.toast
@@ -408,6 +408,7 @@ fun MainScreen(
                         }
 
                         sopletterGraph(
+                            userStatus = userStatus,
                             navigateToHome = {
                                 if (!navigator.navController.popBackStack()) {
                                     navigator.navigateAndClear(MainTab.Home, userStatus)
@@ -429,11 +430,11 @@ fun MainScreen(
                     showBadgeContent = badgeList,
                     currentTab = navigator.currentTab,
                     onTabSelected = { selectedTab ->
-                        if (selectedTab.loggingName != null) {
-                            tracker.track(
-                                name = selectedTab.loggingName,
-                                type = EventType.CLICK,
-                                properties = mapOf("view_type" to userStatus.value)
+                        selectedTab.loggingName?.let { loggingName ->
+                            tracker.trackViewType(
+                                type = MainTab.CLICK_EVENT_TYPE,
+                                name = loggingName,
+                                viewType = userStatus.value,
                             )
                         }
 
@@ -448,7 +449,14 @@ fun MainScreen(
                         }
                     },
                     isMenuOpen = isFloatingMenuOpen,
-                    onMenuToggle = { isFloatingMenuOpen = !isFloatingMenuOpen }
+                    onMenuToggle = {
+                        tracker.trackViewType(
+                            type = MainTab.CLICK_EVENT_TYPE,
+                            name = MainTab.PLUS_BUTTON_LOGGING_NAME,
+                            viewType = userStatus.value,
+                        )
+                        isFloatingMenuOpen = !isFloatingMenuOpen
+                    }
                 )
             }
         }
diff --git a/feature/main/src/main/java/org/sopt/official/feature/main/MainTab.kt b/feature/main/src/main/java/org/sopt/official/feature/main/MainTab.kt
@@ -26,8 +26,10 @@ package org.sopt.official.feature.main
 
 import androidx.annotation.DrawableRes
 import androidx.compose.runtime.Composable
+import org.sopt.official.analytics.EventType
 import org.sopt.official.core.navigation.MainTabRoute
 import org.sopt.official.core.navigation.Route
+import org.sopt.official.feature.appjamtamp.navigation.AppjamtampNavGraph
 import org.sopt.official.feature.mypage.navigation.MyPageGraph
 
 enum class MainTab(
@@ -56,8 +58,8 @@ enum class MainTab(
     Appjamtamp(
         icon = R.drawable.ic_main_soptamp,
         contentDescription = "솝탬프",
-        route = org.sopt.official.feature.appjamtamp.navigation.AppjamtampNavGraph,
-        loggingName = null,
+        route = AppjamtampNavGraph,
+        loggingName = "navi_appjamtamp",
         deeplink = "appjamtamp"
     ),
 
@@ -78,6 +80,9 @@ enum class MainTab(
     );
 
     companion object {
+        val CLICK_EVENT_TYPE = EventType.CLICK
+        const val PLUS_BUTTON_LOGGING_NAME = "plus_button"
+
         @Composable
         fun find(predicate: @Composable (MainTabRoute) -> Boolean): MainTab? {
             return entries.find { predicate(it.route) }
diff --git a/feature/sopletter/build.gradle.kts b/feature/sopletter/build.gradle.kts
@@ -33,6 +33,7 @@ android {
 
 dependencies {
     // core
+    implementation(projects.core.analytics)
     implementation(projects.core.common)
     implementation(projects.core.designsystem)
     implementation(projects.core.model)
diff --git a/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/SopletterAnalyticsEvent.kt b/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/SopletterAnalyticsEvent.kt
@@ -0,0 +1,66 @@
+package org.sopt.official.feature.sopletter
+
+import org.sopt.official.analytics.AnalyticsEvent
+import org.sopt.official.analytics.EventType
+
+enum class SopletterAnalyticsEvent(
+    override val type: EventType,
+    override val eventName: String,
+) : AnalyticsEvent {
+    VIEW_SOPTLETTER_ONBOARDING(
+        type = EventType.VIEW,
+        eventName = "soptletter_onboarding",
+    ),
+    VIEW_SOPTLETTER_NICKNAME(
+        type = EventType.VIEW,
+        eventName = "soptletter_nickname",
+    ),
+    VIEW_SOPTLETTER_MAIN(
+        type = EventType.VIEW,
+        eventName = "soptletter_main",
+    ),
+    CLICK_SOPTLETTER_START_BUTTON(
+        type = EventType.CLICK,
+        eventName = "soptletter_start_button",
+    ),
+    CLICK_WRITE_SOPTLETTER(
+        type = EventType.CLICK,
+        eventName = "write_soptletter",
+    ),
+    CLICK_DONE_WRITE_SOPTLETTER(
+        type = EventType.CLICK,
+        eventName = "done_write_soptletter",
+    ),
+    CLICK_SOPTLETTER_DETAIL(
+        type = EventType.CLICK,
+        eventName = "soptletter_detail",
+    ),
+    CLICK_EDIT_SOPTLETTER(
+        type = EventType.CLICK,
+        eventName = "edit_soptletter",
+    ),
+    CLICK_DONE_EDIT_SOPTLETTER(
+        type = EventType.CLICK,
+        eventName = "done_edit_soptletter",
+    ),
+    CLICK_SOPTLETTER_LIKE_BUTTON(
+        type = EventType.CLICK,
+        eventName = "soptletter_like_button",
+    ),
+    CLICK_DELETE_SOPTLETTER(
+        type = EventType.CLICK,
+        eventName = "delete_soptletter",
+    ),
+    CLICK_EXPORT_SOPTLETTER(
+        type = EventType.CLICK,
+        eventName = "export_soptletter",
+    ),
+    CLICK_DONE_EXPORT_SOPTLETTER(
+        type = EventType.CLICK,
+        eventName = "done_export_soptletter",
+    ),
+    CLICK_QUIT_SOPTLETTER(
+        type = EventType.CLICK,
+        eventName = "quit_soptletter",
+    ),
+}
diff --git a/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/main/SopletterMainScreen.kt b/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/main/SopletterMainScreen.kt
@@ -60,12 +60,18 @@ import androidx.hilt.lifecycle.viewmodel.compose.hiltViewModel
 import androidx.lifecycle.compose.LocalLifecycleOwner
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import androidx.lifecycle.flowWithLifecycle
+import org.sopt.official.analytics.compose.LocalTracker
+import org.sopt.official.analytics.trackViewType
 import org.sopt.official.common.util.onBottomReached
 import org.sopt.official.designsystem.SoptTheme
 import org.sopt.official.designsystem.component.dialog.NetworkErrorDialog
 import org.sopt.official.domain.sopletter.model.SopletterMessage
+import org.sopt.official.feature.sopletter.SopletterAnalyticsEvent
+import org.sopt.official.feature.sopletter.common.component.SopletterScaffold
 import org.sopt.official.feature.sopletter.common.component.SopletterPrintDialog
 import org.sopt.official.feature.sopletter.common.model.SopletterSnackbarVisuals
+import org.sopt.official.feature.sopletter.common.component.SopletterSnackbarHost
+import org.sopt.official.feature.sopletter.main.analytics.TrackedSopletterMemoDetailDialogActions
 import org.sopt.official.feature.sopletter.main.component.EmptySopletterContent
 import org.sopt.official.feature.sopletter.main.component.SopletterDeleteDialog
 import org.sopt.official.feature.sopletter.main.component.SopletterMainTopBar
@@ -83,6 +89,7 @@ import org.sopt.official.webview.view.WebViewActivity
 @OptIn(ExperimentalMaterialApi::class)
 @Composable
 fun SopletterMainRoute(
+    viewType: String,
     onShowSnackbar: (SopletterSnackbarVisuals) -> Unit,
     viewModel: SopletterMainViewModel = hiltViewModel(),
     navigateUp: () -> Unit = {},
@@ -95,9 +102,16 @@ fun SopletterMainRoute(
     val dialogActions: SopletterMemoDetailDialogContract.Actions = viewModel
     val context = LocalContext.current
     val lifecycleOwner = LocalLifecycleOwner.current
+    val tracker = LocalTracker.current
+    val trackedDialogActions = remember(dialogActions, tracker, viewType) {
+        TrackedSopletterMemoDetailDialogActions(dialogActions) { event ->
+            tracker.trackViewType(event, viewType)
+        }
+    }
     var isPrintDialogVisible by remember { mutableStateOf(false) }
 
     LaunchedEffect(Unit) {
+        tracker.trackViewType(SopletterAnalyticsEvent.VIEW_SOPTLETTER_MAIN, viewType)
         viewModel.sideEffect.flowWithLifecycle(lifecycleOwner.lifecycle)
             .collect { sideEffect ->
                 when (sideEffect) {
@@ -118,16 +132,25 @@ fun SopletterMainRoute(
     SopletterMainScreen(
         uiState = uiState,
         onMemoClick = {
+            tracker.trackViewType(SopletterAnalyticsEvent.CLICK_SOPTLETTER_DETAIL, viewType)
             viewModel.fetchMemoDetail(
                 messageId = it.messageId,
                 memoColor = it.memoColor(),
             )
         },
         onRefresh = viewModel::refreshMainContent,
         onLoadMore = { viewModel.fetchMessages(isLoadMore = true) },
-        dialogActions = dialogActions,
-        onBackClick = navigateUp,
-        onDownloadClick = { isPrintDialogVisible = true },
+        dialogActions = trackedDialogActions,
+        onBackClick = {
+            if (uiState.routeTopicId == null) {
+                tracker.trackViewType(SopletterAnalyticsEvent.CLICK_QUIT_SOPTLETTER, viewType)
+            }
+            navigateUp()
+        },
+        onDownloadClick = {
+            tracker.trackViewType(SopletterAnalyticsEvent.CLICK_EXPORT_SOPTLETTER, viewType)
+            isPrintDialogVisible = true
+        },
         isPrintDialogVisible = isPrintDialogVisible,
         onPrintDialogDismiss = { isPrintDialogVisible = false },
         onPrintConfirm = {
@@ -139,7 +162,10 @@ fun SopletterMainRoute(
         onTopicCtaClick = navigateToTopicDetail,
         onReportClick = viewModel::openReportForm,
         onErrorConfirm = viewModel::dismissErrorDialog,
-        onWriteFABClick = { navigateToWrite(uiState.selectedTopicId) },
+        onWriteFABClick = {
+            tracker.trackViewType(SopletterAnalyticsEvent.CLICK_WRITE_SOPTLETTER, viewType)
+            navigateToWrite(uiState.selectedTopicId)
+        },
     )
 }
 
diff --git a/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/main/analytics/TrackedSopletterMemoDetailDialogActions.kt b/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/main/analytics/TrackedSopletterMemoDetailDialogActions.kt
@@ -0,0 +1,53 @@
+/*
+ * MIT License
+ * Copyright 2026 SOPT - Shout Our Passion Together
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package org.sopt.official.feature.sopletter.main.analytics
+
+import org.sopt.official.feature.sopletter.SopletterAnalyticsEvent
+import org.sopt.official.feature.sopletter.main.contract.SopletterMemoDetailDialogContract
+
+internal class TrackedSopletterMemoDetailDialogActions(
+    private val delegate: SopletterMemoDetailDialogContract.Actions,
+    private val trackEvent: (SopletterAnalyticsEvent) -> Unit,
+) : SopletterMemoDetailDialogContract.Actions by delegate {
+    override fun onLikeClick() {
+        trackEvent(SopletterAnalyticsEvent.CLICK_SOPTLETTER_LIKE_BUTTON)
+        delegate.onLikeClick()
+    }
+
+    override fun onEditClick() {
+        trackEvent(SopletterAnalyticsEvent.CLICK_EDIT_SOPTLETTER)
+        delegate.onEditClick()
+    }
+
+    override fun onEditCompleteClick(content: String) {
+        trackEvent(SopletterAnalyticsEvent.CLICK_DONE_EDIT_SOPTLETTER)
+        delegate.onEditCompleteClick(content)
+    }
+
+    override fun onDeleteConfirmClick() {
+        trackEvent(SopletterAnalyticsEvent.CLICK_DELETE_SOPTLETTER)
+        delegate.onDeleteConfirmClick()
+    }
+}
diff --git a/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/name/SopletterNameScreen.kt b/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/name/SopletterNameScreen.kt
@@ -41,22 +41,28 @@ import androidx.lifecycle.Lifecycle
 import androidx.lifecycle.compose.LocalLifecycleOwner
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import androidx.lifecycle.repeatOnLifecycle
+import org.sopt.official.analytics.compose.LocalTracker
+import org.sopt.official.analytics.trackViewType
 import org.sopt.official.designsystem.SoptTheme
+import org.sopt.official.feature.sopletter.SopletterAnalyticsEvent
 import org.sopt.official.feature.sopletter.common.component.SopletterButton
 import org.sopt.official.feature.sopletter.common.component.SopletterTopbar
 import org.sopt.official.feature.sopletter.name.component.SopletterNameInfoHolder
 import org.sopt.official.sopletter.R
 
 @Composable
 fun SopletterNameRoute(
+    viewType: String,
     navigateToSopletterMain: () -> Unit,
     navigateToHome: () -> Unit,
     viewModel: SopletterNameViewModel = hiltViewModel()
 ) {
     val lifeCycleOwner = LocalLifecycleOwner.current
     val state by viewModel.state.collectAsStateWithLifecycle()
+    val tracker = LocalTracker.current
 
     LaunchedEffect(Unit) {
+        tracker.trackViewType(SopletterAnalyticsEvent.VIEW_SOPTLETTER_NICKNAME, viewType)
         lifeCycleOwner.lifecycle.repeatOnLifecycle(Lifecycle.State.STARTED) {
             viewModel.sideEffect.collect { sideEffect ->
                 when (sideEffect) {
@@ -68,7 +74,10 @@ fun SopletterNameRoute(
 
     SopletterNameScreen(
         state = state,
-        navigateToSopletterMain = navigateToSopletterMain,
+        navigateToSopletterMain = {
+            tracker.trackViewType(SopletterAnalyticsEvent.CLICK_SOPTLETTER_START_BUTTON, viewType)
+            navigateToSopletterMain()
+        },
         navigateToHome = navigateToHome,
     )
 }
diff --git a/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/navigation/SopletterNavigation.kt b/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/navigation/SopletterNavigation.kt
diff --git a/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/onboarding/SopletterOnboardingScreen.kt b/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/onboarding/SopletterOnboardingScreen.kt
diff --git a/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/print/SopletterPrintScreen.kt b/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/print/SopletterPrintScreen.kt
diff --git a/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/write/SopletterWriteScreen.kt b/feature/sopletter/src/main/java/org/sopt/official/feature/sopletter/write/SopletterWriteScreen.kt
