与您的 Play 游戏服务项目集成

Firebase 可以帮助您升级游戏：

• 使用 Google Analytics 记录游戏事件。Google Analytics 是一款免费的应用效果衡量解决方案，可提供关于应用使用情况和用户互动度的数据分析。

• 使用任何支持游戏的 Firebase 产品，如 Crashlytics、Remote Config 等。

开始使用

1. 如果您还没有 Firebase 项目，请创建一个，然后将 Firebase 添加到您的游戏中 (C++ | Unity)。

   请注意以下几点：

   • 如果您之前已在 Play 管理中心将您的 Google Play 开发者账号与某个 Google Cloud 项目关联，请使用该项目开始使用 Firebase。Firebase 项目实际上就是 Google Cloud 项目（了解详情）。
   • 请务必在 Firebase 项目创建流程中启用 Google Analytics，或在项目创建之后通过 Firebase 控制台的“集成”标签页启用它。

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 信息中心查看记录的事件。

   还可以从 Play 管理中心访问 Firebase 控制台，方法是在游戏详情页面上点击应用图标旁边的 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”下查看关联状态。