整合 Firebase 與 Play 遊戲服務專案

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

• 使用 Google Analytics 記錄遊戲事件，這是一項免費的應用程式評估解決方案，可提供應用程式使用情形和使用者參與度的深入分析。

• 使用任何支援遊戲的 Firebase 產品，例如 Crashlytics、Remote Config 等。

開始使用

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

2. 將 Firebase 應用程式連結至 Google Play 開發人員帳戶。Play Games services 專案會使用同一個連結。
   在 Firebase 控制台中，前往「Integrations」(整合) 分頁。 在「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 控制台中，按一下「Game details」(遊戲詳細資料) 頁面中應用程式圖示旁的 Firebase 圖示，存取 Firebase 控制台。

疑難排解常見錯誤

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

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

• 確認程式碼是否導入 LOGIN、UNLOCK_ACHIEVEMENT 或 POST_SCORE 的事件。

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

無法將「Google Play」連結至 Firebase

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

• 確認應用程式符合所有連結必備條件。

• 請確認您具備建立連結的必要存取權。

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

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