notifications-@capgo/capacitor

Panoramica

@capgo/capacitor-notifications connects a Capacitor app to Capgo’s native notification pipeline. Your app registers a signed customer user ID with Capgo, Capgo keeps the latest active device state in Cloudflare Analytics Engine, and you can send notifications, set badges, inspect delivery stats, and trigger silent Capgo live-update checks from the Capgo dashboard or API.

La funzione è progettata per evitare una tabella di dispositivi di notifica ad alta cardinalità in Capgo Postgres. Postgres memorizza solo dati di controllo piano a bassa cardinalità, come impostazioni dell'app, metadati di credenziali della piattaforma, bozze di campagna, orari e registri di campagna aggregati. Lo stato attivo dei dispositivi e gli eventi di notifica sono righe di Analytics Engine di sola scrittura.

Cosa Capgo Memorizza

Dati	Dove si trova	Perché
Metadati di credenziali della piattaforma	Capgo Postgres	Needed to manage app setup and permissions.
Segreti della piattaforma privati	Ambiente del lavoratore	Evita di memorizzare le credenziali private nelle tabelle facce a clienti.
Schede di campagna e impostazioni	Capgo Postgres	Dati di controllo a bassa cardinalità.
Stato di registrazione del dispositivo attivo	Cloudflare Motor di analisi	Registrazione di dispositivo attivo a costo ridotto.
Eventi di notifica	Cloudflare Motor di analisi	Statistiche a basso costo per eventi in coda, inviati, ricevuti, aperti, falliti e di background.

Modello di identità

Capgo non ti chiede di caricare una lista di utenti o di mantenere una tabella dei dispositivi.

• La tua backend conosce l'ID utente reale del cliente.
• Il tuo backend chiede Capgo per un token a breve durata identityProof.
• La registrazione dell'app avviene con externalId e quella prova dopo che la tua autenticazione utente ha avuto successo.
• Capgo deriva chiavi interne deterministiche per il destinatario e l'installazione nativa.
• Inviare allo stesso externalId trova nuovamente i dispositivi attivi dell'utente.

Questo ti consente di cercare i dispositivi dell'utente, impostare le badge e mirare alle campagne di notifica senza memorizzare righe di notifica per dispositivo in Capgo Postgres.

Capacità di base

• Registra i dispositivi con un ID utente esterno autenticato.
• Aggiorna i tag, gli attributi, il consenso e lo stato del token all'avvio dell'app o ai cambiamenti del token.
• Ricevi notifiche in primo piano in JavaScript.
• Segui gli eventi di ricezione e apertura delle notifiche.
• Gestisci notifiche dati in background.
• Imposta, annulla e incrementa le etichette dell'app.
• Crea canali di notifica per Android.
• Inviare notifiche univoche, campagne di notifiche, aggiornamenti delle etichette e controlli di aggiornamento silenzioso.
• Attiva @capgo/capacitor-updater da una notifica silenziosa.

Stats

Capgo scrive gli eventi di notifica al Cloudflare Engine di Analytics per mantenere i dati del dashboard economici.

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

I segnali statistici sono segnali operativi, non un registro permanente per destinatario. La conservazione dell'engine di analisi significa che i dispositivi attivi devono aggiornare la registrazione periodicamente.

Pubblico API

Metodo	Descrizione
configure	Imposta l'ID dell'app Capgo, l'host API e il comportamento di integrazione dell'aggiornamento.
register	Registra l'installazione corrente per un ID utente cliente esterno.
setExternalId	Cambia l'ID utente cliente esterno dopo l'accesso o la modifica dell'account.
setTags	Sostituisce i tag utilizzati per la targeting dell'utenza.
setBadge	Imposta il badge dell'app nativa.
clearBadge	Cancella il badge dell'app nativa.
incrementBadge	Incrementa il badge dell'app nativa.
enableUpdaterIntegration	Abilita il trattamento silenzioso delle verifiche di aggiornamento @capgo/capacitor-updater.
runUpdateCheck	Esegue l'integrazione di aggiornamento manualmente per test.
trackReceived	Scrive manualmente un evento ricevuto.
trackOpened	Scrive manualmente un evento aperto.
addListener('notificationReceived')	Si attiva quando viene ricevuta una notifica mentre JavaScript è attivo.
addListener('notificationOpened')	Si attiva quando un utente apre una notifica.
addListener('backgroundNotification')	Si attiva per le notifiche dati in background e espone finish().
addListener('registrationChanged')	Si attiva quando cambia il token di push nativo.

Garanzie di consegna

Il push nativo è almeno una volta. Una campagna può essere ripetuta e un dispositivo può ricevere una copia duplicata se il sistema accetta un messaggio ripetuto. Utilizzare gli ID di crollo per le verifiche degli aggiornamenti e rendere le attività in background idempotenti.

Il push in background su iOS è a prestazioni ottimali. L'System può rallentare o saltare l'esecuzione in background in base alla batteria, al comportamento dell'utente, allo stato di forzato-uscita e alla politica del sistema. Non dipendere dalle notifiche silenziose per i termini di scadenza.

Continua da @capgo/capacitor-notifiche

Se stai utilizzando @capgo/capacitor-notifiche per pianificare la messaggistica push, collega Avvio rapido for setup, Debug per la risoluzione dei problemi, @capgo/capacitor-aggiornatore per controlli di aggiornamento silenziosi, e Directory Plugin Capgo per altri plugin nativi.