タップされたプッシュを振り分ける \
すべてのプッシュにはdata.typeフィールドがあります。アプリはタップを検知し、種類を読み取り、対応する画面を開きます。
app/_layout.tsx
このうち2つの種類は、このガイドでは扱わないJourneysから送られます。
reengagementは、ダッシュボードで作成した休眠ユーザー復帰用Journeyのプッシュに設定されます。member_lapsedは世帯のオーナーと管理者向けのプッシュで、メンバーが掃除をやめたことをそのJourneyが報告したときにバックエンドが送信します。これらもほかのプッシュと同様にここで振り分けられます。
アクションボタン:タップできる場所を増やす \
プッシュにはボタンを付けられます。タスクのプッシュにはStart cleaningとSnooze 1h、「同居人が掃除を終えた」プッシュにはSend kudosがあります。ボタンは通知を展開すると表示されます。iOSでは長押しです。
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
通常のWebリンクからアプリを開く \
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を処理する方法。
通知ペイロード
クリックリスナーで使用できるすべてのフィールド。
アクションボタン
プラットフォームの制限、アイコン、タップの処理。