@capgo/capacitor-notifiche

Panoramica

@capgo/capacitor-notifications connette un'app Capacitor a Capgo's pipeline di notifiche native. L'applicazione si registra con un ID utente cliente firmato in 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 di alta cardinalità in Capgo Postgres. Postgres memorizza solo dati di controllo 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 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 faccia a faccia con i clienti.
Progetti di campagna e impostazioni	Capgo Postgres	Dati di controllo a bassa cardinalità.
Stato di registrazione del dispositivo attivo	Cloudflare Motori di Analytics	Registrazione di dispositivi attivi 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.

• Il vostro backend conosce l'ID utente del cliente reale.
• Il vostro backend chiede a Capgo un token a breve scadenza identityProof.
• L'app si registra con externalId e che prova dopo la propria autenticazione utente è riuscita.
• Capgo deriva chiavi interne deterministiche per il destinatario e l'installazione nativa.
• Invio allo stesso externalId trova nuovamente i dispositivi attivi dell'utente.

Ciò vi 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.
• Segui gli eventi di ricezione e apertura delle notifiche.
• Gestisci le notifiche dei dati in background.
• Imposta, annulla e incrementa le etichette delle app.
• Crea 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.

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, API host e 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 dati in background e esporre 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 di aggiornamento e rendere il lavoro in background idempotente.

Le notifiche in background di iOS sono a miglior rischio. 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 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 Avvio rapido per la configurazione, Debug 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"}]}