Firebase を Play ゲームサービスプロジェクトと統合する

Firebase はゲームをレベルアップさせるのに役立ちます。

無料のアプリ測定ソリューションである Google アナリティクスを使用してゲームイベントをログに記録します。これにより、アプリの使用状況やユーザーエンゲージメントに関する分析情報を得ることができます。
Crashlytics や Remote Config などのゲームをサポートする Firebase プロダクトを使用します。

始める

まだ Firebase プロジェクトを作成していない場合は作成し、ゲームに Firebase を追加します（C++ | Unity）。
次の点にご注意ください。
- 以前に Google Play Console で Google Play デベロッパーアカウントを Google Cloud プロジェクトにリンクしたことがある場合は、そのプロジェクトを使用して Firebase の使用を開始してください。バックグラウンドでは Firebase プロジェクトは Google Cloud プロジェクトと同じです（詳細）。
- Firebase プロジェクトの作成フロー中に Google アナリティクスを有効にしてください。または、プロジェクトの作成後に Firebase コンソールの [統合] タブで Google アナリティクスを有効にしてください。
Firebase アプリを Google Play デベロッパーアカウントにリンクします。このリンクは Play ゲームサービスプロジェクトでも使用されます。
Firebase コンソールで [統合] タブに移動します。Google Play カードで [リンク] をクリックし、画面の指示に沿ってリンクを作成します。
Google Play でアプリが Play ゲームサービスを使用するように設定されていることを確認します。

ゲームですでに Google API を使用しているかどうかを尋ねられたら、[はい、ゲームで Google API をすでに使用しています] を選択してください。リストから Firebase プロジェクトを選択し、[使用する] をクリックしてください。

Google アナリティクスを使用してゲームイベントをログに記録する

Google アナリティクスをアプリに追加します。

Google アナリティクス用の Firebase SDK をアプリに追加したら、Play ゲームのイベントのロギングを開始できます。ロギングできるイベントの例を次に示します。

ログインイベント

Bundle bundle = new Bundle();
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.LOGIN, bundle);

ロック解除の達成

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ACHIEVEMENT_ID, achievementId);
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.UNLOCK_ACHIEVEMENT, bundle);

リーダーボード上のスコア

Bundle bundle = new Bundle();
bundle.putLong(FirebaseAnalytics.Param.SCORE, score);
bundle.putString("leaderboard_id", leaderboardId);
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.POST_SCORE, bundle);

ログに記録されたイベントは、Firebase コンソールのアナリティクスダッシュボードで確認できます。

また、Google Play Console のゲーム詳細ページのアプリアイコンの隣にある Firebase アイコンをクリックして、Firebase コンソールにアクセスすることもできます。

一般的なエラーのトラブルシューティング

アナリティクスダッシュボードで Play ゲームのイベントを表示できない

Firebase プロジェクトで Google アナリティクスが有効になっていて、ゲームに Google アナリティクスを統合していることを確認します。
コードが LOGIN、UNLOCK_ACHIEVEMENT、または POST_SCORE のイベントを実装していることを確認します。
詳細ログを有効にして、SDK がイベントのロギングを行っていることを確認します。デバイスはバッテリー持続時間を維持するためにイベントをバッチ処理するので、これらのイベントがアナリティクスダッシュボードに表示されるまでに時間がかかる場合があります。

Google Play を Firebase にリンクできない

Firebase コンソールを使用して、Google Play を Firebase にリンクする必要があります（ > [プロジェクトの設定] > [統合] > [Google Play]）。リンクに問題がある場合は、次の点を確認してください。

アプリがリンクに必要な前提条件をすべて満たしていることを確認してください。
リンクの作成に必要なアクセス権があることを確認してください。

Google Play Console から Firebase コンソールにアクセスできない

Google Play デベロッパーアカウントが Firebase アプリにリンクされていることを確認してください。Play デベロッパーアカウントの所有者または管理者は、Google Play Console の [設定] > [リンクされたサービス] > [Firebase] でリンクのステータスを確認できます。