Google Analytics(分析)会收集您的应用的使用情况和行为数据。SDK 会记录两种主要类型的信息:
- 事件:您的应用中发生了什么,例如用户操作、系统事件或错误。
- 用户属性:为描述您的各个细分用户群而定义的属性,例如语言首选项或地理位置。
Analytics(分析)会自动记录某些事件和用户属性;您无需为此添加任何代码。
准备工作
将 Firebase 添加到您的 iOS 项目(如果尚未添加),并确保在 Firebase 项目中启用了 Google Analytics(分析)。
如果您要创建新的 Firebase 项目,请在项目创建工作流内启用 Google Analytics(分析)。
如果您使用的是现有 Firebase 项目,而该项目未启用 Google Analytics(分析),请转到
,然后访问 >“项目设置”集成标签页启用该服务。
在项目中启用 Google Analytics(分析)后,您的 Firebase 应用将关联到 Google Analytics(分析)数据流。
(推荐)将 AdSupport 框架添加到您的项目,以启用受众群体和广告系列归因等其他功能。
将 Analytics SDK 添加到您的应用
- 将 Firebase 的依赖项添加到您的 Podfile 中:
pod 'Firebase/Analytics'
- 运行
pod install
并打开创建的.xcworkspace
文件。 - 在
UIApplicationDelegate
中导入 Firebase 模块:Swift
import Firebase
Objective-C
@import Firebase;
- 配置一个
FirebaseApp
共享实例(通常在应用的application:didFinishLaunchingWithOptions:
方法中配置):Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
(可选)停用 Apple 广告联盟归因注册
为方便起见,该 SDK 会使用 SKAdNetwork 自动向 Apple 注册您的应用,以进行广告联盟归因。如果您想停用此功能,请在应用的 info.plist 文件中将 GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
的值设为 NO
(布尔值)。
开始记录事件
配置 FirebaseApp
实例后,您可以开始使用 logEvent()
方法记录事件。
某些事件适用于所有应用;其他事件则适用于特定业务类型或行业。您应该同时发送推荐事件及指定的参数,以确保报告能够提供最详细的信息,并让您在未来功能和集成方案推出时马上就能受益。本部分展示了如何记录预定义的事件;如需详细了解如何记录事件,请参阅记录事件。
下面的示例展示了如何记录推荐的事件,以表明用户已点击应用中的某个特定元素:
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" }];
要在 Xcode 调试控制台中查看此事件,请启用 Analytics 调试功能:
- 在 Xcode 中,依次选择 Product > Scheme > Edit scheme...。
- 从左侧菜单中选择 Run。
- 选择 Arguments 标签页。
- 在 Arguments Passed On Launch 部分中,添加
-FIRAnalyticsDebugEnabled
。
后续步骤
- 使用 DebugView 验证事件。
- 在 Firebase 控制台中浏览数据。
- 浏览事件和用户属性的相关指南。
- 了解如何将数据导出到 BigQuery。