このクイックスタートでは、アプリに Google Analytics を追加し、イベントのロギングを始める方法について説明します。
Google Analytics は、アプリの使用状況や動作に関するデータを収集します。この SDK は主に次の 2 種類の情報を記録します。
- イベント: ユーザーの操作、システム イベント、エラーなど、アプリで起こっていること。
- ユーザー プロパティ: 言語や地域など、ユーザー層を示す属性。自由に定義できます。
Analytics は、一部のイベントとユーザー プロパティを自動的にロギングします。こうしたロギングを有効にするためのコードを追加する必要はありません。
始める前に
まだ追加していない場合は、Apple プロジェクトに Firebase を追加し、Firebase プロジェクトで Google Analytics が有効になっていることを確認します。
新しい Firebase プロジェクトを作成する場合は、プロジェクトの作成ワークフローで Google Analytics を有効にします。
使用している既存の Firebase プロジェクトで Google Analytics が有効になっていない場合は、
[] > [プロジェクトの設定 ] の [統合] タブに移動して Google アナリティクスを有効にします。
プロジェクトで Google Analytics を有効にすると、Firebase アプリが Google Analytics のデータ ストリームにリンクされます。
（推奨）AdSupport フレームワークをプロジェクトに追加して、対象デバイス、キャンペーン アトリビューションなどの追加機能を有効にします。
アプリに Analytics SDK を追加する
Swift Package Manager を使用して Firebase の依存関係のインストールと管理を行います。
- Xcode でアプリのプロジェクトを開いたまま、[File] > [Add Packages] の順に移動します。
- プロンプトが表示されたら、Firebase Apple プラットフォーム SDK リポジトリを追加します。
- Analytics ライブラリを選択します。
- ターゲットのビルド設定の [Other Linker Flags] セクションに
-ObjCフラグを追加します。 - Analytics でのエクスペリエンスを最適化するために、Firebase プロジェクトで Google Analytics を有効にして、Google アナリティクス用の Firebase SDK をアプリに追加することをおすすめします。ライブラリで IDFA の収集を行う / 行わないを選択できます。
- 上記の作業が完了すると、Xcode は依存関係の解決とバックグラウンドでのダウンロードを自動的に開始します。
https://github.com/firebase/firebase-ios-sdk.git
デバイスレベルの広告識別子である IDFA について詳しくは、Apple のユーザーのプライバシーとデータの使用と、App Tracking Transparency に関するドキュメントをご覧ください。
次に、以下の構成手順を行います。
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() } } } }
（省略可）Apple の広告ネットワーク アトリビューション登録を無効にする
SDK は SKAdNetwork を使用して Apple の広告ネットワーク アトリビューションにアプリを自動的に登録します。この機能を無効にするには、アプリの info.plist ファイルで GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED の値を NO（ブール値）に設定します。
イベントのロギングを開始する
FirebaseApp インスタンスを構成すると、logEvent() メソッドを使ってイベントをログに記録できるようになります。
イベントには、すべてのアプリで推奨されるイベントと、特定のビジネスや業種で推奨されるイベントがあります。推奨イベントと既定のパラメータを一緒に送信することで、レポートに詳しい情報を表示できます。また、リリースされる最新の機能や統合を活用することもできます。このセクションでは、あらかじめ定義されているイベントのロギングについて説明します。イベント ロギングの詳細については、イベントをロギングするを参照してください。
次の例では、ユーザーがアプリの特定の要素をクリックしたことを示す推奨イベントをログに記録します。
Swift
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
Objective-C
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
Xcode デバッグ コンソールでイベントを表示するには、次のようにアナリティクス デバッグを有効にします。
- Xcode で [Product] > [Scheme] > [Edit scheme] の順に選択します。
- 左側のメニューから [Run] を選択します。
- [Arguments] タブを選択します。
- [Arguments Passed On Launch] セクションで
-FIRAnalyticsDebugEnabledを追加します。
次のステップ
- 各アナリティクス レポートについて理解する。
- DebugView を使用して、イベントを検証する。
- Firebase コンソールでデータを探す。
- イベントやユーザー プロパティのガイドを読む。
- データを BigQuery にエクスポートする方法を学習する。