Ana içeriğe atla
Resim içeren push bildirimleri gönderirken, OneSignal SDK OSNotification Payload’dan harici resim URL’lerini almaya çalışır ve bunu bildirim içinde görüntüler. Bu işlem sırasında uygulamanın kapalı olması önemli değildir. SDK, resmin indirilmesini bekler, ancak bu ~25 saniyeden fazla sürerse (Apple tarafından zorunlu kılınır), bildirim resim olmadan görüntülenir. OneSignal’in SDK’sı, indirme başarısız olursa resmi tekrar almayı denemez. Bu kılavuz, resimlerin gösterilmemesinin en yaygın nedenlerini ve bunların nasıl düzeltileceğini ele alacaktır. Resim spesifikasyonlarıyla ilgili ayrıntılar için Resimler & Zengin Medya bölümüne bakın.

Resim yapılandırması

Resmin düzgün yapılandırıldığından emin olmak için önce bu öğeleri kontrol edin.

Resim boyutu

Resim 5MB’dan küçük olmalıdır. Resim ne kadar küçükse, o kadar hızlı indirilir. Daha fazla ayrıntı Resimler & Zengin Medya bölümünde bulunabilir.

Resim URL’si

  • Resim URL’lerinin resim kaynağına doğrudan bir bağlantı olması gerekir. Yönlendirme olmamalı ve resmi gösteren ancak gerçek resim kaynağı olmayan sayfalara bağlantı olmamalıdır.
    • Bu genellikle resim URL’sinin https:// ile başladığı ve .png veya .jpg gibi bir dosya uzantısıyla bittiği anlamına gelir.
Örnek:
  • Bu çalışmayacaktır: https://pixabay.com/en/architecture-travel-sky-building-3095716/
  • Ancak resme sağ tıklayıp yeni bir sekmede açarsanız, bu çalışacaktır: https://cdn.pixabay.com/photo/2018/01/21/01/46/architecture-3095716_960_720.jpg

Resim barındırıcısı

Resmi OneSignal’e yüklediyseniz, sunucularımızda yaklaşık 33 gün boyunca barındırılacaktır. Resme daha uzun süre ihtiyacınız varsa, şablonlar kullanabilir veya resmi kendi sunucularınızda saklayabilir ve şablonda kaynak URL’sine doğrudan referans verebilirsiniz. Resmi kendi sunucunuzda barındırıyorsanız, sunucunun indirme miktarını kaldırabildiğinden emin olmanız gerekir. Bildirimi alan her cihazın resmi indirmesi gerekecektir. Cihazın resimler dahil tüm bildirim kaynaklarını indirmek için yaklaşık 30 saniyesi vardır. Daha uzun sürerse, o cihazda gösterilmeyecektir.

Cihaz yapılandırması

Cihazdaki internet bağlantısını kontrol edin. Kararsız ağ bağlantıları resmin gösterilmemesine neden olabilir.
  • Farklı WiFi ağlarında test edin.
  • Farklı hücresel ağlarda test edin.
  • Farklı cihazlarda test edin.

Platform yapılandırması

Resmi almayan platforma göre aşağıdaki bölümleri kontrol edin.

Web push resimleri

  • Yalnızca Chrome, Windows ve Android’de push bildirimlerinde büyük resimleri destekler.
    • macOS için Chrome büyük resimleri desteklemez.
  • Firefox, Safari ve Edge büyük resimleri desteklemez.
  • Android’de, bildirimi aldığınızda, resmi görmek için bildirimi genişletmeniz gerekir.
Mobil tarayıcı uygulamanızda çok sayıda okunmamış push bildirimi ve/veya açık sekme varsa, bu bildirimlerin gösterilmemesine neden olabilir.

Android push resimleri

Android bildirim merkezinde bildirimi aldığınızda, resmi görmek için bildirimi genişletmeniz gerekir. Android, push bildirimlerinde resim almak için ek yapılandırma gerektirmez.

iOS push resimleri

iOS bildirimleri, Notification Service Extension’ın doğru şekilde kurulmasını gerektirir. Notification Service Extension kurulumu, kullandığınız SDK sürümü için Mobil SDK kurulum kılavuzlarımızda ele alınmaktadır. Resim URL’leriniz HTTP ise ve bir HTTP URL’si kullanarak bunları kendiniz barındırmakta ısrar ediyorsanız, Xcode .plist’inizde NSAppTransportSecurity’yi NSAllowsArbitraryLoads olarak ayarlamanız gerekecektir.
Apple, uygulamanızı App Store’a yayınlarken NSAllowsArbitraryLoads etkinse uygulamanızı reddedebilir, çünkü bu bir güvenlik açığı oluşturabilir. Daha fazla bilgi için lütfen Apple’ın Security Overview belgesini okuyun.

Teknik sorun giderme

Yukarıdaki öğeleri kontrol ettiyseniz ve resim yine de gösterilmiyorsa, resim indirmeyle ilgili belirli hataları kontrol etmek için SDK’mızın setLogLevel yöntemini VERBOSE günlüğü ile kullanın. Günlük oluşturma hakkında ayrıntılı bir kılavuz için Debug Günlüğü Yakalama kılavuzumuza bakın. Yaygın hatalar şunları içerir:
  • Could not download image!
  • Encountered an error while attempting to download file with URL:
  • OneSignal encountered an exception while downloading file

iOS Notification Service Extension Sorun Giderme

iOS’ta resimler gösterilmiyorsa, lütfen iOS Notification Service Extension Sorun Giderme kılavuzumuzu takip edin. Bu kılavuz, Notification Service Extension kurulumunuzu gözden geçirmenize ve sorunları belirlemenize yardımcı olacaktır.