クラッシュ分析

アプリのクラッシュをトリアージ・優先順位付け・削減し、クラッシュレートが App Store の発見可能性とレーティングにどのように影響するかを理解するのをサポートします。

クラッシュレートが ASO シグナルである理由

• App Store ランキング — Apple のアルゴリズムはクラッシュレートが高いアプリにペナルティを課す
• App Store フィーチャリング — クラッシュレートが高いとエディトリアルの検討対象から除外される
• レーティング — クラッシュは 1 つ星レビューの最大の原因
• リテンション — 最初のセッションでのクラッシュは Day 1 リテンションを破壊する

目標: クラッシュフリーセッション > 99.5% | クラッシュフリーユーザー > 99%

ツール

ツール	提供内容	セットアップ
Firebase Crashlytics	リアルタイムクラッシュ、ANR、シンボル化されたスタックトレース	FirebaseCrashlytics pod/SPM パッケージを追加
App Store Connect	クラッシュレートのトレンド、セッションあたりのクラッシュ数	組み込み、コード不要
Xcode Organizer	TestFlight + App Store から集約されたクラッシュログ	Xcode → Window → Organizer → Crashes
MetricKit	オンデバイス診断、ハング率、起動時間	iOS 13+、自動

推奨: Crashlytics (リアルタイムアラート + 検索) + App Store Connect (トレンド検証)

Crashlytics セットアップ

iOS (Swift)

// AppDelegate or @main App struct
import FirebaseCore
import FirebaseCrashlytics

@main
struct MyApp: App {
    init() {
        FirebaseApp.configure()
        // Crashlytics is auto-initialized
    }
}

致命的ではないエラー (クラッシュなしで追跡)

// Log a non-fatal error
Crashlytics.crashlytics().record(error: error)

// Log a custom key for debugging context
Crashlytics.crashlytics().setCustomValue(userId, forKey: "user_id")
Crashlytics.crashlytics().setCustomValue(screenName, forKey: "current_screen")

Android (Kotlin)

// build.gradle (app)
implementation("com.google.firebase:firebase-crashlytics:18.x.x")

// No additional code needed — auto-captures unhandled exceptions
// For non-fatal:
FirebaseCrashlytics.getInstance().recordException(throwable)

トリアージフレームワーク

すべてのクラッシュが同じではありません。インパクトで優先順位付けします:

優先度スコア = クラッシュ頻度 × 影響を受けたユーザー × ユーザーセグメント重要度

優先度	条件	対応時間
P0 — 緊急	起動時・チェックアウト・中核機能でのクラッシュ; セッションの >1%	本日修正
P1 — 高	一般的なフローでのクラッシュ; セッションの >0.1%	このリリースで修正
P2 — 中	エッジケースのクラッシュ; セッションの <0.1%	次回リリースで修正
P3 — 低	レアで非ブロッキングのクラッシュ; セッションの <0.01%	バックログ

Crashlytics ダッシュボード トリアージ

1. 頻度ではなく 「Impact」(影響を受けた一意のユーザー) でソート
2. グループ化: onboarding、checkout、core feature、background、launch
3. トップ 3～5 の問題を P0/P1 に割り当て
4. ユーザーの >0.5% に影響する問題については、Crashlytics で velocity アラート を設定

クラッシュレポートの読み方

Fatal Exception: com.example.NullPointerException
  at com.example.UserProfileVC.loadData:87
  at com.example.HomeVC.viewDidLoad:45

Keys:
  user_id: 12345
  current_screen: "home"
  app_version: "2.3.1"
  os_version: "iOS 17.3"

デバッグの手順:

1. Xcode でファイルと行を開く (UserProfileVC.swift:87)
2. その時点で何が nil になる可能性があるかを確認
3. ユーザーコンテキスト (OS バージョン、デバイス、スクリーン) で再現
4. 修正前に失敗するテストを記述

シンボル化

dSYM をアップロードすると、Crashlytics は自動的にシンボル化されます。シンボル化されていないトレースが表示される場合:

# dSYM を手動アップロード
./Pods/FirebaseCrashlytics/upload-symbols -gsp GoogleService-Info.plist -p ios MyApp.app.dSYM

Bitcode 有効なビルドの場合、App Store Connect → Activity → Build → dSYM から dSYM をダウンロードします。

App Store Connect クラッシュデータ

• App Store Connect → App Analytics → Crashes — バージョンごとのクラッシュレートトレンド
• 各リリース前後でクラッシュレートを比較
• 特定のバージョンでのスパイク = そのリリースでの回帰

クラッシュレート計算式: クラッシュ数 / セッション数 × 100

影響範囲を最小化するリリース戦略

段階的リリースを使用して、フルロールアウト前にクラッシュをキャッチします:

iOS: App Store Connect → Version → Phased Release (7 日間ロールアウト: 1% → 2% → 5% → 10% → 20% → 50% → 100%)

Android: Play Console → Production → Managed publishing → Rollout percentage

ルール: 各フェーズで Crashlytics を 24 時間監視します。クラッシュレートが >0.2% 増加した場合はロールアウトを一時停止します。

クラッシュ関連の 1 つ星レビューへの対応

1. クラッシュ関連の 1 つ星が現れたアプリバージョンを特定
2. クラッシュを修正
3. 各クラッシュ関連レビューに返信: 「バージョン X.X で修正 — 更新してください」
4. アップデート公開後、rating-prompt-strategy を使用してレーティングを回復

出力フォーマット

クラッシュ監査レポート

安定性レポート — [アプリ名] v[バージョン] ([期間])

クラッシュフリーセッション: [X]%  (目標: >99.5%)
クラッシュフリーユーザー:    [X]%  (目標: >99%)
トップクラッシュ問題:

P0 問題 (即座に修正):
  #1 [例外タイプ] — [X] ユーザー、セッションの [X]%
     ファイル: [ファイル名:行番号]
     原因: [仮説]
     修正: [具体的なアクション]

P1 問題 (このリリース):
  #2 [例外タイプ] — [X] ユーザー、セッションの [X]%
     ...

行動計画:
  本日:     P0 問題 #1 を修正 → ホットフィックスをリリース
  今週:     P1 問題 #2、#3 を修正 → v[X.X] に含める
  監視:     0.5% セッション閾値で velocity アラートを設定

関連スキル

• app-analytics — 完全な分析スタック; Crashlytics はその一部
• rating-prompt-strategy — クラッシュ関連の 1 つ星修正後にレーティングを回復
• review-management — クラッシュ関連レビューに対応
• retention-optimization — Day 1 でのクラッシュはリテンション指標を破壊
• app-store-featured — クラッシュレート > 2% はエディトリアルフィーチャリングから除外