Theo dõi lượt xem màn hình flow trong Android SDK
Mỗi khi người dùng mở một màn hình trong flow, SDK sẽ báo cáo sự kiện flow_screen_showed tới ứng dụng của bạn. Hãy chuyển tiếp sự kiện này tới Amplitude, Mixpanel, hoặc bất kỳ công cụ phân tích sản phẩm nào bạn đang dùng, để bạn có thể phân tích các màn hình flow cùng với các sự kiện khác trong ứng dụng.
Để xem có bao nhiêu người dùng đến từng màn hình và họ bỏ qua ở đâu, bạn không cần viết thêm code — flow funnel đã hiển thị thông tin đó ngay trên Adapty Dashboard. Hãy dùng hướng dẫn này nếu bạn muốn xây dựng funnel tương tự trong công cụ analytics của riêng mình, hoặc để kết hợp các màn hình flow với những sự kiện mà Adapty không theo dõi.
Trước khi bắt đầu
Bạn cần:
- Adapty Android SDK v4 trở lên: Callback analytics của flow không tồn tại trong các phiên bản cũ hơn.
- Một phiên bản flow được publish sau khi tính năng này ra mắt: Adapty tạo các sự kiện màn hình khi publish flow, vì vậy flow mà bạn đã publish trước đó sẽ không báo cáo gì. Nếu không có sự kiện nào đến ứng dụng của bạn, hãy publish phiên bản mới của flow và thử lại.
Những gì bạn nhận được
Mỗi khi người dùng mở một màn hình trong flow, flow sẽ báo cáo sự kiện flow_screen_showed. Adapty đếm các sự kiện này trong analytics của flow và cũng gửi chúng đến ứng dụng của bạn, để bạn có thể xây dựng cùng một funnel trong hệ thống analytics của riêng mình.
| Tham số | Mô tả |
|---|---|
instanceId | ID của màn hình mà người dùng đã mở. |
screen_order | Vị trí của màn hình trong flow. |
is_last_screen | true khi màn hình không còn điểm đến nào tiếp theo. Một flow có phân nhánh có thể kết thúc ở nhiều màn hình khác nhau, và mỗi màn hình đó đều báo cáo true. Màn hình paywall báo cáo false nếu bất kỳ hành động kết quả nào của nó điều hướng đến màn hình khác, bất kể kết quả mua hàng hay khôi phục là gì. Hành động Navigate back không được tính. Điều hướng đến một màn hình cũng không được tính nếu tất cả người dùng đều thấy màn hình đó trước paywall. |
Cả isBackendEvent và isCustomerEvent đều là true với sự kiện này: Adapty vẫn tiếp tục đếm nó, và ứng dụng của bạn cũng nhận được nó.
Theo mặc định, các ID này được tạo tự động, nên ứng dụng của bạn sẽ nhận scr_oAPBHPa7 thay vì welcome. Nếu analytics của bạn cần đọc các ID này, hãy tự đặt tên: đặt tên cho các input và nhóm có thể chọn trong Flow Builder, và đổi tên màn hình bằng skill flow-generator. Xem Đặt tên ID cho analytics của bạn.
Các lượt xem màn hình được ghi nhận qua cùng một callback analytics như mọi sự kiện flow khác. Xem Xử lý sự kiện flow & paywall để biết nơi đăng ký.
Chuyển tiếp mọi lượt xem màn hình đến hệ thống analytics của bạn
Kiểm tra tên sự kiện trước tiên, vì một flow có thể báo cáo nhiều loại sự kiện khác nhau qua cùng một callback.
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.
}
Chạy code khi người dùng đến màn hình cuối
is_last_screen là true trên màn hình mà flow không thể tiến thêm. Dùng nó để mở khóa nội dung, đánh dấu onboarding đã hoàn thành, hoặc gửi sự kiện hoàn thành của riêng bạn — mà không cần thêm hành động button trong builder.
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.
}
Việc đến màn hình cuối không đồng nghĩa với việc đóng flow. Người dùng có thể xem màn hình cuối rồi thoát flow mà không thực hiện bất kỳ hành động nào, và một flow phân nhánh có thể kết thúc ở nhiều màn hình khác nhau. Để biết khi nào flow thực sự biến mất, hãy dùng onFlowClosed thay thế.