Ana içeriğe atla
Bu kılavuz, OneSignal’de platform desteği, teknik sınırlamalar ve özelleştirme seçenekleri dahil olmak üzere resimler ve zengin medya kullanarak mobil push bildirimlerini nasıl geliştireceğinizi açıklar. Diğer kanallar için resim kılavuzları:

Web Push

Web push bildirimlerine resimler ekleyin.

In-App Messages

Uygulama içi mesajlara resimler ekleyin.

Email

E-postalara resimler ekleyin.

SMS

MMS mesajları oluşturmak için resimler ekleyin.

​
Mobil uygulama resimleri

OneSignal Dashboard veya API aracılığıyla push bildirimlerine resimler ekleyebilirsiniz. İki ana tür vardır:

​
Bildirim simgeleri

  • iOS: Uygulama simgesini otomatik olarak kullanır.
  • Android: Özel büyük ve küçük simgelere izin verir.
  • Kurulum talimatları için Notification icons’a bakın.

​
Büyük Resim (geniş format)

  • Android: Çoğu cihazda varsayılan olarak genişletilmiş şekilde gösterir.
  • iOS: Kullanıcının aşağı kaydırması veya uzun basması gerekir.
Resim eklemek için:
  • Dashboard’da: Messages > New Push > Resim alanına “Upload”
  • Veya API parametrelerini kullanın: big_picture (Android) ve ios_attachments (iOS)

OneSignal Dashboard'da 'Image' alanı aracılığıyla resimler ekleyin.

​
Resim özellikleri

2:1 en boy oranına sahip yatay yönelimli resimler kullanın.
iOSAndroid
Dosya türlerijpg, jpeg, png, gifjpg, jpeg, png, gif*
Çözünürlük1:1 en boy oranı veya 2:1 en boy oranı (örneğin, 1038x1038px veya 1024×512px)
Maks Genişlik: 2000px
Min Genişlik: 300px		2:1 en boy oranı (örneğin, 1024×512px)
Maks Genişlik: 2000px
Min Genişlik: 300px
API Parametresiios_attachmentsbig_picture
OneSignal, 5MB yükleme sınırı uygular ve ses veya video yüklemelerini desteklemez. Barındırılan resimlerin süresi 33 gün sonra dolar. Uzun süreli kullanım için kendi statik URL’nize yükleyin veya Şablonlar kullanın.

​
Zengin bildirim özelleştirme

OneSignal, yerel platform özelliklerini kullanarak daha derin görsel ve etkileşimli özelleştirmeyi destekler.

​
Android özel bildirim düzeni

Android 12+ özel bildirimler için sistem şablonlarını zorunlu kılar. Ancak, Android’in standart bildirim stillerini kullanarak düzeninizi özelleştirebilirsiniz. Ayrıntılar için davranış değişikliklerine bakın. Düzeninizi özelleştirmek için:

​
iOS içerik uzantıları

iOS, bildirimlerde zengin medya ve etkileşimi etkinleştirmek için UNNotificationContentExtension kullanır. Desteklenen özellikler:
  • Resim karuselleri
  • Gömülü video oynatma
  • Takvimler veya sohbet önizlemeleri gibi özel görünümler
Kurulum talimatları için iOS Carousel Guide’a bakın.

​
Desteklenen medya ekleri

Zengin medya, harici olarak barındırılan içeriğe URL’ler aracılığıyla eklenebilir. Bu, iOS’ta UNNotificationContentExtension ile çalışır.
  • URL’lerinizin dosyaya doğrudan bağlantılar olduğundan ve doğru uzantıyla bittiğinden emin olun. Değilse, SDK’nın medya türünü algılayabilmesi için bir sorgu ekleyin (örneğin, ?file=video.mp4).
  • OneSignal, yüklenen resimlerde 5MB sınırına sahiptir. Video ve ses harici olarak barındırılmalıdır. Bir web sayfasına değil, doğrudan medya dosyasına bağlantı verin.
EkDosya TürüMaks BoyutGereksinimler
Sesaif, aiff, wav, mp35MBYok
Videomp4, mpeg, mpeg2, mpeg4, avi50MBUNNotificationContentExtension
Resimjpg, jpeg, png, gif10MBOneSignalNotificationServiceExtension
OneSignalNotificationServiceExtension, OneSignal SDK’ya dahildir ve resim desteği, teslimat takibi ve rozet güncellemeleri için gereklidir.

​
Test ipuçları

Medyanızın cihazlar arasında doğru şekilde görüntülendiğinden emin olun:
  • Her zaman gerçek cihazlarda test edin (emülatörlerde değil).
  • iOS, zengin medyayı ortaya çıkarmak için uzun basma veya aşağı kaydırma gerektirir.
  • Android renderleme, cihaza, işletim sistemi sürümüne ve eylem düğmelerinin varlığına göre değişir.
  • Bir kampanya başlatmadan önce OneSignal’de “Send Test” düğmesini kullanın.

​
Örnek kullanım durumları

  • Terk edilmiş sepet hatırlatıcısında bir ürün fotoğrafı gösterin
  • Video önizlemeli yeni bir film fragmanını tanıtın (yalnızca iOS)
  • Hızlı satış için animasyonlu bir banner gönderin

​
Sorun giderme

Resimleriniz beklendiği gibi görünmüyorsa, yaygın nedenler ve düzeltmeler için Notification Images Not Showing kılavuzuna bakın.