@capgo/capacitor-notifikasi

Ringkasan

@capgo/capacitor-notifications menghubungkan sebuah aplikasi Capacitor ke Capgo’s notifikasi asli pipeline. Aplikasi Anda mendaftarkan ID pengguna pelanggan yang ditandatangani dengan Capgo, Capgo menjaga keadaan perangkat aktif terbaru di Cloudflare Engine Analitik, dan Anda dapat mengirimkan notifikasi, menetapkan bintang, memeriksa statistik pengiriman, dan mengaktifkan Capgo update hidup-nyata tanpa suara 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 kredential platform, draft kampanye, jadwal, dan catatan agregat kampanye. Keadaan perangkat aktif dan event notifikasi hanya ditambahkan ke baris Analytics Engine.

Apa yang disimpan oleh Capgo

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

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.
• Mengrefresh tag, atribut, persetujuan, dan status token pada mulai aplikasi atau perubahan token.
• Menerima notifikasi di depan layar dalam JavaScript.
• Mengikuti acara notifikasi diterima dan dibuka.
• Penerimaan notifikasi data latar belakang.
• Atur, hapus, dan tambah tombol peringatan aplikasi.
• Buat saluran notifikasi Android.
• Kirim notifikasi satu kali, kampanye notifikasi, pembaruan tombol peringatan, dan periksa pembaruan diam.
• Trigger @capgo/capacitor-updater dari notifikasi diam.

Stats

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 beroperasi sebagai signal, bukan buku besar permanen per-penerima. Engine Analitik penyimpanan berarti perangkat aktif harus memperbarui registrasi secara berkala.

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 badge aplikasi native.
clearBadge	Menghapus badge aplikasi native.
incrementBadge	Meningkatkan badge aplikasi native.
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	Menulis secara manual sebuah event terbuka.
addListener('notificationReceived')	Fires ketika sebuah notifikasi diterima sementara JavaScript aktif.
addListener('notificationOpened')	Fires ketika pengguna membuka sebuah notifikasi.
addListener('backgroundNotification')	Fires untuk notifikasi data latar belakang dan mengungkap finish().
addListener('registrationChanged')	Fires ketika token push native berubah.

Jaminan Pengiriman

Push native setidaknya sekali. Suatu kampanye dapat dicoba ulang, dan sebuah perangkat dapat menerima duplikat jika platform menerima pesan yang diulang. Gunakan ID penggabungan untuk periksa update 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 deadline keras.

Teruskan dari @capgo/capacitor-notifikasi

Jika Anda menggunakan @capgo/capacitor-notifikasi untuk merencanakan pesan push, hubungkannya dengan Membuat Mulai untuk pengaturan, Debugging untuk troubleshooting, @capgo/capacitor-pengatur ulang untuk periksa pembaruan diam, dan Direktori Plugin Capgo untuk plugin native lainnya.