Files
sf-app-platform/apps/mobile_app/docs/analytics-catalog.md

16 KiB

Catálogo de Eventos — SaveFamily

Documento para el equipo de Marketing. Lista todos los eventos que la app registra y describe el momento exacto en que se dispara cada uno.


Índice

  1. Pantallas de la app
  2. Autenticación
  3. Cuenta
  4. Alta de dispositivo (reloj/wearable del niño)
  5. Funciones del dispositivo
  6. Contactos del dispositivo
  7. Ajustes del dispositivo
  8. Soporte
  9. Onboarding
  10. Panel principal (home)
  11. Ubicación y mapa

Pantallas de la app

Cada vez que el usuario navega a una pantalla, queda registrada automáticamente. También se registran los cambios entre pestañas del menú inferior.

Pantallas registradas:

  • Pantalla de carga inicial
  • Onboarding / intro
  • Login
  • Alta de cuenta (signup)
  • Recuperación de contraseña
  • Wizard de alta de reloj/dispositivo
  • Inicio de vinculación de teléfono
  • Verificación del código de vinculación
  • Dashboard principal (home)
  • Soporte / atención al cliente
  • Menú de cuenta
  • Editar datos personales
  • Cambiar contraseña
  • Dispositivos vinculados a la cuenta
  • Sub-usuarios de la app
  • Eliminación de cuenta
  • Menú de gestión del dispositivo
  • Actividades programadas
  • Contactos
  • Editar contacto
  • Salud (ritmo cardíaco, oxígeno en sangre)
  • Conexión remota (cámara y llamada)
  • Localizar dispositivo
  • Recompensas
  • Medidor de actividad / pasos
  • Uso de aplicaciones
  • Control de volumen
  • Historial de llamadas
  • Imagen de fondo del dispositivo
  • Mapa de ubicación
  • Chat
  • Menú de ajustes
  • Alarmas
  • Gestión remota
  • Contactos SOS
  • Sonido del dispositivo
  • Sincronización del reloj
  • Gestión de apps instaladas
  • Batería / modo nocturno
  • Bloqueo de teléfono (whitelist)
  • Desactivar funciones (teclado, GPS)
  • Idioma del dispositivo
  • Notificaciones del dispositivo
  • Encendido/apagado remoto
  • Alertas
  • Zona horaria
  • Configuración WiFi

Autenticación

Login

  • legacy_auth_login_attempt — El usuario pulsa "Iniciar sesión" después de completar el formulario.
  • legacy_auth_login_success — Email y contraseña aceptados (todavía falta el segundo factor).
  • legacy_auth_login_failure — El intento de login fue rechazado.

Doble factor (2FA)

  • legacy_auth_2fa_requested — Se le envió el código de verificación al usuario.
  • legacy_auth_2fa_verified — El código fue aceptado y la sesión está activa (login completado).
  • legacy_auth_2fa_failure — El código fue rechazado (incorrecto o expirado).
  • legacy_auth_2fa_resend — El usuario pidió que le reenvíen el código.

Alta de cuenta (signup)

El alta es un wizard de 2 pasos (datos personales → contraseña).

  • legacy_auth_signup_started — El usuario envió el formulario final del alta.
  • legacy_auth_signup_completed — La cuenta se creó exitosamente.
  • legacy_auth_signup_failed — El alta falló.
  • legacy_auth_signup_step_completed — El usuario completó un paso del wizard y avanzó al siguiente.
  • legacy_auth_signup_step_back — El usuario volvió al paso anterior dentro del wizard.
  • legacy_auth_signup_step_validation_failed — El usuario intentó avanzar pero el formulario tenía errores.

Recuperación de contraseña

Flujo exclusivo por email (no hay opción de SMS).

  • legacy_auth_password_reset_requested — El usuario inició el flujo de "olvidé mi contraseña" tipeando su email.
  • legacy_auth_password_reset_email_sent — Se envió el email con el enlace de recuperación.
  • legacy_auth_password_reset_completed — El usuario guardó exitosamente su nueva contraseña.
  • legacy_auth_password_reset_failed — El intento de guardar la nueva contraseña falló.

Vinculación de teléfono

  • legacy_auth_link_phone_code_requested — El usuario envió su número y pidió el código.
  • legacy_auth_link_phone_code_request_failed — Falló el envío del código.
  • legacy_auth_link_phone_code_verified — El código fue verificado, número vinculado.
  • legacy_auth_link_phone_code_verification_failed — El código no fue aceptado.

Cierre de sesión

  • legacy_auth_logout — El usuario cerró sesión.

Cuenta

  • legacy_account_personal_data_edited — El usuario guardó cambios en sus datos personales (nombre, apellido, teléfono).
  • legacy_account_password_changed — El usuario cambió su contraseña exitosamente.
  • legacy_account_password_change_failed — El cambio de contraseña falló.
  • legacy_account_linked_device_unlinked — El usuario quitó un dispositivo vinculado de su cuenta.
  • legacy_account_linked_device_renamed — El usuario renombró un dispositivo vinculado.
  • legacy_account_app_user_delete_triggered — El usuario tocó "eliminar" en la pantalla de sub-usuarios.
  • legacy_account_deletion_initiated — El usuario entró al flujo de "eliminar cuenta". Señal temprana de churn.
  • legacy_account_deletion_confirmed — El usuario confirmó la eliminación.
  • legacy_account_deletion_completed — La cuenta se eliminó.
  • legacy_account_deletion_cancelled — El usuario canceló antes de confirmar la eliminación.

Alta de dispositivo

Vincular el reloj/dispositivo del niño a la cuenta del adulto.

Wizard de alta

  • legacy_device_setup_started — El usuario entró al wizard de alta de dispositivo.
  • legacy_device_setup_step_completed — El usuario completó un paso del wizard. Se registra cuánto tiempo tardó en ese paso.
  • legacy_device_setup_completed — El dispositivo quedó vinculado. Se registra género y edad del niño y la relación con el adulto.
  • legacy_device_setup_failed — Falló el alta del dispositivo.
  • legacy_device_setup_cancelled — El usuario abandonó el wizard.

Cómo se introdujo el código del reloj

  • legacy_device_setup_qr_scanned — El usuario escaneó el código QR del reloj.
  • legacy_device_setup_manual_code_entered — El usuario tipeó el código manualmente.

Familias con varios hijos

  • legacy_device_setup_reset_for_new_kid — Después de terminar un alta, el usuario eligió "agregar otro hijo".

Funciones del dispositivo

Localizar dispositivo

  • legacy_device_locate_requested — El usuario pulsó el botón de localizar.
  • legacy_device_locate_success — La orden de localizar se envió al dispositivo.
  • legacy_device_locate_failure — La orden de localizar falló.

Conexión remota (cámara y llamada)

  • legacy_device_remote_connection_started — El usuario abrió la pantalla de conexión remota.
  • legacy_device_remote_connection_photo_taken — El usuario pidió una foto desde la cámara remota.
  • legacy_device_remote_connection_call_initiated — El usuario inició una llamada con el dispositivo.
  • legacy_device_remote_connection_picture_viewed — El usuario navegó entre las fotos tomadas remotamente.

Volumen del dispositivo

  • legacy_device_volume_control_changed — El usuario guardó un cambio de volumen. Se dispara una vez por cada tipo modificado (multimedia, tono de llamada, alarma).

Imagen de fondo del reloj

  • legacy_device_background_image_changed — El usuario eligió una imagen existente como fondo.
  • legacy_device_background_image_uploaded — El usuario subió una foto personal como fondo.

Actividades programadas (rutinas en el dispositivo)

  • legacy_device_scheduled_activity_added — El usuario creó una nueva actividad programada. Se registra el día de la semana y el horario.
  • legacy_device_scheduled_activity_updated — El usuario editó una actividad programada.
  • legacy_device_scheduled_activity_removed — El usuario eliminó una actividad programada.

Recompensas

  • legacy_device_rewards_granted — El usuario otorgó minutos de recompensa al dispositivo. Se registra la cantidad de minutos.

Podómetro / pasos

  • legacy_device_activity_pedometer_toggled — El usuario activó o desactivó el contador de pasos.
  • legacy_device_activity_meter_time_range_changed — El usuario cambió el rango de fechas en la pantalla de pasos (hoy, 7 días, 30 días, personalizado).

Salud (ritmo cardíaco / oxígeno en sangre)

  • legacy_device_health_heart_rate_frequency_changed — El usuario cambió la frecuencia con la que se mide el ritmo cardíaco.
  • legacy_device_health_measurement_started — El usuario inició una medición manual.
  • legacy_device_health_time_range_changed — El usuario cambió el rango de fechas en la pantalla de salud.

Uso de aplicaciones del dispositivo

  • legacy_device_apps_use_time_range_changed — El usuario cambió el rango de fechas en la pantalla de uso de apps. Se registra el tiempo total acumulado y la app más usada del período.

Historial de llamadas

  • legacy_device_call_history_filter_changed — El usuario filtró el historial (todas, entrantes, salientes, perdidas). Filtrar perdidas suele ser señal de preocupación del adulto.

Contactos del dispositivo

Contactos permitidos para llamar al/desde el dispositivo del niño.

  • legacy_contacts_added — El usuario agregó un contacto. Se registra cuántos contactos tiene en total.
  • legacy_contacts_edited — El usuario editó un contacto existente.
  • legacy_contacts_deleted — El usuario eliminó un contacto. Se registra el total restante.

Ajustes del dispositivo

Alarmas

  • legacy_settings_alarm_added — El usuario creó una alarma. Se registra la hora.
  • legacy_settings_alarm_updated — El usuario editó una alarma.
  • legacy_settings_alarm_removed — El usuario eliminó una alarma.

Contactos SOS

  • legacy_settings_sos_contact_added — El usuario agregó un contacto SOS.
  • legacy_settings_sos_contact_removed — El usuario eliminó un contacto SOS.

Whitelist de llamadas (bloqueo de teléfono)

  • legacy_settings_block_phone_contact_added — El usuario agregó un contacto a la lista de llamadas permitidas.
  • legacy_settings_block_phone_contact_removed — El usuario quitó un contacto de la lista de llamadas permitidas.

Control parental (funciones desactivadas)

  • legacy_settings_disable_functions_changed — El usuario guardó cambios en la pantalla de funciones desactivadas.
  • legacy_settings_disable_functions_keyboard_toggled — El usuario activó o desactivó el teclado.
  • legacy_settings_disable_functions_gps_toggled — El usuario activó o desactivó el GPS.

Otros ajustes

  • legacy_settings_language_changed — El usuario cambió el idioma del dispositivo.
  • legacy_settings_alerts_configured — El usuario guardó cambios en las alertas. Se registra cuántas alertas activas tiene y cuáles están encendidas.
  • legacy_settings_timezone_changed — El usuario cambió la zona horaria.
  • legacy_settings_wifi_added — El usuario agregó una red WiFi permitida.
  • legacy_settings_wifi_removed — El usuario eliminó una red WiFi permitida.
  • legacy_settings_sound_changed — El usuario cambió el modo de sonido del dispositivo (normal / silencio / vibración).
  • legacy_settings_sync_clock_triggered — El usuario disparó una sincronización manual del reloj.
  • legacy_settings_battery_night_mode_toggled — El usuario activó o desactivó el modo nocturno (ahorro de batería).

Gestión remota del dispositivo

  • legacy_settings_remote_management_shutdown — El usuario apagó el dispositivo a distancia.
  • legacy_settings_remote_management_restart — El usuario reinició el dispositivo a distancia.
  • legacy_settings_remote_management_factory_reset — El usuario restauró el dispositivo a fábrica. Suele preceder al desvinculado y al churn.

Soporte

  • legacy_support_contact_initiated — El usuario tocó el botón para contactar a soporte. Se registra el canal (email) y el país seleccionado en el formulario.

Onboarding

  • legacy_onboarding_step_changed — El usuario pasó a un nuevo slide del intro inicial.

Panel principal

  • legacy_control_panel_device_selected — El usuario cambió el dispositivo activo (útil cuando hay varios hijos). Se registra cuántos dispositivos tiene vinculados.
  • legacy_control_panel_positions_refreshed — El usuario refrescó manualmente el dashboard (pull-to-refresh o botón de actualizar).

Ubicación y mapa

Zonas seguras (geofences)

  • legacy_location_geofence_created — Se creó una nueva zona segura.
  • legacy_location_geofence_updated — Se editó una zona segura existente.
  • legacy_location_geofence_deleted — Se eliminó una zona segura.

Lugares frecuentes

  • legacy_location_frequent_place_created — Se creó un nuevo lugar frecuente.
  • legacy_location_frequent_place_updated — Se editó un lugar frecuente existente.
  • legacy_location_frequent_place_deleted — Se eliminó un lugar frecuente.

Funnel de creación de lugares (zonas y frecuentes)

  • legacy_location_place_creation_started — El usuario tocó "agregar zona" o "agregar lugar frecuente".
  • legacy_location_point_confirmed — El usuario fijó el centro del lugar tocando el mapa.
  • legacy_location_radius_confirmed — El usuario confirmó el radio de la zona segura. Se registra el tamaño del radio.
  • legacy_location_place_creation_cancelled — El usuario abandonó el flujo de creación o edición. Se registra en qué paso lo dejó.

Exploración y edición

  • legacy_location_geofence_selected — El usuario tocó una zona segura del mapa para verla.
  • legacy_location_geofence_dismissed — El usuario cerró el detalle de la zona sin hacer cambios.
  • legacy_location_geofence_edit_started — El usuario tocó "editar" en una zona seleccionada.
  • legacy_location_frequent_place_selected — El usuario tocó un lugar frecuente para verlo.
  • legacy_location_frequent_place_dismissed — El usuario cerró el detalle del lugar frecuente.
  • legacy_location_history_position_selected — El usuario tocó un punto del historial de ubicaciones en el mapa.
  • legacy_location_history_position_dismissed — El usuario cerró el detalle del punto del historial.

Historial de ubicaciones

  • legacy_location_history_loaded — El usuario cargó el historial de ubicaciones para un rango de fechas.
  • legacy_location_history_cleared — El usuario limpió el trayecto del mapa.

Frecuencia de ubicación

  • legacy_location_frequency_updated — El usuario cambió cada cuánto el dispositivo manda su posición.

Capas del mapa

  • legacy_location_map_geofences_toggled — El usuario mostró u ocultó las zonas seguras en el mapa.
  • legacy_location_map_frequent_places_toggled — El usuario mostró u ocultó los lugares frecuentes en el mapa.
  • legacy_location_map_route_trail_toggled — El usuario mostró u ocultó la línea del trayecto histórico.

Modo "seguir en vivo"

  • legacy_location_following_toggled — El usuario activó o desactivó el modo "seguir dispositivo" (el mapa se re-centra automáticamente sobre el niño).

Acciones del mapa

  • legacy_location_map_actions_expanded — El usuario abrió o cerró el menú de acciones del mapa.
  • legacy_location_map_zoomed — El usuario hizo zoom y se quedó en ese nivel.
  • legacy_location_map_style_changed — El usuario eligió otro estilo de mapa (estándar, claro, oscuro, satélite, etc.).
  • legacy_location_map_center_tapped — El usuario tocó "centrar en el dispositivo" para volver el mapa sobre el niño.
  • legacy_location_map_refresh_tapped — El usuario tocó refrescar dentro del mapa para pedir la posición más reciente.
  • legacy_location_shared — El usuario compartió la ubicación del niño hacia otra app (familia, pareja, abuelos). Acción viral del producto.
  • legacy_location_list_sheet_opened — El usuario abrió la lista con todas sus zonas, lugares frecuentes e historial.
  • legacy_location_history_type_filter_changed — El usuario filtró el historial por tipo de posición (GPS, WiFi, SOS). Filtrar SOS suele indicar que está investigando un evento crítico.