Firebase を使用して AI 搭載アプリを構築して実行する方法のデモを、2024 年の Demo Day でご覧ください。ぜひご覧ください。

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

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

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

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

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

始める前に

まだ追加していない場合は、Apple プロジェクトに Firebase を追加し、Firebase プロジェクトで Google Analytics が有効になっていることを確認します。
- 新しい Firebase プロジェクトを作成する場合は、プロジェクトの作成ワークフローで Google Analytics を有効にします。
- 使用している既存の Firebase プロジェクトで Google Analytics が有効になっていない場合は、[] > [プロジェクトの設定] の [統合] タブに移動して Google アナリティクスを有効にします。
警告: 2019 年 7 月 31 日より前に作成された Firebase プロジェクトは、完全版の Google アナリティクス 4 エクスペリエンスにアップグレードする必要があります（まだアップグレードしていない場合）。アップグレードが必要な場合は、Analytics ダッシュボードにバナーが表示されます。データの収集を続けるには、2022 年 2 月 15 日までに、関連する利用規約に同意する必要があります。アップグレードについては、サポートのよくある質問で、プロジェクトオーナーを見つける方法をご覧ください。
プロジェクトで Google Analytics を有効にすると、Firebase アプリが Google Analytics のデータストリームにリンクされます。
（推奨）AdSupport フレームワークをプロジェクトに追加して、対象デバイス、キャンペーンアトリビューションなどの追加機能を有効にします。

アプリに Analytics SDK を追加する

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

Xcode でアプリのプロジェクトを開いたまま、[File] > [Add Packages] の順に移動します。
プロンプトが表示されたら、Firebase Apple プラットフォーム SDK リポジトリを追加します。

  https://github.com/firebase/firebase-ios-sdk.git

Analytics ライブラリを選択します。
ターゲットのビルド設定の [Other Linker Flags] セクションに -ObjC フラグを追加します。
Analytics でのエクスペリエンスを最適化するために、Firebase プロジェクトで Google Analytics を有効にして、Google アナリティクス用の Firebase SDK をアプリに追加することをおすすめします。ライブラリで IDFA の収集を行う / 行わないを選択できます。
上記の作業が完了すると、Xcode は依存関係の解決とバックグラウンドでのダウンロードを自動的に開始します。

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

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

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;
// ...

アプリデリゲートの 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];

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

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

次のステップ

各アナリティクスレポートについて理解する。
DebugView を使用して、イベントを検証する。
Firebase コンソールでデータを探す。
イベントやユーザープロパティのガイドを読む。
データを BigQuery にエクスポートする方法を学習する。

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

始める前に

アプリに Analytics SDK を追加する

SwiftUI

Swift

Objective-C

SwiftUI

Swift

Objective-C

SwiftUI

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

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

Swift

Objective-C

次のステップ

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