Cara Mengatur Lencana Notifikasi

Gambaran Nilai Lencana

Lencana notifikasi adalah fitur utama untuk meningkatkan keterlibatan pengguna di aplikasi seluler. Dengan menampilkan jumlah pesan yang belum dibaca langsung di ikon aplikasi, lencana secara efektif mendorong pengguna untuk kembali dan meningkatkan tingkat pembukaan notifikasi.

EngageLab menyediakan solusi lencana lintas platform yang lengkap untuk membantu pengembang menghadirkan pengalaman pengguna terbaik.

Gambaran Dukungan Channel

Karena ada batasan sistem pada berbagai merek ponsel, hanya saluran push tertentu yang mendukung tampilan lencana. Status dukungan sebagai berikut:

Vendor	Dukungan Lencana / Angka Lencana	Catatan Implementasi	Batasan Lencana
Google FCM	Lencana didukung	Secara default tampil sebagai titik, mengikuti perilaku sistem	Tidak ada batas atas eksplisit
Huawei / Honor	Lencana angka didukung	Angka lencana bertambah seiring notifikasi masuk	Biasanya dibatasi hingga 99
Xiaomi	Lencana angka didukung	Mengikuti logika default sistem, setiap notifikasi baru menambah 1	Batas ditentukan sistem, tidak didokumentasikan
OPPO	Lencana angka tidak didukung	Hanya titik merah yang didukung secara default. Lencana angka butuh persetujuan khusus dari OPPO dan umumnya hanya untuk aplikasi seperti WeChat atau QQ	Tidak disebutkan; lencana angka umumnya tidak tersedia
VIVO	Menunggu konfirmasi vendor; saat ini tidak didukung saat pengujian	Informasi daring bervariasi tergantung versi OS dan channel push	Biasanya dibatasi hingga 99
Meizu	Lencana angka tidak didukung	Hanya titik merah	–
iOS	Lencana angka didukung	Angka lencana dapat diatur melalui payload push atau API SDK	Sangat tinggi; tidak ada batas atas terdokumentasi

Contoh Penggunaan Umum

Aplikasi sosial: Sinkronisasi jumlah pesan belum dibaca secara real-time
Aplikasi e-commerce: Pengingat pesanan atau tindakan yang tertunda
Aplikasi berita: Menampilkan jumlah artikel yang belum dibaca

Lencana iOS: Manajemen Lencana yang Presisi

Arsitektur Teknis

alt text

Konfigurasi Lencana di Sisi Klien

Atur Lencana (dengan Callback)

Didukung sejak versi: v5.2.0

Hapus Lencana

Menghapus nilai lencana yang tersimpan di server MTPush, setara dengan memanggil:

setBadge: 0

              
              setBadge: 0

Tampilkan blok kode ini di jendela mengambang

Konfigurasi Lencana di Sisi Server

Saat mengirim notifikasi push, field badge harus dikonfigurasi di bawah payload ios.

Field	Tipe	Opsional	Deskripsi	Catatan
badge	Int atau String	Opsional	Angka lencana ikon aplikasi	• Dapat diatur sebagai `N`, `+N`, atau `-N`, di mana `N` berkisar `[0, 99]`. • Jika nilainya `10`, lencana dapat diartikan sebagai `N`, `10+N`, atau `10-N` (nilai di bawah 0 akan menghapus lencana). • Nilai `0` atau string kosong akan menghapus lencana. • Jika tidak diisi, angka lencana tidak berubah. • Library API resmi MTPush (SDK) secara default mengatur nilai lencana menjadi `"+1"`.

Lencana Huawei / Honor

Konfigurasi di Sisi Klien

<uses-permission android:name="com.huawei.android.launcher.permission.CHANGE_BADGE"/> <uses-permission android:name="com.hihonor.android.launcher.permission.CHANGE_BADGE"/>

              
              <!-- Konfigurasi permission AndroidManifest.xml -->
<uses-permission android:name="com.huawei.android.launcher.permission.CHANGE_BADGE"/>
<uses-permission android:name="com.hihonor.android.launcher.permission.CHANGE_BADGE"/>

Tampilkan blok kode ini di jendela mengambang

Konfigurasi Portal

Penting: Activity entri aplikasi harus dikonfigurasi dengan benar. Huawei dan Honor menggunakan logika konfigurasi yang sama.

Parameter Lanjutan di Sisi Server

Parameter	Deskripsi	Nilai Bisnis
`badge_add_num`	Menambah angka lencana	Cocok untuk aplikasi pesan agar lencana tetap konsisten
`badge_set_num`	Mengatur lencana ke nilai tetap	Cocok untuk indikator berbasis status seperti tugas tertunda
`badge_class`	Menentukan Activity launcher	Memastikan lencana terasosiasi dengan aplikasi yang tepat

Lencana Xiaomi

Perangkat dengan MIUI 6 ke atas mendukung lencana angka. Sistem MIUI secara otomatis menangani logika tampilan lencana:

📱 Terima notifikasi → lencana +1 (tanpa aksi dari pengembang) 🔄 Buka aplikasi → lencana otomatis terhapus ⚡ MIUI 6+ didukung di semua versi, mencakup mayoritas pengguna Xiaomi

Rekomendasi Praktik Terbaik

Strategi Lintas Platform yang Terpadu

Implementasi bertingkat: Prioritaskan dukungan penuh lencana angka di iOS, Huawei, dan Xiaomi
Kompatibilitas fallback: Gunakan indikator titik merah untuk OPPO, VIVO, dan platform lain yang tidak mendukung
Pengalaman pengguna konsisten: Jaga logika lencana tetap seragam di semua platform

Panduan Lengkap Lencana Notifikasi: Fitur Kunci untuk Meningkatkan Keterlibatan Aplikasi