如何在使用Jetpack Compose UI的Android应用中正确跟踪页面浏览事件

核心触发原则 #

仅在页面首次挂载到视图树且对用户可见时触发1次上报，排除重组、临时测量、页面被完全遮挡等非真实用户浏览场景。

具体实现方式 #

1. 独立页面可组合项内部埋点（无路由框架场景） #

使用LaunchedEffect(Unit)作为埋点载体：LaunchedEffect在key为Unit时，仅会在当前可组合项首次进入Composition时执行一次，后续重组不会重复触发；如果页面被移出Composition后重新进入（用户主动切回页面），会重新执行一次，完全匹配真实浏览行为的定义。
示例代码：

@Composable
fun GoodsDetailPage(goodsId: String) {
    // 仅页面首次挂载时触发一次上报
    LaunchedEffect(Unit) {
        val analytics = FirebaseAnalytics.getInstance(LocalContext.current)
        analytics.logEvent(FirebaseAnalytics.Event.SCREEN_VIEW) {
            param(FirebaseAnalytics.Param.SCREEN_NAME, "GoodsDetailPage")
            param(FirebaseAnalytics.Param.SCREEN_CLASS, "GoodsDetailPage")
            param("goods_id", goodsId)
        }
    }

    // 页面布局逻辑
    // ...
}

如果存在页面被全屏弹窗、浮层完全遮盖的场景，可以额外增加可见性判断逻辑，确保仅在页面对用户可见时上报。

2. 基于Navigation Compose的统一埋点（路由管理场景） #

如果项目用Navigation Compose做页面路由管理，可以在路由层统一做埋点，不需要每个页面单独加逻辑：
监听NavController的当前路由变化，仅当路由地址切换为有效页面路由时触发上报：

val navController = rememberNavController()
// 配置需要上报的页面路由白名单，过滤弹窗、中间过渡路由
val reportRouteWhiteList = setOf("home", "goods_detail", "mine")
val currentRoute = navController.currentBackStackEntryAsState().value?.destination?.route

LaunchedEffect(currentRoute) {
    currentRoute?.takeIf { it in reportRouteWhiteList }?.let { route ->
        val analytics = FirebaseAnalytics.getInstance(LocalContext.current)
        analytics.logEvent(FirebaseAnalytics.Event.SCREEN_VIEW) {
            param(FirebaseAnalytics.Param.SCREEN_NAME, route)
            param(FirebaseAnalytics.Param.SCREEN_CLASS, route)
        }
    }
}

// 页面路由注册
NavHost(navController = navController, startDestination = "home") {
    composable("home") { HomePage() }
    composable("goods_detail") { GoodsDetailPage() }
    composable("mine") { MinePage() }
}

避坑注意事项 #

• 不要把埋点逻辑直接写在可组合函数体的顶层，每次重组都会执行，会产生大量重复上报
• 不要使用SideEffect处理页面浏览埋点，SideEffect每次重组都会执行，同样会重复触发
• 不要将动态变化的值作为LaunchedEffect的key，会导致key频繁变更，触发多次重复执行
• 如果产品要求应用退后台超过指定时长切回算新浏览，可以额外配合ProcessLifecycleOwner监听应用前后台状态，结合当前路由做补充判断即可

内容的提问来源于stack exchange，提问作者Art Shendrik