在 Android SDK 中追踪流程页面浏览
每当用户打开流程中的页面时,SDK 都会向您的应用上报一个 flow_screen_showed 事件。将其转发至 Amplitude、Mixpanel 或您使用的任意产品分析工具,即可将流程页面数据与应用其他事件一起进行分析。
如需查看有多少用户到达每个页面以及他们在哪里流失,无需编写任何代码——流程漏斗已在 Adapty 看板中直接展示。如果您希望在自己的分析工具中构建相同的漏斗,或将流程页面与 Adapty 未知的事件关联起来,请参阅本指南。
开始之前
您需要:
- Adapty Android SDK v4 或更高版本:早期版本不支持流程分析回调。
- 在此功能发布后发布的流程版本:Adapty 在发布流程时生成页面事件,因此在此之前发布的流程不会上报任何数据。如果应用未收到任何事件,请发布新版本的流程后重试。
您会收到什么
每当用户打开某个流程页面时,该流程都会上报 flow_screen_showed 事件。Adapty 在自有流程分析中统计这些事件,同时也会将其推送给您的应用,以便您在自己的分析工具中构建相同的漏斗。
| 参数 | 说明 |
|---|---|
instanceId | 用户打开的页面 ID。 |
screen_order | 该页面在流程中的位置。 |
is_last_screen | 当该页面没有后续页面时为 true。有分支的流程可以在多个不同页面结束,每个结束页面均上报 true。若付费墙页面的任意结果动作(无论购买或恢复结果如何)会跳转到其他页面,则该付费墙页面上报 false。Navigate back 动作不计入此逻辑。如果所有用户在到达付费墙之前都会经过某个页面,则跳转到该页面的动作也不计入。 |
此事件的 isBackendEvent 和 isCustomerEvent 均为 true:Adapty 会持续统计该事件,您的应用也会同时接收到它。
默认情况下,这些 ID 是自动生成的,因此你的应用收到的是 scr_oAPBHPa7 而非 welcome。如果你的分析功能依赖于读取这些 ID,请自行设置:在付费墙编辑工具中为输入框和可选分组命名,并使用 flow-generator 技能重命名屏幕。详见为分析功能设置自定义 ID。
屏幕浏览事件会通过与其他流程事件相同的分析回调上报。请参阅处理流程与付费墙事件,了解如何注册该回调。
将每个页面浏览事件转发给你的分析工具
在读取其他内容之前,先匹配事件名称,因为流程会通过同一个回调上报其他事件。
override fun onAnalyticEvent(
name: String,
params: Map<String, Any?>,
context: Context,
) {
if (name != "flow_screen_showed") return
val screenId = params["instanceId"]
val screenOrder = params["screen_order"]
// Send screenId and screenOrder to your analytics provider here.
}
当用户到达末尾时执行代码
is_last_screen 在流程无法继续前进的页面上为 true。使用它来解锁内容、标记用户引导完成,或发送自定义的完成事件,而无需在编辑工具中为此添加按钮操作。
override fun onAnalyticEvent(
name: String,
params: Map<String, Any?>,
context: Context,
) {
if (name != "flow_screen_showed") return
if (params["is_last_screen"] != true) return
// The user reached the end of the flow.
}
到达最后一个屏幕并不等同于关闭流程。用户可能看到最终屏幕后直接关闭流程而不进行任何操作,并且有分支的流程可能在多个不同的屏幕上结束。如需确认流程本身已关闭,请改用 onFlowClosed。