Seguimiento de eventos dentro de la aplicación
Los eventos dentro de la aplicación le ayudan a medir el rendimiento de la campaña y los indicadores clave de rendimiento (KPI) mediante el seguimiento de las acciones del usuario, como inicios de sesión, registros, finalización de tutoriales o subidas de nivel en aplicaciones de juegos. Singular recopila estos eventos para proporcionar información sobre el comportamiento del usuario y optimizar los esfuerzos de marketing.
Eventos estándar frente a eventos personalizados
Singular admite dos tipos de eventos:
- Eventos estándar: Eventos predefinidos (por ejemplo, sngLogin, sngContentView) reconocidos por Singular y a menudo admitidos por las redes publicitarias para la generación de informes y la optimización. El uso de eventos estándar simplifica la configuración, ya que Singular los añade automáticamente a la lista de eventos sin necesidad de definirlos manualmente. Recomendación: Utilice eventos estándar siempre que sea posible por motivos de compatibilidad y facilidad de uso. Consulte la Lista de eventos y atributos estándar para conocer los nombres de los eventos estándar y los atributos recomendados.
-
Eventos personalizados: Eventos exclusivos de su aplicación (por ejemplo, Signup, AchievementUnlocked) que no coinciden con los eventos estándar de Singular.
Limitaciones de los eventos personalizados:
- Recomendamos encarecidamente pasar los nombres y atributos de los eventos en inglés para garantizar la compatibilidad con socios de terceros y soluciones de análisis si tiene previsto utilizarlos.
- Losnombres de eventos están limitados a 32 caracteres ASCII. Las cadenas en caracteres no ASCII deben tener menos de 32 bytes una vez convertidas a UTF-8.
- Los atributos y valores están limitados a 500 caracteres ASCII.
Trabaje con su equipo de UA, marketing o comercial para compilar una lista de eventos y atributos basada en los KPI de marketing de su aplicación. Consulte Cómo realizar el seguimiento de eventos en la aplicación: Guía para clientes de Singular Attribution para obtener orientación sobre la selección de eventos.
Enviar eventos
- Utilice el método event para rastrear un evento personalizado simple con el SDK de Singular.
- Utilice el método eventWithArgs para rastrear un evento personalizado con atributos adicionales con el SDK de Singular.
Mejores prácticas
- Utilice eventos estándar: Prefiera eventos estándar para compatibilidad con redes publicitarias y reconocimiento automático en la lista de eventos de Singular.
- Valide los atributos: Compruebe que los atributos coinciden con el formato esperado.
- Depuración de eventos: Active el registro del SDK durante el desarrollo para verificar que los eventos se envían correctamente y se activan en los momentos adecuados del ciclo de vida de su aplicación (por ejemplo, después de que un usuario inicie sesión).
Nota: coordine con su equipo de UA/marketing para asegurarse de que los eventos rastreados coinciden con los KPI de su aplicación. Pruebe los eventos en un entorno de desarrollo antes de desplegarlos en producción para verificar la exactitud de los datos en Singular Dashboard.
Seguimiento de ingresos
El SDK React Native de Singular le permite realizar un seguimiento de los eventos de ingresos dentro de la aplicación para analizar el rendimiento de la campaña y el ROI. Los datos de ingresos están disponibles en los informes de Singular, las exportaciones de registro y los postbacks, proporcionando información procesable sobre la monetización de su aplicación.
¿Por qué hacer un seguimiento de los eventos de ingresos?
- Análisis detallados: Capture datos detallados de transacciones para mejorar los informes de Singular.
- Prevención del fraude: Incluya recibos de transacciones (por ejemplo, de Google Play o Apple App Store) para validar las compras y combatir el fraude dentro de la aplicación.
- Optimización de campañas: Mida el ROI vinculando los ingresos a los esfuerzos de marketing.
Práctica recomendada: Pasar el objeto de compra completo
Recomendamos encarecidamente pasar el objeto de compra devuelto por el proceso In-App Purchase (IAP) de Android (Google Play Billing) o iOS (StoreKit). Esto asegura que Singular reciba los detalles completos de la transacción, incluyendo:
- ID del producto
- Precio
- Moneda
- ID de la transacción
- Datos del recibo (para validación)
Al pasar el objeto de compra completo, habilita informes más ricos y aprovecha las capacidades de detección de fraude de Singular, en particular para las transacciones de Google Play.
Captura del objeto de compra IAP
Utilice las bibliotecas IAP específicas de la plataforma para recuperar el objeto de compra:
- iOS: Utilice react-native-iap o similar para acceder a los detalles de compra de StoreKit.
- Android: Utilice react-native-iap o la biblioteca de facturación de Google Play para obtener el objeto de compra.
Enviar ingresos de IAP
- Utiliza el método inAppPurchase para rastrear un evento de compra dentro de la aplicación con detalles de compra.
- Utiliza el método inAppPurchaseWithArgs para realizar el seguimiento de un evento de compra dentro de la aplicación con detalles de compra y atributos personalizados adicionales.
Enviar ingresos sin el objeto de compra
Aunque recomendamos encarecidamente informar de los eventos de ingresos utilizando los métodos inAppPurchase para la validación de ingresos, también puede enviar eventos de ingresos a Singular simplemente pasando la divisa y el importe de la transacción.
Importante: Al enviar eventos de ingresos sin un objeto de compra válido, Singular no valida las transacciones.
Requisitos
Nota: Pase la divisa como un código de divisa ISO 4217 de tres letras, por ejemplo, "USD," "EUR", "INR".
- Utilice el método revenue para realizar el seguimiento de un evento de ingresos simple con una divisa y un importe especificados.
- Utilice el método revenueWithArgs para realizar el seguimiento de un evento de ingresos con una divisa, un importe y atributos personalizados adicionales especificados.
- Utilice el método customRevenue para realizar el seguimiento de un evento de ingresos personalizado con un nombre de evento, divisa e importe especificados.
- Utilice el método customRevenueWithArgs para realizar el seguimiento de un evento de ingresos personalizado con un nombre de evento, divisa, importe y atributos personalizados adicionales especificados.
Envío de ingresos de suscripción
Singular ofrece una guía completa sobre cómo implementar eventos de suscripción utilizando el SDK de Singular. Cubre el seguimiento de eventos de suscripción dentro de la aplicación en varias plataformas.
- Lea nuestra Guía de implementación técnica de eventos de suscripción si desea realizar un seguimiento de los ingresos por suscripción.
Envío de ingresos por publicidad
Ad Revenue Attribution le ayuda a conectar sus ingresos publicitarios con las campañas específicas que llevaron a los usuarios a su aplicación. Esto le ofrece una imagen clara del rendimiento de sus anuncios al mostrar el coste de la campaña, los ingresos dentro de la aplicación y los ingresos por publicidad, todo en un mismo lugar. Esta función también le permite enviar los datos de ingresos publicitarios a sus redes publicitarias para mejorar el rendimiento de sus anuncios.
- Utilice el método adRevenue para realizar un seguimiento de los eventos de ingresos publicitarios con información detallada de los datos publicitarios.
- Lea nuestra guía detallada sobre la implementación de la atribución de ingresos publicitarios con socios de mediación.
Seguimiento de eventos híbridos
Singular recomienda enviar todos los eventos e ingresos a través del SDK de Singular integrado en su aplicación. Sin embargo, Singular puede recopilar eventos e ingresos de otras fuentes.
Cualquier evento NO enviado desde el SDK de Singular debe cumplir con los requisitos de documentación de eventos de servidor a servidor de Singular y proporcionar el identificador de dispositivo correspondiente para atribuir correctamente un evento.
Importante:
Se producirán discrepancias si los identificadores de dispositivo utilizados en las solicitudes de eventos de servidor a servidor no tienen un identificador de dispositivo coincidente en Singular. Tenga en cuenta las siguientes posibilidades:
- Si se recibe una solicitud de evento "antes" de que Singular SDK haya registrado el identificador de dispositivo, desde una App Session, entonces la solicitud de evento se considerará la "primera sesión" para el dispositivo desconocido, y Singular atribuirá el dispositivo como una atribución orgánica.
- Si Singular SDK registró un identificador de dispositivo, pero el identificador de Singular SDK difiere del identificador de dispositivo especificado en la solicitud de evento de servidor a servidor, entonces el evento se atribuirá incorrectamente.
Guías de seguimiento de eventos híbridos
Singular puede recopilar datos sobre los ingresos de su Servidor para ayudar a analizar el rendimiento y el ROI de sus campañas.
Requisitos:
- Desde un Evento de Registro o Inicio de Sesión in-app, capture y pase los identificadores de dispositivo y almacene estos datos con el ID de Usuario en su servidor. Dado que los identificadores de dispositivo pueden cambiar para un usuario, asegúrese de actualizar los identificadores cuando un usuario genere una sesión de aplicación. Esto garantiza que el evento del lado del servidor se atribuya al dispositivo correcto.
- Los eventos del lado del servidor son específicos de cada plataforma y sólo deben enviarse con el identificador de dispositivo que coincida con la plataforma del dispositivo (por ejemplo, IDFA o IDFV para dispositivos iOS).
- Puede utilizar el mecanismo de postback de Singular Internal BI para enviar un evento en tiempo real a su endpoint interno para que pueda actualizar el conjunto de datos en el lado del servidor. Consulte las Preguntas Frecuentes sobre Postback de BI Interno.
- Revise la sección de Seguimiento de Ingresos en la guía de Integración Servidor-a-Servidor para más detalles.
Siga los siguientes enlaces para obtener más información sobre cómo habilitar a estos socios.