コンソールへ移動

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

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

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

アナリティクスは、一部のイベントユーザー プロパティのログを自動的に記録します。こうしたログ記録を有効にするためのコードを追加する必要はありません。それ以外のデータをアプリで収集する場合は、アナリティクスのユーザー プロパティを最大 25 個まで設定し、最大 500 種類までのアナリティクス イベントをログに記録できます。アプリで記録できるログの量に制限はありません。

このデータにアクセスするには、次のように操作します。

  1. Firebase コンソールでプロジェクトを開きます。
  2. メニューで [アナリティクス] を選択し、アナリティクスのレポート ダッシュボードを表示します。

[イベント] タブには、アプリによってロギングされたアナリティクス イベントの種類ごとに自動的に作成されたイベント レポートが表示されます。アナリティクスのレポート ダッシュボードについて詳しくは、Firebase ヘルプセンターをご覧ください。

アナリティクス SDK には、小売、e コマース、旅行、ゲームなどといったさまざまな種類のアプリでよく使われるイベントが推奨イベントとして多数定義されており、すぐに使うことができます。こうしたイベントの詳細と使い方については、Firebase ヘルプセンターのイベントとプロパティをご覧ください。できる限り詳細なレポートを取得するには、アプリと既定のパラメータに対して適切な推奨アナリティクス イベントを記録します。これにより、Google アナリティクスに新しい機能が追加されたときにその機能を確実に利用できます。

始める前に

Google アナリティクスを使用するには、あらかじめ次の作業が必要です。

  • Firebase を使用するように C++ プロジェクトを登録して構成する。

    C++ プロジェクトですでに Firebase を使用している場合、この登録と構成はすでに行われています。

  • プロジェクト レベルの build.gradle ファイルの buildscript セクションと allprojects セクションの両方に Google の Maven リポジトリを組み込む。

  • Firebase C++ SDK を C++ プロジェクトに追加する。

Firebase を C++ プロジェクトに追加するには、Firebase コンソールと開いている C++ プロジェクトの両方でこのタスクを行う必要があります(コンソールから Firebase 構成ファイルをダウンロードして C++ プロジェクトに移動するなど)。

firebase App を作成して初期化する

最初に、firebase App を作成して初期化する必要があります。

Android

Firebase アプリを作成し、引数として JNI 環境と jobject 参照を Java アクティビティに渡します。

app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);

アナリティクス ライブラリを初期化します。

::firebase::analytics::Initialize(app);

iOS

firebase App を作成します。

app = ::firebase::App::Create(::firebase::AppOptions());

アナリティクス ライブラリを初期化します。

::firebase::analytics::Initialize(app);

イベントをロギングする

firebase::App インスタンスを構成すると、LogEvent() メソッドを使ってイベントをログに記録できるようになります。

次の例は、ユーザーの得点を更新するコードです。

analytics::LogEvent(analytics::kEventPostScore, analytics::kParameterScore, 42);

次のステップ