Google アナリティクスは Firebase の分析エンジンです。アプリ内でアナリティクスと Crashlytics を組み合わせて使用すると、問題を生成してクラッシュ データを細かくトラッキングするための機能を利用できます。たとえば、クラッシュが発生していないユーザーをトラッキングしたり、クラッシュの前の特定のイベントを追跡するパンくずリストや BigQuery を利用したりすることができ、アプリの主要な指標を可視化できます。
このガイドでは、Crashlytics が設定されているアプリにアナリティクスを追加する方法について説明します(アプリに Crashlytics をまだ追加していない場合は追加してください)。
ステップ 1: Firebase 構成ファイルを追加する
- [プロジェクトの設定] を開きます。[マイアプリ] カードで、構成ファイルが必要なアプリのバンドル ID をリストから選択します。
[GoogleService-Info.plist をダウンロード] をクリックして、Firebase Apple プラットフォーム構成ファイル(
GoogleService-Info.plist
)を取得します。Firebase Apple プラットフォーム構成ファイルはいつでも再ダウンロードできます。
構成ファイル名に
(2)
のような文字が追加されていないことを確認してください。
構成ファイルを Xcode プロジェクトのルートに移動します。メッセージが表示されたら、構成ファイルをすべてのターゲットに追加するオプションを選択します。
プロジェクトに複数のバンドル ID がある場合は、Firebase コンソールで各バンドル ID を登録済みアプリに関連付けて、各アプリで固有の GoogleService-Info.plist
ファイルを使用できるようにする必要があります。
ステップ 2: アプリにアナリティクス SDK を追加する
Swift Package Manager を使用して Firebase の依存関係のインストールと管理を行います。
- Xcode でアプリ プロジェクトを開いたまま、[File(ファイル)] > [Swift Packages(Swift パッケージ)] > [Add Package Dependency(パッケージの依存関係を追加)] の順に移動します。
- プロンプトが表示されたら、Firebase Apple プラットフォーム SDK リポジトリを追加します。
- Google アナリティクス用の Firebase SDK を追加します。IDFA の収集を行うライブラリ、IDFA の収集を行わないライブラリのいずれかを選択してください。
- 上記の作業が完了すると、Xcode は依存関係の解決とバックグラウンドでのダウンロードを自動的に開始します。
https://github.com/firebase/firebase-ios-sdk
次に、Firebase モジュールを構成します。
UIApplicationDelegate
にFirebaseCore
モジュールと、アプリのデリゲートが使用する他の Firebase モジュールをインポートします。たとえば、Cloud Firestore と Authentication を使用するには、次のようにします。SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- アプリ デリゲートの
application(_:didFinishLaunchingWithOptions:)
メソッドで、FirebaseApp
共有インスタンスを構成します。SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- SwiftUI を使用している場合は、アプリケーション デリゲートを作成し、
UIApplicationDelegateAdaptor
またはNSApplicationDelegateAdaptor
を介してApp
構造体に接続する必要があります。また、アプリ デリゲートの実装入れ替えを無効にする必要があります。詳細については、SwiftUI の手順をご覧ください。SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
Google アナリティクスを使用するようにアプリが設定されました。
次のステップ
- DebugView を使用して、イベントを検証する。
- Firebase コンソールでデータを探索する。
- イベントやユーザー プロパティのガイドを読む。
- データを BigQuery にエクスポートする方法を学習する。