Saltar al contenido principal
Esta guía explica cómo mejorar las notificaciones push móviles usando imágenes y medios enriquecidos, incluyendo soporte de plataforma, limitaciones técnicas y opciones de personalización en OneSignal. Guías de imágenes para otros canales:

Imágenes de app móvil

Puedes agregar imágenes a notificaciones push a través del Dashboard de OneSignal o API. Hay dos tipos principales:

Iconos de notificación

  • iOS: Usa automáticamente el icono de la app.
  • Android: Permite iconos grandes y pequeños personalizados.
  • Consulta Iconos de notificación para instrucciones de configuración.

Imagen Big Picture (formato grande)

  • Android: Se muestra expandida por defecto en la mayoría de dispositivos.
  • iOS: Requiere que el usuario deslice hacia abajo o mantenga presionado.
Para agregar imágenes:
  • En Dashboard: Messages > New Push > “Upload” al campo de imagen
  • O usa parámetros API: big_picture (Android) y ios_attachments (iOS)

Agrega imágenes en el Dashboard de OneSignal a través del campo 'Image'.


Especificaciones de imagen

Usa imágenes orientadas al paisaje con una relación de aspecto 2:1.
iOSAndroid
Tipos de archivojpg, jpeg, png, gifjpg, jpeg, png, gif*
ResoluciónRelación de aspecto 1:1 o 2:1 (ej., 1038x1038px o 1024×512px)
Ancho Máx: 2000px
Ancho Mín: 300px
Relación de aspecto 2:1 (ej., 1024×512px)
Ancho Máx: 2000px
Ancho Mín: 300px
Parámetro APIios_attachmentsbig_picture
OneSignal aplica un límite de carga de 5MB y no soporta cargas de audio o video. Las imágenes alojadas expiran después de 33 días. Para uso a largo plazo, carga a tu propia URL estática o usa Plantillas.

Personalización de notificaciones enriquecidas

OneSignal soporta personalización visual e interactiva más profunda usando funciones nativas de plataforma.

Diseño de notificación personalizado Android

Android 12+ aplica plantillas del sistema para notificaciones personalizadas. Sin embargo, aún puedes personalizar tu diseño usando estilos de notificación estándar de Android. Consulta cambios de comportamiento para detalles. Para personalizar tu diseño:

Extensiones de contenido iOS

iOS usa UNNotificationContentExtension para habilitar medios enriquecidos e interactividad en notificaciones. Funciones soportadas:
  • Carruseles de imágenes
  • Reproducción de video incorporado
  • Vistas personalizadas como calendarios o vistas previas de chat
Consulta nuestra Guía de Carrusel iOS para instrucciones de configuración.

Adjuntos multimedia soportados

Los medios enriquecidos se pueden agregar a través de URLs a contenido alojado externamente. Esto funciona con UNNotificationContentExtension en iOS.
  • Asegúrate de que tus URLs sean enlaces directos al archivo y terminen en la extensión correcta. Si no, agrega una consulta (ej., ?file=video.mp4) para que el SDK pueda detectar el tipo de medio.
  • OneSignal tiene un límite de 5MB en imágenes cargadas. El video y audio deben estar alojados externamente. Enlaza directamente al archivo multimedia, no a una página web.
AdjuntoTipo de ArchivoTamaño MáxRequisitos
Audioaif, aiff, wav, mp35MBNinguno
Videomp4, mpeg, mpeg2, mpeg4, avi50MBUNNotificationContentExtension
Imagenjpg, jpeg, png, gif10MBOneSignalNotificationServiceExtension
La OneSignalNotificationServiceExtension está incluida en el SDK de OneSignal y es requerida para soporte de imágenes, rastreo de entrega y actualizaciones de insignia.

Consejos de prueba

Asegúrate de que tus medios se muestren correctamente en todos los dispositivos:
  • Siempre prueba en dispositivos reales (no emuladores).
  • iOS requiere mantener presionado o deslizar hacia abajo para revelar medios enriquecidos.
  • La renderización Android varía según el dispositivo, versión del SO y presencia de botones de acción.
  • Usa el botón “Send Test” en OneSignal antes de lanzar una campaña.

Casos de uso de ejemplo

  • Mostrar una foto de producto en un recordatorio de carrito abandonado
  • Promover un nuevo tráiler de película con una vista previa de video (solo iOS)
  • Enviar un banner animado para una venta flash

Solución de problemas

Si tus imágenes no aparecen como se esperaba, consulta la guía Imágenes de Notificación No Se Muestran para causas y soluciones comunes.