メインコンテンツへスキップ
このページは、1つの実在アプリを最初から最後まで追うサンプルアプリ:OneSignalの完全な統合の一部です。アプリはClean Beansという共同生活の家のための掃除当番表アプリで、Expo(React Native)とSupabaseバックエンドで構築されています。 このガイドのメッセージのほとんどは、バックエンドから1リクエストずつ送信されます。Journeyはそれとは異なります。OneSignalダッシュボードで作成するシーケンスで、誰にいつメッセージを送り、次に何が起こるかを自ら判断します。Clean Beansは、数時間から数日にわたって進行するもの、そしてリリースなしで変更できるようにしたい文面やタイミングにJourneysを使っています。 Clean Beansでは7つのJourneyを運用しています。 最後のJourneyの最後にあるWebhookを除き、どのJourneyにも専用のバックエンドコードはありません。アプリの役割は、Journeysが扱える材料を渡すことです。

アプリがJourneyに渡すもの \

Journeyがある人について把握できるのは、送信したカスタムイベント、その人のタグ、所属するセグメントの3つです。データベースは読み取れません。Journeyが反応すべきものはすべて、これらのいずれかの形で届く必要があります。 セッションイベントについてはタグ、カスタムイベント、Conversion Metricsで説明しています。ほかの2つのイベントは、Journeyを開始するためだけに存在します。 signed_upはアカウントごとに1回だけ発生します。最初にアカウントの作成からの経過時間を確認するため、新しいスマートフォンにアプリをインストールした人が再びオンボーディングされることはありません。
src/lib/onesignalSync.ts
streak_milestoneは連続記録の日数を数値として含むため、メッセージに表示できます。
src/lib/onesignalSync.ts
Journeyを開始するイベントは、OneSignal.login()を呼び出した後にのみ送信してください。ログイン前に送信したイベントは、これからサインインする人ではなく、匿名ユーザーに記録されます。Clean Beansは同じeffect内でlogin()の直後にtrackSignedUpOnce()を呼び出しています。SDKのセットアップとユーザーIDを参照してください。

オンボーディング:目標のあるシーケンス \

オンボーディングJourneyの目的は1つだけで、新しいメンバーに最初の掃除セッションを完了してもらうことです。それが起きた時点で、すべてが止まります。
1

アプリがsigned_upを送信する

メンバーがJourneyに入ります。各メンバーが通過するのは1回だけです。
2

ウェルカムメールとアプリ内ウォークスルーがすぐに送られる

メールには、始めるための3つのステップが記載されています。アプリ内メッセージは、メンバーが次にアプリを開いたときに表示されます。
3

1日目、3日目、6日目に3回のプッシュが続く

それぞれ、メンバー自身のタイムゾーンで10:00から19:00の時間枠を待ちます。
4

セッションが完了すると終了する

Journeyの終了ルールはcleaning_session_completedイベントです。すでにやったことを促されることはありません。
ダッシュボードでの設定。 開始ルールにCustom Event、イベントにsigned_upを指定してJourneyを作成します。終了ルールでは、カスタムイベントが発生したときに終了するよう選択し、cleaning_session_completedを指定します。各プッシュの前にTime Windowステップを置き、03:00に終わる待機が03:00に送信しないようにします。
まず目標を決め、それを終了ルールにしてください。目標のないシーケンスは、求めたことをすでに済ませた人にも話しかけ続けます。

セッションリマインダー:あるイベントで開始し、別のイベントでキャンセルする \

掃除セッションを始めたまま終えないと、その作業は記録されません。このJourneyはcleaning_session_startedで開始し、3時間待ってからリマインダーを送ります。終了ルールはcleaning_session_completedなので、セッションを終えるとリマインダーはキャンセルされます。 この開始とキャンセルの組み合わせは、役に立つJourneyとして最もシンプルなものです。同じ形は、放棄されたカート、途中のサインアップフォーム、送信されなかった下書きにも使えます。
時間枠の境界を確認してください。 当初、時間枠は18:00に閉じていました。16:00に始めたセッションは19:00に待機を終え、時間枠が閉じているのを見て、翌朝08:00に”you didn’t finish”と伝えられていました。現在、時間枠は21:00に閉じます。その日のうちにしか意味のないメッセージでは、時間枠が閉じた直後に到達した人がどうなるかを確認してください。

セッション完了:イベントからパーソナライズする \

セッションが終わると、掃除した人に部屋の名前を入れた短い確認が届きます。部屋はタグではありません。Journeyを開始したイベントから取得します。
Push template: Cleaning Session Completed
journey.first_event.propertiesは開始イベントのプロパティを読み取ります。user_name単体はタグを読み取り、defaultフィルターはタグがない人をカバーします。 このJourneyは1ステップだけです。バックエンドからプッシュを送信するで同じセッションを同居人に知らせるプッシュのように、バックエンドから送ることもできました。Journeyにしているのは、ダッシュボードで文面を変更、テスト、停止できるようにするためです。
Event Streamは、Journeyのメッセージを書かれたまま、Liquidを含んだ状態で報告します。Clean Beansの受信箱では、Webhookが展開できるようになるまで{{ journey.first_event.properties.room_name }} cleanedと表示されていました。保存する前にLiquidを展開するを参照してください。

部屋別プロモーション:イベントプロパティで分岐する \

このJourneyは、掃除した部屋に応じて異なるメッセージを送ります。ここでは2つのことを示しています。イベントが起きるまで人を待たせること、そしてそのイベントのプロパティで分岐することです。 メンバーは、過去7日間にアクティブだった人のセグメントから入ります。最初のステップは3つのブランチを持つWait Untilです。各ブランチは、特定のroom_nameを持つcleaning_session_completedを待ちます。 ほかの部屋のセッションはどのブランチにも一致せず、メンバーは待ち続けます。30分後の再入場が許可されているため、Journeyは新しいセッションのたびに反応します。
このJourneyのプッシュは、架空の掃除用品を宣伝しています。パターンを示すためのものです。これらはアプリの通知設定でカバーされないマーケティングメッセージでもあり、実際のアプリでは設計時に考慮が必要です。Journeysから見えないものを参照してください。

連続記録マイルストーン:数値を持つイベント \

連続記録がマイルストーンに達したかどうかはアプリが判断します。新しい連続記録を保存したばかりだからです。アプリが日数とともにstreak_milestoneを送り、残りはJourneyが行います。
Push template: Streak - Milestone reached
2つのJourney、同じ瞬間。 マイルストーンは必ずセッションの終わりに発生し、これはセッション完了Journeyが送信するタイミングでもあります。1分の待機がなければ、2つのプッシュが同時に届きます。複数のJourneyが同じユーザー操作から始まる場合は、並べて確認してください。

連続記録途切れ間近:タイミング、セグメントの確認、文面の変化 \

セッションのない日は、その日の深夜0時に連続記録が途切れます。このJourneyは、その日の夜にメンバーに警告します。7つの中で最も複雑で、各ステップがそれぞれ別の問題を解決しています。 適切な夜に届ける。 警告は、最後のセッションが何時であっても、その翌日の夜に届くべきものです。22時間の待機の後に18:00から22:00の時間枠を置けば、必ずそこに収まります。08:00のセッションは翌日06:00に時間枠ステップに到達し、18:00まで保留されます。23:00のセッションは翌日21:00に到達し、すぐに送信されます。 Journeyから見えない設定を尊重する。 Clean Beansの通知設定には”Streak reminders”スイッチがあり、データベースに保存されています。アプリはこれをタグとして反映します。
src/lib/onesignalSync.ts
このセグメントは、streak_countが1より大きく、streak_remindersがonであることを条件とします。古いビルドのメンバーにはstreak_remindersタグがまったくないため、セグメントから外れ、警告は送られません。 文面を変える。 毎晩同じ文だと、すぐに目に留まらなくなります。Splitステップは、各人を5つのブランチのいずれかにランダムに振り分け、各ブランチには独自のテンプレートがあります。ブランチは入場のたびに選び直されるため、メンバーは夜ごとに異なる文面を目にします。
Clean Beansは、Live Activitiesで説明しているLive Activityとしても連続記録の警告を表示します。Live Activitiesをオンにしているメンバーは両方を受け取ります。プッシュは、AndroidとLive Activitiesをオフにした人をカバーします。

再エンゲージメントとJourney Webhook \

最後のJourneyは、アプリを開かなくなったメンバーを扱います。セグメントだけで開始する唯一のJourneyであり、バックエンドを呼び出す唯一のJourneyです。 30日後の再入場が許可されています。入場は、Journeyの開始後にセグメントに加わった人に限定されています。この制限がないと、Journeyをオンにした日にすでに非アクティブだった全員に、すぐ最初のプッシュが送られます。

シーケンスが終わったらバックエンドに知らせる \

掃除しないまま最後まで到達したメンバーは、4通のメッセージに反応していません。5通目が役立つ可能性は低いでしょう。代わりにClean Beansは世帯に知らせます。Webhookステップがバックエンド関数を呼び出し、その関数がメンバーを非アクティブとしてマークし、世帯のオーナーと管理者に通知します。 ダッシュボードでの設定。 次の設定でJourney Webhookを作成し、Journeyの最後のステップで選択します。
Journey webhook
関数は、何よりも先にシークレットを確認します。OneSignalはSupabaseのトークンを送信しないため、この関数はSupabaseのトークンチェックなしでデプロイされています。そのため、共有シークレットだけがエンドポイントと公開インターネットの間を隔てています。
supabase/functions/journey-webhook/index.ts
次に、その主張を自ら確認します。Journeyはメンバーが非アクティブだと伝えますが、Journeyが知っているのはアプリのセッションとイベントだけです。掃除したかどうかはデータベースが知っています。
supabase/functions/journey-webhook/index.ts
そのうえで初めて、メンバーをマークし、対応できる人たちに1回だけプッシュを送ります。
supabase/functions/journey-webhook/index.ts
このフラグは自動的に解除されます。メンバーが次にセッションを完了すると、データベーストリガーがフラグを削除するため、アプリが覚えておく必要はありません。
Webhookステップは、メッセージステップにはできないことを何でも行えます。レコードの更新、サポートチケットの作成、別システムのリストへの追加などです。リクエストは、ほかの外部からの呼び出しと同じように扱ってください。シークレットを確認し、事実を確認し、繰り返し呼ばれても害がないようにします。

Journeysから見えないもの \

このガイドのバックエンドからの送信はすべて、送信前にメンバーの通知設定を確認します。設定はアプリのデータベースにあるため、Journeyにはそれができません。 設定が反映されているのは、連続記録の警告だけです。ほかのJourneyのプッシュは、アプリのプッシュ通知をオンにしている全員に届きます。アプリに種類ごとの通知設定がある場合は、Journeyが尊重すべき設定をそれぞれ反映してください。

知っておくべきこと \

  • オーディエンスが重複するJourneyに注意してください。 Clean Beansでは一時期、同じセグメントに対して2つの再エンゲージメントJourneyが稼働しており、非アクティブなメンバー全員が両方のシーケンスの対象になっていました。セグメントに2つ目のJourneyをオンにするのは簡単ですが、気付くのは困難です。
  • JourneyのプッシュにはURLとdata.typeを設定してください。 ダッシュボードで作成したテンプレートには、どちらもデフォルトでは設定されていないため、タップしてもアプリが開くだけです。Clean BeansはすべてのJourneyテンプレートに両方を設定し、バックエンドのプッシュと同じように振り分けられるようにしています。ディープリンクと通知のクリックを参照してください。
  • 稼働中のJourneyは編集でき、その編集はすでに参加している人に影響する可能性があります。 Clean Beansは、稼働中のJourneyで時間枠を変更し、待機を追加しました。このような変更は慎重に行ってください。
  • Journeyのメッセージも受信箱に入ります。 ほかのプッシュと同じEvent Streamを通じて、Liquidが展開されていない状態で届きます。
  • ボタンがUniversal Linkのメールでは、クリックトラッキングをオフにしてください。 トラッキングはリンクをトラッキングドメイン経由に書き換えるため、書き換えられたリンクではアプリが開かなくなります。通常のWebリンクからアプリを開くを参照してください。

Journeysの概要

開始ルール、ステップ、Journeyの実行の仕組み。

Journeyの設定

誰が入り、終了し、再入場するか。

Journeyのアクション

Wait、Wait Until、Yes/No、Split、Time Window。

Journey Webhook

Journeyのステップから自分のサーバーを呼び出します。

カスタムイベントでパーソナライズする

Journeyのメッセージでイベントプロパティを使います。

イベント駆動のJourneys

行動に反応するJourneysを設計します。