@capgo/capacitor-notifications

Présentation

@capgo/capacitor-notifications connecte une application Capacitor à la file d'attente de notifications native de Capgo. Votre application enregistre un ID d'utilisateur client signé avec Capgo, Capgo conserve l'état de l'appareil actif le plus récent dans l'Cloudflare Engine de données Analytics, et vous pouvez envoyer des notifications, définir des badges, inspecter les statistiques de livraison et déclencher des vérifications silencieuses de mise à jour en direct Capgo à partir de la Capgo table de bord ou API.

Le fonctionnement est conçu pour éviter une table de dispositifs de notification à haute cardinalité dans Capgo Postgres. Postgres stocke uniquement des données de plan de contrôl’à faible cardinalité telles que les paramètres d'application, les métadonnées de métadonnées de plateforme, les brouillons de campagne, les calendriers et les enregistrements de campagne agrégés. L'état de l'appareil actif et les événements de notification sont des lignes Analytics Engine à ajout unique.

Quels sont les Capgo stockés ?

Les données	Où elles vivent	Pourquoi
Métadonnées de métadonnées de plateforme	Capgo Postgres	Nécessaires pour gérer la configuration et les autorisations de l'application.
Les secrets de plateforme privés	Environnement de travail	Évite de stocker des informations de connexion privées dans les tables destinées aux clients.
Conception de campagnes et paramètres	Capgo Postgres	Données de contrôle plan de faible cardinalité.
État d'enregistrement actif du dispositif	Cloudflare Moteur d'analytique	Registre des appareils actifs à faible coût et sans modification.
Événements de notification	Cloudflare Moteur d'analytique	Statistiques abordables pour les événements en attente, envoyés, reçus, ouverts, échoués et en arrière-plan.

Modèle d'identité

Capgo ne vous demande pas de télécharger une liste d'utilisateurs ou de maintenir une table de dispositifs.

• Votre backend connaît l'ID utilisateur client réel.
• Votre backend demande à Capgo une autorisation à court terme identityProof.
• L'application s'inscrit avec externalId et que cette preuve après votre propre authentification utilisateur réussit.
• Capgo dérive des clés internes déterministes pour le destinataire et l'installation native.
• En envoyant à la même externalId retrouve les appareils actifs de l'utilisateur à nouveau.

Cela vous permet de consulter les appareils d'un utilisateur, d'attribuer des badges et de cibler des campagnes de notification sans stocker des lignes de notification par appareil dans Capgo Postgres.

Capacités de base

• Inscrire les appareils avec un ID utilisateur externe authentifié.
• Actualisez les balises, les attributs, le consentement et l'état du jeton lors du démarrage de l'application ou des changements de jeton.
• Recevez des notifications en arrière-plan dans JavaScript.
• Suivez les événements de réception et d'ouverture de notification.
• Gérez les notifications de données en arrière-plan.
• Configurez, supprimez et incrémentez les icônes de l'application.
• Créez des canaux de notification Android.
• Envoyez des notifications uniques, des notifications de campagne, des mises à jour d'icônes et des vérifications de mise à jour silencieuses.
• Déclenchez @capgo/capacitor-updater à partir d'une notification silencieuse.

Section intitulée « Stats »

Capgo Cloudflare

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

Les statistiques sont des signaux d'état opérationnels, et non un registre permanent par destinataire.

Public API

Méthode	Description
configure	Configure les identifiants d'application Capgo, l'hôte API et le comportement d'intégration de mise à jour.
register	Enregistre l'installation actuelle pour un ID d'utilisateur client externe.
setExternalId	Modifie l'ID d'utilisateur client externe après connexion ou changement de compte.
setTags	Remplace les balises utilisées pour la ciblage de l'audience.
setBadge	Configure l'icône de la notification native.
clearBadge	Supprime l'icône de la notification native.
incrementBadge	Augmente l'icône de la notification native.
enableUpdaterIntegration	Active la gestion silencieuse de la vérification des mises à jour. @capgo/capacitor-updater.
runUpdateCheck	Exécute manuellement l'intégration de l'actualiseur pour les tests.
trackReceived	Écrit manuellement un événement reçu.
trackOpened	Écrit manuellement un événement ouvert.
addListener('notificationReceived')	Se déclenche lorsqu'une notification est reçue tandis que JavaScript est actif.
addListener('notificationOpened')	Se déclenche lorsqu'un utilisateur ouvre une notification.
addListener('backgroundNotification')	Se déclenche pour les notifications de données en arrière-plan et expose finish().
addListener('registrationChanged')	Se déclenche lorsqu'un utilisateur ouvre une notification.

Garanties de livraison

Le push natif est au moins une fois. Une campagne peut être réessayée, et un appareil peut recevoir une copie si le système accepte un message répété. Utilisez les IDs de collapsage pour les vérifications de mise à jour et rends les tâches en arrière-plan idempotentes.

Les notifications en arrière-plan iOS sont de meilleure qualité. Le système peut limiter ou ignorer l'exécution en arrière-plan en fonction de la batterie, du comportement de l'utilisateur, de l'état de force-quit et de la politique du système. N'ayez pas confiance dans les notifications silencieuses pour les délais durs.

Continuez de là à @capgo/capacitor-notifications

Si vous utilisez @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-notifications @capgo/capacitor-notifications pour planifier les messages push, connectez-l’avec Getting Started pour la configuration, Debugging pour le dépannage, @capgo/capacitor-updater pour les vérifications silencieuses de mise à jour, et Capgo Répertoire des plugins {"targetLanguage":"French","pagePath":"/fr/docs/plugins/notifications/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"pour les autres plugins natifs."},{"text":"Éditer la page"}]}