> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reportes de mensajes push

> Los reportes de mensajes push muestran resultados de entrega, entrega confirmada, diagnósticos de fallos, tasas de clics y actividad de audiencia por suscripción para cada envío push.

Los reportes de mensajes push te ayudan a rastrear el rendimiento de cada notificación push, incluyendo resultados de entrega, participación del usuario (CTR), confirmaciones a nivel de dispositivo y diagnósticos de errores.

<Frame caption="Estadísticas de alto nivel del reporte de mensajes push.">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/7fb7f716c8be4e153110e21fe514e872347188578674781fc75787cbc2f60136-Screenshot_2025-03-11_at_2.48.15_PM.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=3a0aae3f8a7376838920bd16234c6876" alt="Reporte de mensajes push mostrando métricas de entregados, clicados y CTR" width="2292" height="386" data-path="images/docs/7fb7f716c8be4e153110e21fe514e872347188578674781fc75787cbc2f60136-Screenshot_2025-03-11_at_2.48.15_PM.png" />
</Frame>

***

## Métricas de entrega

OneSignal envía notificaciones push a los **servicios push** (Google FCM, Apple APNs, Huawei HMS) que las entregan a los dispositivos de tus usuarios (Suscripciones). Las métricas Entregados, Desuscritos y Fallidos provienen de estos servicios push. Las métricas de [Entrega Confirmada](./confirmed-delivery) y Clicados provienen del SDK de OneSignal en el dispositivo.

| Métrica                      | Definición                                                                                                                                                                                      |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Enviados**                 | El número de mensajes enviados exitosamente desde OneSignal al proveedor.                                                                                                                       |
| **Total Intentados**         | El número de mensajes que intentamos enviar. Métrica derivada calculada como Enviados + Limitados por frecuencia.                                                                               |
| **Audiencia**                | El número de suscripciones en los segmentos objetivo.                                                                                                                                           |
| **Entregados**               | El número de Suscripciones push a las que el servicio push entregó el mensaje.                                                                                                                  |
| **Desuscritos**              | El número de Suscripciones push que no recibieron el mensaje porque desinstalaron la app, borraron datos del navegador u optaron por no recibir push y no han abierto la app desde entonces.    |
| **Fallidos**                 | El número de Suscripciones push que no recibieron el mensaje debido a un error. Consulta [Solución de problemas de mensajes fallidos](#failure-message-troubleshooting).                        |
| **Clics**                    | El número de clics en una notificación.                                                                                                                                                         |
| **Limitados por frecuencia** | El número de Suscripciones push a las que no se envió la notificación debido a la configuración de límite de frecuencia.                                                                        |
| **Entrega Confirmada**       | El número de Suscripciones push que confirmaron recibir el mensaje.                                                                                                                             |
| **Restantes**                | El número de notificaciones aún en cola en el lado de OneSignal para envío.                                                                                                                     |
| **Tasa de clics**            | Calculado como `(Clics / Entregados) * 100%`.                                                                                                                                                   |
| **CTR Confirmado**           | Calculado como `(Clics / Entrega Confirmada) * 100%`.                                                                                                                                           |
| **Aperturas Influenciadas**  | El número de aperturas de app que ocurrieron después de recibir la notificación, sin hacer clic. Basado en la ventana de tiempo establecida en **Settings > Push & In-App > Influenced Opens**. |

<Note>
  Para definiciones detalladas de métricas en todos los canales, consulta el [Glosario de métricas](./analytics-metrics-glossary).
</Note>

### Solución de problemas de mensajes fallidos

Estos errores impidieron que OneSignal entregara el mensaje al proveedor push:

| Error                                                                                                                                                                  | Tipo | Pasos de solución de problemas                                                                                                                                                               |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **401 Unauthorized**                                                                                                                                                   | Web  | El servidor web push dio un error 401 poco claro. Reintenta con precaución — puede causar envíos duplicados.                                                                                 |
| **404 Not Found**                                                                                                                                                      | Web  | Endpoint de suscripción push inválido (token incorrecto).                                                                                                                                    |
| **Authentication Error**                                                                                                                                               | FCM  | Verifica tus [credenciales FCM](./android-firebase-credentials), vuelve a subir el archivo de cuenta de servicio e inténtalo nuevamente.                                                     |
| **[DeviceTokenNotForTopic](https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/CommunicatingwithAPNs.html)** | APNs | El Bundle ID del token no coincide con tu clave APNs o certificado. Corrígelo en [token p8](./ios-p8-token-based-connection-to-apns) o [configuración p12](./ios-p12-generate-certificates). |
| **Expired Certificate**                                                                                                                                                | APNs | Tu certificado p12 ha expirado. Consulta [configuración de certificados](./ios-p12-generate-certificates).                                                                                   |
| **FcmV1InvalidToken / Not Found**                                                                                                                                      | FCM  | Token push inválido. Verifica las [credenciales Firebase](./android-firebase-credentials). Los dispositivos deben reabrir la app para actualizar tokens.                                     |
| **None / Missing**                                                                                                                                                     | FCM  | Es posible que Firebase Cloud Messaging API no esté habilitado en tu proyecto. Actívalo en la Consola de Firebase y reintenta.                                                               |
| **Permission Denied**                                                                                                                                                  | FCM  | Verifica el mensaje de error completo para saber qué permiso falta. [Actualiza el permiso para el archivo Service Account](./android-firebase-credentials) y vuelve a subirlo a OneSignal.   |
| **SenderIdMismatch**                                                                                                                                                   | FCM  | Desajuste de Sender ID de FCM v1. Verifica las [credenciales Firebase](./android-firebase-credentials). Los usuarios deben reabrir la app para tokens actualizados.                          |
| **[TopicDisallowed](https://developer.apple.com/documentation/usernotifications/handling-notification-responses-from-apns)**                                           | APNs | Desajuste de token APNs. Verifica tu Team ID, Key ID y Bundle ID en [configuración p8](./ios-p8-token-based-connection-to-apns).                                                             |

***

## Estado de entrega

| Estado                | Descripción                                                                                                      |
| --------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Entregado**         | El servicio push ha reportado la entrega del mensaje a los destinatarios.                                        |
| **Programado**        | El mensaje está programado para entrega futura.                                                                  |
| **Enviando**          | El mensaje se está enviando activamente.                                                                         |
| **En cola**           | El mensaje está esperando para ser enviado.                                                                      |
| **Cancelado**         | El mensaje fue cancelado manualmente. Consulta [Cancelar notificaciones push](./push#cancel-push-notifications). |
| **Sin Destinatarios** | Sin audiencia válida al momento del envío (ej., canceló suscripción o fuera del segmento).                       |
| **Fallido**           | OneSignal no pudo enviar el mensaje debido a errores.                                                            |

***

## Conversiones

<Info>
  **Próximamente** — Las [métricas de conversión](/docs/es/conversion-metrics) estarán disponibles en los informes de mensajes. Una vez disponibles, verás las conversiones atribuidas e influenciadas para cada mensaje directamente en su informe. Consulta [Métricas de conversión](/docs/es/conversion-metrics) para obtener detalles sobre el modelo de atribución e instrucciones de configuración.
</Info>

## Estadísticas de mensajes

El gráfico de estadísticas de mensajes rastrea clics, sesiones y [resultados personalizados](./custom-outcomes) (legado, siendo reemplazado por métricas de Conversión) durante los 30 días posteriores a un envío. Úsalo para ver si el engagement ocurrió inmediatamente después de la entrega o continuó con el tiempo.

<Frame caption="Gráfico de estadísticas de mensajes mostrando clics, sesiones y resultados personalizados a lo largo del tiempo.">
  <img src="https://mintcdn.com/onesignal/4HyuQPBpu-4xjmQC/images/docs/d3e4db9-Screenshot_2023-07-25_at_2.18.57_PM.png?fit=max&auto=format&n=4HyuQPBpu-4xjmQC&q=85&s=03607676051399984b2966a93216b3a7" alt="Gráfico de estadísticas de mensajes mostrando clics, sesiones y resultados personalizados durante un período de 30 días" width="1364" height="993" data-path="images/docs/d3e4db9-Screenshot_2023-07-25_at_2.18.57_PM.png" />
</Frame>

<Warning>
  Los mensajes enviados a través del API de OneSignal solo se retienen durante 30 días. Usa [Analíticas de Plantillas](./template-analytics) para rastrear el rendimiento a lo largo del tiempo, o [exporta tus datos](./exporting-data) para análisis offline.
</Warning>

***

## Actividad de audiencia

El reporte de **Actividad de audiencia** muestra cómo cada Suscripción interactuó con un mensaje específico. Los resultados se agrupan en categorías para que puedas diagnosticar problemas de entrega, medir engagement, identificar desuscripciones vinculadas a un mensaje específico y segmentar audiencias para retargeting o exportación.

<Frame caption="Pestañas y tabla de actividad de audiencia">
  <img src="https://mintcdn.com/onesignal/DAcDCtZEGr7EAIA1/images/push/push-reports-audience-activity.png?fit=max&auto=format&n=DAcDCtZEGr7EAIA1&q=85&s=6ca39ae71008717bc4606b0633369949" alt="Captura de pantalla de actividad de audiencia" width="2048" height="706" data-path="images/push/push-reports-audience-activity.png" />
</Frame>

<Tabs>
  <Tab title="Categorías">
    | Categoría               | Descripción                                              |
    | ----------------------- | -------------------------------------------------------- |
    | **Enviado**             | El mensaje fue enviado al dispositivo.                   |
    | **Entrega Confirmada**  | La entrega fue confirmada por el dispositivo.            |
    | **No Confirmó Entrega** | No se recibió confirmación de entrega.                   |
    | **Clicado**             | El usuario hizo clic en la notificación.                 |
    | **No Clicó**            | El usuario no hizo clic en la notificación.              |
    | **Fallido**             | La entrega falló.                                        |
    | **Desuscrito**          | La suscripción se canceló después de recibir el mensaje. |

    Cada pestaña muestra el número de destinatarios en esa categoría y te permite profundizar en los registros de suscripción individuales.
  </Tab>

  <Tab title="Columnas de tabla">
    | Columna                   | Descripción                                                                |
    | ------------------------- | -------------------------------------------------------------------------- |
    | **External ID**           | Tu identificador de sistema (si está establecido).                         |
    | **OneSignal ID**          | ID de usuario único de OneSignal.                                          |
    | **Subscription ID**       | Instancia de suscripción única (dispositivo + app/navegador).              |
    | **Dispositivo**           | Tipo de navegador o SO. Si ves `()`, el dispositivo fue eliminado.         |
    | **Estado de Suscripción** | Estado actual (por ejemplo, Subscribed, Unsubscribed).                     |
    | **Enviado**               | Hora en que se envió el mensaje.                                           |
    | **Entrega Confirmada**    | Hora en que la entrega fue confirmada por el dispositivo, o `-` si no.     |
    | **Clicado**               | Marca de tiempo si el usuario hizo clic, o `-` si no.                      |
    | **Fallido**               | Indica si la entrega falló.                                                |
    | **Desuscrito**            | Indica si el usuario canceló la suscripción después de recibir el mensaje. |
    | **Mensaje de fallo**      | Mensaje de error si la entrega falló (por ejemplo, "Invalid token").       |
  </Tab>
</Tabs>

<Warning>
  Los datos de actividad de audiencia solo están disponibles durante **30 días** desde el momento en que se envía el mensaje. Exporta los resultados si necesitas retenerlos por más tiempo.
</Warning>

### Retargeting de audiencias

Desde la vista de **Actividad de audiencia**, puedes enviar un **Mensaje Retargeted** directamente a cualquier categoría (por ejemplo, todos los usuarios que no hicieron clic).

Esto facilita hacer seguimiento con usuarios que no participaron, reenganchear a aquellos que abandonaron o reforzar el éxito con usuarios que confirmaron la entrega.

***

### Exportación de resultados

Puedes descargar datos de audiencia con el menú **Export**:

* **Selected activity** – exporta solo la pestaña vista actualmente (por ejemplo, todos los usuarios que fallaron en la entrega).
* **All activities** – exporta el reporte completo a través de cada categoría.

Las exportaciones te permiten analizar resultados sin conexión, compartir con otros equipos o fusionar con tus herramientas de CRM y analíticas.

<Card title="Exportar datos" icon="file-export" href="./exporting-data">
  Exporta datos de mensajes y usuarios a CSV para análisis offline.
</Card>

***

## Configuración del mensaje

El panel de configuración del mensaje muestra la configuración utilizada para el envío.

* **Audiencia** - Detalles de la audiencia incluyendo:
  * Número total de destinatarios - Cuántas Suscripciones recibieron el mensaje
  * Cómo se envió el mensaje: Filtros de orientación o segmentos usados
* **Programación** - Cuándo el mensaje comenzó a enviarse y opciones de entrega por usuario seleccionadas, si las hay.
* **Limitación** - Cualquier limitación, límites de frecuencia o anulaciones de canal
* **Mensaje** - El contenido del mensaje.
  * Plataformas orientadas (Android, iOS, navegadores específicos)
* **Configuración avanzada** - Como Prioridad, Tiempo de vida y Collapse ID.
* **Datos adicionales** - Cualquier dato personalizado agregado al mensaje.

***

## Preguntas frecuentes

### ¿Cuándo se actualizan los estados de suscripción push?

Los estados de suscripción push se actualizan mediante dos mecanismos:

**1. Cuando el usuario abre tu app o sitio**

El SDK de OneSignal verifica si el token push es válido y si los permisos de notificación siguen concedidos, luego actualiza el estado de suscripción inmediatamente.

Por ejemplo, si un usuario deshabilita las notificaciones push en la configuración de su dispositivo y luego reabre tu app, el SDK detecta el cambio y marca la suscripción como **Desuscrito** de inmediato.

Puedes capturar estos cambios con el Observador de Suscripción del SDK ([móvil](./mobile-sdk-reference#addobserver-push-subscription-changes) | [web](./web-sdk-reference#addeventlistener-push-subscription-changes)) para sincronizar el estado con tu propia base de datos.

**2. Cuando envías notificaciones push**

Si un usuario desinstala tu app, borra datos del navegador, o deshabilita push **y nunca regresa**, OneSignal no puede detectar el cambio hasta que envíes una notificación. El servicio push (FCM, APNs, HMS) reporta el token como inválido, y OneSignal marca la suscripción como **Desuscrito**.

Esta detección típicamente toma 2 o más mensajes:

| Envío      | Qué sucede                                                                                                                                               |
| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Mensaje 1  | Entregado al dispositivo. El usuario luego se desuscribe en la configuración del dispositivo o desinstala la app.                                        |
| Mensaje 2  | El servicio push acepta el mensaje pero el dispositivo no lo recibe. OneSignal reporta "Entregado" porque el servicio push aún no ha rechazado el token. |
| Mensaje 3  | El servicio push rechaza el token. OneSignal marca la suscripción como **Desuscrito**.                                                                   |
| Mensaje 4+ | OneSignal no intenta entregar a esta suscripción.                                                                                                        |

Usa [Event Streams](./event-streams) para detectar desuscripciones en tiempo real al enviar mensajes.

<Warning>
  Si pasas largos períodos sin enviar a todos los usuarios, las desuscripciones se acumulan silenciosamente y aparecen como un gran pico cuando reanudas el envío. Envía a todos los usuarios al menos una o dos veces al mes para detectar desuscripciones gradualmente. Consulta el [FAQ de tokens FCM expirados](./fcm-expired-token-faq) para más información sobre picos de desuscripción.

  Apple retrasa el reporte de desuscripciones 14+ días. Para proteger la privacidad del usuario, Apple no reporta inmediatamente desinstalaciones o revocaciones de permisos. Si un usuario abre tu app después de deshabilitar push, OneSignal detecta el cambio instantáneamente a través del SDK. Si el usuario nunca vuelve a abrir la app, puede tomar varias semanas para que Apple reporte el token inválido. Consulta el [Apple Forum](https://developer.apple.com/forums/thread/670868) y la [Technical Note](https://developer.apple.com/library/archive/technotes/tn2265/_index.html#//apple_ref/doc/uid/DTS40010376-CH1-TNTAG34) para más detalles.

  Usa el dashboard o la API para [eliminar suscripciones antiguas](./delete-users) y mantener tu audiencia limpia.
</Warning>

### ¿Por qué mis números de Entregados no coinciden con Entrega Confirmada?

Entregados refleja lo que reportó el servicio push (FCM, APNs) — aceptó el mensaje para entrega. Entrega Confirmada requiere que el SDK de OneSignal en el dispositivo reporte de vuelta, lo que solo ocurre si el dispositivo está en línea y la app procesa la notificación. Los dispositivos sin conexión, con la app cerrada forzadamente o sin el SDK aparecerán como Entregados pero no como Confirmados.

### ¿Por cuánto tiempo están disponibles los datos de actividad de audiencia?

Los datos de actividad de audiencia se retienen durante 30 días desde el momento en que se envía el mensaje. Exporta tus resultados antes de que cierre esta ventana si necesitas conservarlos por más tiempo.

***

## Páginas relacionadas

<Columns cols={2}>
  <Card title="Entrega Confirmada" icon="check-double" href="./confirmed-delivery">
    Cómo funciona la confirmación de entrega a nivel de dispositivo y qué afecta las tasas de confirmación.
  </Card>

  <Card title="Glosario de métricas" icon="book" href="./analytics-metrics-glossary">
    Definiciones de todas las métricas de entrega, engagement y conversión en todos los canales.
  </Card>

  <Card title="Analíticas de Plantillas" icon="chart-line" href="./template-analytics">
    Rastrea el rendimiento de notificaciones push a través de envíos usando plantillas.
  </Card>

  <Card title="Limitación de push" icon="gauge" href="./throttling">
    Controla la tasa de entrega para gestionar la carga del servidor durante envíos de alto volumen.
  </Card>
</Columns>
