Google アナリティクスは、アプリの使用状況や動作に関するデータを収集します。この SDK は主に次の 2 種類の情報を記録します。
- イベント: ユーザーの操作、システム イベント、エラーなど、アプリで起こっていること。
- ユーザー プロパティ: 言語や地域など、ユーザーベースを示す属性。自由に定義できます。
アナリティクスは、一部のイベントとユーザー プロパティのログを自動的に記録します。これらのログ記録を有効にするためのコードを追加する必要はありません。
始める前に
新しいプロジェクトを作成する場合は、プロジェクト作成時に Firebase を iOS プロジェクトに追加し、手順に沿ってプロジェクトに Google アナリティクスを設定します。
Google アナリティクスを構成していない既存のプロジェクトでは、統合] タブから Google アナリティクスをリンクできます。
[プロジェクトの設定] の [(推奨)AdSupport フレームワークをプロジェクトに追加して、対象デバイス、キャンペーン アトリビューションなどの追加機能を有効にします。
アプリにアナリティクス SDK を追加する
- podfile に Firebase の依存関係を追加します。
pod 'Firebase/Analytics'
pod install
を実行し、作成された.xcworkspace
ファイルを開きます。- Firebase モジュールを
UIApplicationDelegate
にインポートします。Swift
import Firebase
Objective-C
@import Firebase;
FirebaseApp
共有インスタンスを構成します。通常はアプリのapplication:didFinishLaunchingWithOptions:
メソッドで行います。Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
イベントのロギングを開始する
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 にエクスポートする方法を学習する。