Panduan Lengkap Lencana Notifikasi: Fitur Kunci untuk Meningkatkan Keterlibatan Aplikasi
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 | Badge numerik desktop melalui channel vendor didukung | Aktifkan kemampuan badge numerik desktop di OPPO Open Platform; atur melalui badge_operation_type dan badge_message_count. Tanpa izin, permintaan mungkin berhasil tetapi badge tidak berlaku. |
Batas tampilan akhir dan kebijakan desktop mengikuti OPPO. |
| VIVO | Penambahan otomatis channel vendor dan pengaturan badge SDK didukung | Channel vendor menggunakan add_badge; notifikasi lokal serta setNotificationBadge/resetNotificationBadge SDK juga didukung. Aktifkan izin badge vivo dan nyalakan badge desktop. |
Batas tampilan akhir dan perilaku bergantung pada versi OS serta kebijakan desktop. |
| 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
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
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
<!-- 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"/>
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
Badge OPPO: konfigurasi sisi server vendor
Atur di options.third_party_channel.oppo pada permintaan push:
{
"badge_operation_type": 1
}
badge_operation_type=1: menambah badge sebanyak 1;badge_message_counttidak diperlukan.badge_operation_type=0: menimpa badge saat ini denganbadge_message_count; nilai0menghapus badge.- Sebelum mengirim, aktifkan kemampuan badge numerik desktop untuk aplikasi di OPPO Open Platform; sisi aplikasi tidak perlu integrasi badge tambahan.
Badge vivo: channel vendor dan kontrol SDK
Penambahan badge otomatis melalui channel vendor:
{
"add_badge": true
}
Field ini berada di options.third_party_channel.vivo. Untuk notifikasi lokal atau sinkronisasi unread dari sisi bisnis, panggil MTPushPrivatesApi.setNotificationBadge untuk menetapkan nilai dan resetNotificationBadge untuk mengosongkannya. Efek aktual bergantung pada izin badge vivo, versi OS, dan sakelar badge desktop pengguna. Di OriginOS, +1 menggunakan API sistem add_badge, dan +N (N > 1) ditetapkan ke nilai target kumulatif.
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
