在iOS应用中集成GA4,目前提供两种创建入口:
- 一种是在GA4制台中创建数据流
- 一种是在Firebase控制台创建
两者的后续配置步骤基本一致。
本文以Swift语言开发的应用为例,演示完整的集成流程。APP的应用包ID是BusBookingSwift。
第一步:在GA4中注册iOS应用数据流
在GA4数据流位置点击「添加数据流」——「iOS应用」:
进入注册页面后:
填写以下信息:
- iOS 软件包 ID(Bundle ID):填写 BusBookingSwift(需与 Xcode 项目中的 Bundle Identifier 完全一致)。
- 应用名称:填写您的应用名称,此处示例为 Demo。
- App Store ID:如果尚未注册开发者账号或应用未上架,此处可暂时留空。
填写完成后,点击「注册应用」。
第二步:下载并添加配置文件
注册完成后,页面会进入第二步「下载配置文件」
直接点击「下载的GoogleService-Info.plist」按钮,获取配置文件。
在Xcode中打开你的项目,将下载好的 GoogleService-Info.plist 文件拖拽至 Xcode 项目的根目录,会弹出一个框框,点击Finish完成添加:
最后的效果是:
GoogleService-Info.plist在BusBookingSwift这个文件夹里。
第三步:通过CocoaPods添加Firebase SDK
GA4的iOS SDK通过Firebase SDK提供,推荐使用 CocoaPods 进行依赖管理。
切换到Xcode项目根目录
检查是否有 Podfile,如果没有 Podfile,用如下命令创建一个:
pod init
执行后,项目目录中会生成一个名为 Podfile 的文件
打开 Podfile,在这个位置添加pod ‘Firebase/Analytics’:
保存退出后,输入命令pod install 运行:
该命令会下载 Firebase SDK 及相关依赖库。安装完成后,项目目录下会生成一个.xcworkspace文件,后续的配置都需要在这个文件里面配置。
第四步:添加初始化代码
Xcode里面关闭文件,点击.xcworkspace,一定要通过.xcworkspace打开文件,找到AppDelegate 主类:
在这两个位置添加Firebase初始化代码:
第五步:测试验证集成是否成功
在Xcode顶部工具栏中,选择一个 iOS 模拟器
然后开启开启调试模式,点击Product-Scheme-Edit Scheme,在Run Argument里添加:-FIRDebugEnabled:
点击要做左上角▶(Run)开始测试:
在 Xcode 的控制台(Console)中,如果看到类似以下日志,则表示 SDK 初始化成功并与 GA44服务器完成通信:
[Firebase/Analytics][I-ACS023007] Analytics is enabled successfully
或在GA4上显示服务器成功通信,就表示数据走通。
可以在实时报告里看到:
至此,GA4的基础集成工作已全部完成,你可以在应用内继续添加自定义事件和用户属性,以丰富数据采集维度。


















