包含 Google Analytics for Firebase 自定义事件的 Google Ads - iOS

1. 简介

上次更新日期：2020 年 12 月 14 日

构建内容

在此 Codelab 中，您将学习如何使用 GA4F iOS SDK 实现自定义事件，并通过 Google Ads 发布操作广告系列。

通过本 Codelab，您可以体验客户在应用业务中面临的整个流程。如果您想以更轻松的方式了解 Firebase iOS，请先学习 Firebase iOS Codelab Swift

学习内容

如何在 iOS Swift 中初始化 GA4F（Google Analytics for Firebase）
如何创建自定义事件和参数。
如何将 Firebase 中的事件导入 Google Ads。
使用自定义事件发布操作广告系列。

所需条件

Xcode
Firebase 账号
Google Ads 账号

2. 启动新的 iOS Swift 项目

创建一个简单的模板化 iOS Swift 应用。您将通过修改此起始应用来创建最终应用。

首先，启动 Xcode。

如果您没有已打开的项目，请从欢迎页面中选择“Create a new Xcode project”。
选择对话框顶部的“iOS”。
在“应用”部分中，选择“应用”，然后点击“下一步”。
在随即显示的对话框中，使用以下值来命名应用并为项目选择其他选项，然后点击“下一步”：
产品名称：例如 ios-app

Xcode 会使用您输入的产品名称来命名项目和应用。

团队：如果此字段未自动填充，请将团队设置为“无”。
组织名称：您组织的名称或您自己的姓名。
软件包标识符：此值会根据您的产品名称和组织标识符自动生成。
语言：Swift
选择项目保存位置，然后点击“创建”。
Xcode 会在工作区窗口中打开新项目。

3. 创建和设置 Firebase 项目

如需开始使用 Firebase，您需要创建并设置 Firebase 项目。

创建 Firebase 项目

如果您已有 Firebase 项目，但未启用 Google Analytics，则可以从“设置”>“项目设置”的“集成”标签页中启用 Google Analytics。继续执行 Firebase 配置步骤。

在 Firebase 控制台中，点击“添加项目”（或“创建项目”），然后将您的 Firebase 项目命名为“Firebase-iOS-Ads”

点击相应的项目创建选项。在系统提示是否接受 Firebase 条款时选择“接受”。您应为此项目启用 Google Analytics，因为您需要使用 Google Analytics 事件来跟踪操作事件和转化数据。

如需详细了解 Firebase 项目，请参阅了解 Firebase 项目。

4. Firebase 配置

在 Firebase 控制台中，依次选择左侧导航栏中的“项目概览”>“项目设置”，然后点击“常规”>“您的应用”下的“iOS”按钮

您将在接下来的屏幕中看到如下对话框。

要提供的重要值是 iOS 软件包 ID，您可以使用以下步骤获取该 ID。
在 iOS 应用的 Xcode 项目中，选择项目导航器中的顶级应用，然后选择“常规”标签页。
“软件包标识符”字段的值是 iOS 软件包 ID（类似于 com.yourcompany.yourproject）。复制此值。
在 Firebase 对话框中，将复制的软件包 ID 粘贴到 iOS bundle ID 字段中。
点击注册应用。
还是在 Firebase 中，按照说明下载配置文件 GoogleService-Info.plist

前往 Xcode 项目，然后将您刚刚下载的 GoogleService-Info.plist 文件移至 Xcode 项目的根目录中。
跳过其余的步骤，然后返回 Firebase 控制台的主页面。

5. 在 Xcode 中配置 Firebase Analytics

在此步骤中，您将开始向 Xcode 项目添加 Firebase SDK。

打开一个终端窗口，然后导航到应用的 Xcode 项目所在的位置。
如果您没有 Podfile，请创建一个：

$ pod init

打开 Podfile 并添加：

$ vi Podfile

$ pod 'Firebase/Analytics'

保存文件并运行：

$ pod install

添加初始化代码：

如要在应用启动时连接 Firebase 平台，请在主 AppDelegate 类中添加以下初始化代码。

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}

您已准备就绪！继续前往控制台。

现在，您可以触发一些自定义事件日志！

6. 使用 Firebase Analytics 记录自定义事件

在此步骤中，您将学习如何在 iOS 应用中使用 Firebase Analytics 记录自定义事件。

Firebase Analytics 会自动为您记录一些事件，您无需为此添加任何代码。如果应用需要收集其他数据，您可以在应用中记录多达 500 种不同的 Analytics 自定义事件类型。

记录事件

配置 FirebaseApp 实例后，您就可以开始使用 logEvent() 方法记录事件了。

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

设置默认事件参数

您可以使用 setDefaultEventParameters 跨事件记录参数。默认参数会与记录的所有将来的事件相关联。

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

在 Xcode 调试控制台中查看事件

您可以启用详细日志记录功能以监控 SDK 的事件记录，从而帮助验证是否正确记录了事件，包括自动和手动记录的事件。

您可以按如下方式启用详细日志记录功能：

在 Xcode 中，依次选择 Product > Scheme > Edit scheme…
从左侧菜单中选择 Run。
选择 Arguments 标签页。
在 Arguments Passed On Launch 部分中，添加 -FIRAnalyticsDebugEnabled。

下次您运行应用时，事件将显示在 Xcode 调试控制台中，有助于您即时验证事件是否正在发送。

在信息中心内查看事件

几小时内，您就可以在 Firebase 控制台中看到记录的事件。它位于 Google Analytics →“事件”中。您还可以通过点击相应事件来查找参数值。

您可以通过将“标记为转化”开关向右滑动，将“text_search”标记为转化。

您可以通过 Firebase Analytics 的“转化”标签页仔细检查相应事件是否已成功标记为转化。将此事件标记为转化后，Google Ads 也可以将此事件作为转化进行导入。

7. 在 Google Ads 中导入分析事件

Firebase-iOS 设置已完成，您可以随时发布带有已记录操作事件的应用广告系列。首先，您需要将 Firebase 关联到 Google Ads。通过将 Firebase 关联到 Google Ads，应用广告系列将能够详细了解受众群体并提升应用广告系列的学习效果，这通常会带来更好的效果和转化。