Saltar al contenido principal
Al enviar notificaciones push que incluyen imágenes, el SDK de OneSignal intenta obtener las URLs de imágenes externas del OSNotification Payload y mostrarla dentro de la notificación. No importa si la app está cerrada durante este proceso. El SDK espera a que la imagen se descargue, pero si toma más de ~25 segundos (aplicado por Apple), la notificación se muestra sin la imagen. El SDK de OneSignal no reintenta obtener la imagen nuevamente si falla la descarga. Esta guía cubrirá las razones más comunes por las que las imágenes no se muestran y cómo solucionarlas. Para detalles sobre especificaciones de imágenes, consulta Images & Rich Media.

​
Configuración de imagen

Verifica estos elementos primero para asegurarte de que la imagen esté configurada correctamente.

​
Tamaño de imagen

La imagen debe tener menos de 5MB de tamaño. Cuanto más pequeña sea la imagen, más rápido se descargará. Más detalles en Images & Rich Media.

​
URL de imagen

  • Las URLs de imagen necesitan un enlace directo al recurso de imagen. Sin redirecciones y sin enlaces a páginas que muestran la imagen pero no el recurso de imagen real.
    • Usualmente esto significa que la URL de imagen comienza con https:// y termina con una extensión de archivo como .png o .jpg.
Ejemplo:
  • Esto no funcionará: https://pixabay.com/en/architecture-travel-sky-building-3095716/
  • Pero si haces clic derecho en la imagen y la abres en una pestaña nueva, esto funcionará: https://cdn.pixabay.com/photo/2018/01/21/01/46/architecture-3095716_960_720.jpg

​
Host de imagen

Si subiste la imagen a OneSignal, se alojará en nuestros servidores por ~33 días. Si necesitas la imagen por más tiempo, puedes usar plantillas o almacenar la imagen en tus propios servidores y hacer referencia a la URL del recurso directamente en la plantilla. Si estás alojando la imagen por tu cuenta, necesitas asegurarte de que el servidor pueda manejar la cantidad de descargas. Cada dispositivo que recibe la notificación necesitará descargar la imagen. Alrededor de 30 segundos es el tiempo que tiene el dispositivo para descargar todos los recursos de notificación, incluidas las imágenes. Si toma más tiempo, no se mostrará en ese dispositivo.

​
Configuración del dispositivo

Verifica la conexión a internet del dispositivo. Las conexiones de red inestables pueden causar que la imagen no se muestre.
  • Prueba en diferentes redes WiFi.
  • Prueba en diferentes redes celulares.
  • Prueba en diferentes dispositivos.

​
Configuración de plataforma

Verifica las secciones a continuación según la plataforma que no está recibiendo la imagen.

​
Imágenes de web push

  • Solo Chrome soporta imágenes grandes en notificaciones push en Windows y Android.
    • Chrome para macOS no soporta imágenes grandes.
  • Firefox, Safari y Edge no soportan imágenes grandes.
  • En Android, cuando recibes la notificación, necesitarás tocar la notificación para expandirla y ver la imagen.
Si tu app de navegador móvil tiene muchas notificaciones push no leídas y/o muchas pestañas abiertas, esto puede causar que las notificaciones no se muestren.

​
Imágenes de push Android

Cuando recibes la notificación en el centro de notificaciones de Android, necesitarás expandir la notificación para ver la imagen. Android no requiere ninguna configuración adicional para recibir imágenes en notificaciones push.

​
Imágenes de push iOS

Las notificaciones iOS requieren que la Notification Service Extension esté configurada correctamente. La configuración de Notification Service Extension se cubre en nuestras guías de Mobile SDK setup para la versión de nuestro SDK que estés usando. Si tus URLs de imagen son HTTP y insistes en alojarlas tú mismo usando una URL HTTP, necesitarás establecer NSAppTransportSecurity a NSAllowsArbitraryLoads en tu .plist de Xcode.
Apple puede rechazar tu app si NSAllowsArbitraryLoads está habilitado al lanzar tu app a la App Store, ya que esto puede crear una vulnerabilidad de seguridad. Para más información, por favor lee el Security Overview de Apple.

​
Solución de problemas técnicos

Si verificaste los elementos anteriores y la imagen aún no se muestra, usa el método setLogLevel de nuestro SDK con registro VERBOSE para verificar errores específicos relacionados con la descarga de imágenes. Para una guía detallada sobre cómo generar registros, consulta nuestra guía Capturing a Debug Log. Los errores comunes incluyen:
  • Could not download image!
  • Encountered an error while attempting to download file with URL:
  • OneSignal encountered an exception while downloading file

​
Solución de problemas de iOS Notification Service Extension

Si las imágenes no se muestran en iOS, por favor sigue nuestra guía Troubleshooting the iOS Notification Service Extension. Esta guía te ayudará a revisar tu configuración de Notification Service Extension e identificar cualquier problema.