Pular para o conteúdo principal
Ao enviar notificações push que incluem imagens, o SDK do OneSignal tenta obter as URLs de imagem externas do Payload de OSNotification e exibi-las dentro da notificação. Não importa se o aplicativo está fechado durante esse processo. O SDK aguarda o download da imagem, mas se demorar mais de ~25 segundos (imposto pela Apple), a notificação é exibida sem a imagem. O SDK do OneSignal não tenta obter a imagem novamente se falhar no download. Este guia cobrirá os motivos mais comuns para imagens não aparecerem e como corrigi-los. Para detalhes sobre especificações de imagem, consulte Imagens e Rich Media.

​
Configuração de imagem

Verifique estes itens primeiro para garantir que a imagem esteja configurada corretamente.

​
Tamanho da imagem

A imagem deve ter menos de 5MB de tamanho. Quanto menor a imagem, mais rápido ela será baixada. Mais detalhes encontrados em Imagens e Rich Media.

​
URL da imagem

  • As URLs de imagem precisam de um link direto para o recurso de imagem. Sem redirecionamentos e sem links para páginas que mostram a imagem, mas não o recurso de imagem real.
    • Geralmente isso significa que a URL da imagem começa com https:// e termina com uma extensão de arquivo como .png ou .jpg.
Exemplo:
  • Isso não funcionará: https://pixabay.com/en/architecture-travel-sky-building-3095716/
  • Mas se você clicar com o botão direito na imagem e abrir em uma nova aba, isso funcionará: https://cdn.pixabay.com/photo/2018/01/21/01/46/architecture-3095716_960_720.jpg

​
Host da imagem

Se você fez upload da imagem para o OneSignal, ela será hospedada em nossos servidores por ~33 dias. Se você precisar da imagem por mais tempo, pode usar templates ou armazenar a imagem em seus próprios servidores e referenciar a URL do recurso diretamente no template. Se você está hospedando a imagem por conta própria, precisa garantir que o servidor seja capaz de lidar com a quantidade de downloads. Cada dispositivo que recebe a notificação precisará baixar a imagem. Cerca de 30 segundos é quanto tempo o dispositivo tem para baixar todos os recursos de notificação, incluindo imagens. Se demorar mais, ela não será exibida naquele dispositivo.

​
Configuração do dispositivo

Verifique a conexão com a internet no dispositivo. Conexões de rede instáveis podem fazer com que a imagem não apareça.
  • Teste em diferentes redes WiFi.
  • Teste em diferentes redes celulares.
  • Teste em diferentes dispositivos.

​
Configuração da plataforma

Verifique as seções abaixo com base na plataforma que não está recebendo a imagem.

​
Imagens de push web

  • Apenas o Chrome suporta imagens grandes em notificações push no Windows e Android.
    • O Chrome para macOS não suporta imagens grandes.
  • Firefox, Safari e Edge não suportam imagens grandes.
  • No Android, quando você recebe a notificação, precisará tocar na notificação para expandi-la e ver a imagem.
Se o aplicativo do seu navegador móvel tiver muitas notificações push não lidas e/ou muitas abas abertas, isso pode fazer com que as notificações não apareçam.

​
Imagens de push Android

Quando você recebe a notificação no centro de notificações do Android, precisará expandir a notificação para ver a imagem. O Android não requer nenhuma configuração adicional para receber imagens em notificações push.

​
Imagens de push iOS

As notificações iOS requerem que a Extensão de Serviço de Notificação esteja configurada corretamente. A configuração da Extensão de Serviço de Notificação é coberta em nossos guias de Configuração do SDK Móvel para a versão do nosso SDK que você está usando. Se suas URLs de imagem são HTTP e você insiste em hospedá-las você mesmo usando uma URL HTTP, você precisará definir NSAppTransportSecurity como NSAllowsArbitraryLoads no seu .plist do Xcode.
A Apple pode rejeitar seu aplicativo se NSAllowsArbitraryLoads estiver habilitado ao lançar seu aplicativo na App Store, pois isso pode criar uma vulnerabilidade de segurança. Para mais informações, leia a Visão Geral de Segurança da Apple.

​
Solução de problemas técnicos

Se você verificou os itens acima e a imagem ainda falha em ser exibida, use o método setLogLevel do nosso SDK com log VERBOSE para verificar erros específicos relacionados ao download de imagens. Para um guia detalhado sobre geração de logs, consulte nosso guia Capturando um Log de Depuração. Erros comuns incluem:
  • Could not download image!
  • Encountered an error while attempting to download file with URL:
  • OneSignal encountered an exception while downloading file

​
Solução de problemas da Extensão de Serviço de Notificação iOS

Se as imagens não estiverem aparecendo no iOS, siga nosso guia Solução de Problemas da Extensão de Serviço de Notificação iOS. Este guia ajudará a revisar sua configuração da Extensão de Serviço de Notificação e identificar quaisquer problemas.