@capgo/capacitor-notifiche

Panoramica

@capgo/capacitor-notifications connette un'app Capacitor a Capgo's pipeline di notifiche native. L'applicazione 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 silenzioso Capgo dal pannello di controllo Capgo o API.

La funzione è progettata per evitare una tabella dispositivo di notifiche 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 registri di campagna aggregati. Lo stato dispositivo attivo e gli eventi di notifica sono righe di Analytics Engine a sola scrittura.

Quali Capgo archivi

Dati	Dove risiedono	Perché
Metadati di credenziali di piattaforma	Capgo Postgres	Richiesto per gestire la configurazione dell'app e le autorizzazioni.
Segreti di piattaforma privati	Ambiente di lavoro	Evita di memorizzare le credenziali private nelle tabelle facce a clienti.
Bozzetti e impostazioni di campagna	Capgo Postgres	Dati di controllo a bassa cardinalità.
Stato di registrazione del dispositivo attivo	Cloudflare Motori di Analytics	Registrazione di dispositivo attivo a basso costo e senza modifiche.
Eventi di notifica	Cloudflare Motori di Analytics	Statistiche a basso costo per eventi in coda, inviati, ricevuti, aperti, falliti e di background.

Modello di identità

Capgo non richiede che carichiate una lista di utenti o manteniate una tabella dei dispositivi.

• La vostra backend conosce l'ID utente del cliente reale.
• La vostra backend chiede a Capgo una chiave temporanea. identityProof.
• L'app si registra con externalId e quella prova dopo che la vostra 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 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 le etichette, gli attributi, il consenso e lo stato del token all'avvio dell'applicazione o ai cambiamenti del token.
• Ricevi notifiche in primo piano in JavaScript.
• Traccia gli eventi di ricezione e apertura delle notifiche.
• Gestisci le notifiche dei dati in background.
• Imposta, annulla e incrementa le etichette delle app.
• Creare canali di notifica per Android.
• Inviare notifiche univoche, notifiche di campagna, aggiornamenti delle etichette e controlli di aggiornamento silenzioso.
• Trigger @capgo/capacitor-updater da una notifica silenziosa.

Sezione intitolata “Stats”

Capgo writes notification events to Cloudflare Analytics Engine so dashboard stats stay cheap:

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

Le statistiche sono segnali operativi, non un registro permanente per destinatario.

Public API

Metodo	Descrizione
configure	Imposta l'ID dell'app Capgo, l'host API e il comportamento di integrazione dell'aggiornatore.
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'audience.
setBadge	Imposta la badge dell'app nativa.
clearBadge	Elimina la badge dell'app nativa.
incrementBadge	Incrementa la badge dell'app nativa.
enableUpdaterIntegration	Abilita il trattamento silenzioso delle verifiche di aggiornamento attraverso @capgo/capacitor-updater.
runUpdateCheck	Esegue manualmente l'integrazione di aggiornamento 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 esporre finish().
addListener('registrationChanged')	Si attiva quando cambia il token di push nativo.

Garanzie di consegna

La push nativa è almeno una volta. Una campagna può essere riprovata e un dispositivo può ricevere una copia duplicata se il sistema accetta un messaggio ripetuto. Utilizzare gli ID di crollo per le verifiche di aggiornamento e rendere il lavoro in background idempotente.

Il sistema operativo iOS per le notifiche in background è a miglior prestazione. L'OS 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 si fidi delle notifiche silenziose per i termini di scadenza rigidi.

Continua da @capgo/capacitor-notifications

Se stai utilizzando @capgo/capacitor-notifications per pianificare la messaggistica push, collega Avvio rapido per la configurazione, Debugging per la risoluzione dei problemi, @capgo/capacitor-aggiornatore per controlli di aggiornamento silenziosi, e @Capgo Directory dei plugin {"targetLanguage":"Italian","pagePath":"/it/docs/plugins/notifications/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"per altri plugin nativi."},{"text":"Modifica pagina"}]}