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

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

• 無料のアプリ測定ソリューションである Google Analytics を使用してゲームイベントをログに記録します。これにより、アプリの使用状況やユーザー エンゲージメントに関する分析情報を得ることができます。

• Crashlytics、Remote Config などのゲームをサポートする Firebase プロダクトを使用します。

使ってみる

1. まだ Firebase プロジェクトを作成していない場合は作成し、ゲームに Firebase を追加します（C++ | Unity）。

   次の点にご注意ください。

   • 以前に Play Console で Google Play デベロッパー アカウントを Google Cloud プロジェクトにリンクしたことがある場合は、そのプロジェクトを使用して Firebase の使用を開始してください。バックグラウンドでは Firebase プロジェクトは Google Cloud プロジェクトと同じです（詳細）。
   • Firebase プロジェクトの作成フロー中に Google Analytics を有効にしてください。または、プロジェクトの作成後に Firebase コンソールの [統合] タブで有効にしてください。

2. Firebase アプリを Google Play デベロッパー アカウントにリンクします。 このリンクは Play Games services プロジェクトでも使用されます。
   Firebase コンソールで、[統合] タブに移動します。 Google Play カードで [リンク] をクリックし、画面の指示に沿ってリンクを作成します。

3. Google Play のアプリが Play Games services を使用するように設定されていることを確認します。

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

Google Analytics を使用してゲームイベントをログに記録する

1. Google Analytics をアプリに追加します。

2. Google Analytics 用の Firebase SDK をアプリに追加したら、Play Games イベントのロギングを開始できます。ロギングできるイベントの例を次に示します。

   • ログイン イベント

     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);
     

3. ログに記録されたイベントは、Firebase コンソールの Analytics ダッシュボードで確認できます。

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

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

Analytics ダッシュボードで Play Games イベントを表示できない

• Firebase プロジェクトで Google Analytics が有効になっていて、ゲームに Google Analytics を統合していることを確認します。

• コードが LOGIN、UNLOCK_ACHIEVEMENT、または POST_SCORE のイベントを実装していることを確認します。

• 詳細ログを有効にして、SDK がイベントのロギングを行っていることを確認します。デバイスはバッテリー持続時間を維持するためにイベントをバッチ処理するので、これらのイベントが Analytics ダッシュボードに表示されるまでに時間がかかる場合があります。

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

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

• アプリがリンクに必要な前提条件をすべて満たしていることを確認してください。

• リンクの作成に必要なアクセス権があることを確認してください。

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

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