Ana içeriğe atla
Rozetler, mobil uygulama simgenizde görünen küçük numaralı noktalardır. Kullanıcı dikkatini çekmeye yardımcı olurlar ve etkileşim davranışını etkileyebilirler. Özellikle iOS’ta rozetler ek kurulum gerektirir ve esnek kontrol sunar, aşağıda açıklandığı gibi.
Android Web Push bildirimleri için rozet, bildirimler üzerinde gösterilen küçük simgeyi ifade eder—uygulama simgesini değil—ve özelleştirilebilir. Web Push Rozetleri’ne bakın.

​
Android rozetleri

Android uygulama simgesi rozet davranışı Android bildirim kategorileri aracılığıyla yönetilebilir. Bir kategorinin (kanalın) rozet gösterip göstermediğini kontrol edebilir ve kategori bazında rozet davranışını ayarlayabilirsiniz.

​
Huawei rozetleri

Huawei cihazlarında, bir rozet kullanıcının cihaz ayarlarına bağlı olarak uygulama simgesinde bir sayı veya nokta olarak görüntülenebilir. Rozetler, okunmamış mesajları veya bekleyen işlemleri göstermeye yardımcı olur ve kullanıcıları uygulamayı açmaya teşvik eder. OneSignal, Huawei rozet sayılarını doğrudan kontrol paneli veya API aracılığıyla kontrol etmenize olanak tanır.

​
Huawei rozetleri nasıl çalışır

Rozet, kullanıcının cihaz ayarına (Ayarlar > Bildirimler > Uygulama simgesi rozetleri) bağlı olarak uygulama simgesinde sayısal değer veya nokta olarak görüntülenir. API çağrınız temel sayıyı kontrol eder; cihaz görsel stili belirler.

​
Parametreler

ParametreTürAralıkAçıklama
huawei_badge_classstring—(Gerekli) Uygulamanızın başlatıcı Activity’sinin tam nitelikli sınıf adı (örneğin, com.example.myapp.MainActivity). Huawei sistemine hangi uygulama simgesine rozet ekleneceğini bildirir.
huawei_badge_set_numinteger0–99Rozeti tam bir sayıya ayarlar. 0 rozeti temizler.
huawei_badge_add_numinteger1–99Mevcut rozet sayısını bu miktar kadar artırır.

​
Davranış kuralları

  • huawei_badge_class herhangi bir rozet işlemi için gereklidir.
  • Hem huawei_badge_set_num hem de huawei_badge_add_num sağlanırsa, huawei_badge_set_num öncelik alır.
  • Hiçbiri sağlanmazsa (ancak huawei_badge_class ayarlıysa), rozet sayısı varsayılan olarak 1 artar.

​
Rozetlerle Huawei push gönderme

  1. Mesajlar > Push veya Şablonlar’a gidin
  2. Platform Ayarları > Huawei Android’e Gönder > Rozet altında
  3. Aşağıdakilerden birini seçin:
    • Ayarlama — rozet bu bildirimden etkilenmez
    • Ayarla — rozeti belirli bir sayıya ayarlar (0-99)
    • Artır — mevcut rozet sayısını artırır (1-99)

​
Rozetleri temizleme

Huawei, kullanıcı uygulamayı açtığında veya bir bildirime dokunduğunda rozeti otomatik olarak temizlemez. Rozeti temizlemek için iki seçeneğiniz var:
  • API veya kontrol paneli aracılığıyla: huawei_badge_set_num’u 0 olarak ayarlanmış bir bildirim gönderin (veya kontrol panelinde Ayarla > 0 kullanın). Görünür bir bildirim görünmesini istemiyorsanız, bu bir veri/arka plan bildirimi olabilir.
  • İstemci tarafı kod aracılığıyla: Uygulamanız Huawei rozet API’sini kullanarak rozeti yerel olarak temizleyebilir. Bu, AndroidManifest.xml dosyanızda com.huawei.android.launcher.permission.CHANGE_BADGE iznini gerektirir. Uygulama ayrıntıları için Huawei rozet geliştirme kılavuzu’na bakın.
huawei_badge_set_num parametresi EMUI 10.0.0 veya sonrası ve Push SDK 10.1.0 veya sonrasını gerektirir. Eski cihazlarda yalnızca huawei_badge_add_num desteklenir.

​
iOS rozetleri

iOS’ta rozet sayılarının doğru şekilde artmasını sağlamak için şunları yapılandırmanız gerekir:
  • OneSignalNotificationServiceExtension
  • App Groups
Tam talimatlar için Mobil SDK kurulumu’na bakın. Varsayılan olarak, OneSignal SDK:
  1. Uygulama açıldığında uygulama simgesi rozetini temizler.
  2. Bildirim Merkezi’nden bildirimleri kaldırır.
Bildirimleri korumak ve rozet mantığını manuel olarak yönetmek istiyorsanız (örn. kendi sayacınızı kullanarak veya cihazlar arasında durumu senkronize ederek), bu otomatik davranışı devre dışı bırakabilirsiniz. Manuel rozet kontrolü için yaygın kullanım durumları
  • Uygulama başlatıldığında veya devam ettiğinde rozeti sıfırlama
  • Ön planda bir bildirim alındığında rozeti artırma
  • Bir mesaj okunduğunda veya kapatıldığında azaltma
  • App Groups veya arka ucunuz aracılığıyla cihazlar veya uygulama uzantıları arasında rozet durumunu senkronize etme

​
Otomatik bildirim ve rozet temizlemeyi devre dışı bırakın

Uygulamanızın info.plist dosyasında, Anahtar: OneSignal_disable_badge_clearing ile Boolean türünde Değer YES ekleyin
Xcode Info.plist editor showing OneSignal_disable_badge_clearing set to YES
<key>OneSignal_disable_badge_clearing</key>
<true/>
Bu, SDK’nın uygulama açıldığında bildirimleri otomatik olarak kaldırmasını veya rozeti sıfırlamasını önler.

​
iOS yerel rozet yönetimi

OneSignal’ın otomatik rozet temizlemesini devre dışı bırakırsanız, rozet davranışını kontrol etmek için Apple’ın yerel API’lerini kullanabilirsiniz.
Apple, iOS 17’de UIApplication.shared.applicationIconBadgeNumber’ı kullanımdan kaldırdı. Artık UserNotifications çerçevesinden aşağıdaki yöntemleri kullanmalısınız:
Rozet sayısını ayarlama Uygulama simgesindeki rozeti belirli bir değere ayarlamak için: 
import UserNotifications
import UIKit

if #available(iOS 17.0, *) {
  UNUserNotificationCenter.current().setBadgeCount(5) { error in
    if let error = error {
      print("Failed to set badge count: \(error.localizedDescription)")
    } else {
      print("Badge count updated successfully.")
    }
  }
} else {
  UIApplication.shared.applicationIconBadgeNumber = 5
}
Mevcut rozet sayısını alma iOS, sistemden mevcut rozet sayısını almanız için bir yöntem sağlamaz. Rozet sayısını uygulamanızın durumunda takip etmelisiniz (örneğin, UserDefaults, uygulamanızın veri modeli veya arka ucunuzla senkronize ederek kullanarak). 
// Example: Store and retrieve badge count using UserDefaults
let badgeCount = UserDefaults.standard.integer(forKey: "badgeCount")
// Update badge count as needed
UserDefaults.standard.set(badgeCount, forKey: "badgeCount")
Rozeti artırma veya azaltma Rozet mantığını manuel olarak yönetmelisiniz, çünkü yüklerde göreceli değişiklikler (+1 veya -1 gibi) desteklenmez. Saklanan rozet sayınızı güncelleyin ve ardından ayarlayın: 
// Example: Increment badge count and update system badge
let currentCount = UserDefaults.standard.integer(forKey: "badgeCount")
let updatedCount = max(0, currentCount + 1)
UserDefaults.standard.set(updatedCount, forKey: "badgeCount")

if #available(iOS 17.0, *) {
  UNUserNotificationCenter.current().setBadgeCount(updatedCount)
} else {
  UIApplication.shared.applicationIconBadgeNumber = updatedCount
}
Rozeti temizleme Rozeti tamamen kaldırmak için: 
if #available(iOS 17.0, *) {
  UNUserNotificationCenter.current().setBadgeCount(0)
} else {
  UIApplication.shared.applicationIconBadgeNumber = 0
}

​
Rozetlerle iOS push gönderme

OneSignal kontrol panelinde veya API’yi kullanarak rozet sayısını ayarlayabilirsiniz.
  1. Mesajlar > Push veya Şablonlar’a gidin.
  2. Platform Ayarları > Apple iOS’a Gönder > Rozetler altında.
  3. Şunlardan birini seçin:
    • Belirli bir sayıya ayarlayın.
    • Göreceli bir miktarda artırın.
OneSignal dashboard push message form showing iOS badge count options
iOS push bildirimleri gönderirken rozet sayısı bu seçeneklere göre değişir. Uygulama açıksa, otomatik rozet temizlemeyi devre dışı bırakmak için yukarıdaki talimatları takip etmediyseniz rozet sayısı sıfırlanır.

​
SSS

​
iOS’ta rozet sayım neden artmıyor?

OneSignalNotificationServiceExtension ve App Groups’u yapılandırdığınızdan emin olun. Bunlar olmadan rozet sayıları doğru şekilde artamaz. Tam talimatlar için Mobil SDK kurulumu’na bakın.

​
Huawei’de rozetleri nasıl temizlerim?

huawei_badge_set_num’u 0 olarak ayarlanmış bir bildirim gönderin veya kontrol panelinde Ayarla > 0 kullanın. Görünür bir bildirim göstermeden rozetleri temizlemek için veri/arka plan bildirimi de kullanabilirsiniz. Alternatif olarak, Huawei rozet API’sini kullanarak rozeti istemci tarafında temizleyin.

​
Web push için rozet ayarlayabilir miyim?

Hayır. Uygulama simgesi rozetleri yalnızca iOS, Android ve Huawei’de desteklenir. Android web push için “rozet”, bildirimin kendisinde gösterilen küçük simgeyi ifade eder — bkz. Web Push Rozetleri.

​
İlgili sayfalar

Android bildirim kategorileri

Android’de bildirim kanalı başına rozet görüntülemeyi ve davranışını kontrol edin.

Huawei yetkilendirmesi

OneSignal ile Huawei push mesajlaşmasını kurun.

Push genel bakış

Web push rozetleri dahil push bildirimi özellikleri için tam başvuru kaynağı.

Mobil SDK kurulumu

iOS için rozet önkoşulları dahil OneSignal SDK’yı yapılandırın.