@capgo/capacitor-Benachrichtigungen

Übersicht

@capgo/capacitor-notifications verbindet eine Capacitor-Anwendung mit Capgo’s native Benachrichtigungspipeline. Die Anwendung registriert einen signierten Kundenbenutzer-Id bei Capgo, Capgo hält die neuesten aktiven Gerätestatus in Cloudflare Analytics Engine, und Sie können Benachrichtigungen senden, Badges setzen, Lieferstatus überprüfen und stille Capgo Live-Update-Überprüfungen aus der Capgo-Oberfläche oder API auslösen.

Die Funktion ist dazu konzipiert, eine Benachrichtigungssammlung mit hoher Kardinalität in Capgo Postgres zu vermeiden. Postgres speichert nur Daten mit niedriger Kardinalität, wie z.B. Anwendungseinstellungen, Plattformkreditmetadata, Kampagnenvorschläge, Schedules und aggregierte Kampagnen.

Was Capgo speichert

Daten	Wo es sich befindet	Warum
Plattformzertifikatsmetadata	Capgo Postgres	Benötigt zum Verwalten der Anwendungs-Setup und -Berechtigungen.
Private Plattformgeheimnisse	Arbeitsumgebung	Vermeidet das Speichern von privaten Anmeldedaten in Kundenfazentabellen.
Kampagnenvorschläge und -einstellungen	Capgo Postgres	Niedrigkardinalitätliche Steuerungsebene-Daten.
Aktivierter Geräteanmeldungsstatus	Cloudflare Analytics Engine	Billige Anfügeoperationen für eine aktive-Geräte-Registrierung.
Benachrichtigungsereignisse	Cloudflare Analytics Engine	Billige Statistiken für in der Warteschleife stehende, gesendete, empfangene, geöffnete, fehlgeschlagene und Hintergrundereignisse.

Identitätsmodell

Capgo fragt Sie nicht auf, eine Liste von Benutzern hochzuladen oder eine Geräte-Tabelle zu pflegen.

• Ihr Backend kennt den echten Kunden-Benutzer-IDs.
• Ihr Backend fragt Capgo nach einer kurzlebigen identityProof.
• The app registriert sich mit externalId und diese Bestätigung nach dem erfolgreichen eigenen Benutzerauthentifizierung.
• Capgo berechnet deterministische interne Schlüssel für den Empfänger und die native Installation.
• Senden an denselben externalId findet die Geräte des Benutzers wieder.

Dies ermöglicht es, die Geräte eines Benutzers aufzulisten, Benachrichtigungen zu setzen und Kampagnen für Benachrichtigungen ohne das Speichern von Benachrichtigungszeilen pro Gerät in Capgo Postgres zu verwalten.

Kernfunktionen

• Registrieren Sie Geräte mit einer authentifizierten externen Benutzer-ID.
• Aktualisieren Sie Tags, Attribute, Zustimmung und Token-Zustand bei der Anwendungsstart oder Token-Änderungen.
• Empfangen Sie Benachrichtigungen im Vordergrund in JavaScript.
• Verfolgen Sie Ereignisse für empfangene und geöffnete Benachrichtigungen.
• Hintergrunddatenbenachrichtigungen verwalten.
• App-Badges setzen, löschen und erhöhen.
• Android-Notification-Channel erstellen.
• Einzelfachbenachrichtigungen, Kampagnenbenachrichtigungen, Badge-Updates und stille Aktualisierungsprüfungen senden.
• Trigger @capgo/capacitor-updater aus einer stummen Benachrichtigung.

Stats

Capgo schreibt Benachrichtigungsereignisse an Cloudflare Analytics Engine, damit die Dashboard-Statistiken günstig bleiben:

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

Die Statistiken sind operative Signale und nicht ein dauerhafter Ledger pro Empfänger. Die Analytics Engine-Retention bedeutet, dass aktive Geräte regelmäßig die Registrierung erneuern müssen.

Öffentliche API

Methode	Beschreibung
configure	Setzt die Capgo-Anwendungs-ID, API-Host und die Verhaltensweise der Updater-Integration.
register	Registriert die aktuelle Installation für einen externen Kundenbenutzer-ID.
setExternalId	Ändert die externe Kundenbenutzer-ID nach Anmeldung oder Kontoswitch.
setTags	Ersetzt die verwendeten Tags für die Zielgruppenzielung.
setBadge	Setzt das native App-Badge.
clearBadge	Löscht das native App-Badge.
incrementBadge	Erhöht das native App-Badge.
enableUpdaterIntegration	Aktiviert die stille Update-Prüfung über @capgo/capacitor-updater.
runUpdateCheck	Läuft die Updater-Integration manuell für Testzwecke.
trackReceived	Führt die Updater-Integration manuell für Testzwecke aus.
trackOpened	Manuell schreibt ein geöffnetes Ereignis.
addListener('notificationReceived')	Fired, wenn eine Benachrichtigung empfangen wird, während JavaScript aktiv ist.
addListener('notificationOpened')	Fired, wenn ein Benutzer eine Benachrichtigung öffnet.
addListener('backgroundNotification')	Fired für Hintergrunddatenbenachrichtigungen und enthüllt finish().
addListener('registrationChanged')	Fired, wenn der native Push-Token ändert.

Liefergarantien

Native Push ist mindestens einmal. Eine Kampagne kann wiederholt werden, und ein Gerät kann eine Duplikat erhalten, wenn das Betriebssystem einen wiederholten Nachrichten akzeptiert. Verwenden Sie Collapse-IDs für Update-Überprüfungen und machen Hintergrundarbeiten idempotent.

iOS-Hintergrundbenachrichtigungen sind bestmöglich. Das Betriebssystem kann Hintergrundausführung aufgrund von Batterie, Benutzerverhalten, Zwangs-Beendigungszustand und Systemrichtlinien einschränken. Ziehen Sie nicht auf stumme Benachrichtigungen für harte Fristen.

Weitergehen von @capgo/capacitor-Benachrichtigungen

Wenn Sie diese verwenden @capgo/capacitor-Benachrichtigungen um Push-Benachrichtigungen zu planen, verbinden Sie es mit Einstieg für die Einrichtung, Fehlersuche für die Fehlerbehebung, @capgo/capacitor-Updater für stille Aktualisierungsprüfungen und Capgo-Plugin-Verzeichnis für andere native Plugins.