Ana içeriğe atla
Push bildirim simgeleri, bildirimlerinizin yanında görünen küçük resimlerdir. Kullanıcıların markanızı hızlıca tanımasına, bağlamı anlamasına ve mesajlarınızı diğerlerinden ayırt etmesine yardımcı olurlar. Her platform simgeleri farklı şekilde işler, bu nedenle bildirimlerin doğru görüntülenmesini sağlamak için platforma özgü standartları takip etmek kritik öneme sahiptir. Bu kılavuz push bildirim simgelerini kapsar. Büyük resimler arıyorsanız, Görseller ve Zengin Medya bölümüne bakın.

​
Push bildirim simgeleri için en iyi uygulamalar

  • Mümkün olduğunca şeffaflık içeren PNG görüntüler kullanın.
  • Simgeleri çok küçük boyutlarda basit ve tanınabilir tutun.
  • Okunamaz hale gelebilecek metin veya ince detaylardan kaçının.
  • Boyut, renk ve şeffaflık için platforma özgü kurallara uyun.
  • Bildirimleri platformlar ve işletim sistemi sürümleri genelinde gerçek cihazlarda test edin.

​
Web bildirim simgeleri

Web push bildirimleri, gönderim sırasında sağlanan veya site ayarlarınızda varsayılan olarak tanımlanan bir simge görüntüler.
  • Desteklenen formatlar: PNG, JPG, GIF (animasyonsuz)
  • Simge kare olmalıdır. Önerilen boyut 256x256 pikseldir.
Farklı tarayıcılar (Chrome, Edge, Safari, Firefox) cihaz ve işletim sistemine bağlı olarak simgeleri farklı şekilde kırpabilir veya ölçeklendirebilir. Tüm tarayıcılarda tutarlı görüntüleme sağlamak için kare 256x256 simge önerilir.
Varsayılan simgeyi Dashboard Ayarları > Push & In-App > Web Ayarları bölümünden ayarlayın. Dashboard veya REST API’yi kullanarak bildirim başına simgeyi geçersiz kılabilirsiniz. Ayrıntılar için Varsayılan olmayan simgelerle bildirim gönderme bölümüne bakın.

​
Android web push rozet simgesi

Android cihazlarda, Web Push bildirimleri Web App Manifest badge özelliği tarafından tanımlanan daha küçük bir rozet simgesi görüntüleyebilir. Rozet simgesi sınırlı kullanıcı arayüzü bağlamlarında (Android durum çubuğu gibi) kullanılır ve tüm Android cihazlarda görünmeyebilir. Rozet simgeleri Android uygulama küçük bildirim simgeleri gibi aynı katı yalnızca alfa kurallarına tabi olmasa da, yine de sistem kontrollü kullanıcı arayüzünde işlenir. En iyi uygulamalar:
  • Şeffaf arka plana sahip kare PNG kullanın
  • Tasarımı basit ve yüksek kontrastlı tutun
  • Metin veya ince detaylardan kaçının
  • En iyi tutarlılık için tek renkli veya minimal renk kullanın
Minimum 72×72 piksel boyutu önerilir. Daha büyük görseller kabul edilebilir ve gerektiğinde küçültülür.
Android uygulama küçük bildirim simgelerinden farklı olarak, Web Push rozet simgeleri bazı cihazlarda rengi koruyabilir. Ancak, tam renkli veya karmaşık simgeler Android sürümüne, tarayıcıya ve cihaz üreticisine bağlı olarak tutarsız şekilde işlenebilir.
Ayrıntılar için Varsayılan olmayan simgelerle bildirim gönderme bölümüne bakın.

​
iOS bildirim simgeleri

iOS bildirimleri her zaman uygulama simgenizi kullanır.
  • Bildirim simgesi, uygulamanızın simge varlığından otomatik olarak türetilir
  • Bildirim simgesini mesaj başına değiştiremezsiniz
  • Simgeyi değiştirmek, uygulama simgenizi güncellemenizi ve yeni bir uygulama sürümü yayınlamanızı gerektirir
iOS’ta özel bir bildirim simgesi belirtmenize izin veren bir APNs yük alanı yoktur.Bu davranış iOS tarafından uygulanır ve standart push bildirimleri, Kritik Uyarılar ve Canlı Etkinlikler için geçerlidir.

​
İletişim Bildirimleri

iOS 15 ve daha yenisinde, Apple İletişim Bildirimleri’ni destekler. Doğru şekilde uygulandığında, iletişim tarzı bildirimler (mesajlaşma veya arama uygulamaları gibi) desteklenen sistem görünümlerinde uygulama simgesi yerine bir kişi veya gönderen görseli görüntüleyebilir.
İletişim Bildirimleri belirli kullanım durumlarıyla sınırlıdır ve Apple’ın iletişim bildirimi API’lerinin açıkça benimsenmesini gerektirir. Genel amaçlı bildirimler için kullanılamazlar.

​
Android bildirim simgeleri

Android (Amazon ve Huawei cihazları dahil) Küçük ve Büyük bildirim simgelerini destekler. Android ayrıca simgeyi kullanıcının profil resmine değiştirmenize olanak tanıyan Konuşma Bildirimleri’ni destekler.
Android 8.0+ (API 26+) sürümünde, bildirim görünümü büyük ölçüde sistem kullanıcı arayüzü, bildirim kanalları ve cihaz üreticisi özelleştirmeleri tarafından etkilenir.
Android bildirim simgesi yerleşimi

​
Küçük bildirim simgeleri

Küçük bildirim simgesi durum çubuğunda ve bildirimin sol üst köşesinde görünür. Özel küçük simge sağlanmazsa, OneSignal varsayılan bir çan simgesi görüntüler. Android, küçük bildirim simgelerini renk verileri yerine simgenin alfa kanalını kullanarak işler. Sistem, simgeyi görüntülerken kendi rengini (veya yapılandırdığınız vurgu rengini) uygular. Gereksinimler ve en iyi uygulamalar:
  • Şeffaf arka planda tek renkli siluet simge kullanın
  • Simgeyi şeklin şeffaflıkla tanımlanacağı şekilde tasarlayın, renkle değil
  • Degradeler, gölgeler veya çok renkli çalışmalardan kaçının
  • Tasarımı çok küçük boyutlarda basit ve tanınabilir tutun
Yaygın ve önerilen bir yaklaşım, simgeyi şeffaf arka planda beyaz çalışma olarak tasarlamaktır, ancak teknik olarak Android beyaz rengin kendisini değil alfa maskesini kullanır.
Düz arka planlı veya tam renkli simgeler yanlış işlenebilir — cihaz üreticisine ve Android sürümüne bağlı olarak genellikle beyaz kare, kırpılmış şekil veya beklenmeyen siluet olarak görünür.Android genellikle küçük bildirim simgelerindeki renk bilgilerini yok sayar ve nihai görünümü alfa kanalından ve sistem veya uygulama tanımlı renklendirmeden türetir.

​
Küçük simge vurgu rengi

Bildirimin küçük simgesinin etrafında gösterilen rengi değiştirebilirsiniz.
Varsayılan bir renk ayarlamak için, projenizde res/values/strings.xml dosyanıza aşağıdaki satırı ekleyin. Karanlık mod için farklı bir renk istiyorsanız, anahtarı res/values-night/strings.xml dosyanıza da ekleyin. HEX değerini kullanın. Yardım için Android Asset Studio Renk şemasını kullanın. 
<resources>
    <string name="onesignal_notification_accent_color">FF00FF00</string>
</resources>
Bildirim başına rengi ayarlamak için, Bildirim oluştur API çağrımızda android_accent_color ayarlayın veya Messages > New Push > Platform Settings > Google Android Options altındaki Accent color alanına bir değer girin.
Uygulamanıza çok yakın zamanda bir simge kaynağı eklediyseniz, simgeyi kullanarak bildirim göndermeden önce birkaç gün beklemek isteyebilirsiniz. Bunun nedeni, kullanıcılarınızın çoğunluğunun yeni simgelerinizi içeren en son sürüme uygulamalarını güncellemeleri günler hatta haftalar alabilir.

​
Özel alfa kanalı olmayan küçük simge görselleri

Bazı cihaz üreticileri görseli olduğu gibi görüntüler (alfa kanalı kuralını yok sayar). Tüm cihazlarda alfa kanalı olmayan görseller kullanmak istiyorsanız Android’in belgelerine dayalı özel bildirim düzeni kurabilirsiniz. Simgeler tüm cihazlarda tutarlı görünmeyebileceğinden alfa kuralını izlemenizi şiddetle öneririz. Google bunu bu şekilde tasarladı — simge, anlamlı herhangi bir detayı görmek için çok küçük, bu nedenle tek bir rengi zorlamak, bir bakışta tanınması daha kolay bir simgeyi zorlamaya yardımcı olur.

​
Büyük bildirim simgeleri

Büyük simge Android bildiriminin sağ tarafında görünür.
  • Önerilen boyut: 256×256 piksel
  • Format: PNG veya JPG
  • Ayarlanmazsa, Android küçük simgeyi yeniden kullanabilir

​
Android varsayılan simgelerini nasıl eklersiniz

Her Android tabanlı uygulama için (Google Play, Amazon, Huawei) varsayılan bildirim simgelerini yapılandırmanızı şiddetle öneririz. Eksik veya yanlış yapılandırılmış simgeler, bozuk bildirim işlemenin en yaygın nedenidir. Android iki varsayılan simgeyi destekler:
  • Küçük bildirim simgesi (gerekli)
  • Büyük bildirim simgesi (isteğe bağlı ancak önerilir)
1

Küçük bildirim simgesini oluşturun

Küçük bildirim simgesi durum çubuğunda ve bildirim başlığında görünür.Gereksinimler:
  • Tek renkli siluet simge
  • Şeffaf arka plan (alfa kanalı gereklidir)
  • Renk, degrade veya gölge yok
Yaygın ve önerilen bir yaklaşım şeffaf arka planda beyaz simgedir, ancak Android beyaz rengin kendisini değil alfa kanalını kullanır.
Uyumlu küçük simgeler oluşturmanın en hızlı ve en güvenli yolu Android Asset Studio – Notification Icons kullanmaktır.
Simgeyi adlandırın: ic_stat_onesignal_default
2

Gerekli küçük simge boyutlarını oluşturun

Gerekli: Küçük simge için tüm yoğunluk varyantlarını eklemelisiniz. Herhangi bir boyutun eksik olması Android’in sistem varsayılan simgesine geri dönmesine neden olabilir.
Simge adıYoğunluk (dp)Boyut (px)
ic_stat_onesignal_defaultMDPI24x24
ic_stat_onesignal_defaultHDPI36x36
ic_stat_onesignal_defaultXHDPI48x48
ic_stat_onesignal_defaultXXHDPI72x72
ic_stat_onesignal_defaultXXXHDPI96x96
3

Büyük bildirim simgesini oluşturun (isteğe bağlı)

En iyi uygulamalar:
  • Kare görsel
  • PNG veya JPG
  • Şeffaf arka plan önerilir
  • Önerilen boyut: 256×256 px
Küçük simgelerin aksine:
  • Renge izin verilir
  • Yalnızca alfa gerekli değildir
  • Yalnızca bir boyut gereklidir
Gerekli dosya adı: ic_onesignal_large_icon_default.png
4

Simgeleri doğru proje yollarına yerleştirin

Her simge, framework’ünüz için doğru kaynak dizinine yerleştirilmelidir. Aşağıdaki yolların mevcut olduğundan emin olun; eksik klasörleri oluşturun.Gerekli: Her görsel aşağıdaki yollarda bulunmalıdır:
  • res/drawable-mdpi/ (24x24)
  • res/drawable-hdpi/ (36x36)
  • res/drawable-xhdpi/ (48x48)
  • res/drawable-xxhdpi/ (72x72)
  • res/drawable-xxxhdpi/ (96x96)
  • res/drawable-xxxhdpi/ (256x256) (Büyük Simge)
Projeniz buna benzer görünmelidir (SDK’nıza bağlı olarak):
Simgeniz yerine düz bir kare görüyorsanız, görselin uygun şeffaflığı yoktur.
OneSignal çan simgesini görüyorsanız, bir veya daha fazla gerekli küçük simge boyutu eksiktir veya yanlış dizine yerleştirilmiştir.
Android uygulamanız artık varsayılan bildirim simgeleriyle doğru şekilde yapılandırılmıştır.

​
Varsayılan olmayan simgelerle bildirim gönderme

OneSignal dashboard’undan veya REST API’den push bildirimleri gönderirken, Android, Amazon, Huawei ve Web Push bildirimleri için varsayılan simgeleri özel simgelerle geçersiz kılabilirsiniz. iOS bildirimleri için simgeyi geçersiz kılamazsınız.

​
REST API parametreleri

Android, Amazon ve Huawei REST API parametreleri:
​
small_icon
string
Amazon: adm_small_icon Huawei: huawei_small_iconKüçük simge için, görsel varsayılan küçük simgeyle aynı proje yolunda bulunmalıdır. Uzak URL kullanamaz. Özel simgelerinizi nereye ekleyeceğinizle ilgili ayrıntılar için Android varsayılan simgelerini nasıl eklersiniz bölümüne bakın.REST API parametrelerinde simge adını dosya uzantısı olmadan ayarlayın.Örnek: "small_icon": "my_custom_icon_name_without_extension"
​
large_icon
string
Amazon: adm_large_icon Huawei: huawei_large_iconBüyük simge için, görsel varsayılan büyük simgeyle aynı proje yolunda bulunabilir veya uzak bir URL olabilir. Özel simgelerinizi nereye ekleyeceğinizle ilgili ayrıntılar için Android varsayılan simgelerini nasıl eklersiniz bölümüne bakın.REST API parametrelerinde simge adını dosya uzantısı olmadan ayarlayın.Örnek: "large_icon": "my_custom_icon_name_without_extension"
Web Push REST API parametresi:
​
chrome_web_icon
string
Firefox: firefox_iconGörsel kaynağının URL’si. Görsel kaynağının doğrudan URL’si olmalıdır.Örnek: "chrome_web_icon": "https://example.com/my_custom_icon.png"
​
chrome_web_badge
string
Görsel kaynağının URL’si. Görsel kaynağının doğrudan URL’si olmalıdır.Örnek: "chrome_web_badge": "https://example.com/my_custom_icon.png"

​
Dashboard

OneSignal dashboard’unda, Messages > Push > New Push formunu veya Templates kullanarak platforma özgü seçeneklere gidin. Android, Amazon ve Huawei için, dosya varsayılan simgeyle aynı proje yolunda mevcutsa, simge adlarını dosya uzantısı olmadan ayarlayın. Büyük Bildirim Simgeleri ile, simgenin görüntüleneceği doğrudan bir URL de sağlayabilirsiniz.