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

このクイックスタートでは、アプリに Google アナリティクスを追加し、イベントのロギングを始める方法について説明します。

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

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

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

始める前に

  1. まだ追加していない場合は、iOS プロジェクトに Firebase を追加し、Firebase プロジェクトで Google アナリティクスが有効になっていることを確認します。

    • 新しい Firebase プロジェクトを作成する場合は、プロジェクトの作成ワークフローで Google アナリティクスを有効にします。

    • Google アナリティクスが有効になっていない既存の Firebase プロジェクトがある場合は、[] > [プロジェクトの設定] の [統合] タブで Google アナリティクスを有効にできます。

    プロジェクトで Google アナリティクスを有効にすると、Firebase アプリが Google アナリティクスのデータ ストリームにリンクされます。

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

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

  1. Podfile に Firebase の依存関係を追加します。 
    pod 'Firebase/Analytics'
  2. pod install を実行し、作成された .xcworkspace ファイルを開きます。
  3. Firebase モジュールを UIApplicationDelegate にインポートします。

    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];


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

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

次のステップ