@capgo/capacitor-notifiche

Panoramica

@capgo/capacitor-notifications collega un'app Capacitor a Capgo's pipeline di notifiche native. L'app registra un ID utente cliente firmato con Capgo, Capgo mantiene lo stato dispositivo attivo più recente in Cloudflare Analytics Engine, e puoi inviare notifiche, impostare badge, esaminare statistiche di consegna e attivare controlli di aggiornamento in tempo reale silenziosi Capgo da Capgo dashboard o API.

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

Cosa Capgo Archivia

Dati	Dove risiede	Perché
Metadati di credenziali di piattaforma	Capgo Postgres	Serve per gestire la configurazione e le autorizzazioni dell'applicazione.
Segreti di piattaforma privati	Ambiente del worker	Evita di memorizzare le credenziali private nelle tabelle facce a faccia con i clienti.
Bozze di campagna e impostazioni	Capgo Postgres	Dati di controllo a bassa cardinalità.
Stato di registrazione del dispositivo attivo	Cloudflare Motori di analisi	Registrazione a basso costo di dispositivi attivi.
Eventi di notifica	Cloudflare Motori di analisi	Statistiche a basso costo per eventi in coda, inviati, ricevuti, aperti, falliti e di background.

Modello di identità

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

• La tua backend conosce l'ID utente del cliente reale.
• La tua backend chiede a Capgo un token a breve scadenza. identityProof.
• Registra l'applicazione con externalId e che la prova dopo il proprio autenticazione utente ha 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 badge e targetizzare campagne di notifiche senza memorizzare righe di notifiche per dispositivo in Capgo Postgres.

Capacità di base

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

Stats

Capgo scrive eventi di notifica a Cloudflare Analytics Engine per garantire che le statistiche del dashboard rimangano a basso costo:

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

Le statistiche sono segnali di funzionamento, non un registro permanente per destinatario. La conservazione dell'Analytics Engine significa che i dispositivi attivi devono aggiornare periodicamente la registrazione.

Public 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 di pubblico.
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 del controllo di aggiornamento silenzioso attraverso @capgo/capacitor-updater.
runUpdateCheck	Esegue manualmente l'integrazione dell'aggiornamento per test.
trackReceived	Esegue manualmente l'integrazione dell'aggiornamento per test tramite Cloudflare e Capacitor.
trackOpened	Scrive un evento aperto manualmente.
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 collasso per verifiche di aggiornamento e rendere il lavoro in background idempotente.

Le notifiche in background di iOS sono a prestazioni ottimali. L'System può rallentare o saltare l'esecuzione in background in base alla batteria, al comportamento dell'utente, allo stato di forzatura e alla politica del sistema. Non contare sulle notifiche silenziose per scadenze dure.

Continua da @capgo/capacitor-notifiche

Se stai utilizzando @capgo/capacitor-notifications per pianificare la messaggistica push, connettilo con Iniziare per la configurazione, Debugging per il debug, @capgo/capacitor-aggiornatore per controlli di aggiornamento silenziosi, e Capgo Directory dei plugin nativi per altri plugin nativi.