Descripción general
Entrega confirmada rastrea cuándo un dispositivo realmente recibe una notificación push enviada a través de OneSignal. En su panel de OneSignal, esto aparece en el Informe de mensajes como Confirmed (o Received).
Flujo de entregas confirmadas
- iOS y Safari: Apple Push Notification Service (APNs)
- Android y Chrome: Google Firebase Cloud Messaging (FCM)
- Dispositivos Huawei: Huawei Messaging Service (HMS)
- Dispositivos Amazon: Amazon Device Messaging (ADM)
- Dispositivos Windows: Microsoft Push Notification Service (MPNS)
- El ID de la notificación
- El ID de suscripción del dispositivo
Requisitos
- Disponible solo en planes pagos. Comparar planes.
- Complete la configuración del SDK móvil, incluyendo:
- Extensión de servicio de notificación de iOS
- Configuración del grupo de aplicaciones
- La entrega confirmada solo funciona si el dispositivo tiene instalado el SDK de OneSignal.
- No compatible para suscripciones creadas solo a través de API.
Limitaciones específicas de la plataforma
iOS
- Requiere tanto la configuración de Notification Service Extension como del App Group.
- APNs mantiene solo un mensaje por aplicación cuando está fuera de línea. Si se envían múltiples pushes mientras está fuera de línea, solo se entrega el último.
Huawei
- Compatible solo para el
datatipo de mensaje de Huawei. - Para el tipo
message, Huawei proporciona datos de recibo solo en su propio panel.
Web
- Safari no admite entrega confirmada.
Preguntas frecuentes
¿Por qué mis números de entrega confirmada son bajos o faltan?
Causas comunes:- Muchos dispositivos inactivos o abandonados. Consulte Manejo de dispositivos inactivos.
- Limitaciones de la plataforma (Huawei, Safari).
- Problemas de configuración, especialmente comunes con iOS. Consulte Solución de problemas de entrega confirmada.
- Los dispositivos Android pueden forzar el cierre de su aplicación, deteniendo los eventos del SDK. Algunos fabricantes de dispositivos tratan deslizar la aplicación como un cierre forzado. Consulte Guía de push móvil no mostrado.
Manejo de dispositivos inactivos
Los dispositivos que están fuera de línea no recibirán notificaciones push ni enviarán eventos de entrega confirmada. Esto es común cuando los usuarios reemplazan o abandonan dispositivos. Consejos para reactivar usuarios inactivos:- Use Audience Activity para reenviar a usuarios que no confirmaron entrega.
- Cree segmentos basados en Last Session (por ejemplo, inactivos por más de 90 días).
- Combine con un Journey de reenganche para recuperarlos.
- Diríjase periódicamente a usuarios inactivos para eliminar dispositivos inalcanzables.
Consulte ¿Cuándo se actualizan los estados de suscripción push? para más detalles.
¿Por qué muestra Confirmada pero no aparece en mi dispositivo?
Un evento de entrega confirmada significa que el dispositivo recibió el push. En raras ocasiones, el dispositivo puede no mostrarlo. Verifique:- Es posible que lo haya perdido. Intente enviarse un push de prueba para ver si aparece.
- Modo de enfoque en iOS: Los pushes se retrasan o se agrupan de manera diferente cuando “No molestar”, “Dormir” u otros modos de enfoque están activos. Descartar notificaciones agrupadas puede hacer que lo pierda.
- Código de aplicación personalizado que suprime la visualización:
event.preventDefault()en el oyente del ciclo de vida en primer plano o Notification Service Extension- APIs de notificación que eliminan mensajes:
- Configuración de carga útil de push:
- Asegúrese de que
priorityesté configurado en alto. Consulte Prioridad de push. - Tenga cuidado con
collapse_id: reemplaza pushes antiguos con nuevos usando el mismo ID.
- Asegúrese de que
- Dispositivo incorrecto objetivo: Use Encontrar y establecer suscripciones de prueba para confirmar.
Solución de problemas de entrega confirmada
General
- Dispositivo fuera de línea: Los pushes pueden retrasarse hasta 3 días (predeterminado). Ajuste con Time To Live.
- Red inestable: La notificación puede recibirse pero la confirmación falla si la aplicación falla o no tiene red. Esto es raro.
iOS
Problema más común: Notification Service Extension o App Groups mal configurados. Lista de verificación:- Agregue el objetivo
OneSignalNotificationServiceExtensionen Xcode. - Verifique dos veces los pasos 3–6 en la configuración del SDK de iOS. Asegúrese de usar el mismo nombre de App Group para la aplicación y la extensión:
- ✅
group.your-main-app-target-bundle-id.onesignal - ❌
group.your-bundle-id.OneSignalNotificationServiceExtension.onesignal - Si usa su propio nombre de App Group, debe actualizar sus archivos
Info.plisttanto para la aplicación principal como para la Notification Service Extension para indicarle a nuestro SDK qué App Group usar.
- ✅
- Asegúrese de que
mutable-content: 1esté presente en la carga útil (se establece automáticamente a menos que se anule).
Android
- Si las notificaciones no se muestran: consulte Solución de problemas de push móvil.
- Si las notificaciones se muestran pero falta la entrega confirmada: una extensión de servicio de Android personalizada puede estar bloqueándola. Consulte nuestra guía de Android Service Extension.
Web
- Safari no es compatible.
- Para otros navegadores, asegúrese de que la migración al SDK v16 esté completa:
- Inicialización correcta del SDK:
- Referencia correcta del Service Worker:
- Inicialización correcta del SDK:
¿Necesita ayuda?Chatee con nuestro equipo de Soporte o envíe un correo electrónico a
support@onesignal.comPor favor incluya:- Detalles del problema que está experimentando y pasos para reproducir si están disponibles
- Su ID de aplicación de OneSignal
- El ID externo o ID de suscripción si corresponde
- La URL del mensaje que probó en el panel de OneSignal si corresponde
- Cualquier registro o mensaje de error relevante