本快速入门向您展示如何将 Google Analytics 添加到您的应用程序并开始记录事件。
Google Analytics 收集您应用程序的使用情况和行为数据。 SDK 记录两种主要类型的信息:
- 事件:您的应用程序中发生的事情,例如用户操作、系统事件或错误。
- 用户属性:您定义的用于描述用户群细分的属性,例如语言偏好或地理位置。
Analytics 自动记录一些事件和用户属性;您无需添加任何代码即可启用它们。
在你开始之前
如果您还没有,请将 Firebase 添加到您的 Apple 项目并确保在您的 Firebase 项目中启用了 Google Analytics:
如果您要创建新的 Firebase 项目,请在项目创建工作流程中启用 Google Analytics。
如果您使用的是未启用 Google Analytics 的现有 Firebase 项目,请转到设置的“集成”选项卡 >项目设置 启用它。
当您在项目中启用 Google Analytics 时,您的 Firebase 应用程序会链接到 Google Analytics 数据流。
(推荐) 。将 AdSupport 框架添加到您的项目以启用其他功能,例如受众和活动归因。
将 Analytics SDK 添加到您的应用程序
使用 Swift Package Manager 安装和管理 Firebase 依赖项。
- 在 Xcode 中,打开您的应用程序项目,导航至File > Add Packages 。
- 出现提示时,添加 Firebase Apple 平台 SDK 存储库:
- 选择分析库。
- 为了获得最佳的 Analytics 体验,我们建议在您的 Firebase 项目中启用 Google Analytics ,并将适用于 Google Analytics 的 Firebase SDK 添加到您的应用中。您可以选择没有 IDFA 集合或有 IDFA 集合的库。
- 完成后,Xcode 将自动开始在后台解析和下载您的依赖项。
https://github.com/firebase/firebase-ios-sdk
在 Apple 的用户隐私和数据使用以及App Tracking Transparency文档中了解有关设备级广告标识符 IDFA 的更多信息。
接下来,执行一些配置步骤:
- 在您的
UIApplicationDelegate
中导入FirebaseCore
模块,以及您的应用委托使用的任何其他Firebase 模块。例如,要使用 Cloud Firestore 和身份验证:斯威夫特用户界面
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
迅速
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
目标-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- 在您的应用委托的
application(_:didFinishLaunchingWithOptions:)
方法中配置一个FirebaseApp
共享实例:斯威夫特用户界面
// Use Firebase library to configure APIs FirebaseApp.configure()
迅速
// Use Firebase library to configure APIs FirebaseApp.configure()
目标-C
// Use Firebase library to configure APIs [FIRApp configure];
- 如果您使用的是 SwiftUI,则必须创建一个应用程序委托并通过
UIApplicationDelegateAdaptor
或NSApplicationDelegateAdaptor
将其附加到您的App
结构。您还必须禁用应用委托调配。有关详细信息,请参阅SwiftUI 说明。斯威夫特用户界面
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
(可选)禁用 Apple 广告网络归因注册
为了您的方便,SDK 会自动向 Apple注册您的应用程序,以便使用SKAdNetwork进行广告网络归因。如果您希望禁用此功能,请在应用的 info.plist 文件中将GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
的值设置为NO
(布尔值)。
开始记录事件
配置FirebaseApp
实例后,您可以开始使用logEvent()
方法记录事件。
某些事件被推荐用于所有应用程序;其他建议用于特定的业务类型或垂直行业。您应该发送建议的事件及其规定的参数,以确保报告中提供尽可能多的可用详细信息,并在未来可用的功能和集成中受益。本节演示记录预定义事件,有关记录事件的更多信息,请参阅记录事件。
以下示例演示了如何记录推荐事件以指示用户单击了您应用中的特定元素:
迅速
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
目标-C
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
要在 Xcode 调试控制台中查看此事件,请启用 Analytics 调试:
- 在 Xcode 中,选择Product > Scheme > Edit scheme...
- 从左侧菜单中选择运行。
- 选择参数选项卡。
- 在启动时传递的参数部分中,添加
-FIRAnalyticsDebugEnabled
。
下一步
- 使用DebugView验证您的事件。
- 在Firebase 控制台中探索您的数据。
- 浏览有关事件和用户属性的指南。
- 了解如何将数据导出到BigQuery。
本快速入门向您展示如何将 Google Analytics 添加到您的应用程序并开始记录事件。
Google Analytics 收集您应用程序的使用情况和行为数据。 SDK 记录两种主要类型的信息:
- 事件:您的应用程序中发生的事情,例如用户操作、系统事件或错误。
- 用户属性:您定义的用于描述用户群细分的属性,例如语言偏好或地理位置。
Analytics 自动记录一些事件和用户属性;您无需添加任何代码即可启用它们。
在你开始之前
如果您还没有,请将 Firebase 添加到您的 Apple 项目并确保在您的 Firebase 项目中启用了 Google Analytics:
如果您要创建新的 Firebase 项目,请在项目创建工作流程中启用 Google Analytics。
如果您使用的是未启用 Google Analytics 的现有 Firebase 项目,请转到设置的“集成”选项卡 >项目设置 启用它。
当您在项目中启用 Google Analytics 时,您的 Firebase 应用程序会链接到 Google Analytics 数据流。
(推荐) 。将 AdSupport 框架添加到您的项目以启用其他功能,例如受众和活动归因。
将 Analytics SDK 添加到您的应用程序
使用 Swift Package Manager 安装和管理 Firebase 依赖项。
- 在 Xcode 中,打开您的应用程序项目,导航至File > Add Packages 。
- 出现提示时,添加 Firebase Apple 平台 SDK 存储库:
- 选择分析库。
- 为了获得最佳的 Analytics 体验,我们建议在您的 Firebase 项目中启用 Google Analytics ,并将适用于 Google Analytics 的 Firebase SDK 添加到您的应用中。您可以选择没有 IDFA 集合或有 IDFA 集合的库。
- 完成后,Xcode 将自动开始在后台解析和下载您的依赖项。
https://github.com/firebase/firebase-ios-sdk
在 Apple 的用户隐私和数据使用以及App Tracking Transparency文档中了解有关设备级广告标识符 IDFA 的更多信息。
接下来,执行一些配置步骤:
- 在您的
UIApplicationDelegate
中导入FirebaseCore
模块,以及您的应用委托使用的任何其他Firebase 模块。例如,要使用 Cloud Firestore 和身份验证:斯威夫特用户界面
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
迅速
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
目标-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- 在您的应用委托的
application(_:didFinishLaunchingWithOptions:)
方法中配置一个FirebaseApp
共享实例:斯威夫特用户界面
// Use Firebase library to configure APIs FirebaseApp.configure()
迅速
// Use Firebase library to configure APIs FirebaseApp.configure()
目标-C
// Use Firebase library to configure APIs [FIRApp configure];
- 如果您使用的是 SwiftUI,则必须创建一个应用程序委托并通过
UIApplicationDelegateAdaptor
或NSApplicationDelegateAdaptor
将其附加到您的App
结构。您还必须禁用应用委托调配。有关详细信息,请参阅SwiftUI 说明。斯威夫特用户界面
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
(可选)禁用 Apple 广告网络归因注册
为了您的方便,SDK 会自动向 Apple注册您的应用程序,以便使用SKAdNetwork进行广告网络归因。如果您希望禁用此功能,请在应用的 info.plist 文件中将GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
的值设置为NO
(布尔值)。
开始记录事件
配置FirebaseApp
实例后,您可以开始使用logEvent()
方法记录事件。
某些事件被推荐用于所有应用程序;其他建议用于特定的业务类型或垂直行业。您应该发送建议的事件及其规定的参数,以确保报告中提供尽可能多的可用详细信息,并在未来可用的功能和集成中受益。本节演示记录预定义事件,有关记录事件的更多信息,请参阅记录事件。
以下示例演示了如何记录推荐事件以指示用户单击了您应用中的特定元素:
迅速
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
目标-C
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
要在 Xcode 调试控制台中查看此事件,请启用 Analytics 调试:
- 在 Xcode 中,选择Product > Scheme > Edit scheme...
- 从左侧菜单中选择运行。
- 选择参数选项卡。
- 在启动时传递的参数部分中,添加
-FIRAnalyticsDebugEnabled
。
下一步
- 使用DebugView验证您的事件。
- 在Firebase 控制台中探索您的数据。
- 浏览有关事件和用户属性的指南。
- 了解如何将数据导出到BigQuery。