メインコンテンツへスキップ
このページは、1つの実在アプリを最初から最後まで追うサンプルアプリ:OneSignalの完全な統合の一部です。アプリはClean Beansという共同生活の家のための掃除当番表アプリで、Expo(React Native)とSupabaseバックエンドで構築されています。 通知は、タップしたときに正しい場所へ移動できて初めて役に立ちます。Clean Beansは、アプリに入る4つの経路を処理します。プッシュのタップ、プッシュ上のボタンのタップ、カスタムスキームのリンク、通常のWebリンクです。

タップされたプッシュを振り分ける \

すべてのプッシュにはdata.typeフィールドがあります。アプリはタップを検知し、種類を読み取り、対応する画面を開きます。
app/_layout.tsx
このうち2つの種類は、このガイドでは扱わないJourneysから送られます。reengagementは、ダッシュボードで作成した休眠ユーザー復帰用Journeyのプッシュに設定されます。member_lapsedは世帯のオーナーと管理者向けのプッシュで、メンバーが掃除をやめたことをそのJourneyが報告したときにバックエンドが送信します。これらもほかのプッシュと同様にここで振り分けられます。
自分で管理する種類で振り分けるほうが、URLを解析するよりも堅牢です。画面が移動しても、switch文を1つ変更するだけで、変更前に送信したすべてのプッシュも正しく開きます。

アクションボタン:タップできる場所を増やす \

プッシュにはボタンを付けられます。タスクのプッシュにはStart cleaningとSnooze 1h、「同居人が掃除を終えた」プッシュにはSend kudosがあります。ボタンは通知を展開すると表示されます。iOSでは長押しです。
Start cleaningとSnooze 1hのボタンがある展開されたプッシュ通知

2つのアクションボタンがある展開されたリマインダー。

バックエンドがボタンをリクエストに追加します。各ボタンにはidとラベルがあります。
supabase/functions/_shared/buttons.ts
ボタンをタップするとアプリが開き、上記のクリックリスナーがボタンのidをevent.result.actionIdとして受け取ります。通知そのもののタップにはactionIdがありません。アプリはまずボタンかどうかを確認し、そうでなければ通常の振り分けを行います。
src/lib/pushActions.ts
アプリはプッシュを送信できないため、スヌーズにはバックエンドが必要です。アプリはsend_afterで次のリマインダーをスケジュールする関数を呼び出します。OneSignalがその時刻までメッセージを保持するため、1時間何かを動かし続ける必要はありません。
supabase/functions/snooze-reminder/index.ts
ボタンのタップはすべて、カスタムイベントpush_action_clickedとしても記録されます。Journeyはボタンで直接分岐できませんが、このイベントを待機し、action_idプロパティで分岐できます。
ボタンをタップすると、デフォルトでアプリが開きます。アプリを開かずにタップを処理するには、ネイティブコードが必要です。iOSでは通知カテゴリ、Androidではnotification service extensionです。
アプリ外からのリンクは/cleanのような短いパスを使います。Expo Routerのnative intentフックがナビゲーション前にこれをアプリの実際のルートに書き換えるため、アプリ外のものは画面の構成を知る必要がありません。
app/+native-intent.tsx
cleaning-rota://のようなカスタムスキームはアプリがインストールされている場合にしか機能せず、多くのアプリはそれをタップ可能にしません。iOSのUniversal LinksとAndroidのApp Linksがこれを解決します。これらは通常のhttps://リンクで、アプリがインストールされていればアプリを、そうでなければWebサイトを開きます。そのため、メール、SMS、共有メッセージ内のリンクに適しています。 設定には双方での宣言が必要です。アプリは自分が属するドメインを宣言し、Webサイトはどのアプリがそのリンクを開けるかを宣言します。
1

アプリでドメインを宣言する

app.json
2

Appleの関連付けファイルを公開する

/.well-known/apple-app-site-associationに、HTTPSで、JSONとして配信してください。アプリIDは、Apple Team IDの後にバンドルIDを続けたものです。
website/.well-known/apple-app-site-association
3

Androidの関連付けファイルを公開する

/.well-known/assetlinks.jsonに配置してください。フィンガープリントはアプリの署名証明書から取得します。EASではeas credentials -p androidを実行すると確認できます。
website/.well-known/assetlinks.json
4

リンクを使う

世帯画面は招待リンクを共有します。リンクをタップすると、コードが入力済みの状態で参加画面が開きます。
app/household.tsx
app/join-household.tsx
Clean Beansは、アプリで表示できるパスだけを対象にしています。ホームページは対象外のため、マーケティングサイトは引き続きブラウザで開きます。iOSはアプリのインストール時または更新時に関連付けファイルを読み込むため、ビルドをリリースする前にファイルを公開してください。

ディープリンク

各プラットフォームでOneSignalがURLを処理する方法。

通知ペイロード

クリックリスナーで使用できるすべてのフィールド。

アクションボタン

プラットフォームの制限、アイコン、タップの処理。