Google アナリティクスは、アプリの使用状況や動作に関するデータを収集します。この SDK は主に次の 2 種類の情報を記録します。
- イベント: ユーザーの操作、システム イベント、エラーなど、アプリで起こっていること。
- ユーザー プロパティ: 言語や地域など、ユーザー層を示す属性。自由に定義できます。
アナリティクスでは、一部のイベントとユーザー プロパティが自動的にログに記録されます。これらのログ記録を有効にするコードを追加する必要はありません。
始める前に
まだ追加していない場合は、iOS プロジェクトに Firebase を追加し、Firebase プロジェクトで Google アナリティクスが有効になっていることを確認します。
新しい Firebase プロジェクトを作成する場合は、プロジェクトの作成ワークフローで Google アナリティクスを有効にします。
Google アナリティクスが有効になっていない既存の Firebase プロジェクトがある場合は、
[ の [ ] > [プロジェクトの設定]統合] タブで Google アナリティクスを有効にできます。
プロジェクトで Google アナリティクスを有効にすると、Firebase アプリが 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];
(省略可)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 にエクスポートする方法を学習する。