C++ 版 Google Analytics 使用入门

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

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

Analytics 会自动记录某些事件和用户属性；您无需为此添加任何代码。如果您的应用需要收集额外的数据，您可以在应用中设置多达 25 种不同的 Analytics 用户属性，并记录多达 500 种不同的 Analytics 事件类型。您的应用记录的事件总数没有限制。

要访问此数据，请执行以下操作：

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

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

为帮助您着手使用，Analytics SDK 定义了许多常见于各类型应用（零售、电子商务、旅行以及游戏应用等）的推荐事件。如需详细了解这些事件及其适用情形，请参阅推荐事件。为了让您的报告尽可能详尽，请记录对您的应用有意义的推荐事件及其预设参数。这也可确保当最新的 Google Analytics 功能推出时，您马上就能受益。

准备工作

在使用 Google Analytics 之前，您需要：

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

    如果您的 C++ 项目已在使用 Firebase，那么该项目已经注册并已配置为使用 Firebase。

  • 将 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);

后续步骤