Get started with Google Analytics（Google アナリティクスの利用を始める）

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

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

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

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

始める前に

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

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

プロジェクトで Google アナリティクスを有効にすると、Firebase ウェブアプリは、アプリ + ウェブプロパティに関連付けられた Google アナリティクスのデータストリームにリンクされます。

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

ウェブアプリケーションのホスト方法によっては、構成が自動的に処理されない場合があります。その場合は、手動で Firebase 構成オブジェクトを更新する必要があります。ウェブアプリですでに Google アナリティクスを使用している場合は、Firebase での既存の gtag.js のタグ付けにある追加の手順が必要になることがあります。

コードの Firebase config オブジェクトに measurementId が含まれていることを確認してください。この ID は、Firebase プロジェクトでアナリティクスを有効にしてウェブアプリを登録すると自動的に作成され、アナリティクスを使用する場合に必要です。

注: Firebase JavaScript SDK v7.20.0 以降を使用するアプリの場合、アプリがアナリティクスを初期化するときに Firebase は measurementId を動的に取得します。この ID を config オブジェクトに含めるかどうかはオプションですが、動的フェッチが失敗するというまれなケースではこれがフォールバックとして機能します。
- アプリが Firebase Hosting を使用し、Firebase SDK に予約済みの URL を使用している場合:
  
  Firebase は、アプリケーションの構成を自動的に処理します。設定を完了するには、[プロジェクトの設定] の [アプリ] カードのスクリプトをアプリの <body> タグに追加します（まだ追加していない場合）。
- アプリが予約済みの URL を使用していない場合: 既存のウェブアプリを使用しているときは、measurementId フィールドが存在するようにコードの Firebase config オブジェクトを更新します。config オブジェクトは次の例のようになります。
```
// For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field
const firebaseConfig = {
  apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc",
  authDomain: "project-id.firebaseapp.com",
  databaseURL: "https://project-id.firebaseio.com",
  projectId: "project-id",
  storageBucket: "project-id.appspot.com",
  messagingSenderId: "637908496727",
  appId: "2:637908496727:web:a4284b4c99e329d5",
  measurementId: "G-9VP01NDSXJ"
};
```
まだ行っていない場合は、Firebase JS SDK をインストールして Firebase を初期化します。
アナリティクス JS SDK を追加して、アナリティクスを初期化します。

モジュール方式の Web API

import { initializeApp } from "firebase/app";
import { getAnalytics } from "firebase/analytics";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);


// Initialize Analytics and get a reference to the service
const analytics = getAnalytics(app);

ウェブ向けの名前空間 API

import firebase from "firebase/compat/app";
import "firebase/compat/analytics";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


// Initialize Analytics and get a reference to the service
const analytics = firebase.analytics();

Firebase で既存の gtag.js タグ付けを使う

gtag.js スニペットを使用してアプリ内ですでに Google アナリティクスを実行している場合、次のいずれかを行うには、アプリで追加の設定が必要になることがあります。

Firebase からの Google アナリティクス呼び出しをページに追加し、同じページに対する gtag() 直接呼び出しを引き続き使用する。
gtag() 直接呼び出しと Firebase に送信される Google アナリティクスデータの間で同じ測定 ID を使用する。

すべての Firebase サービスでイベントが使用されるようにするには、次の追加手順を行います。

gtag('config', 'GA_MEASUREMENT_ID'); の行を削除します。GA_MEASUREMENT_ID は、Firebase ウェブアプリの measurementId です。ページで他のアナリティクスプロパティに他の ID が設定されている場合、この config 行を削除する必要はありません。
gtag() でイベントを送信する前に、firebase.analytics() を呼び出します。

この設定を行わないと、gtag() 呼び出しの ID に送信されたイベントは Firebase に関連付けられず、他の Firebase サービスでのターゲティングに利用できません。

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

アナリティクスサービスを初期化した後、logEvent() メソッドでイベントロギングを開始できます。

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

次の例は、ユーザーがアプリで通知を受信したことを示す推奨イベントをロギングします。

ウェブ向けのモジュラー API

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');analytics_log_event.js

ウェブ向けの名前空間付き API

firebase.analytics().logEvent('notification_received');index.js

次のステップ

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