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

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

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

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

使ってみる

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

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

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

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 を統合していることを確認します。

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

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

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

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

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

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

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