@capgo/capacitor-通知

Capgo-管理的原生通知，用于营销活动、徽章、用户查找、送达统计和静默实时更新检查。

概述

@capgo/capacitor-notifications 连接一个 Capacitor 应用到 Capgo 的原生通知管道。您的应用程序在 Capgo 注册一个签名的客户端用户 ID， Capgo 保持最新的活跃设备状态在 Cloudflare 分析引擎中，并且您可以从 Capgo 控制台或 API 发送通知、设置徽章、检查送达统计和触发静默 Capgo 实时更新检查。

该功能旨在避免在 Capgo Postgres 中创建高基数的通知设备表。Postgres 只存储低基数的控制平面数据，如应用设置、平台凭证元数据、营销活动草稿、计划和汇总营销活动记录。活跃设备状态和通知事件是只读的 Analytics Engine 行。

什么 Capgo 存储

数据	存储位置	为什么
平台凭证元数据	Capgo PostgreSQL	用于管理应用程序设置和权限。
私有平台密钥	工作环境	避免将私有凭证存储在客户端表中。
活动设备注册状态	Capgo PostgreSQL	__CAPGO_KEEP_0__ 分析引擎
推广草稿和设置	Cloudflare 分析引擎	廉价的追加写入设备注册表。
通知事件	Cloudflare 分析引擎	廉价的统计信息，包括排队、发送、接收、打开、失败和后台事件。

身份模型

Capgo 不要求您上传用户列表或维护设备表。

您的后端知道真正的客户用户 ID。
您的后端要求 Capgo 一个短期的 identityProof.
应用程序注册到 externalId 并且证明在您的用户身份验证成功后。
Capgo 为接收者和本机安装生成确定性的内部密钥。
向同一设备发送 externalId 会再次找到用户的活跃设备。

这使您可以在不在Capgo Postgres 中存储每个设备通知行的情况下查找用户的设备、设置徽章和目标通知活动。

核心功能

使用已验证的外部用户 ID 注册设备。
在应用启动或令牌更改时刷新标签、属性、同意和令牌状态。
在 JavaScript 中接收前台通知。
跟踪接收和打开通知事件。
处理后台数据通知。
设置、清除和增加应用徽章。
创建 Android 通知频道。
发送一次性通知、营销通知、徽章更新和静默更新检查。
触发 @capgo/capacitor-updater 从静默通知

统计

Capgo将通知事件写入Cloudflare分析引擎，以便仪表板统计保持低廉：

queued
sent
provider_accepted
received
opened
failed
permission_changed
background_started
background_finished

统计是操作信号，而不是永久的每个接收者账本。分析引擎的保留意味着活动设备必须定期刷新注册。

公共API

描述	Description
`configure`	Sets the Capgo app ID, API host, and updater integration behavior.
`register`	注册当前安装为外部客户用户 ID。
`setExternalId`	登录或切换账户后修改外部客户用户 ID。
`setTags`	替换用于目标受众的标签。
`setBadge`	设置原生应用徽章。
`clearBadge`	清除原生应用徽章。
`incrementBadge`	增加原生应用徽章。
`enableUpdaterIntegration`	通过静默方式启用更新检查处理。 `@capgo/capacitor-updater`.
`runUpdateCheck`	手动运行更新器集成进行测试。
`trackReceived`	手动写入接收到的事件。
`trackOpened`	手动写入打开的事件。
`addListener('notificationReceived')`	当 JavaScript 活跃时接收到通知时触发。
`addListener('notificationOpened')`	当用户打开通知时触发。
`addListener('backgroundNotification')`	在后台数据通知中触发并暴露 `finish()`.
`addListener('registrationChanged')`	当原生推送令牌发生变化时触发

交付保证

原生推送至少一次。一个营销活动可以重试，设备可以接收重复的消息，如果平台接受重复的消息。使用折叠 ID 进行更新检查并使后台工作幂等

iOS 后台通知是尽力而为的。操作系统可以根据电池、用户行为、强制退出状态和系统政策来限制或跳过后台执行。不要依赖静默通知来实现硬性截止日期

继续从 @capgo/capacitor-notifications

如果您正在使用 @capgo/capacitor-通知 来规划推送消息，连接它到开始使用为设置调试为故障排除 @capgo/capacitor-更新器为静默更新检查 Capgo 插件目录其他本机插件