@capgo/capacitor-notifications

Debug-Konfiguration

@capgo/capacitor-notifications verbindet eine Capacitor-Anwendung mit Capgo’s nativer Benachrichtigungs-Pipeline. Ihre Anwendung registriert einen signierten Kunden-User-Id bei Capgo, Capgo hält die neuesten aktiven Gerätestä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 vom Capgo-Dashboard 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. Anwendungseinstellungen, Plattform-Zugriffsmetadaten, Kampagnenvorschläge, Schedules und aggregierte Kampagnen-Records. Aktive Gerätestände und Benachrichtigungsereignisse sind nur in Analytics Engine-Rows hinzufügbare Daten.

Wie Capgo speichert

Daten	Wo sie leben	Warum
Plattform-Zugriffsmetadaten	Capgo Postgres	Werden benötigt, um die Anwendungskonfiguration und die Berechtigungen zu verwalten.
Private Plattformgeheimnisse	Arbeitsumgebung	Auf private Zugangsdaten in Kundenfazentabellen speichern.
Werbekampagnen und Einstellungen	Capgo Postgres	Niederkardinalität-Kontrollflugdaten.
Aktivierter Geräte-Registrierungsstatus	Cloudflare Analytics Engine	Billiger Anhang-für-aktive-Geräte-Verzeichnis.
Benachrichtigungsereignisse	Cloudflare Analytics Engine	Billige Statistiken für in der Warteschlange, gesendete, empfangene, geöffnete, fehlgeschlagene und Hintergrundereignisse.

Identitätsmodell

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

• Der Backend-Server kennt die echte Kundenbenutzer-ID.
• Der Backend-Server fragt Capgo nach einer kurzlebigen identityProof.
• Die App registriert sich mit externalId und diese Bestätigung nach dem eigenen Benutzerauthentifizierungsprozess.
• Capgo berechnet deterministische interne Schlüssel für den Empfänger und die native Installation.
• Senden Sie zu demselben externalId findet die Geräte des Benutzers wieder.

Dies ermöglicht es Ihnen, die Geräte eines Benutzers zu finden, Benachrichtigungen zu setzen und Benachrichtigungs-Kampagnen ohne die Speicherung von pro-Geräte-Benachrichtigungszeilen in Capgo Postgres zu erstellen.

Grundlegende Funktionen

• Geräte mit einer authentifizierten externen Benutzer-ID registrieren.
• Tags, Attribute, Zustimmung und Token-Zustand aktualisieren Sie auf App-Start oder Token-Änderungen.
• Vordergrundbenachrichtigungen in JavaScript empfangen.
• Benachrichtigungen erhalten und geöffneten Ereignisse verfolgen.
• Hintergrund-Daten-Benachrichtigungen verarbeiten.
• App-Badges setzen, löschen und erhöhen.
• Android-Benachrichtigungs-Kanäle erstellen.
• Eine-Betracht-Benachrichtigungen, Kampagnen-Benachrichtigungen, Badge-Updates und stille Aktualisierungsprüfungen senden.
• 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 Betriebsanzeichen, keine dauerhafte Rechnung pro Empfänger. Die Analytics Engine-Retentionszeit 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 Benutzerswitch.
setTags	Ersetzt die verwendeten Tags für die Zielgruppenzielung.
setBadge	Setzt das native App-Badge.
clearBadge	Löscht das native App-Badge.
incrementBadge	Inkrementiert das native App-Badge.
enableUpdaterIntegration	Wird das stille Update-Überprüfungsverhalten aktiviert. @capgo/capacitor-updater.
runUpdateCheck	Für die Testung läuft die Updater-Integration manuell aus.
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 sich der native Push-Token ändert.

Zuverlässigkeit der Lieferung

Der native Push ist mindestens einmalig. Eine Kampagne kann wiederholt werden, und ein Gerät kann eine 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 die Hintergrundausführung aufgrund von Batterie, Benutzerverhalten, Zwangsschließen und Systemrichtlinien einschränken oder überspringen. Verlassen Sie sich nicht auf stille Benachrichtigungen für feste Fristen.

Fortsetzung 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 Starten zur Einrichtung 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"}]}