Google アナリティクスを使ってみる

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

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

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

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

始める前に

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

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

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

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

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

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

  1. Firebase の構成に measurementId が含まれていることを確認します。

    • アプリが Firebase Hosting を使用し、Firebase SDK に予約済みの URL を使用している場合:

      Firebase は、アプリケーションの構成を自動的に処理します。設定を完了するには、[プロジェクトの設定] の [アプリ] カードのスクリプトをアプリの <body> タグに追加します(まだ追加していない場合)。

    • アプリが予約済みの URL を使用していない場合: 既存のウェブアプリを使用しているときは、measurementId フィールドが存在するようにコードの Firebase config オブジェクトを更新します。ウェブアプリで Google アナリティクスを使用する必要があります。config オブジェクトは次の例のようになります。

      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"
      };
      
  2. Firebase Analytics を次のように初期化します。

     firebase.analytics();
    

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

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

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

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

  • URL の [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) を削除します。gtag スニペットは次のようになります。

    <script async src="https://www.googletagmanager.com/gtag/js"></script>
    
  • Firebase config スニペットで GA_MEASUREMENT_IDmeasurementId と同じになっている行 gtag('config', 'GA_MEASUREMENT_ID'); を削除します。ページで他のアナリティクス プロパティに他の ID が設定されている場合、この config 行を削除する必要はありません。

  • gtag() でイベントを送信する前に、firebase.analytics() を呼び出します。

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

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

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

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

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

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

次のステップ