@capgo/capacitor-pemberitahuan

Ringkasan

@capgo/capacitor-notifications menghubungkan sebuah Capacitor aplikasi ke Capgo’s pipeline notifikasi native. Aplikasi Anda mendaftarkan ID pengguna pelanggan yang ditandatangani dengan Capgo, Capgo menyimpan status perangkat aktif terbaru di Cloudflare Engine Analitik, dan Anda dapat mengirimkan notifikasi, mengatur badge, memeriksa statistik pengiriman, dan mengaktifkan periksa pembaruan Capgo live secara diam-diam dari Capgo dashboard atau API.

Fitur ini dirancang untuk menghindari tabel perangkat notifikasi dengan kardinalitas tinggi di Capgo Postgres. Postgres hanya menyimpan data kontrol plane dengan kardinalitas rendah seperti pengaturan aplikasi, metadata kredensial platform, draft kampanye, jadwal, dan catatan kampanye agregat. Status perangkat aktif dan event notifikasi adalah baris Analytics Engine yang hanya dapat ditambahkan.

Apa yang disimpan oleh Capgo

Data	Dimana ia tinggal	Mengapa
Metadata kredensial platform	Capgo Postgres	Diperlukan untuk mengelola pengaturan aplikasi dan izin.
Rahasia platform pribadi	Environment pekerja	Menjaga kreditensi pribadi dari tabel yang menghadap pelanggan.
Membuat kampanye dan pengaturan	Capgo Postgres	Data kontrol penerbangan dengan kardinalitas rendah.
Status pendaftaran perangkat aktif.	Cloudflare Mesin Analitik	Daftar perangkat aktif yang murah dan dapat ditambahkan secara berurutan.
Event pemberitahuan	Cloudflare Mesin Analitik	Statistik murah untuk event yang antri, dikirim, diterima, dibuka, gagal, dan latar belakang.

Model Identitas

Capgo tidak meminta Anda untuk mengunggah daftar pengguna atau menjaga tabel perangkat.

• Backend Anda tahu ID pengguna pelanggan yang sebenarnya.
• Capgo meminta backend Anda untuk token yang berlaku singkat. identityProof.
• Aplikasi mendaftarkan diri dengan externalId dan bukti tersebut setelah autentikasi pengguna Anda berhasil.
• Capgo menghasilkan kunci internal yang deterministik untuk penerima dan instalasi native.
• Mengirim ke perangkat yang sama externalId mencari perangkat aktif pengguna lagi.

Hal ini memungkinkan Anda mencari perangkat pengguna, menetapkan badge, dan mengarahkan kampanye notifikasi tanpa menyimpan baris notifikasi per-device di Capgo Postgres.

Kemampuan Utama

• Mendaftarkan perangkat dengan ID pengguna eksternal yang terautentikasi.
• Segarkan tag, atribut, persetujuan, dan status token pada saat aplikasi dijalankan atau perubahan token.
• Menerima notifikasi di latar depan dengan JavaScript.
• Melacak event notifikasi yang diterima dan dibuka.
• Menangani notifikasi data di latar belakang.
• Mengatur, menghapus, dan meningkatkan badge aplikasi.
• Membuat saluran notifikasi Android.
• Mengirimkan notifikasi tunggal, kampanye notifikasi, update badge, dan periksa update diam.
• Mengaktifkan @capgo/capacitor-updater dari notifikasi diam.

Statistik

Capgo menulis event notifikasi ke Cloudflare Engine Analitik sehingga statistik dashboard tetap murah:

• queued
• sent
• provider_accepted
• received
• opened
• failed
• permission_changed
• background_started
• background_finished

Statistik berfungsi sebagai signal operasional, bukan catatan permanen per-penerima.

Publik API

Metode	Deskripsi
configure	Mengatur ID aplikasi Capgo , API host, dan perilaku integrasi pembaruan.
register	Mendaftarkan instalasi saat ini untuk ID pengguna pelanggan eksternal.
setExternalId	Mengubah ID pengguna pelanggan eksternal setelah login atau perubahan akun.
setTags	Mengganti tag yang digunakan untuk target audiens.
setBadge	Mengatur ikon aplikasi asli.
clearBadge	Menghapus ikon aplikasi asli.
incrementBadge	Mengatur ikon aplikasi asli dengan nilai tertinggi.
enableUpdaterIntegration	Memungkinkan penanganan pembaruan update secara diam-diam melalui @capgo/capacitor-updater.
runUpdateCheck	Menggunakan integrasi pembaruan secara manual untuk tes.
trackReceived	Menggunakan event yang diterima secara manual.
trackOpened	Menggunakan event yang dibuka secara manual.
addListener('notificationReceived')	Mengaktifkan ketika sebuah notifikasi diterima ketika JavaScript aktif.
addListener('notificationOpened')	Mengaktifkan ketika pengguna membuka sebuah notifikasi.
addListener('backgroundNotification')	Mengaktifkan untuk notifikasi data latar belakang dan mengungkapkan finish().
addListener('registrationChanged')	Mengaktifkan ketika token push native berubah.

Jaminan Pengiriman

Pengiriman native setidaknya sekali. Suatu kampanye dapat dicoba ulang, dan sebuah perangkat dapat menerima duplikat jika platform menerima pesan yang diulang. Gunakan ID penggabungan untuk pengecekan pembaruan dan membuat pekerjaan latar belakang idempoten.

Notifikasi latar belakang iOS adalah usaha terbaik. Sistem operasi dapat mengurangi atau melewatkan eksekusi latar belakang berdasarkan baterai, perilaku pengguna, keadaan force-quit, dan kebijakan sistem. Jangan bergantung pada notifikasi diam-diam untuk jadwal keras.

Teruskan dari @capgo/capacitor-pemberitahuan

Jika Anda menggunakan @capgo/capacitor-pemberitahuan untuk merencanakan pesan push, hubungkannya dengan Panduan Pemula untuk pengaturan, Pengembangan untuk troubleshooting, @capgo/capacitor-pengatur untuk periksa update diam, dan Capgo Direktori Plugin {"targetLanguage":"Indonesia","pagePath":"/id/docs/plugins/pemberitahuan/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"untuk plugin asli lainnya."},{"text":"Edit halaman"}]}