AppMKTG
JA EN

iOSアプリにFirebase Analyticsを導入する手順

本記事は開発者向けの内容です。SDKの導入やコードの実装など、アプリのソースコードを編集する作業を含みます。

記事内の手順やコードは実装の一例です。実際の導入は、ご自身のアプリの構成や開発環境に合わせて行ってください。本記事の内容を参考にした実装によって生じた不具合や損害について、当サイトは責任を負いかねます。

目次

  1. SDKの導入
  2. AdSupport Frameworkの追加
  3. ATTの実装
  4. App Store IDの登録
  5. DebugViewで検証

この記事では、iOSアプリにFirebase Analyticsを導入し、計測が正しく動いていることを確認するまでの手順を解説します。SDKの導入から始め、広告IDを取得するためのAdSupport Frameworkの追加、App Tracking Transparency（ATT）による許諾ダイアログの実装、Firebaseコンソールへの App Store ID の登録を行い、最後にDebugViewでイベントが届いているかを検証します。

SDKの導入

Firebaseの公式ドキュメントに沿って、アプリの登録からSDKの初期化までを行います。

Apple プラットフォーム（iOS）プロジェクトに Firebase を追加する（Firebase 公式ドキュメント）

  1. Firebaseコンソールでプロジェクトを作成し、iOSアプリを登録する

    バンドルIDに加えて、App Store ID も入力します。Firebase 上は任意の項目ですが、Google 広告との連携などで必要になるため、本記事では必須としています。

    Firebaseコンソールの［設定］→［全般］で、マイアプリの［iOS］ボタンを赤枠で囲んだ画面
    ［設定］→［全般］を開き、マイアプリの［iOS］からアプリを登録します。
    ［Apple アプリへの Firebase の追加］の［アプリの登録］画面。Apple バンドル ID、アプリのニックネーム、App Store ID の入力欄がある
    バンドル ID と App Store ID を入力し、［アプリを登録］を押します。
  2. 設定ファイルをダウンロードする

    表示される GoogleService-Info.plist をダウンロードし、Xcode プロジェクトのルートに追加します。追加するときは、アプリのターゲットにチェックが入っていることを確認してください。

    ［設定ファイルのダウンロード］画面。GoogleService-Info.plist をダウンロードし、Xcode プロジェクトに追加する様子の図
    GoogleService-Info.plist をダウンロードして、Xcode プロジェクトのルートに追加します。
  3. Firebase SDK を追加する

    Xcode の [File] → [Add Package Dependencies] を開き、https://github.com/firebase/firebase-ios-sdk を入力します。ライブラリの一覧から FirebaseAnalytics を選択して追加します。

    ［Firebase SDK の追加］画面。Swift Package Manager でリポジトリ URL を入力し、FirebaseAnalytics を追加する手順
    Swift Package Manager でリポジトリ URL を入力し、FirebaseAnalytics を追加します。
  4. 初期化コードを追加する

    アプリの起動時に FirebaseApp.configure() を呼び出します。画面で、使っている構成（SwiftUI・Swift・Objective-C）を選ぶと、対応するコードが表示されます。

    ［初期化コードの追加］画面。SwiftUI を選択した状態の初期化コード
    SwiftUI・Swift・Objective-C から、使っている構成のコードを選べます。
  5. [コンソールに進む] を押し、アプリが追加されていることを確認する

    [設定] → [全般] の [マイアプリ] に、登録した iOS アプリが表示されていれば完了です。

    ［次のステップ］画面。［コンソールに進む］ボタンがある
    ［コンソールに進む］を押して、設定を完了します。

AdSupport Frameworkの追加

Firebase Analytics で広告ID（IDFA）を取得できるようにするため、AdSupport Framework を追加します。広告ID は Google 広告との連携や広告効果の測定に使われます。

フレームワークを追加する

  1. Xcode でプロジェクトのターゲットを選択する
  2. [General] タブを開く
  3. [Frameworks, Libraries, and Embedded Content] の [+] をクリックする
  4. [AdSupport.framework] を選択して追加する
    Xcode のターゲットの［General］タブ。［General］、［Frameworks, Libraries, and Embedded Content］と、一覧に追加された AdSupport.framework を赤枠で囲んでいる
    一覧に AdSupport.framework が表示されていれば追加できています。

-ObjC リンカーフラグを追加する

  1. ターゲットの [Build Settings] タブを開き、表示を [All] にする
  2. 右上の検索欄に「Other Linker Flags」と入力する（[Linking - General] 内に表示されます）
  3. -ObjC を追加する
    Xcode の［Build Settings］タブ。［Build Settings］、表示切り替えの［All］、Other Linker Flags に -ObjC が設定された行を赤枠で囲んでいる
    ［All］を選び、［Linking - General］の Other Linker Flags に -ObjC が入っていることを確認します。

ATTの実装

iOS 14.5 以降、ユーザーのトラッキングや広告ID（IDFA）へのアクセスには、App Tracking Transparency（ATT）フレームワークを通じてユーザーの許可を得ることが Apple により求められています。実装は、Firebase の公式ドキュメントに沿って進めます。

iOS 14 のサポート（Firebase 公式ドキュメント）

App Store IDの登録

登録時に入力しなかった場合は、次の手順で後から登録してください。

  1. Firebase コンソールで対象のプロジェクトを開く
  2. 左メニューの [設定] → [全般] を開く
    Firebaseコンソールの左メニューの［設定］と、サブメニューの［全般］を枠で囲んだ画面
    左メニューの［設定］から［全般］を選びます。
  3. [マイアプリ] で、対象の iOS アプリを選択する
    ［全般］の［マイアプリ］でiOSアプリを選択した画面。［マイアプリ］、選択中のiOSアプリ、［App Store ID］の項目を赤枠で囲んでいる
    ［マイアプリ］で対象のアプリを選び、［App Store ID を追加］から入力します。
  4. [App Store ID] に ID を入力する

App Store ID は、App Store のアプリページの URL（apps.apple.com/…/id123456789）で、id に続く数字の部分です。

DebugViewで検証

最後に、イベントが Firebase に届いているかを DebugView で確認します。

イベントのデバッグ（Firebase 公式ドキュメント）

  1. Xcode で [Product] → [Scheme] → [Edit Scheme] を開く
  2. [Run] → [Arguments] の [Arguments Passed On Launch] に -FIRDebugEnabled を追加する
  3. 実機またはシミュレーターでアプリを起動する
  4. Firebase コンソールの DebugView を開き、first_open や session_start などのイベントが表示されることを確認する
    Firebase コンソールの DebugView。first_open、session_start、screen_view などのイベントが時系列で表示されている
    DebugView に、アプリで発生したイベントが時系列で表示されます。
  5. 確認が終わったら、デバッグモードを無効にする

    デバッグモードは、一度有効にすると明示的に無効にするまで端末に残ります。[Arguments Passed On Launch] で -FIRDebugEnabled のチェックを外し、-FIRDebugDisabled を追加してチェックを入れた状態で、アプリを一度起動してください。

    Xcode のスキーム編集画面の［Arguments］タブ。-FIRDebugEnabled のチェックを外し、赤枠で囲んだ -FIRDebugDisabled にチェックを入れている
    -FIRDebugDisabled にチェックを入れて起動すると、デバッグモードが無効になります。
次の記事Firebase AnalyticsのイベントをGoogle広告にインポートする手順
© 2026 App MKTG 本サイトは Google および Firebase とは関係のない個人運営のメディアです。