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

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

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

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

始める前に

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

    既存のプロジェクトがあり、Google アナリティクスを設定していない場合は、[settings] > [プロジェクトの設定] の [統合] タブから 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];


イベントをロギングする

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 を追加します。

次のステップ