iOS 用 Google アナリティクスを使ってみる

Google アナリティクスは、アプリの使用状況や動作に関するデータを収集します。この SDK は主に次の 2 種類の情報を記録します。

• イベント: ユーザーの操作、システム イベント、エラーなど、アプリで起こっていること。
• ユーザー プロパティ: 言語や地域など、ユーザー層を示す属性。自由に定義できます。

アナリティクスは、一部のイベントとユーザー プロパティのログを自動的に記録します。これらのログ記録を有効にするためのコードを追加する必要はありません。

始める前に

1. 新しいプロジェクトを作成する場合は、プロジェクトの作成時に Firebase を iOS プロジェクトに追加し、手順に沿ってプロジェクトの Google アナリティクスを設定します。

   既存のプロジェクトがあり、Google アナリティクスを設定していない場合は、 > [プロジェクトの設定] の [統合] タブから Google アナリティクスをプロジェクトにリンクできます。

2. （推奨）AdSupport フレームワークをプロジェクトに追加して、対象デバイス、キャンペーン アトリビューションなどの追加機能を有効にします。

アプリにアナリティクスを追加する

1. podfile に Firebase の依存関係を追加します。

   pod 'Firebase/Analytics'

2. pod install を実行して、作成した .xcworkspace ファイルを開きます。
3. UIApplicationDelegate で Firebase モジュールをインポートします。

   Swift

   import Firebase

   Objective-C

   @import Firebase;

4. FirebaseApp 共有インスタンスを構成します。通常、アプリの application:didFinishLaunchingWithOptions: メソッドで行います。

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

アプリ内購入をトラッキングしている場合は、Firebase を初期化する前に application:didFinishLaunchingWithOptions: のトランザクション オブザーバーを初期化する必要があります。これを行わないと、オブザーバーがすべての購入通知を受け取ることができない場合があります。詳しくは、Apple のアプリ内購入のベスト プラクティスをご覧ください。

イベントをロギングする

FirebaseApp インスタンスを構成すると、logEventWithName() メソッドを使ってイベントをログに記録できるようになります。事前定義されたイベントとパラメータはヘッダー ファイルの FIREventNames.h と FIRParameterNames.h で調べることができます。

次の例は、推奨イベントの kFIREventSelectContent を記録して、ユーザーがアプリで特定の要素をクリックしたかどうかがわかるようにする方法を示したものです。

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 デバッグ コンソールでイベントを表示するには、次のようにアナリティクス デバッグを有効にします。

1. Xcode で [Product] > [Scheme] > [Edit scheme] の順に選択します。
2. 左側のメニューから [Run] を選択します。
3. [Arguments] タブを選択します。
4. [Arguments Passed On Launch] セクションで -FIRAnalyticsDebugEnabled を追加します。

次のステップ

• Firebase コンソールで表示されるデータが定期的に更新されることを確認する
• イベントやユーザー プロパティのガイドを読む