メインコンテンツへスキップ
このページは、1つの実在アプリを最初から最後まで追うサンプルアプリ:OneSignalの完全な統合の一部です。アプリはClean Beansという共同生活の家のための掃除当番表アプリで、Expo(React Native)とSupabaseバックエンドで構築されています。 プッシュを届けることは最初の一歩にすぎません。このページでは、プッシュを信頼できるものにする細かな判断を扱います。同じプッシュを二度送らないこと、古くなったプッシュを期限切れにすること、そして種類ごとにふさわしい動作をさせることです。

同じリマインダーを二度送らない \

スケジュールされたジョブは再試行されます。誤って2回実行されることもあります。対策がなければ、繰り返すたびにプッシュがもう1通送られます。 OneSignalのidempotency_keyがこれを解決します。2つのリクエストが同じキーを持つ場合、2つ目は送信されません。キーはUUIDである必要があり、OneSignalは30日間記憶します。 スケジュールされた関数には、実行間でランダムなキーを保持する場所がありません。そこでClean Beansは、送信の内容、つまり種類、受信者、日付からキーを導き出します。同じ送信からは常に同じキーが生成されます。
supabase/functions/_shared/idempotency.ts
バッチ送信では、キーはバッチ全体を対象とします。
supabase/functions/send-cleaning-reminder/index.ts
べき等キーはCreate messageとCreate custom eventsのエンドポイントで機能します。Live Activityのリクエストでは受け付けられません。Live Activityはactivity_idで識別されます。

プッシュの種類ごとに固有の動作を与える \

2時間遅れて届く掃除リマインダーは、届かないよりも悪い結果になります。Kudosはうれしいものですが、急ぎではありません。Clean Beansはこうした違いを一連の配信プロファイルとして一度だけ定義し、各リクエストに適切なものを展開します。
supabase/functions/_shared/delivery.ts
種類一覧にあるmember_lapsedプロファイルは、Journey Webhookから送信されるプッシュ用のもので、このガイドでは扱いません。 各設定の役割:
  • ttl は、オフラインのデバイス向けにプッシュを保持する期間です。掃除リマインダーは「1時間後」と伝えるため、1時間後に破棄されます。
  • thread_id と android_group は、関連するプッシュを通知一覧でまとめます。
  • ios_interruption_level は、プッシュがどれだけ強く知らせるかを制御します。time_sensitiveは集中モードを突破できます。passiveは音を鳴らさずに届きます。
  • ios_relevance_score は、iOSの通知要約でのプッシュの順位を決めます。Clean Beansは1.0を重大なメッセージ用に取っておき、そうしたメッセージは送信していません。
アプリの設定。 iOSは、アプリがcapabilityを宣言している場合にのみtime_sensitiveを適用します。
app.json
得られた教訓:collapse_id。 Clean Beansは当初、リマインダーがダイジェストを置き換えるように、ダイジェストと期限切れリマインダーに同じcollapse_idを設定していました。iOSでは、通知一覧にまだ残っているプッシュを置き換えるプッシュは、バナーも音もなくその場で差し替えられます。リマインダーが気付かれず目的を果たせなかったため、この設定は削除しました。collapse_idは、試合のスコアのように静かな更新が必要な場合にだけ使ってください。

アプリアイコンに件数を表示する \

2つのタスクのプッシュは、アプリアイコンのバッジをタイトルの数に設定します。
supabase/functions/send-overdue-reminders/index.ts
バッジの数字が付いたClean Beansのアプリアイコン

アプリアイコンのバッジに期限切れのタスク数が表示されます。

バッジは未読通知の数ではなくタスクの数なので、IncreaseではなくSetToを使っています。午後のリマインダーは朝の数を置き換えます。
OneSignal SDKはアプリが開かれるたびにバッジを自動的に消去するため、アプリ側でリセットするコードは不要です。アプリが開いている間に届いたプッシュのバッジは表示されません。Androidには、APIで設定できる数値バッジはありません。

べき等なリクエスト

キーの仕組みと保持期間。

割り込みレベル

集中モードと4つのレベル。

バッジ

各プラットフォームでのバッジの動作。