Rastrear vistas de pantallas de flow en el SDK de Android

Cada vez que un usuario abre una pantalla en un flow, el SDK envía un evento flow_screen_showed a tu app. Reenvíalo a Amplitude, Mixpanel o la herramienta de analíticas de producto que uses, para analizar las pantallas del flow junto con el resto de los eventos de tu app.

Tip

Para ver cuántos usuarios llegan a cada pantalla y en qué punto abandonan, no necesitas código — el embudo de flow ya lo muestra en el Adapty Dashboard. Usa esta guía para construir el mismo embudo en tu propia herramienta de analítica, o para combinar las pantallas del flow con eventos que Adapty no conoce.

Antes de empezar

Necesitas:

  • Adapty Android SDK v4 o posterior: El callback de análisis de flows no existe en versiones anteriores.
  • Una versión del flow publicada después de que se lanzara esta funcionalidad: Adapty genera los eventos de pantalla al publicar un flow, por lo que un flow publicado antes de eso no reportará nada. Si no llegan eventos a tu app, publica una nueva versión del flow e inténtalo de nuevo.

Qué recibes

Un flow reporta flow_screen_showed cada vez que un usuario abre una de sus pantallas. Adapty contabiliza estos eventos en su propio análisis de flows y también los entrega a tu app, para que puedas construir el mismo embudo en tu propio sistema de análisis.

ParámetroDescripción
instanceIdEl ID de la pantalla que abrió el usuario.
screen_orderLa posición de la pantalla dentro del flow.
is_last_screentrue cuando la pantalla no tiene a dónde ir más. Un flow con ramificaciones puede terminar en varias pantallas distintas, y cada una reporta true. Una pantalla de paywall reporta false si alguna de sus acciones de resultado navega a otra pantalla, independientemente del resultado de la compra o restauración. Una acción Navigate back no cuenta. Tampoco cuenta la navegación a una pantalla si todos los usuarios ven esa pantalla antes del paywall.

Tanto isBackendEvent como isCustomerEvent son true en este evento: Adapty sigue contabilizándolo y tu app también lo recibe.

Note

Por defecto, estos IDs se generan automáticamente, por lo que tu app recibe scr_oAPBHPa7 en lugar de welcome. Si tu analítica depende de leerlos, defínelos tú mismo: asigna nombres a los inputs y grupos seleccionables en el Flow Builder, y renombra las pantallas con la skill del generador de flows. Consulta Nombra los IDs que ve tu analítica.

Las vistas de pantalla llegan al mismo callback de análisis que cualquier otro evento del flow. Consulta Gestionar eventos de flow y paywall para saber dónde registrarlo.

Reenvía cada vista de pantalla a tus analíticas

Comprueba el nombre del evento antes de leer cualquier otro dato, ya que un flow reporta otros eventos a través del mismo 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.
}

Ejecutar código cuando el usuario llega al final

is_last_screen es true en una pantalla desde la que el flow no puede avanzar. Úsalo para desbloquear contenido, marcar el onboarding como completado o enviar tu propio evento de finalización, sin necesidad de añadir una acción de botón en el 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.
}

Llegar a la última pantalla no es lo mismo que cerrar el flow. Un usuario puede ver la pantalla final y descartar el flow sin realizar ninguna acción, y un flow con bifurcaciones puede terminar en varias pantallas diferentes. Para saber que el flow en sí desapareció, usa onFlowClosed en su lugar.