@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 dashboard Capgo o API.

La funzione è progettata per evitare una tabella dispositivo di notifiche di alta cardinalità in Capgo Postgres. Postgres memorizza solo dati di controllo piani di 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 di sola scrittura.

Quali Capgo archivi

Dati	Dove si trova	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 faccia a faccia con i clienti.
Schede di campagna e impostazioni	Capgo Postgres	Alta velocità per i dati del controllo piazzale di bassa cardinalità.
Stato di registrazione attiva del dispositivo	Cloudflare Motorino di Analytics	Registrazione di dispositivi attivi a basso costo e senza modifiche.
Eventi di notifica	Cloudflare Motorino di Analytics	Statistiche a basso costo per eventi in coda, inviati, ricevuti, aperti, falliti e di background.

Modello di identità

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

• Il tuo backend conosce l'ID utente del cliente reale.
• Il tuo backend chiede a Capgo una chiave a breve scadenza identityProof.
• L'app si registra con externalId e quella prova dopo la tua autenticazione utente ha avuto successo.
• Capgo deriva chiavi interne deterministiche per il destinatario e l'installazione nativa.
• Invia allo stesso externalId trova nuovamente i dispositivi attivi dell'utente.

Ciò ti consente di cercare i dispositivi dell'utente, impostare le badge e mirare alle campagne di notifiche senza memorizzare righe di notifiche 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'applicazione 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'applicazione.
• Creare canali di notifica per Android.
• Inviare notifiche univoche, notifiche di campagna, aggiornamenti delle etichette e controlli di aggiornamento silenzioso.
• Attiva @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 di funzionamento, 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'utenza.
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 di 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 ripetuta 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 rischio. L'OS può rallentare o saltare l'esecuzione in background in base alla batteria, al comportamento dell'utente, allo stato di forzato chiusura e alla politica del sistema. Non si fidi delle notifiche silenziose per scadenze rigide.

Continua da @capgo/capacitor-notifications

Se stai utilizzando @capgo/capacitor-notifications per pianificare la messaggistica push, collega @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-notifications con Getting Started per la configurazione Debugging per la risoluzione dei problemi @capgo/capacitor-updater 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"}]}