將 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 控制台的“集成”選項卡中創建項目後啟用它。

2. 將您的 Firebase 應用鏈接到您的 Google Play 開發者帳戶。您的 Play 遊戲服務項目將使用同一鏈接。
   在 Firebase 控制台中，轉到“集成”選項卡。在Google Play卡上，單擊鏈接，然後按照屏幕上的說明創建鏈接。

3. 確保您在 Google Play 中的應用已設置為使用 Play 遊戲服務。

   當系統要求您指定您的遊戲是否已使用 Google API 時，請選擇是，我的遊戲已使用 Google API 。從列表中選擇您的 Firebase 項目，然後單擊“使用” 。

使用 Google Analytics 記錄遊戲事件

1. 將 Google Analytics 添加到您的應用程序中。

2. 將適用於 Google Analytics 的 Firebase SDK 添加到您的應用後，您就可以開始記錄 Play 遊戲事件。以下是您可以記錄的一些示例事件：

   • 登錄事件

     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 Console訪問 Firebase 控制台。

常見錯誤故障排除

無法在 Analytics 信息中心中查看 Play 遊戲事件

• 檢查您是否已為 Firebase 項目啟用 Google Analytics（分析） ，以及是否已將Google Analytics（分析）集成到您的遊戲中。

• 驗證您的代碼是否實現了LOGIN 、 UNLOCK_ACHIEVEMENT或POST_SCORE事件。

• 通過啟用詳細日誌記錄來驗證 SDK 是否正在記錄事件。由於設備對事件進行批處理以延長電池壽命，因此可能需要一些時間才能在 Analytics 儀表板中看到這些事件。

無法將 Google Play 關聯到 Firebase

您需要使用 Firebase 控制台（ >項目設置>集成> Google Play ）將 Google Play 鏈接到 Firebase 。如果您在鏈接時遇到問題，請檢查以下內容：

• 確保您的應用程序滿足鏈接的所有先決條件。

• 確保您擁有創建鏈接所需的訪問權限。

無法從 Play 管理中心訪問 Firebase 控制台

確保您的 Google Play 開發者帳戶已關聯到 Firebase 應用。在Play Console中，Play 開發者帳戶的所有者或管理員可以在設置鏈接服務> Firebase下查看鏈接狀態。