Firebase Summit で発表されたすべての情報をご覧ください。Firebase を使用してアプリ開発を加速し、自信を持ってアプリを実行する方法を紹介しています。詳細

GoogleAnalyticsを始めましょう

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

このクイックスタートでは、Google アナリティクスをアプリに追加し、イベントのログ記録を開始する方法を示します。

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

  • イベント:ユーザー アクション、システム イベント、エラーなど、アプリで発生していること。
  • ユーザー プロパティ:言語設定や地理的位置など、ユーザー ベースのセグメントを説明するために定義する属性。

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

あなたが始める前に

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

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

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

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

  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
  3. 分析ライブラリを選択します。
  4. Analytics を最適に使用するには、Firebase プロジェクトでGoogle Analytics を有効にし、Google Analytics 用の Firebase SDK をアプリに追加することをお勧めします。 IDFA コレクションのないライブラリまたは IDFA コレクションのあるライブラリのいずれかを選択できます。
  5. 完了すると、Xcode はバックグラウンドで依存関係の解決とダウンロードを自動的に開始します。

デバイス レベルの広告識別子である IDFA について詳しくは、Apple のユーザー プライバシーとデータ使用およびアプリ トラッキングの透明性に関するドキュメントをご覧ください。

次に、いくつかの構成手順を実行します。

  1. UIApplicationDelegateにFirebaseCoreモジュールをインポートし、アプリ デリゲートが使用する他のすべてのFirebase モジュールをインポートします。たとえば、Cloud Firestore と認証を使用するには:

    SwiftUI

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

    迅速

    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()

    迅速

    // 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()メソッドを使用してイベントのログ記録を開始できます。

すべてのアプリで特定のイベントが推奨されます。その他は、特定のビジネス タイプまたは業種に推奨されます。レポートで利用可能な最大の詳細を確保し、利用可能になった将来の機能と統合から利益を得るために、推奨されるイベントを所定のパラメータとともに送信する必要があります。このセクションでは、事前定義されたイベントのログ記録について説明します。イベントのログ記録の詳細については、ログイベント を参照してください。

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

迅速

注:この 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 デバッグ コンソールでこのイベントを表示するには、Analytics デバッグを有効にします。

  1. Xcode で、[製品] > [スキーム] > [スキームの編集... ] を選択します。
  2. 左側のメニューから [実行] を選択します。
  3. 引数タブを選択します。
  4. [起動時に渡される引数] セクションで、 -FIRAnalyticsDebugEnabledを追加します。

次のステップ

,

このクイックスタートでは、Google アナリティクスをアプリに追加し、イベントのログ記録を開始する方法を示します。

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

  • イベント:ユーザー アクション、システム イベント、エラーなど、アプリで発生していること。
  • ユーザー プロパティ:言語設定や地理的位置など、ユーザー ベースのセグメントを説明するために定義する属性。

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

あなたが始める前に

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

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

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

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

  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
  3. 分析ライブラリを選択します。
  4. Analytics を最適に使用するには、Firebase プロジェクトでGoogle Analytics を有効にし、Google Analytics 用の Firebase SDK をアプリに追加することをお勧めします。 IDFA コレクションのないライブラリまたは IDFA コレクションのあるライブラリのいずれかを選択できます。
  5. 完了すると、Xcode はバックグラウンドで依存関係の解決とダウンロードを自動的に開始します。

デバイス レベルの広告識別子である IDFA について詳しくは、Apple のユーザー プライバシーとデータ使用およびアプリ トラッキングの透明性に関するドキュメントをご覧ください。

次に、いくつかの構成手順を実行します。

  1. UIApplicationDelegateにFirebaseCoreモジュールをインポートし、アプリ デリゲートが使用する他のすべてのFirebase モジュールをインポートします。たとえば、Cloud Firestore と認証を使用するには:

    SwiftUI

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

    迅速

    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()

    迅速

    // 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()メソッドを使用してイベントのログ記録を開始できます。

すべてのアプリで特定のイベントが推奨されます。その他は、特定のビジネス タイプまたは業種に推奨されます。レポートで利用可能な最大の詳細を確保し、利用可能になった将来の機能と統合から利益を得るために、推奨されるイベントを所定のパラメータとともに送信する必要があります。このセクションでは、事前定義されたイベントのログ記録について説明します。イベントのログ記録の詳細については、ログイベント を参照してください。

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

迅速

注:この 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 デバッグ コンソールでこのイベントを表示するには、Analytics デバッグを有効にします。

  1. Xcode で、[製品] > [スキーム] > [スキームの編集... ] を選択します。
  2. 左側のメニューから [実行] を選択します。
  3. 引数タブを選択します。
  4. [起動時に渡される引数] セクションで、 -FIRAnalyticsDebugEnabledを追加します。

次のステップ