Google アナリティクスのスタートガイド


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

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

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

Analytics は、一部のイベントとユーザー プロパティを自動的にロギングします。こうしたロギングを有効にするためのコードを追加する必要はありません。

始める前に

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

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

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

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

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

アプリに Analytics SDK を追加する

Swift Package Manager を使用して Firebase の依存関係のインストールと管理を行います。

  1. Xcode でアプリのプロジェクトを開いたまま、[File] > [Add Packages] の順に移動します。
  2. プロンプトが表示されたら、Firebase Apple プラットフォーム SDK リポジトリを追加します。
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Analytics ライブラリを選択します。
  4. ターゲットのビルド設定の [Other Linker Flags] セクションに -ObjC フラグを追加します。
  5. Analytics でのエクスペリエンスを最適化するために、Firebase プロジェクトで Google Analytics を有効にして、Google アナリティクス用の Firebase SDK をアプリに追加することをおすすめします。ライブラリで IDFA の収集を行う / 行わないを選択できます。 Firebase SDK 向け Google Analytics のモジュールの最新の構成に関するよくある質問をご覧ください。
  6. 上記の作業が完了すると、Xcode は依存関係の解決とバックグラウンドでのダウンロードを自動的に開始します。

デバイスレベルの広告識別子である IDFA について詳しくは、Apple のユーザーのプライバシーとデータの使用と、App Tracking Transparency に関するドキュメントをご覧ください。

次に、以下の構成手順を行います。

  1. UIApplicationDelegate に FirebaseCore モジュールと、アプリのデリゲートが使用する他の Firebase モジュールをインポートします。たとえば、Cloud Firestore、Authentication を使用するには、次のように指定します。

    SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. アプリ デリゲートの application(_:didFinishLaunchingWithOptions:) メソッドで、FirebaseApp 共有インスタンスを構成します。

    SwiftUI

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

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. SwiftUI を使用している場合は、アプリケーション デリゲートを作成し、UIApplicationDelegateAdaptor または NSApplicationDelegateAdaptor を介して App 構造体に接続する必要があります。また、アプリ デリゲートのメソッドの実装入れ替えを無効にする必要があります。詳細については、SwiftUI の手順をご覧ください。

    SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}


（省略可）Apple の広告ネットワーク アトリビューション登録を無効にする

SDK は SKAdNetwork を使用して Apple の広告ネットワーク アトリビューションにアプリを自動的に登録します。この機能を無効にするには、アプリの info.plist ファイルで GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED の値を NO（ブール値）に設定します。

イベントのロギングを開始する

FirebaseApp インスタンスを構成すると、logEvent() メソッドを使ってイベントをログに記録できるようになります。

イベントには、すべてのアプリで推奨されるイベントと、特定のビジネスや業種で推奨されるイベントがあります。推奨イベントと既定のパラメータを一緒に送信することで、レポートに詳しい情報を表示できます。また、リリースされる最新の機能や統合を活用することもできます。このセクションでは、あらかじめ定義されているイベントのロギングについて説明します。イベント ロギングの詳細については、イベントをロギングするを参照してください。

次の例では、ユーザーがアプリの特定の要素をクリックしたことを示す推奨イベントをログに記録します。

Swift

注: この Firebase プロダクトは、macOS ターゲットでは使用できません。 
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

Objective-C

注: この Firebase プロダクトは、macOS ターゲットでは使用できません。 
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

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

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

次のステップ