转到控制台

C++ 版 Google Analytics for Firebase 使用入门

Google Analytics for Firebase 会为您的应用收集使用情况数据和行为数据。SDK 会记录两种主要类型的信息:

  • 事件:您的应用中发生了什么,例如用户操作、系统事件或错误。
  • 用户属性:您为了描述自己的细分用户群而定义的属性,例如语言首选项或地理位置。

Analytics 会自动记录某些事件用户属性;您无需为此添加任何代码。如果您的应用需要收集其他数据,您可以在应用中设置最多 25 种不同的 Analytics 用户属性,以及记录最多 500 种不同的 Analytics 事件类型。 应用可记录的事件总量不受限制。

要访问此数据,请执行以下操作:

  1. Firebase 控制台中,打开您的项目。
  2. 从菜单中选择 Analytics 以查看 Analytics 报告信息中心。

事件标签页会显示事件报告,这些报告是针对应用所记录的每种独特的 Analytics 事件自动创建的。要详细了解 Analytics 报告信息中心,请访问 Firebase 帮助中心。

为帮助您着手使用,Analytics SDK 定义了许多常见于各种应用类型(零售、电子商务、旅行以及游戏等)的推荐事件。如需详细了解这些事件及其适用情形,请在 Firebase 帮助中心浏览事件和属性相关文章。为使报告尽可能地详尽,记录对您的应用有意义的推荐 Analytics 事件及其预设参数。这也可确保在最新的 Google Analytics for Firebase 功能推出时您马上就能受益。

准备工作

使用 Google Analytics for Firebase 之前,您需要:

  • 注册 C++ 项目并将其配置为使用 Firebase。

    如果您的 C++ 项目已经在使用 Firebase,则说明该项目已经注册并且针对 Firebase 进行了配置。

  • 在项目级层 build.gradle 文件中,请务必在您的 buildscriptallprojects 部分添加 Google 的 Maven 代码库。

  • Firebase C++ SDK 添加到您的 C++ 项目。

请注意,将 Firebase 添加到 C++ 项目需要在 Firebase 控制台中和打开的 C++ 项目中执行若干任务(例如,从控制台下载 Firebase 配置文件,然后将配置文件移动到 C++ 项目中)。

创建并初始化 Firebase 应用

在开始之前,您需要先创建并初始化 Firebase 应用:

Android

创建 Firebase 应用,将 JNI 环境和 jobject 引用以参数形式传递到 Java Activity:

app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);

初始化 Analytics 库:

::firebase::analytics::Initialize(app);

iOS

创建 Firebase 应用:

app = ::firebase::App::Create(::firebase::AppOptions());

初始化 Analytics 库:

::firebase::analytics::Initialize(app);

记录事件

配置 firebase::App 实例后,您便可使用 LogEvent() 方法来记录事件。

下面的示例会更新用户的分数:

analytics::LogEvent(analytics::kEventPostScore, analytics::kParameterScore, 42);

后续步骤