@capgo/capacitor-Benachrichtigungen

Übersicht

@capgo/capacitor-notifications Verbindet eine Capacitor-App mit Capgo's native Benachrichtigungspipeline. Die App registriert einen signierten Kundenbenutzer-Id bei Capgo, Capgo hält die neuesten aktiven Gerätestände 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 darauf ausgelegt, eine Benachrichtigungstabelle mit hoher Kardinalität in Capgo Postgres zu vermeiden. Postgres speichert nur Daten mit niedriger Kardinalität, wie z.B. Anwendungs-Einstellungen, Plattform-Zertifikat-Metadaten, Kampagnenvorschläge, Schedules und Aggregat-Kampagnen-Records. Aktive Gerätestände und Benachrichtigungsereignisse sind nur in Analytics Engine-Rows als append-only verfügbar.

Was Capgo Speichert

Daten	Wo es sich befindet	Warum
Plattformkreditmetadaten	Capgo Postgres	Benötigt zum Verwalten der App-Einrichtung und -Berechtigungen.
Private Plattformgeheimnisse	Arbeitsumgebung	Vermeidet die Speicherung von privaten Anmeldeinformationen in Kundenfazit-Tabellen.
Kampagnenvorschläge und -einstellungen	Capgo Postgres	Niedrigkardinalitätige Steuerungsebene-Daten.
Aktivierter Geräte-Registrierungsstatus	Cloudflare Analytics-Engine	Billiger Anhang für eine aktive Gerätedatenbank.
Benachrichtigungsereignisse	Cloudflare Analytics-Engine	Cheap stats for queued, sent, received, opened, failed, and background events.

Identitätsmodell

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

• Ihr Backend kennt die echte Kundenbenutzer-ID.
• Ihr Backend fragt Capgo nach einem kurzlebigen identityProof.
• Die App registriert sich mit externalId und diesem Nachweis nach Ihrem eigenen Benutzerauthentifizierungsprozess.
• Capgo generiert deterministische interne Schlüssel für den Empfänger und die native Installation.
• Senden an denselben externalId findet die Geräte des Benutzers erneut.

Das ermöglicht es, die Geräte eines Benutzers zu recherchieren, Benachrichtigungs-Labels zu setzen und Benachrichtigungs-Kampagnen ohne Speicherung von Benachrichtigungszeilen pro Gerät in Capgo Postgres anzuziehen.

Kernfunktionen

• Registrieren Sie Geräte mit einem authentifizierten externen Benutzer-ID.
• Aktualisieren Sie Tags, Attribute, Zustimmung und Token-Zustand bei App-Start oder Token-Änderungen.
• Empfangen Sie Benachrichtigungen im Vordergrund in JavaScript.
• Benachrichtigungen verfolgen und geöffnete Ereignisse.
• Behandeln Sie Hintergrund-Daten-Benachrichtigungen.
• Setzen, löschen und erhöhen Sie die App-Badges.
• Benachrichtigungen erstellen.
• Ermittle benutzerdefinierte Benachrichtigungen, Kampagnenbenachrichtigungen, Badge-Updates und stille Aktualisierungsprüfungen.
• Trigger @capgo/capacitor-updater aus einer stummen Benachrichtigung.

Statistiken

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

Statistiken sind operative Signale, keine dauerhafte Empfängerliste. Die Analytics Engine-Retention bedeutet, dass aktive Geräte ihre Registrierung regelmäßig aktualisieren müssen.

Öffentliche API

Methode	Beschreibung
configure	Setzt die Capgo-App-ID, API-Host und die Verhaltensweise des Updaters.
register	Registriert die aktuelle Installation für einen externen Kundenbenutzer.
setExternalId	Ändert den externen Kundenbenutzer nach Anmeldung oder Account-Wechsel.
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	Schreibt einen empfangenen Ereignis manuell.
trackOpened	Schreibt ein geöffnetes Ereignis manuell.
addListener('notificationReceived')	Ausgelöst, wenn eine Benachrichtigung empfangen wird, während JavaScript aktiv ist.
addListener('notificationOpened')	Ausgelöst, wenn ein Benutzer eine Benachrichtigung öffnet.
addListener('backgroundNotification')	Wird für Hintergrunddatenbenachrichtigungen ausgelöst und enthält finish().
addListener('registrationChanged')	Wird ausgelöst, wenn sich der native Push-Token ändert.

Liefergarantien

Native Push ist mindestens einmalig. Eine Kampagne kann wiederholt werden und ein Gerät kann eine Duplikat erhalten, wenn das Betriebssystem eine wiederholte Nachricht akzeptiert. Verwenden Sie Collapse-IDs für Aktualisierungsprüfungen und machen Hintergrundarbeiten idempotent.

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

Weitermachen von @capgo/capacitor-Benachrichtigungen

Wenn Sie @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Benachrichtigungen @capgo/capacitor-Benachrichtigungen um Push-Benachrichtigungen zu planen, verbinden Sie es mit Getting Started for setup, Fehlersuche für die Fehlerbehebung Der @capgo/capacitor-Updater für stille Aktualisierungsprüfungen und Capgo-Plugin-Verzeichnis für andere native Plugins.