@capgo/capacitor-通知

デバッグ設定

@capgo/capacitor-notifications connects a Capacitor app to Capgo’s native notification pipeline. Your app registers a signed customer user ID with Capgo, Capgo keeps the latest active device state in Cloudflare Analytics Engine, and you can send notifications, set badges, inspect delivery stats, and trigger silent Capgo live-update checks from the Capgo dashboard or API.

The feature is designed to avoid a high-cardinality notification device table in Capgo Postgres. Postgres stores only low-cardinality control plane data such as app settings, platform credential metadata, campaign drafts, schedules, and aggregate campaign records. Active device state and notification events are append-only Analytics Engine rows.

何がCapgoに保存されるか

データ	どこに存在するか	なぜ
プラットフォーム資格情報メタデータ	Capgo Postgres	アプリセットアップとパーミッションの管理に必要なものです。
プライベートプラットフォームシークレット	ワーカー環境	プライベートクレデンシャルを顧客向けテーブルに保存するのを避ける
キャンペーンの草案と設定	Capgo Postgres	低カードinalityの制御プレーンデータ
有効なデバイスの登録状態	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

パブリック__CAPGO_KEEP_0__

Public API

Method	概要
configure	CapgoアプリID、APIホスト、更新プログラム統合の動作を設定します。
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')	ネイティブプッシュトークンの変更時に発火します。

配信保証

ネイティブプッシュは少なくとも1回配信されます。キャンペーンは再試行され、デバイスはプラットフォームが繰り返しメッセージを受け入れる場合に重複配信を受け取る可能性があります。更新チェック用にコラプスIDを使用し、バックグラウンドワークをidempotentにします。

iOSバックグラウンド通知はベストエフォートです。OSはバッテリー、ユーザー行動、強制終了状態、システムポリシーに基づいてバックグラウンド実行を抑制またはスキップする可能性があります。静かな通知に依存してハードデッドラインを確保しないでください。

「@capgo/capacitor-通知」から続けてください。

「@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-通知」 @capgo/capacitor-通知 プッシュ メッセージングの計画に、接続する はじめに 設定のため デバッグ トラブルシューティングのため @capgo/capacitor-アップデーター 静的更新チェック、そして Capgo プラグイン ディレクトリ その他のネイティブ プラグインのため