メインコンテンツにスキップ
Capgo - Capacitor アプリ向けライブアップデート Capgo

@capgo/capacitor-通知

Capgoによるキャンペーン、バッジ、ユーザー検索、配信統計、静音ライブアップデートチェックのためのネイティブ通知の管理
はじめに デバッグ設定

概要

__CAPGO_KEEP_0__

@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.

What Capgo Stores

Section titled “What Capgo Stores”
データデータがどこに格納されているかなぜ
プラットフォームクレデンシャルメタデータCapgo Postgresアプリのセットアップとパーミッションの管理が必要です。
プライベートプラットフォームシークレットワーカー環境顧客向けのテーブルにプライベートクレデンシャルを保存しないようにします。
キャンペーンの草案と設定Capgo Postgres低カードinalityの制御プレーンデータ
有効なデバイスの登録状態Cloudflare アナリティクス エンジン有効なデバイスのレジストリ
__CAPGO_KEEP_0__ アナリティクス エンジンCloudflare Analytics Engineアイデンティティモデル

セクション「アイデンティティモデル」

キャンペーンの草案と設定

Capgoはユーザーの一覧をアップロードする必要も、デバイスのテーブルを維持する必要もありません。

  • あなたのバックエンドは、実際の顧客ユーザーIDを知っています。
  • あなたのバックエンドはCapgoに短期間の identityProof.
  • アプリは自身のユーザー認証が成功した後、 externalId __CAPGO_KEEP_0__は受信者の内部キーとネイティブインストールの内部キーを決定論的に導出します。
  • Capgo derives deterministic internal keys for the recipient and the native install.
  • ユーザーのアクティブデバイスを再度見つけることができます。 externalId これにより、__CAPGO_KEEP_0__ Postgresにデバイスごとの通知行を保存する必要がなくなるため、ユーザーのデバイスを検索する、バッジを設定する、通知キャンペーンをターゲットにすることができます。

This lets you look up a user’s devices, set badges, and target notification campaigns without storing per-device notification rows in Capgo Postgres.

「Core Capabilities」のセクション

認証済み外部ユーザーIDでデバイスを登録する
  • __CAPGO_KEEP_0__
  • アプリ起動またはトークン変更時にタグ、属性、同意、トークン状態を更新します。
  • JavaScriptでフロントエンド通知を受け取ります。
  • 通知を受け取ったと開いたイベントを追跡します。
  • バックグラウンドデータ通知を処理します。
  • アプリバッジを設定、クリア、インクリメントします。
  • Android通知チャンネルを作成します。
  • 一時的な通知、キャンペーン通知、バッジ更新、静音の更新チェックを送信します。
  • 静音通知からトリガーします。 @capgo/capacitor-updater __CAPGO_KEEP_0__は__CAPGO_KEEP_1__Analyticsエンジンに通知イベントを書きます。ダッシュボードの統計が安いようにします。

統計

「統計」セクション

Capgo Cloudflare

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

統計値は、受信者ごとの永続的なレコードではありません。分析エンジンの保持期間は、有効なデバイスが定期的に登録を更新する必要があります。

パブリック API

セクション "パブリック API"
メソッド説明
configureCapgo アプリ 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を使用して更新チェックを行い、バックグラウンドワークを無害化してください。

Capgoから続けて@capgo/capacitor-notifications

Capgoから続けて@capgo/capacitor-notifications

Capgoを利用している場合 Capgoから続けて@capgo/capacitor-notifications プッシュメッセージの計画に@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-notificationsを使用している場合 はじめに 設定のために トラブルシューティングのために Capgoから続けて@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-updater @capgo/capacitor-updater プラグインディレクトリ__CAPGO_KEEP_0__ Capgo {"targetLanguage":"Japanese","pagePath":"/ja/docs/plugins/notifications/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"他のネイティブ プラグインについても"},{"text":"ページを編集する"}]}