メインコンテンツにジャンプ
プラグインに戻る
@capgo/capacitor-notifications
チュートリアル
@capgo/capacitor-notifications

通知

Capgoから、iOSとAndroidのネイティブプッシュ通知を送信し、ユーザーロック、バッジ、統計、静的更新チェックを実行します。

ガイド

通知のチュートリアル

@capgo/capacitor-notificationsを使用

Capgoで、ユーザーロック、バッジ、フォアグラウンド/オープン追跡、バックグラウンドコールバック、静的Capgoライブアップデートチェックから、ネイティブiOSおよびAndroidプッシュ通知を送信します。

プラグインはCapgo通知パイプラインに作成されています。CapgoはPostgresにプラットフォーム認証情報メタデータとキャンペーンコントロールデータを、Cloudflare Analytics Engineにアクティブデバイス状態と配信イベントを保存します。

インストール

このパッケージは現在プライベートプレビュー中です。Capgoがnpmアカウントのパッケージアクセスを有効にしないと、インストールが機能しません。

Capgo CLIを使用して、ガイデッドセットアップを行います:

npx @capgo/cli@latest notifications setup com.example.app

手動インストール:

npm install @capgo/capacitor-notifications @capgo/capacitor-updater
npx cap sync

設定

import { CapgoNotifications } from '@capgo/capacitor-notifications'

await CapgoNotifications.configure({
  appId: 'com.example.app',
  autoUpdater: true,
  updateInstallMode: 'next',
})

署名ユーザーを登録

トークンを生成 identityProof バックエンドから POST /notifications/recipients/proof, その後、デバイスを登録するには、自身のログインが成功するまで待つ必要があります。

await CapgoNotifications.register({
  externalId: 'customer-user-123',
  identityProof,
  tags: ['paid'],
  attributes: { plan: 'team' },
  consent: true,
})

イベントを待ち受ける

await CapgoNotifications.addListener('notificationReceived', (notification) => {
  console.log('Received', notification)
})

await CapgoNotifications.addListener('notificationOpened', (event) => {
  console.log('Opened', event.notification.id)
})

await CapgoNotifications.addListener('backgroundNotification', async (event) => {
  try {
    console.log('Background payload', event.notification.data)
  } finally {
    await event.finish()
  }
})

iOS設定

有効 プッシュ通知 および バックグラウンドモード > Remote notifications Xcodeで

リモート通知を前方に送信する ios/App/App/AppDelegate.swift:

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    NotificationCenter.default.post(name: Notification.Name("CapgoNotificationsRemoteNotification"), object: userInfo)
    completionHandler(.newData)
}

Androidセットアップ

実行 npx cap sync androidAndroidプラットフォームの資格情報をCapgoに設定し、Android 13以降で通知許可を要求し、Google Playサービスを搭載したデバイスまたはエミュレータでテストする

デバッグチェックリスト

  • 実行 npx @capgo/cli@latest notifications setup com.example.app __CAPGO_KEEP_0__内のフォルダから capacitor.config.*.
  • Capgo内で顧客IDを外部で検索する
  • デバイスがプラットフォームを確認し、または android 許可が付与されていることを確認する ios 一時的なリスナーを追加する
  • Android 13以降の場合、通知許可を要求する registrationChanged, notificationReceived, notificationOpened、と backgroundNotification.
  • ダッシュボードからテスト通知を送信してください。
  • キュー、送信、受信、開封イベントの統計を確認してください。
  • 静的更新チェックの場合、 @capgo/capacitor-updater インストールされているかどうかを確認してください。 autoUpdater 有効になっているかどうかを確認してください。

フルリファレンス

Using @capgo/capacitor-notificationsから続けてください。

あなたが @capgo/capacitor-notifications を使用している場合、 @capgo/capacitor-notifications と接続して @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-notifications の実装詳細を確認する @capgo/capacitor-updater トラブルシューティング用 @Capgo/__CAPGO_KEEP_1__-updater 静的更新チェック用