Eventos y analítica
Qué reporta la app para medir recepción, aperturas y clics.
Google y Apple solo informan si aceptaron el mensaje. Para saber si llegó, si se abrió o si se tocó un botón, la app lo reporta a POST /v1/events, con la llave pública.
{ "type": "opened", "token": "TOKEN_DEL_DISPOSITIVO", "notificationId": "01JC…" }El notificationId es el _phid que viene en los datos de cada notificación.
Tipos
| Tipo | Cuándo | Campos extra |
|---|---|---|
received |
La app recibió la notificación (útil con la app abierta o en la extensión iOS) | notificationId |
opened |
El usuario tocó la notificación | notificationId |
clicked |
El usuario tocó un botón | notificationId, actionId (id del botón) |
dismissed |
El usuario la descartó (Android) | notificationId |
permission_granted / permission_denied |
Cambió el permiso de notificaciones | — |
occurredAt (ISO 8601 o epoch) permite reportar eventos de hasta 7 días atrás, por ejemplo si la app estaba sin conexión.
Lotes
Envía hasta 100 eventos en {"events": [ … ]}. La respuesta es 202 e indica, por evento, si se aceptó o el motivo del rechazo:
| Motivo | Qué significa |
|---|---|
device_not_found |
El token no está registrado en esa app |
not_a_recipient |
Esa notificación no se le envió a ese dispositivo |
rate_limited |
Más de 60 eventos por minuto del mismo dispositivo |
invalid_type, notification_required, invalid_action, occurred_at_out_of_range… |
Error en los datos del evento |
Los repetidos (mismo dispositivo, notificación, tipo y botón) se descartan sin error, así que puedes reintentar con tranquilidad.
Dónde se ve
En Analítica del panel: embudo, tasas, por plataforma, idioma y versión de la app, por hora y por botón. También en GET /v1/notifications/{id}.