Android bildirim kategorileri

Android bildirim kategorileri (bildirim kanalları olarak da bilinir), Android 8.0 (Oreo) ile kullanıcılara uygulamanızdan bildirimleri nasıl alacakları konusunda daha fazla kontrol sağlamak için tanıtıldı. Bu, bildirimlerinizi kategorize etmenizi ve görüntüleme davranışı, ses, titreşim, rozetler ve kilit ekranı görünürlüğü gibi farklı deneyimler tanımlamanızı sağlar. Örneğin, son dakika haber bildirimleriniz varsa, bunlar için bir kategori oluşturabilir ve sessiz veya varsayılan ses kullanabilecek daha az önemli bildirimlerin aksine belirgin bir şekilde görüntülenmelerini sağlamak için “Acil” önem derecesi ve özel bir ses ayarlayabilirsiniz. OneSignal, bu kategorileri doğrudan kontrol paneli içinde oluşturmanızı ve yönetmenizi kolaylaştırır. Alternatif olarak, kategorileri uygulamanızda programatik olarak tanımlayabilirsiniz. Android’in bildirim kanalları oluşturma kılavuzuna bakın.

---

​

Varsayılan bildirim kategorileri

OneSignal otomatik olarak iki varsayılan kategori oluşturur:

​

Diğer (Miscellaneous)

Kategori ayarlanmadığında kullanılır.

• Önem: Yüksek
• Ses: Varsayılan
• Titreşim: Varsayılan
• Rozetler: Etkin
• Kilit Ekranı: Özel

​

Geri Yüklendi (Restored)

Uygulama zorla kapatılıp yeniden açıldığında kullanılır. Uygulama zorla kapatıldığında Bildirim Merkezi’nde push bildirimleri varsa, bunlar cihazdan kaldırılır. Uygulamayı yeniden açmak bu bildirimleri yeniden oluşturur (geri yükler). OneSignal SDK’sı, birden fazla geri yüklenen bildirimden kaynaklanan istenmeyen sesleri ve açılır pencereleri önlemek için kategoriyi otomatik olarak “Geri Yüklendi” olarak ayarlar ve aşağıdaki ayarları kullanır.

• Önem: Düşük
• Ses: Kapalı
• Titreşim: Kapalı
• Rozetler: Devre Dışı
• Kilit Ekranı: Özel

​

Huawei’ye özel davranış

Huawei cihazlarında OneSignal varsayılan bir kategori ayarlamaz. Bir kategori eklemezseniz, Huawei varsayılan olarak Yüksek önem uygular. Huawei cihazlarında rozet kontrolü için Create message API’sinde özel Huawei rozet parametrelerini (huawei_badge_class, huawei_badge_set_num, huawei_badge_add_num) de kullanabilirsiniz. Ayrıntılar için Badges bölümüne bakın.

---

​

OneSignal’da Android bildirim kategorileri oluşturma

Başlamadan önce, Android platformuyla yapılandırılmış bir OneSignal uygulamanızın olduğundan emin olun.

1. OneSignal Kontrol Panelinde Settings > Push & In-App > Android Notification Channels’a gidin.
2. Kategorilerinizi düzenlemek için Add Group’a tıklayın (örneğin, “Haber Güncellemeleri”, “Sosyal Aktivite”).
3. Yeni bir kategori oluşturmak için grup içinde Add Channel’a tıklayın.

Aşağıdakileri tanımlamanız istenecektir:

​

Ad (Name)

Kullanıcı tarafından görünür. Net ve açıklayıcı tutun.

​

Açıklama (Description)

Kullanıcı tarafından görünür. Bu kategorinin işleyeceği bildirim türünü kısaca açıklayın.

​

Önem (Importance)

Bildirimin ne kadar görünür ve rahatsız edici olacağını kontrol eder:

• Düşük: Sessiz, uyarı yok
• Orta: Ses/titreşim yok, minimum görsel kesinti
• Yüksek: Ses çalar veya titreşir, ekran açılır penceresi yok
• Acil: Ses çalar ve heads-up veya banner tarzı bildirim olarak görünür.

​

Ses (Sound)

• Kapalı: Ses yok
• Varsayılan: Cihazın varsayılan bildirim tonu
• Özel: Özel bir ses yükleyin ve referans verin (dosya uzantısı olmadan). Örnek: alert_beep (alert_beep.wav değil)

​

Titreşim (Vibration)

• Kapalı: Titreşim yok
• Varsayılan: Cihazın titreşim desenini kullanır
• Özel: Bir desen kullanarak kendi deseninizi tanımlayın (ms cinsinden). Örnek: 0, 300, 500, 300 → 0ms bekle, 300ms titreş, 500ms duraklat, 300ms titreş.

​

LED Rengi (LED Color)

Bazı Android cihazlar LED göstergelerini destekler:

• Kapalı: LED yok
• Varsayılan: Cihaz varsayılanı
• Özel: ARGB hex değeri (örneğin, mavi için FF0000FF)

​

Rozetler (Badges)

Uygulama simgesinde rozet sayısını gösterir:

• Etkin: Rozet gösterilir
• Devre Dışı: Rozet görüntülenmez

​

Kilit ekranı görünürlüğü (Lockscreen visibility)

• Genel: Tam içerik gösterilir
• Özel: Sadece uygulama adı, içeriği gizler
• Gizli: Kilit ekranında bildirim görünmez

---

​

Kategorileri güncelleme

Bir cihaz bir kategoriden bildirim aldıktan sonra, Android o kategorinin davranışını kilitler. Önem, ses, titreşim veya diğer ayarlardaki değişiklikler geriye dönük olarak uygulanmaz. Örneğin, “Yüksek” önem derecesi ve ses kullanan bir kategori ile push bildirimi gönderirseniz, sonra önem derecesini “Acil” olarak değiştirir ve farklı bir ses dosyası kullanırsanız, aynı kategori ile aynı cihaza gönderilen bir sonraki push bildiriminde “Acil” önem derecesi veya yeni ses olmayacaktır. Seçenekler:

• Davranışı güncellemek için: Yeni bir kategori oluşturun.
• Değişiklikleri test etmek için: Uygulama verilerini temizleyin veya uygulamayı kaldırıp yeniden yükleyin.

Güncelleyebilecekleriniz:

• Kategori adı (Android ayarlarında “kanal adı” olarak gösterilir)
• Kategori grup adı (Android ayarlarında “kanal grubu adı” olarak gösterilir)

Bunlar, güncellenen kategori kullanılarak bir sonraki bildirim alındığında Android’in bildirim ayarlarında güncellenecektir.

---

​

Kategorileri silme

Silinen bir kategoriyi kullanıcının cihazından kaldırmak için:

1. Kategoriyi OneSignal kontrol panelinden silin.
2. Tüm bildirimlerin Bildirim Merkezi’nden temizlendiğinden emin olun.
3. Kullanıcının yapması gerekenler:
   • Uygulamayı 60+ saniye boyunca arka plana alın
   • Tekrar açın (SDK senkronizasyonunu tetikler)

SDK yeniden senkronize olacak ve silinen kategoriyi Android ayarlarından kaldıracaktır.

---

​

Bildirimlere kategori ekleme

Android Kategorisini nasıl oluşturduğunuza ve mesajı nasıl gönderdiğinize bağlı olarak, push bildirimlerinizde kategoriyi referans almanın yolları şunlardır.

​

OneSignal Kontrol Panelinden Gönderme

1. Template veya Push Mesaj Oluşturucunuzda Android ayarlarına gidin.
2. Category altında, OneSignal kontrol panelinde oluşturulmuşsa kategorinizi seçin veya uygulamanızda programatik olarak oluşturulmuşsa (Created in App) seçin.
   • Programatik olarak oluşturulmuşsa, Existing Channel alanını da kodunuzda tanımlanan isme ayarlayın.

​

REST API ile Gönderme

OneSignal kontrol panelinde kategoriyi oluşturduysanız, Create message API isteğinde android_channel_id kullanın. Kanal Kimliğini Android Kategori kurulum ekranında bulabilirsiniz. Kendi programatik olarak oluşturduğunuz Android kanallarını kullanıyorsanız, Create message API isteğinde existing_android_channel_id parametresini kullanın ve kodunuzda tanımlanan isme ayarlayın.

---

​

SSS

​

Kategoriler Rahatsız Etmeyin (DND) modunda ses çalabilir mi?

Hayır. OneSignal kategorilerde setBypassDnd ayarlamaz. DND’yi geçersiz kılmak için kendi kanalınızı programatik olarak oluşturun ve bu ayarı etkinleştirin. Bkz. setBypassDnd.

​

Kategori adlarını veya açıklamalarını yerelleştirebilir miyim?

Hayır. OneSignal kategoriler için birden fazla dili desteklemez. Yerelleştirmeyi desteklemek için kendi Android kanallarınızı tanımlayın ve push API isteklerinizde bunlara existing_android_channel_id aracılığıyla başvurun.

​

Android kategorim neden çalışmıyor?

Android kategorinizin beklendiği gibi çalışmamasının birkaç nedeni olabilir. Sorun gidermek için aşağıdakileri kontrol edin:

• Ne çalışmıyor?
  • Ses dosyası çalmıyor mu?
  • Cihazda görüntülenmiyor mu?
  • Android Bildirim Ayarlarında kategoriyi görmüyor musunuz?
• Kategori nasıl oluşturuldu?
  • OneSignal kontrol panelinde oluşturulduysa, ayarların beklediğiniz gibi tanımlandığından emin olun.
  • Uygulamanızda programatik olarak oluşturulduysa, kodunuzu gözden geçirin. Bkz. Android’in bildirim kanalları oluşturma kılavuzu.
• Kategori ayarlarını gözden geçirin:
  • Ayarların beklediğiniz gibi tanımlandığından emin olun.
  • Ses dosyası doğru referans alınıyor mu? Yukarıdaki Ses bölümüne bakın.
  • Mesaj gönderirken kategori adı veya ID’si doğru referans alınıyor mu?
• Bildirim gönderdikten sonra ayarları güncellediniz mi?
  • Bildirim gönderdikten sonra ayarları güncellediyseniz, Android bu güncellemeleri cihazınıza uygulamaz. Yukarıdaki Kategorileri güncelleme bölümüne bakın.
• OneSignal SDK başlatmasını kontrol edin:
  • OneSignal’ın bir Activity değil, Application sınıfında başlatıldığından emin olun. Bkz. Android SDK Kurulumu.

---

​

İlgili sayfalar