此页面由 Cloud Translation API 翻译。

包含 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”（创建新的 Xcode 项目）。
选择对话框顶部的“iOS”。
在“Application”（应用）部分，选择“App”（应用），然后点击“Next”（下一步）。
在显示的对话框中，使用以下值为您的应用命名，并为项目选择其他选项，然后点击下一步：
产品名称：例如 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 按钮

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

425bb1c07921e71d

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

26e5b98711c2787a

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

5. 在 Xcode 中配置 Firebase Analytics

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

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

$ pod init

打开 Podfile 并添加以下内容：

$ vi Podfile

$ pod 'Firebase/Analytics' 54204c9ce2a49666

保存文件并运行：

$ 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 种不同的 Google 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 控制台中看到记录的事件。该工具位于“数据分析”→“事件”中。您还可以通过点击事件来查找参数值。

286b640ed4646163

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

您可以通过 Firebase Analytics 的“转化”标签页仔细检查事件是否已成功标记为转化。如果将该事件标记为转化，Google Ads 就可以将其导入为转化。

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

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