@capgo/capacitor-Benachrichtigungen

Übersicht

@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, die 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 hochkardinalische Benachrichtigungsgeräte-Tabelle in Capgo Postgres zu vermeiden. Postgres speichert nur niederkardinalische Steuerflächen-Daten wie Anwendungseinstellungen, Plattform-Zertifikats-Metadaten, 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-Zertifikats-Metadaten	Capgo Postgres	Benötigt, um die Anwendungseinstellungen und Berechtigungen zu verwalten.
Private Plattformgeheimnisse	Arbeitsumgebung	Auf Kosten von Privatsphäre speichert keine Kundenfazilitäten.
Kampagnenvorschläge und -einstellungen	Capgo Postgres	Niedrigkardinalität für die Steuerungsebene.
Aktivierter Geräte-Registrierungsstatus	Cloudflare Analytics Engine	Billiger, nur für aktive Geräte erforderlicher Speicher.
Benachrichtigungsereignisse	Cloudflare Analytics Engine	Billige Statistiken für in der Warteschleife, 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.

• Ihr Backend kennt die echte Kundenbenutzer-ID.
• Ihr Backend fragt Capgo nach einem kurzlebigen identityProof.
• Die App registriert sich mit externalId und diese Bestätigung nach Ihrem 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 aufzufinden, Benachrichtigungen zu setzen und Benachrichtigungs-Kampagnen ohne die Speicherung von pro-Geräte-Benachrichtigungszeilen in Capgo Postgres zu targeten.

Kernfunktionen

• Geräte registrieren mit einer authentifizierten externen Benutzer-ID.
• Tags, Attribute, Zustimmung und Token-Zustand aktualisieren Sie auf Anwendungsstart oder Token-Änderungen.
• Vordergrundbenachrichtigungen in JavaScript empfangen.
• Benachrichtigungs-Ereignisse und -Öffnungen verfolgen.
• Hintergrund-Daten-Benachrichtigungen verarbeiten.
• App-Badges setzen, löschen und erhöhen.
• Android-Benachrichtigungs-Kanäle erstellen.
• Einzelfachbenachrichtigungen, Kampagnenbenachrichtigungen, Badge-Updates und stille Aktualisierungsprüfungen senden.
• Trigger @capgo/capacitor-updater aus einer stummen Benachrichtigung.

Statistik

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

Statistiken sind Betriebsanzeichen, keine dauerhafte Rechnung pro Empfänger. 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 Benutzerwechsel.
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	Ermöglicht stille Update-Überprüfungen durch @capgo/capacitor-updater.
runUpdateCheck	Läuft die Updater-Integration manuell für Testzwecke 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 der native Push-Token sich ä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 Hintergrund-Arbeit idempotent.

iOS-Hintergrund-Benachrichtigungen sind bestmöglich. Das Betriebssystem kann Hintergrund-Ausführung basierend auf Batterie, Benutzerverhalten, Zwangsschließen-Zustand und Systemrichtlinie einschränken. Verlassen Sie sich nicht auf stille Benachrichtigungen für feste Fristen.

Weitermachen von @capgo/capacitor-Benachrichtigungen

Wenn Sie Benachrichtigungen verwenden @capgo/capacitor-notifications um Push-Nachrichten zu planen, verbinden Sie sie mit Einstieg für die Einrichtung Fehlersuche für die Fehlerbehebung @capgo/capacitor-updater für stille Aktualisierungsprüfungen und Capgo-Plugin-Verzeichnis {"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"}]}