レビュー誘導機能

App Store のレビューを促すタイミング制御

v1.0 機能ID: DT-FEAT-REVIEW

概要

起動回数を記録し、決まったタイミング（5回目・20回目）で SwiftUI native の in-app review を表示する機能。 ユーザーがアプリに馴染んだタイミングで自然に促す設計。

関連画面

• ホーム画面（レビュー表示トリガー）

誘導タイミング

起動回数	動作
5回目	初回レビュー依頼
20回目	2回目レビュー依頼
その他	表示なし

処理フロー

1. アプリ起動時に ReviewService.recordLaunchAndShouldRequestReview() 実行
2. 起動回数を launch_count に +1
3. 5回目 or 20回目なら true を返す
4. AppViewModel.shouldRequestReview = true
5. HomeView 表示後 2秒待機
6. @Environment(\.requestReview) で native レビューシート表示

API

@MainActor
final class ReviewService {
    func recordLaunchAndShouldRequestReview() -> Bool
    // 起動回数+1、5回目/20回目で true を返す
}

// 使用箇所
@Environment(\.requestReview) private var requestReview

.task {
    if appViewModel.shouldRequestReview {
        try? await Task.sleep(for: .seconds(2))
        requestReview()
    }
}

ビジネスルール

• 初回起動時には表示しない（馴染ませる時間が必要）
• 2秒の遅延でユーザーがコンテンツに目を通した状態で表示
• SwiftUI native の requestReview は OS がレートリミット制御（年3回まで）
• 表示タイミングは A/B テストで継続検証（v1.x 検討）

外部連携

連携先	用途
SwiftUI requestReview	native レビューシート起動
StoreKit (内部)	requestReview の実体

エラー処理

requestReview は OS レベルで処理されるためアプリ側エラーは原則発生しない。 レートリミットでブロックされた場合もサイレント。

実装メモ

• launch_count キーは AppGroup UserDefaults に保存
• 2秒遅延で UX 自然
• 表示後の継続率・レビュー数の効果測定（v1.x）

変更履歴

バージョン	日付	変更内容
1.0	2026-05-09	初版作成