Medición de campañas de notificaciones push

Documento

Medición de campañas de notificaciones push

Realice un seguimiento y mida el rendimiento de las campañas de notificaciones push en iOS y Android para atribuir eventos de reenganche a campañas push específicas y optimizar las estrategias de retención de usuarios.

Singular proporciona un seguimiento perfecto de las campañas de notificaciones push a través de Firebase Cloud Messaging (FCM), Apple Push Notification Service (APNs) y plataformas de terceros como CleverTap, MoEngage, WebEngage, OneSignal, Salesforce Marketing Cloud y Braze.


Cómo funciona el seguimiento de notificaciones push

Singular realiza el seguimiento de las campañas de notificaciones push incrustando enlaces de seguimiento en las cargas útiles de las notificaciones y atribuyendo las aperturas de las aplicaciones a la campaña de origen.

Flujo de seguimiento

  1. Crear campaña: Cree una notificación push con un enlace de seguimiento de Singular incrustado como datos clave/valor personalizados.
  2. El usuario recibe la notificación: El proveedor push entrega la notificación al dispositivo del usuario
  3. El usuario toca la notificación: El usuario abre la aplicación tocando la notificación
  4. SDK procesa la carga útil: El SDK de Singular extrae los datos de seguimiento de la carga útil de la notificación.
  5. Atribución registrada: Singular atribuye la apertura de la aplicación como un evento de reconexión a la campaña push.

Reconexión vs. Adquisición: El seguimiento de notificaciones push mide el reenganche (usuarios existentes que vuelven a su aplicación), no la adquisición de nuevos usuarios. El enlace de seguimiento debe configurarse con la reconexión activada.


Proveedores de notificaciones push compatibles

Singular soporta el seguimiento de notificaciones push a través de los principales proveedores push y plataformas de automatización de marketing.

Matriz de plataformas compatibles

Proveedor Plataforma Tipo de integración Soporte de Singular
Mensajería en la nube Firebase (FCM) Android Carga útil de datos personalizada
Servicio de notificaciones push de Apple (APNs) iOS Carga útil de datos personalizada
CleverTap iOS, Android Carga útil de datos personalizada
MoEngage iOS, Android Carga útil de datos personalizada
WebEngage iOS, Android Carga útil de datos personalizada
OneSignal iOS, Android Datos personalizados o URL de lanzamiento
Salesforce Marketing Cloud (SFMC) iOS, Android Datos personalizados u OpenDirect
Braze iOS, Android Datos personalizados o comportamiento al hacer clic

Flexibilidad de integración: Algunos proveedores (OneSignal, SFMC, Braze) admiten la integración directa de enlaces de seguimiento a través de campos CTA, lo que elimina la necesidad de una configuración SDK personalizada. Consulte Métodos de integración alternativos para obtener más detalles.


Requisitos previos

Compruebe que su aplicación cumple estos requisitos antes de implementar el seguimiento de notificaciones push.

Configuración requerida

Integración de Singular SDK

Instale y configure Singular SDK con el soporte de notificaciones push activado.


Infraestructura de notificaciones push

Configure la entrega de notificaciones push en su aplicación y sistemas backend.

  • Android: Firebase Cloud Messaging configurado con una clave de servidor válida
  • iOS: Certificados APNs o tokens configurados en la cuenta de desarrollador de Apple
  • Registro del dispositivo: La aplicación se registra correctamente para las notificaciones push y almacena los tokens
  • Pruebas de entrega: Verificación de que las notificaciones push llegan correctamente a los dispositivos

Cuenta de proveedor push

Establezca y configure su proveedor de servicios de notificaciones push.

  • Cuenta de proveedor: Cuenta activa con FCM, APN o plataforma de terceros.
  • Soporte de datos personalizados: Compruebe que el proveedor admite pares clave/valor personalizados en las cargas útiles.
  • Acceso a API: Credenciales configuradas para enviar notificaciones mediante programación

Pasos de implementación

Siga estos pasos para implementar el seguimiento de campañas de notificaciones push con Singular.

Paso 1: Crear enlace de seguimiento de Singular

Generar enlace de reenganche

Cree un Enlace Singular configurado específicamente para el seguimiento del reenganche de las campañas de notificaciones push.

  1. Vaya a Enlaces Singulares: Acceda a la sección Singular Links en su panel de control de Singular.
  2. Crear nuevo enlace: Haga clic en "Crear nuevo enlace" y seleccione su aplicación.
  3. Habilitar reenganche: Active la opción "Re-engagement" (fundamental para el seguimiento push)
  4. Configurar parámetros: Añada parámetros de campaña para la atribución (fuente, medio, nombre de campaña)
  5. Generar enlace: Guarde y genere formatos de URL cortos y largos

Guía completa: Creación de enlaces de seguimiento singulares

Crítico: El enlace de seguimiento DEBE tener activada la reactivación. Los enlaces que no tengan activada la reconexión no atribuirán correctamente las aperturas de notificaciones push.

Ejemplo de configuración de enlace:

Singular Link Creation

Alternar reenganche:

Enable Re-engagement

Enlace generado:

Generated Singular Link

Paso 2: Añadir enlace a la carga útil de la notificación push

Configurar datos personalizados

Incruste el enlace de seguimiento de Singular en la sección de datos personalizados de su notificación push utilizando el nombre de clave estándar.

Requisitos de configuración:

  • Nombre de la clave: Utilice sng_link como clave de datos personalizados (distingue mayúsculas de minúsculas).
  • Valor: Pegue su enlace de seguimiento Singular completo (formato corto o largo)
  • Tipo de datos: Valor de cadena en la carga útil de datos personalizados

Ejemplo de mensajería en la nube Firebase

Añadir datos personalizados a las notificaciones FCM a través de la Consola Firebase o API.

Configuración de la Consola Firebase:

Firebase Custom Data
FCM API
{
  "notification": {
    "title": "Special Offer Inside!",
    "body": "Open now to claim your reward"
  },
  "data": {
    "sng_link": "https://your-app.sng.link/Abc12/xyz9?pcn=push_campaign"
  },
  "to": "device_registration_token_here"
}

Ejemplo de servicio de notificaciones push de Apple

Incluir datos personalizados en la carga útil de APNs utilizando el formato estándar de diccionario aps.

Estructura de la carga útil de APNs:

APNs Custom Data
APNs JSON
{
  "aps": {
    "alert": {
      "title": "Special Offer Inside!",
      "body": "Open now to claim your reward"
    },
    "sound": "default",
    "badge": 1
  },
  "sng_link": "https://your-app.sng.link/Abc12/xyz9?pcn=push_campaign"
}

Admite ambos formatos: Singular acepta tanto enlaces cortos (sng.link) como enlaces largos (formato de dominio personalizado). Utilice el formato que mejor se adapte a su infraestructura de seguimiento.


Paso 3: Configurar el SDK para procesar la clave personalizada

Configuración del SDK de Android

Configure el SDK de Android de Singular para extraer y procesar la clave de datos personalizados sng_link de las notificaciones de FCM.

Kotlin
// In your FirebaseMessagingService
override fun onMessageReceived(remoteMessage: RemoteMessage) {
    super.onMessageReceived(remoteMessage)
    
    // Extract custom data from notification
    val data = remoteMessage.data
    
    // Check for Singular tracking link
    if (data.containsKey("sng_link")) {
        val singularLink = data["sng_link"]
        
        // Pass to Singular SDK for attribution
        Singular.setGCMData(data)
    }
    
    // Display notification to user
    showNotification(remoteMessage)
}

Guía completa de integración: Soporte de notificaciones push de Android


Configuración del SDK de iOS

Configure el SDK de Singular iOS para extraer y procesar la clave de datos personalizados sng_link de las notificaciones APNs.

Swift
// In your AppDelegate
func application(_ application: UIApplication, 
                 didReceiveRemoteNotification userInfo: [AnyHashable : Any],
                 fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    
    // Check for Singular tracking link
    if let singularLink = userInfo["sng_link"] as? String {
        // Pass to Singular SDK for attribution
        Singular.setAPNSData(userInfo)
    }
    
    completionHandler(.newData)
}

// For iOS 10+ UNUserNotificationCenter
func userNotificationCenter(_ center: UNUserNotificationCenter,
                           didReceive response: UNNotificationResponse,
                           withCompletionHandler completionHandler: @escaping () -> Void) {
    
    let userInfo = response.notification.request.content.userInfo
    
    // Check for Singular tracking link
    if let singularLink = userInfo["sng_link"] as? String {
        // Pass to Singular SDK for attribution
        Singular.setAPNSData(userInfo)
    }
    
    completionHandler()
}

Guía completa de integración: Soporte de notificaciones push de iOS.


Paso 4: Probar y validar

Procedimiento de prueba

Compruebe que el seguimiento de las notificaciones push funciona correctamente antes de lanzar las campañas.

  1. Enviar notificación de prueba: Activar una notificación push de prueba con el enlace Singular en los datos personalizados.
  2. Recibir en dispositivo: Confirma que la notificación aparece en el dispositivo de prueba
  3. Tocar notificación: Abra la aplicación tocando la notificación
  4. Compruebe los registros SDK: Compruebe que los registros del SDK muestran la extracción de Singular link
  5. Validar panel de control: Confirme que el evento de reenganche aparece en el panel de Singular en un plazo de 5 minutos.

Validación específica de la plataforma:

Problemas comunes:

  • Faltan eventos: Compruebe que el nombre de la clave sng_linkes exacto (distingue entre mayúsculas y minúsculas)
  • Atribución incorrecta: Confirme que el reenganche está activado en el enlace de seguimiento
  • SDK no procesado: Comprobar que el SDK se inicializa antes de gestionar la notificación

Paso 5: Supervisar el rendimiento de la campaña

Analizar los resultados de las notificaciones push

Realice un seguimiento del rendimiento y el retorno de la inversión de las campañas de notificaciones push en los informes analíticos de Singular.

Métricas disponibles:

  • Re-engagement Events: Total de aperturas de aplicaciones atribuidas a notificaciones push
  • Tasa de reconexión: Porcentaje de usuarios que abrieron la aplicación desde una notificación push
  • Atribución de ingresos: Ingresos generados por los usuarios reenganchados
  • Comparación de campañas: Rendimiento de diferentes campañas push
  • Análisis de cohortes: Comportamiento de los usuarios tras la reconexión

Ejemplo de panel de control:

Singular Analytics Dashboard

Acceda a los informes a través de: Analytics → Aggregated Analytics Reports → Filter by Re-engagement Source.


Métodos de integración alternativos

Algunos proveedores de push admiten la integración directa de enlaces de seguimiento sin necesidad de configurar datos personalizados en SDK.

Integración directa de CTA

Ciertas plataformas permiten configurar enlaces de seguimiento Singular directamente en campos CTA de notificaciones, lanzando automáticamente la app con datos de atribución.

URL de lanzamiento de OneSignal

OneSignal admite enlaces de seguimiento directo a través de la función Launch URL.

  • Configuración: Añadir enlace Singular al campo Launch URL en el compositor de notificaciones.
  • Comportamiento: Al tocar la notificación se abre la aplicación con el enlace Singular procesado automáticamente
  • Requisito SDK: Integración mínima con el SDK de Singular

Documentación: URL de lanzamiento de OneSignal


OpenDirect de Salesforce Marketing Cloud

SFMC proporciona la funcionalidad OpenDirect para lanzar aplicaciones con vínculos de seguimiento.

  • Configuración: Establezca el enlace Singular como URL OpenDirect en la configuración de mensajes
  • Comportamiento: El toque de notificación activa el lanzamiento de la aplicación a través del protocolo OpenDirect.
  • Compatibilidad con plataformas: Disponible para iOS y Android

Documentación: SFMC OpenDirect


Comportamiento al hacer clic de Braze

Braze permite configurar los enlaces de seguimiento Singular en los ajustes de comportamiento al hacer clic de las notificaciones.

  • Configuración: Añadir enlace Singular al campo Comportamiento al hacer clic en el compositor push
  • Comportamiento: El toque en la notificación abre la aplicación con procesamiento automático del enlace
  • Tipos de acción: Admite opciones de enlace profundo y URL externa

Documentación: Braze On-Click Behavior

Recomendación: Utilice la integración directa de CTA cuando esté disponible: simplifica la implementación y reduce los requisitos de configuración del SDK. Sin embargo, el método de datos personalizados proporciona la máxima flexibilidad en todos los proveedores.


Mejores prácticas

Siga estas directrices para maximizar la precisión y la eficacia del seguimiento de campañas de notificaciones push.

Estructura de la campaña

Configuración de enlaces

  • Enlaces únicos por campaña: Cree enlaces de seguimiento independientes para cada campaña push con el fin de aislar el rendimiento
  • Parámetros descriptivos: Utilice nombres de campaña claros en los parámetros de los enlaces de seguimiento
  • Nombres coherentes: Establezca convenciones de nomenclatura para las campañas push (por ejemplo, push_promo_2025_q1)
  • Pruebas antes del lanzamiento: Valide cada nuevo enlace de seguimiento con notificaciones de prueba

Implementación técnica

  • Sensibilidad a mayúsculas y minúsculas: Utilice siempre sng_linkexactamente como está escrito (minúsculas)
  • Codificación de URL: Asegúrese de que los enlaces de seguimiento están codificados correctamente en las solicitudes de API.
  • Tamaño de la carga útil: Supervise el tamaño de la carga útil de las notificaciones y manténgalo por debajo de los límites de la plataforma (4 KB para APN, 4 KB para FCM).
  • Gestión de errores: Implementación de una lógica alternativa si faltan datos personalizados en la notificación
  • Versión del SDK: Utilice la última versión del SDK de Singular para una compatibilidad óptima con las notificaciones push.

Optimización del rendimiento

  • Segmentación: Dirija las campañas push a segmentos de usuarios comprometidos para obtener mayores tasas de apertura
  • Tiempo: Envía notificaciones durante las ventanas de compromiso óptimas basadas en el comportamiento del usuario
  • Pruebas A/B: Pruebe diferentes mensajes y tiempos con enlaces de seguimiento independientes.
  • Límites de frecuencia: Limite la frecuencia de las notificaciones push para evitar el cansancio de los usuarios y las bajas voluntarias.
  • Enlaces profundos: Combine el seguimiento push con enlaces profundos a contenidos específicos de la aplicación.

Resolución de problemas

Problemas comunes y soluciones

Problema Causa Solución
Los eventos no aparecen en el panel de control El reenganche no está habilitado en el enlace Compruebe que el enlace de seguimiento tiene activada la reactivación en Singular Links.
SDK no extrae el enlace Nombre incorrecto de la clave de datos personalizados Confirme que la clave es exactamente sng_link (distingue mayúsculas de minúsculas)
Atribución a campaña incorrecta Uso del mismo enlace en todas las campañas Cree un enlace de seguimiento único para cada campaña
Retraso en la notificación de eventos Latencia de la red o modo sin conexión El SDK pone en cola los eventos y los envía cuando se restablece la conexión (hasta 24 horas)
No se realiza el seguimiento de las notificaciones de iOS Falta el manejador de datos APNs Implemente setAPNSData() en los métodos delegados de notificación
No se realiza un seguimiento de las notificaciones de Android Falta el manejador de datos FCM Llamar a setGCMData() en FirebaseMessagingService

Soporte: Para obtener ayuda adicional para la solución de problemas, póngase en contacto con Singular Support con ejemplos de carga útil de notificaciones push, registros de SDK y capturas de pantalla del panel de control que muestren el problema.