@capgo/capacitor-Benachrichtigungen

Übersicht

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

Die Funktion ist dazu konzipiert, eine Benachrichtigungsgeräte-Tabelle mit hoher Kardinalität in Capgo Postgres zu vermeiden. Postgres speichert nur Daten mit niedriger Kardinalität, wie z.B. Anwendungs-Einstellungen, Plattform-Zertifikats-Metadaten, Kampagnenvorschläge, Schedules und aggregierte Kampagnen-Records. Aktive Gerätezustände und Benachrichtigungsereignisse sind nur in Analytics Engine-Rows hinzufügbare Daten.

Was Capgo speichert

Daten	Wo sie leben	Warum
Plattform-Zertifikats-Metadaten	Capgo Postgres	Notwendig zum Verwalten der Anwendungs-Einstellungen und -Berechtigungen.
Private Plattform-Geheimnisse	Arbeitsumgebung	Auf private Zugangsdaten in Kundentabellen speichern.
Werbekampagnen und -einstellungen	Capgo Postgres	Niedrigkardinalität für die Steuerungsebene.
Status der aktiven Geräteanmeldung	Cloudflare Analytics Engine	Billiger Anhang für 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 verlangt nicht, dass Sie eine Liste von Benutzern hochladen oder eine Geräte-Tabelle pflegen.

• Ihr Backend kennt die echte Kunden-Benutzer-ID.
• Ihr Backend fragt Capgo nach einem kurzlebigen identityProof.
• Die App registriert sich mit externalId und diese Bestätigung nach Ihrem eigenen Benutzer-Authentifizierungsprozess.
• Capgo berechnet deterministische interne Schlüssel für den Empfänger und die native Installation.
• Sende zu den gleichen externalId findet die Geräte des Benutzers wieder.

Dies ermöglicht es Ihnen, die Geräte eines Benutzers zu finden, Badges zu setzen und Benachrichtigungs-Kampagnen zu targeten, ohne pro-Gerät-Benachrichtigungszeilen in Capgo Postgres zu speichern.

Kernfunktionen

• Registriere Geräte mit einer authentifizierten externen Benutzer-ID.
• Aktualisieren Sie Tags, Attribute, Zustimmung und Token-Zustand bei der App-Start oder Token-Änderung.
• Empfangen Sie Vordergrundbenachrichtigungen in JavaScript.
• Verfolgen Sie die Empfangs- und Öffnungsereignisse von Benachrichtigungen.
• Verarbeiten Sie Hintergrunddatenbenachrichtigungen.
• Setzen, löschen und erhöhen Sie die App-Badges.
• Erstellen Sie Android-Benachrichtigungs-Kanäle.
• Senden Sie eine Benachrichtigung, Kampagnenbenachrichtigungen, Badge-Updates und stille Update-Überprüfungen.
• Auslösen @capgo/capacitor-updater aus einer stummen Benachrichtigung.

Statistik

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 Betriebsanzeichen, keine dauerhafte Empfängerliste. Die Analytics Engine-Retention bedeutet, dass aktive Geräte die Registrierung regelmäßig aktualisieren müssen.

Public API

Methode	Beschreibung
configure	Setzt die Capgo-App-ID, die API-Host und das Updater-Integration-Verhalten.
register	Registriert die aktuelle Installation für einen externen Kundenbenutzer.
setExternalId	Ändert den externen Kundenbenutzer nach Anmeldung oder Account-Wechsel.
setTags	Ersetzt die Tags, die für die Zielgruppenzielung verwendet werden.
setBadge	Setzt das native App-Badge.
clearBadge	Löscht das native App-Badge.
incrementBadge	Inkrementiert das native App-Badge.
enableUpdaterIntegration	Aktiviert stilles Update-Überprüfungsverhalten durch @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')	Ausgelöst für Hintergrund-Daten-Benachrichtigungen und enthüllt finish().
addListener('registrationChanged')	Ausgelöst, wenn der native Push-Token geändert wird.

Liefergarantien

Native Push ist mindestens einmal. Eine Kampagne kann wiederholt werden, und ein Gerät kann ein Duplikat erhalten, wenn das Betriebssystem einen wiederholten Nachrichtenempfang 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. Verlassen Sie sich nicht auf stille Benachrichtigungen für feste Fristen.

Fortsetzen von @capgo/capacitor-Benachrichtigungen

Wenn Sie @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Benachrichtigungen verwenden @capgo/capacitor-Benachrichtigungen um Push-Nachrichten zu planen, verbinden Sie es mit Anleitung zum Einrichten zur Fehlerbehebung zur Fehlersuche @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Updater @capgo/capacitor-updater __CAPGO_KEEP_0__ Plugin-Verzeichnis Capgo {"targetLanguage":"German","pagePath":"/de/docs/plugins/notifications/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"für andere native Plugins."},{"text":"Seite bearbeiten"}]}