@capgo/capacitor-pemberitahuan

Ringkasan

@capgo/capacitor-notifications menghubungkan aplikasi Capacitor ke Capgo’s pipeline pemberitahuan asli. Aplikasi Anda mendaftarkan ID pengguna pelanggan yang ditandatangani dengan Capgo, Capgo memelihara keadaan perangkat aktif terbaru di Cloudflare Engine Analitik, dan Anda dapat mengirim pemberitahuan, menetapkan tanda, memeriksa statistik pengiriman, dan mengaktifkan Capgo live-update diam dari Capgo dashboard atau API.

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

Capgo Menyimpan Apa

Data	Di mana ia tinggal	Mengapa
Metadata kredit platform	Capgo Postgres	Diperlukan untuk mengelola pengaturan dan izin aplikasi.
Rahasia platform pribadi	Lingkungan pekerja	Menghindari penyimpanan kredit pribadi di tabel wajah pelanggan.
Rancangan kampanye dan pengaturan	Capgo Postgres	Data kontrol penerbangan dengan kardinalitas rendah.
Status pendaftaran perangkat aktif	Cloudflare Mesin Analitik	Daftar perangkat aktif murah.
Event notifikasi	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.
• Backend Anda meminta Capgo untuk token yang berlaku singkat identityProof.
• Applikasi mendaftar dengan externalId dan bukti setelah autentikasi pengguna Anda sendiri berhasil.
• Capgo menghasilkan kunci internal deterministik untuk penerima dan instalasi asli.
• Mengirimkan ke perangkat yang sama externalId Mencari perangkat aktif pengguna lagi.

Menggunakan fitur ini, Anda dapat mencari perangkat pengguna, menambahkan label, dan mengirimkan kampanye notifikasi tanpa menyimpan baris notifikasi per-perangkat di Capgo Postgres.

Kemampuan Dasar

• Mendaftarkan perangkat dengan ID pengguna eksternal yang telah diotentikasi.
• Mengrefresh tag, atribut, persetujuan, dan status token pada saat aplikasi dijalankan atau perubahan token.
• Menerima notifikasi di depan layar dalam JavaScript.
• Mengikuti peristiwa notifikasi yang diterima dan dibuka.
• Menghandle notifikasi data di latar belakang.
• Mengatur, menghapus, dan meningkatkan label aplikasi.
• Membuat saluran notifikasi Android.
• Kirim notifikasi satu kali, kampanye notifikasi, pembaruan badge, dan periksa pembaruan diam.
• Trigger @capgo/capacitor-updater dari notifikasi diam.

Statistik

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

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

Statistik adalah signal operasional, bukan catatan permanen per-penerima. Engine Analitik penyimpanan berarti perangkat aktif harus memperbarui registrasi secara berkala.

Publik API

Metode	Deskripsi
configure	Menetapkan ID aplikasi Capgo , host API , dan perilaku integrasi pembaruan.
register	Mendaftarkan instalasi saat ini untuk ID pengguna klien eksternal.
setExternalId	Mengubah ID pengguna klien eksternal setelah login atau perubahan akun.
setTags	Mengganti tag yang digunakan untuk target audiens.
setBadge	Mengatur badge aplikasi asli.
clearBadge	Menghapus badge aplikasi asli.
incrementBadge	Menggunakan badge aplikasi asli.
enableUpdaterIntegration	Mengaktifkan penanganan pembaruan diam-diam melalui @capgo/capacitor-updater.
runUpdateCheck	Menggunakan integrasi pembaruan secara manual untuk tes.
trackReceived	Menulis event yang diterima secara manual.
trackOpened	Menggunakan integrasi pembaruan secara manual untuk tes.
addListener('notificationReceived')	Menggunakan integrasi pembaruan secara manual untuk tes.
addListener('notificationOpened')	Menggunakan integrasi pembaruan secara manual untuk tes.
addListener('backgroundNotification')	Terjadi untuk pemberitahuan data latar belakang dan mengungkapkan finish().
addListener('registrationChanged')	Terjadi ketika token push asli berubah.

Jaminan Pengiriman

Push asli beroperasi setidaknya sekali. Kampanye dapat dicoba ulang, dan perangkat dapat menerima duplikat jika platform menerima pesan yang diulang. Gunakan ID penggabungan untuk memeriksa pembaruan dan membuat pekerjaan latar belakang idempoten.

Pemberitahuan 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 pemberitahuan diam untuk jadwal keras.

Teruskan dari @capgo/capacitor-pemberitahuan

Jika Anda menggunakan @capgo/capacitor-pemberitahuan untuk merencanakan pemberitahuan push, hubungkannya dengan Panduan Awal untuk pengaturan, Debugging untuk memecahkan masalah, @capgo/capacitor-pengupdate untuk pemeriksaan update diam. Direktori Plugin Capgo untuk periksa update diam, dan