本文介绍了如何使用 Google Analytics for Firebase SDK 将事件从应用发送到 Google Analytics(分析)。如需了解如何从您的网站发送事件,请参阅发送事件。如需详细了解事件,请参阅事件简介。
准备工作
确保您已按照 Google Analytics(分析)使用入门中的说明设置了您的项目,并且可以使用 Google Analytics(分析)。
发送事件
配置 FirebaseApp
实例后,您就可以开始使用 logEvent()
方法发送事件了。该方法等同于在 gtag.js 中使用 event 命令。
您可在以下位置找到有关如何实现推荐的事件类型的详细说明:
- 推荐的事件:请参阅 com.google.firebase.analytics.FirebaseAnalytics.Event 类参考文档。
- 预设参数:请参阅 com.google.firebase.analytics.FirebaseAnalytics.Param 参考文档。
下面的示例演示了如何发送名为 select_content
的推荐事件:
Swift
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
AnalyticsParameterItemID: "id-\(title!)",
AnalyticsParameterItemName: title!,
AnalyticsParameterContentType: "cont",
])
Objective-C
[FIRAnalytics logEventWithName:kFIREventSelectContent
parameters:@{
kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
kFIRParameterItemName:self.title,
kFIRParameterContentType:@"image"
}];
除了预设参数外,您还可以将以下参数添加到任何事件中:
- 自定义参数:自定义参数可以用作 Google Analytics(分析)报告中的维度和指标。您可以对非数值事件参数数据使用自定义维度,而对任何以更好的数值形式表示的参数数据使用自定义指标。使用 SDK 记录自定义参数后,请注册维度或指标,以确保这些自定义参数能够出现在 Google Analytics(分析)报告中。可依次点击以下各项完成此操作:“Google Analytics(分析)”>“事件”>“管理自定义设置”>“创建自定义维度”
kFIRParameterValue
参数:kFIRParameterValue
是一个通用参数,可用于累积与事件相关的关键指标,例如收入、距离、时间和分数。
如果推荐的事件类型未涵盖您的应用的特定需求,您可以按以下示例所示方式记录自己的自定义事件:
Swift
Analytics.logEvent("share_image", parameters: [
"name": name as NSObject,
"full_text": text as NSObject,
])
Objective-C
[FIRAnalytics logEventWithName:@"share_image"
parameters:@{
@"name": name,
@"full_text": text
}];
设置默认事件参数
您可以使用 setDefaultEventParameters
跨事件记录参数。默认参数会与记录的所有将来的事件相关联。
与自定义参数一样,请注册默认事件参数,以确保这些自定义参数显示在 Google Analytics(分析)报告中。
Swift
Analytics.setDefaultEventParameters([ "level_name": "Caverns01", "level_difficulty": 4 ])
Objective-C
[FIRAnalytics setDefaultEventParameters:
@{
@"level_name": "Caverns01",
@"level_difficulty": @(4)
}];
如果在 logEvent()
方法中指定了一个参数,则系统会使用该值而非默认值。
如需清除默认参数,请调用 setDefaultEventParameters
方法,并将参数设置为 nil
。
在 Xcode 调试控制台中查看事件
您可以启用详细日志记录功能以监控 SDK 的事件记录,从而帮助验证是否正确记录了事件,包括自动和手动记录的事件。
您可以按如下方式启用详细日志记录功能:
- 在 Xcode 中,依次选择 Product > Scheme > Edit scheme…
- 从左侧菜单中选择 Run。
- 选择 Arguments 标签页。
- 在 Arguments Passed On Launch 部分,添加
-FIRAnalyticsDebugEnabled
。
下次您运行应用时,事件将显示在 Xcode 调试控制台中,有助于您即时验证事件是否正在发送。
在信息中心内查看事件
您可以在 Firebase 控制台信息中心内查看有关事件的汇总统计信息。这些信息中心会全天定时更新。如需立即测试,请按照上一部分中所述的方式使用 logcat 输出。
您可以在 Firebase 控制台的事件信息中心访问这些数据。此信息中心显示了为应用记录的每种不同事件自动创建的事件报告。