Referencia de eventos integrados

Seguir
Avatar
Jonathan Chen
Updated

Referencia de eventos integrados

Guía completa sobre los eventos mapeados automáticamente en el SDK de Singular y las integraciones S2S, que cubre los tipos de eventos, los disparadores de seguimiento y las ubicaciones de los informes.

Seguimiento automático de eventos: Al integrar el SDK de Singular o S2S en tu aplicación, ciertos eventos se mapean y rastrean automáticamente en la plataforma de Singular sin configuración adicional.

Estos eventos integrados aparecen automáticamente en los informes a nivel de usuario, los postbacks de socios y el análisis agregado, y proporcionan métricas fundamentales para la medición de campañas y el análisis del comportamiento de los usuarios.

Seguimiento automático de eventos

Ventajas de la inicialización del SDK

Una vez que el SDK de Singular se inicializa o se configura la integración S2S, Singular reporta automáticamente los eventos principales sin necesidad de implementación adicional.

Métricas rastreadas automáticamente:

  • Instalaciones: La primera sesión de dispositivos únicos se rastrea automáticamente
  • Sesiones: Se monitorean todos los lanzamientos de la aplicación y las sesiones de usuario
  • DAU: Los usuarios activos diarios se calculan a partir de los datos de sesión
  • Retención: Las tasas de retorno de usuarios se miden en cohortes

Configuración de eventos de ingresos: Si bien los eventos de instalación y sesión son automáticos, los eventos de ingresos requieren configuración en la aplicación mediante los métodos de ingresos del SDK o los parámetros de ingresos de S2S. Una vez configurado, el seguimiento de ingresos es automático para todas las compras posteriores.

Ubicaciones de los informes de eventos

Dónde aparecen los eventos integrados

Los eventos integrados aparecen automáticamente en múltiples ubicaciones de informes y exportación de datos en la plataforma de Singular.

Ubicación Descripción
Registros de atribución a nivel de usuario

Exporta datos detallados a nivel de usuario que incluyen todos los eventos integrados con marcas de tiempo e información de atribución.

Preguntas frecuentes sobre registros de exportación y datos a nivel de usuario

Postbacks de socios

Envía eventos integrados a plataformas de socios para la optimización de campañas si el socio está configurado para recibir nombres de eventos generados automáticamente.

Configura en Configuración de socios → Postbacks de eventos

Postbacks de BI interno

Reenvía eventos integrados a sistemas internos de inteligencia empresarial para análisis e informes personalizados.

Documentación de postbacks de BI interno

Modelos de conversión SKAN

Incluye eventos integrados en el mapeo de valores de conversión de SKAdNetwork para la optimización de campañas de iOS.

Configura en el constructor de modelos de conversión SKAN

Eventos mapeados automáticamente

Referencia completa de los eventos integrados que el SDK de Singular y las integraciones S2S rastrean automáticamente, con los disparadores de seguimiento y detalles de disponibilidad.

Referencia de eventos a nivel de usuario

Tipos de eventos integrados

__START__ - Evento de instalación

Descripción del evento

Representa la instalación de la aplicación y la primera sesión para un dispositivo único, y sirve como evento principal de atribución de instalaciones.

Disparador de seguimiento

Rastreado automáticamente cuando se envía la primera sesión a través de la integración SDK/S2S para un identificador de dispositivo único.

Limitación importante: El evento __START__ es visible SOLO en los postbacks de BI. Este evento no aparece en los informes estándar ni en los postbacks de socios.

Detalles técnicos

Nombre del evento __START__
Tipo de evento Instalación/Primera sesión
Método de seguimiento Automático (inicialización SDK/S2S)
Configuración requerida Ninguna - rastreado automáticamente
Disponibilidad Solo postbacks de BI
__SESSION__ - Evento de sesión

Descripción del evento

Rastrea todos los lanzamientos de la aplicación y las sesiones de usuario, proporcionando la base para las métricas de engagement y retención.

Disparador de seguimiento

Rastreado automáticamente cuando se envían sesiones a través de la integración SDK/S2S. Incluye la primera sesión (instalación) y todos los lanzamientos posteriores de la aplicación.

Definición de sesión

La sesión comienza cuando la aplicación pasa a primer plano y termina después de un período de tiempo de espera configurable (predeterminado: 60 segundos) cuando la aplicación pasa a segundo plano.

Detalles técnicos

Nombre del evento __SESSION__
Tipo de evento Sesión/Lanzamiento de aplicación
Método de seguimiento Automático (gestión de sesiones del SDK)
Configuración requerida Ninguna - rastreado automáticamente
Disponibilidad Todas las ubicaciones de informes

Uso en análisis

Los eventos de sesión generan múltiples métricas derivadas:

  • Usuarios activos diarios (DAU): Usuarios únicos con sesiones en un día determinado
  • Tasa de retención: Porcentaje de usuarios que regresan para sesiones posteriores
  • Frecuencia de sesiones: Promedio de sesiones por usuario durante un período de tiempo
  • Atribución de reinteracción: Sesiones provenientes de campañas de reinteracción
__iap__ - Evento de ingresos del SDK

Descripción del evento

Rastrea las compras dentro de la aplicación y los eventos de ingresos reportados a través de los métodos de ingresos del SDK sin nombres de eventos personalizados.

Disparador de seguimiento

Se rastrea cuando la integración SDK/S2S reporta un evento de ingresos a través del método de ingresos , siempre que el evento de ingresos no tenga un nombre personalizado en la configuración del SDK.

Nombres de eventos de ingresos personalizados: Si el evento de ingresos tiene un nombre personalizado (por ejemplo, "purchase" o "subscription"), aparece con ese nombre en lugar de __iap__ . Ambos enfoques rastrean los ingresos correctamente; __iap__ es el valor predeterminado cuando no se especifica un nombre personalizado.

Detalles técnicos

Nombre del evento __iap__
Tipo de evento Ingresos/Compra dentro de la aplicación
Método de seguimiento Método de ingresos del SDK o parámetros de ingresos S2S
Configuración requerida Implementación del seguimiento de ingresos en el código de la aplicación
Disponibilidad Todas las ubicaciones de informes

Ejemplos de implementación

SDK de iOS: 

// Track revenue without custom event name (appears as __iap__)
Singular.revenue(withAmount: 9.99, currency: "USD")

SDK de Android: 

// Track revenue without custom event name (appears as __iap__)
Singular.revenue("USD", 9.99);

Ingresos S2S: 

amt=9.99&cur=USD&is_revenue_event=true
__REVENUE__ - Cualquier evento de ingresos

Descripción del evento

Evento de ingresos agregados que se activa automáticamente cada vez que se reporta cualquier tipo de ingresos, independientemente de la fuente o el nombre del evento.

Disparador de seguimiento

Rastreado automáticamente si se reportan ingresos a través de cualquier método:

  • Evento __iap__ activado (evento de ingresos predeterminado)
  • SDK reporta evento de ingresos de monetización de anuncios
  • S2S reporta ingresos con nombre de evento personalizado (por ejemplo, "purchase")
  • Otros eventos de ingresos como "refund" u "offline_purchase" reportados

Advertencia sobre la configuración de postbacks

Riesgo de duplicación de ingresos: No envíes postbacks para __REVENUE__ si ya estás enviando postbacks para __iap__ u otros eventos de ingresos. Esto provoca informes de ingresos duplicados ya que __REVENUE__ se activa para cada evento de ingresos.

Enfoque recomendado: Envía postbacks para eventos de ingresos específicos ( __iap__ , eventos de ingresos personalizados) O para __REVENUE__ , pero no para ambos.

Detalles técnicos

Nombre del evento __REVENUE__
Tipo de evento Ingresos agregados (todas las fuentes)
Método de seguimiento Automático (activado por cualquier evento de ingresos)
Configuración requerida Ninguna - automático cuando existen eventos de ingresos
Disponibilidad Todas las ubicaciones de informes

Casos de uso

Cuándo usar __REVENUE__ :

  • Postback único para todos los tipos de ingresos a plataformas de socios
  • Informes de ingresos agregados sin desglose por evento
  • Configuración simplificada de socios con un solo evento de ingresos

Cuándo usar eventos de ingresos específicos:

  • Seguimiento separado para IAP, suscripciones e ingresos publicitarios
  • Optimización por evento en plataformas de socios
  • Atribución detallada de ingresos por tipo de evento
__UNINSTALL__ - Evento de desinstalación

Descripción del evento

Rastrea las desinstalaciones de la aplicación, lo que permite el análisis de abandono y la segmentación de campañas de reinteracción.

Disparador de seguimiento

Rastreado automáticamente si el seguimiento de desinstalaciones está habilitado para la aplicación de iOS o Android, y se detecta al menos una desinstalación. Una vez detectada la desinstalación de un dispositivo, el evento se activa una vez al día hasta la reinstalación o el límite de retención de datos.

Requisitos previos

El seguimiento de desinstalaciones debe habilitarse explícitamente en la plataforma de Singular antes de que aparezcan los eventos __UNINSTALL__ .

Configuración específica por plataforma:

Detalles técnicos

Nombre del evento __UNINSTALL__
Tipo de evento Desinstalación/Abandono
Método de seguimiento Automático (requiere habilitar el seguimiento de desinstalaciones)
Configuración requerida Habilitar el seguimiento de desinstalaciones en la plataforma de Singular
Frecuencia Una vez al día por dispositivo desinstalado
Disponibilidad Todas las ubicaciones de informes (tras la habilitación)

Métodos de detección de desinstalaciones

iOS: Verificación mediante notificación push silenciosa

Android: Verificación mediante FCM (Firebase Cloud Messaging)

Momento de detección: La detección de desinstalaciones no es en tiempo real. Generalmente se detecta dentro de las 24-48 horas posteriores a la desinstalación real, dependiendo de la entrega de notificaciones de la plataforma.

__REINSTALL__ - Evento de reinstalación

Descripción del evento

Rastrea la reinstalación de la aplicación tras una desinstalación previa, lo que permite la medición de campañas de recuperación y el análisis del ciclo de vida del usuario.

Disparador de seguimiento

Rastreado automáticamente si el seguimiento de desinstalaciones está habilitado a través de SDK/S2S. Cuando se rastrea __UNINSTALL__ para un dispositivo y luego se activa __SESSION__ , el evento __REINSTALL__ se activa automáticamente.

Secuencia de activación

  1. Instalación inicial: El usuario instala la aplicación, se rastrean __START__ y __SESSION__
  2. Uso de la aplicación: El usuario interactúa con la aplicación, se rastrean múltiples eventos __SESSION__
  3. Desinstalación: El usuario desinstala la aplicación, se detecta y rastrea __UNINSTALL__
  4. Reinstalación: El usuario reinstala la aplicación y la lanza
  5. Detección de reinstalación: La primera __SESSION__ después de __UNINSTALL__ activa el evento __REINSTALL__

Detalles técnicos

Nombre del evento __REINSTALL__
Tipo de evento Reinstalación/Recuperación
Método de seguimiento Automático (requiere seguimiento de desinstalaciones)
Configuración requerida Habilitar el seguimiento de desinstalaciones en la plataforma de Singular
Requisitos previos Evento __UNINSTALL__ previo para el dispositivo
Disponibilidad Todas las ubicaciones de informes

Consideraciones de atribución

Las reinstalaciones pueden atribuirse a campañas de reinteracción si el usuario hizo clic en un enlace de campaña antes de reinstalar. La configuración de la ventana de atribución se aplica a la atribución de reinstalaciones de la misma forma que a la atribución de la instalación inicial.

Medición de campañas de recuperación: Usa los eventos __REINSTALL__ para medir la efectividad de las campañas de recuperación dirigidas a usuarios que abandonaron. Compara las tasas de reinstalación y el engagement posterior entre fuentes de campaña.

Informes de eventos agregados

Singular genera automáticamente eventos y métricas a nivel agregado basados en eventos integrados, proporcionando medición del rendimiento de campañas y análisis del comportamiento de usuarios.

Métricas derivadas

Eventos basados en sesiones

Métricas agregadas calculadas automáticamente a partir de eventos de sesión que aparecen en informes y paneles de análisis.

Nota importante: Estos eventos agregados no son visibles en la sección de Eventos, pero aparecen en toda la interfaz de informes como métricas estándar.

Instalaciones

Definición de la métrica

Rastrea la primera sesión de dispositivos únicos, que representa las nuevas instalaciones de la aplicación y la métrica de atribución principal.

Método de cálculo

Recuento de identificadores de dispositivos únicos con el primer evento __SESSION__ en el período del informe.

Uso en informes

  • Medición del rendimiento de campañas
  • Atribución de instalaciones por fuente y canal
  • Cálculo del costo por instalación (CPI)
  • Análisis del embudo de instalaciones
Reinteracción

Definición de la métrica

Rastrea las sesiones activadas por campañas de reinteracción, midiendo la efectividad de las campañas dirigidas a usuarios existentes.

Dependencia de configuración

El seguimiento de reinteracción depende de la configuración de socios que define las ventanas de atribución de reinteracción y los parámetros de campaña.

Método de cálculo

Sesiones atribuidas a campañas de reinteracción dentro de la ventana de atribución configurada, independientemente de si es la primera o una sesión posterior del usuario.

Uso en informes

  • Medición del ROI de campañas de reinteracción
  • Tasas de activación de usuarios inactivos
  • Rendimiento de reinteracción entre canales
  • Transiciones entre etapas del ciclo de vida del usuario
Usuarios activos diarios (DAU)

Definición de la métrica

Recuento diario de usuarios únicos con al menos una sesión en un día determinado, que mide el tamaño de la base de usuarios activos.

Método de cálculo

Recuento de identificadores de dispositivos únicos con al menos un evento __SESSION__ en un día calendario específico.

Métricas relacionadas

  • WAU: Usuarios activos semanales (recuento único de 7 días)
  • MAU: Usuarios activos mensuales (recuento único de 30 días)
  • Relación DAU/MAU: Indicador de fidelización (DAU dividido por MAU)

Uso en informes

  • Análisis de tendencias de engagement de la aplicación
  • Medición del crecimiento de la base de usuarios
  • Identificación de patrones de uso estacionales
  • Monitoreo del estado de la plataforma
Retención

Definición de la métrica

Porcentaje de usuarios que instalaron la aplicación (primera sesión) y regresaron para sesiones adicionales dentro de un período de tiempo especificado.

Método de cálculo

(Usuarios con sesiones en el Día N después de la instalación / Total de usuarios instalados en el Día 0) × 100

Tipos de retención

Tipo de retención Descripción
Retención del Día 1 Porcentaje de usuarios que regresan el día después de la instalación
Retención del Día 7 Porcentaje de usuarios que regresan 7 días después de la instalación
Retención del Día 30 Porcentaje de usuarios que regresan 30 días después de la instalación
Retención continua Usuario regresó en o después del Día N (acumulativo)

Uso en informes

  • Evaluación del ajuste producto-mercado
  • Medición de la efectividad del proceso de incorporación
  • Comparación de la calidad de campañas (fuentes de alta vs baja retención)
  • Predicción y prevención del abandono

Eventos basados en ingresos

Métricas de ingresos agregados

Métricas de ingresos calculadas automáticamente que aparecen en informes y paneles de análisis para la medición del ROI de campañas.

Ingresos

Definición de la métrica

Rastrea las compras dentro de la aplicación (IAP), eventos de ingresos personalizados e ingresos por suscripción, excluyendo la monetización de anuncios.

Fuentes de ingresos incluidas

  • Eventos __iap__ (evento de ingresos predeterminado)
  • Eventos de ingresos personalizados (purchase, subscription, etc.)
  • Renovaciones y actualizaciones de suscripciones
  • Compras únicas y consumibles

Fuentes de ingresos excluidas

  • Ingresos por monetización de anuncios (rastreados por separado en Ad Mon Revenue)

Uso en informes

  • Cálculo del ROI y ROAS de campañas
  • Medición del LTV del usuario
  • Análisis del embudo de monetización
  • Atribución de ingresos por fuente
Ad Mon Revenue

Definición de la métrica

Rastrea SOLO los ingresos generados por eventos de monetización de anuncios, separando los ingresos publicitarios de los ingresos por compras.

Fuentes de ingresos incluidas

  • Impresiones de anuncios banner
  • Visualizaciones de anuncios intersticiales
  • Completaciones de video con recompensa
  • Interacciones con anuncios nativos
  • Completaciones de offerwall

Requisito de implementación

Requiere integración del SDK de monetización de anuncios o reporte de ingresos publicitarios vía S2S con la designación del tipo de evento correspondiente.

Uso en informes

  • Optimización de la estrategia de monetización de anuncios
  • Análisis del modelo de monetización híbrida
  • Rentabilidad por segmento de usuarios (IAP vs ingresos publicitarios)
  • Rendimiento de la tasa de relleno y eCPM
Ingresos totales

Definición de la métrica

Rastrea todos los eventos de ingresos de todas las fuentes, proporcionando un panorama completo de la monetización que incluye IAP, suscripciones e ingresos publicitarios.

Método de cálculo

Ingresos totales = Ingresos + Ad Mon Revenue

Fuentes de ingresos incluidas

  • Todos los ingresos de IAP y compras
  • Ingresos por suscripciones
  • Ingresos por monetización de anuncios
  • Eventos de ingresos personalizados (reembolsos, compras offline, etc.)

Uso en informes

  • Medición completa del ROI de campañas
  • Cálculo del LTV combinado entre tipos de monetización
  • Seguimiento del rendimiento general del negocio
  • Comparación de rentabilidad entre canales

Segmentación de ingresos: Usa Ingresos, Ad Mon Revenue e Ingresos totales en conjunto para entender la combinación de monetización y optimizar la estrategia para diferentes segmentos de usuarios.

Recursos adicionales

Documentación completa sobre el seguimiento de eventos, la configuración y los informes en la plataforma de Singular.

Documentación de eventos

Seguimiento de desinstalaciones