整合 Firebase 與 Play 遊戲服務專案

Firebase 可協助您提升遊戲品質：

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

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

開始使用

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

   請注意以下事項：

   • 如果您先前已將 Google Play 開發人員帳戶連結至 Play 控制台中的 Google Cloud 專案，請使用該專案開始使用 Firebase。在幕後，Firebase 專案是 Google Cloud 專案 (瞭解詳情)。
   • 請務必在 Firebase 專案建立流程中啟用 Google Analytics，或是在建立專案後，前往 Firebase 主控台的「Integrations」分頁 啟用。

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 資訊主頁中查看記錄的事件。

   您也可以在「遊戲詳細資料」頁面中，點選應用程式圖示旁的 Firebase 圖示，從 Play 管理中心存取 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 控制台存取 Firebase 控制台

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