オンボーディングの流れ（2.2.11）
新しく入れた人は、次の順に画面を進みます。
- ウェルカム
- アンケート3問
- 建築を選ぶ
- （A/B で半分の人だけ）スクリーンタイムの許可とアプリ選択
- ホームでスタートを押す
- 5分のチュートリアル集中（途中で打ち切り）
- ウィジェット案内などの告知
画面の順番
1ウェルカム
OnboardingWelcomeView
- 見出しは「集中するほど、建築物が育つ。」
- ボタン「長押しで建てる」を押し続けると、約3秒で建築が完成するデモが動く
- 完成すると「はじめる」に変わり、触ると次へ進む。スキップは無い
onboarding_step_view(welcome)onboarding_step_complete(welcome)
アンケート未回答なら 2 へ・回答済みなら 5 へ
2アンケート1：知ったきっかけ
- 「このアプリを知ったきっかけは？」
- TikTok／Instagram／Threads／YouTube／App Storeの検索／友人・家族の紹介／Web記事・ブログ／その他
- 選ぶまで「次へ」は押せない。スキップは無い
3アンケート2：年齢
- 「あなたの年齢を教えてください」
- 〜17歳／18〜24歳／25〜34歳／35〜44歳／45〜54歳／55歳以上
4アンケート3：性別
- 「あなたの性別を教えてください」
- 男性／女性／その他／回答しない
onboarding_survey_complete
5（画面なし）
- 2026-09-07 に中身を消した段。記録だけ送って、すぐ建築を選ぶ画面へ進む
onboarding_step_complete(mechanicCarousel)
6建築を選ぶ
OnboardingBuildingPickerView
- 見出しは「建てたい建築を選ぼう」
- カードを押すと、その建築の完成までの段を見られる。地域で絞り込める
- Premium の作品も無料で選べる。期間限定の作品が先頭に並ぶ
- 「この建築で始める」で確定する
ここで A/B（OnboardingBlockOffer）に分かれる
offer の腕（新規の約半分）
7スクリーンタイムの説明
- 「スクリーンタイムへのアクセスを許可」
- 「次へ」で OS の許可ダイアログ
- 許可済みの人はこの画面を飛ばす
許可 → 8／断る・「あとで」・✕ → 9
shield_opt_in_step_shownshield_opt_in_closed
8ブロックするアプリを選ぶ
- 「アプリを選ぶ」で OS のアプリ選択を開く
- 「続ける」で保存、「あとで」で保存せず進む
- 無料4個の腕（cap4）で5個以上選ぶと、上限の課金画面が開く
どの終わり方でも → 9
app_picker_shownapp_picker_closed
none の腕（対照・新規の約半分）
—今までどおり
- 説明もアプリ選択も出さず、そのままホームへ
→ 9
確定と同時に着工する（construction_start）
9ホーム：スタートを押す
HomeView（guideStart）
- タイマーは5分に固定される。タブは押せない
- 吹き出しは「集中した分だけ、建築が育つ」「まず5分。押すだけで着工します」
- 右上に「スキップ」がある
スタート → 10／スキップ → オンボ完了（method: skipped）→ 13
10「集中タイム、スタート！」
- 「集中している間、建築物は少しずつ育っていきます。」タップか6秒で次へ
onboarding_tutorial_step(start_announcement)
本物の集中が始まる。この瞬間にオンボーディング完了になる
11集中の画面：秒数の説明
FocusSessionFullScreenView
- 約1.4秒後に、残り秒数を指して「集中している間、建築が育ちます」「ここの秒数が0になったら、終了です」
- タップで次へ
onboarding_completed(guided)onboarding_tutorial_step(countdown_coach)
12「今回はチュートリアルなので、5分はスキップします」
- 「本番では、集中した分だけ建築が進みます。」タップか6秒で閉じる
- 閉じると5分ぶんを完了として建築に足す。結果画面は出さない
onboarding_tutorial_step(skip_notice)session_skipped
集中の画面が閉じてホームへ
13ホームに戻ったあとの告知（上から順に）
- ウィジェットの案内（まだ見ていない人）
- クラフトの告知（条件を満たす人）
- インストール特典：倍速の a の腕の人だけ。1つ目の建築は×3、2つ目は×2、3つ目は×1.5。ボタンは「受け取る」
- 「明日も、続けませんか？」（通知許可の事前確認）：ほかの告知が出ていないときだけ。出るかどうかは実機で未確認
14ホーム（自由に使える）
- 集中のあとの課金画面は、使い始めて2日目以降の5分以上の集中のあとから出る
A/B と出し分け（新規だけ）
| 実験 | 腕 | オンボでの違い |
|---|---|---|
| ブロック設定の勧め OnboardingBlockOffer | offer／none（50:50） | offer だけ 7・8 が出る |
| ブロック無料の上限 BlockCap | cap4／unlimited | cap4 だけ、8 で5個以上選ぶと課金画面。枠の印も cap4 だけ |
| 倍速 BoostExperiment | a／b／c | a はインストール特典の告知が出る。b は最初の1回で第2段まで進める。c は何もしない |
| ブロック倍速 BlockBoost | 新規は removed | 新規には、ブロックしたアプリの数で速くなる仕組みが無い |
前から使っている人（入れ直した人を含む）はすべて legacy で、オンボーディングは出ません。設定から見直す「再受講」では、7・8 と記録の送出は出ません。
課金画面が出る場所
- オンボーディングの途中：出ない（cap4 の腕で、8 のアプリ選択で上限を超えたときだけ出る）
- チュートリアルの直後：出ない（PostOnboardingPaywallPolicy と FirstFocusOfferPolicy は常に false）
- 使い始めて2日目以降：5分以上の集中を終えたあとに出る（AfterFocusPaywallPolicy）
気をつけること
自分で始める最初の集中で、OS の通知許可が先に出ることがある。
チュートリアルの5分では出ません（コードで確認）。ところが新規の休憩の既定は5分なので、オンボ後に自分で始める最初の集中はポモドーロになります。開始の時点で OS の許可ダイアログが出ます。2026-10-16 の計測では、この経路の許可率は 18.3% でした。先に断られると、許可率の高い「明日も、続けませんか？」のシートでは二度と聞けません。直した版は別ブランチにあり、2.2.11 には入っていません。
まだ確かめていないこと
- ウィジェット案内の見出しとボタンの文
- チュートリアル直後に「明日も、続けませんか？」が実際に出るか（ウィジェット案内が先に出ると出ない）
- 倍速 a の腕で、チュートリアルの5分が建築に何分ぶん足されるか