整合 Firebase 與 Play 遊戲服務專案

Firebase 可協助您提升遊戲體驗:

  • 使用免費的應用程式評估解決方案 Google Analytics 記錄遊戲事件,深入瞭解應用程式使用情況和使用者參與度。

  • 使用支援遊戲的 Firebase 產品,例如 CrashlyticsRemote Config 等。

開始使用

  1. 如果您尚未建立 Firebase 專案,請先建立,然後將 Firebase 新增至遊戲 (C++ | Unity)。

  2. 將 Firebase 應用程式連結至開發人員帳戶Google PlayPlay 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資訊主頁中查看記錄的事件。

    您也可以在「遊戲詳細資料」頁面中,點選應用程式圖示旁的 Firebase 圖示,從 Play管理中心存取 Firebase管理中心。

排解常見錯誤

無法在 Analytics 資訊主頁中查看 Play Games 事件

  • 確認您已為 Firebase 專案啟用 Google Analytics,並已將 Google Analytics整合至遊戲中。

  • 確認程式碼是否為 LOGINUNLOCK_ACHIEVEMENTPOST_SCORE 導入事件。

  • 啟用詳細記錄,確認 SDK 是否正在記錄事件。為節省電量,裝置會批次處理事件,因此這些事件可能需要一段時間才會顯示在 Analytics 資訊主頁中。

您需要使用 Firebase 控制台Google Play 連結至 Firebase (依序點選 >「專案設定」>「整合」>「Google Play)。如果無法順利連結,請檢查下列事項:

無法從 Play 控制台存取 Firebase 控制台

請確認Google Play開發人員帳戶已連結至 Firebase 應用程式。在Play管理中心中,Play開發人員帳戶的擁有者或管理員可以依序前往「設定」 >「已連結的服務」 >「Firebase」,查看連結狀態。