Google Ads 与 Google Analytics for Firebase 自定义事件 - Unity

1. 简介

上次更新时间：2021 年 2 月 19 日

构建内容

在此 Codelab 中，您将学习如何在 Unity 环境中使用 Google Analytics for Firebase (GA4F) iOS 实现自定义事件，以及如何通过 Google Ads 发布操作广告系列。

在本 Codelab 中，您可以体验客户在应用业务中面临的整个流程。如果您想了解有关在 iOS 上使用 Firebase 和 AdMob 的更简单易懂的入门知识，请先参阅 AdMob+Firebase 101 Unity：设置和 Analytics 基础知识。

学习内容

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

所需条件

• Xcode
• Unity
• Firebase 账号
• Google Ads 账号

2. 启动新的 Unity 项目

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

启动 Unity

1. 如果您没有已打开的项目，请选择“创建新项目”。
2. 从对话框中选择 3D 模板。
3. 填写项目名称：例如 Unity Firebase 自定义事件。
4. 选择一个位置来保存项目，然后点击“创建”。
5. Unity 会在工作区窗口中打开新项目。

3. 创建和设置 Firebase 项目

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

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

1. 登录 Firebase。

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

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

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

4. Unity 配置

1. 在 Unity 中，依次选择“文件”>“构建设置”。重要值是设置 iOS 软件包 ID，您可以使用以下步骤获取该 ID。

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

2. 在 iOS 应用的 Unity 项目中，打开“构建设置”对话框（依次选择 File > Build Settings）。如果平台未设置为 iOS，您可以选择 iOS 平台，然后点击 Switch Platform 按钮。

3. 更改平台后，点击“Player Settings”（播放器设置）按钮以设置软件包 ID。您可以看到身份证件区域周围的文本字段。
4. “Bundle Identifier”（软件包标识符）字段的值是 iOS 软件包 ID（类似于 com.yourcompany.yourproject）。复制此值或设置您的值并复制它。
5. 在 Firebase 对话框中，将复制的软件包 ID 粘贴到 iOS bundle ID 字段中。
6. 点击注册应用。
7. 还是在 Firebase 中，按照说明下载配置文件 GoogleService-Info.plist
8. 打开 Unity 项目的“Project”窗口，然后将配置文件移动到 Assets 文件夹中。
9. 跳过其余的步骤，然后返回 Firebase 控制台的主页面。

5. 在 Unity 中配置 Firebase Analytics

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

1. 前往 Firebase 控制台。
2. 在项目概览页面的中心位置，点击 Unity 图标 ( ) 以启动设置工作流。如果您已向 Firebase 项目添加了应用，请点击添加应用以显示平台选项。
3. 选择您要注册的 Unity 项目的 build 目标，甚至可以选择同时注册两个目标。

注意：如果您现在只注册 Unity 项目的一个 build 目标，之后可以随时返回到设置工作流注册另一个 build 目标。

4. 输入 Unity 项目针对具体平台的 ID。

• 对于 iOS - 在 iOS 软件包 ID 字段中输入您的 Unity 项目的 iOS ID。
• 对于 Android - 在 Android 软件包名称字段中输入您的 Unity 项目的 Android ID。术语“软件包名称”和“应用 ID”通常可互换使用。

5. 在哪里可以找到您的 Unity 项目 ID？

注意：请确保输入项目实际使用的 ID。此 ID 值区分大小写。当您在 Firebase 项目中注册这些 Firebase 应用后，此 ID 值无法再更改。

6. （可选）输入 Unity 项目针对具体平台的别名。这些别名是方便内部使用的标识符，只有您能在 Firebase 控制台中看到。
7. 点击注册应用。

添加 Firebase Analytics Unity SDK

1. 在 Firebase 控制台中，点击下载 Firebase Unity SDK，然后将此 SDK 解压缩到方便的位置。

• 您可以随时再次下载 Firebase Unity SDK。
• Firebase Unity SDK 不局限于特定平台。

2. 在您打开的 Unity 项目中，依次点击 Assets（资源）> Import Package（导入软件包）> Custom Package（自定义软件包）。
3. 从解压缩的 SDK 中，选择您希望在应用中使用且受支持的 Firebase 产品。

• 添加支持 Google Analytics 的 Firebase 软件包：FirebaseAnalytics.unitypackage
• 为要在应用中使用的任何其他 Firebase 产品添加软件包。例如，要使用 Firebase Authentication 和 Firebase Realtime Database，需要添加 FirebaseAuth.unitypackage 和 FirebaseDatabase.unitypackage

Unity 5.x 及更低版本使用 .NET 3.x 框架，因此请导入 dotnet3/ 软件包。Unity 2017.x 及更高版本支持 .NET 4.x 框架。如果您的 Unity 项目使用 .NET 4.x，请导入 dotnet4/ 软件包。Unity 2019 及更高版本不再支持 .NET 3.x 框架，因此请导入 dotnet4/ 软件包。

4. 在“Import Unity Package”窗口中，点击 Import。
5. 返回 Firebase 控制台，在设置工作流中，点击下一步。

重要提示：使用 iOS 版 Firebase Unity SDK 时，请勿停用方法调配。SDK 需要调配，如果禁止调配，关键的 Firebase 功能（如 FCM 令牌处理）将无法正常运行。

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

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

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

记录事件

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

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

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

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

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

1. 在 Xcode 中，依次选择 Product > Scheme > Edit scheme…
2. 从左侧菜单中选择 Run。
3. 选择 Arguments 标签页。
4. 在 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，应用广告系列将能够详细了解受众群体并提升应用广告系列的机器学习效果，这通常会带来更好的效果和转化。

1. 点击“项目概览”旁边的按钮转到 Firebase“设置”。
2. 在“集成”标签页中，您会看到“Google Ads”和对应的“关联”按钮。点击“关联”和“继续”。

3. 选择 Google Ads 账号。

注意：如果目标事件未标记为转化，Google Ads 将无法将其导入。请确保该事件已正确标记为转化。

现在，Firebase 部分已完成。

现在，前往 Google Ads 并登录。

1. 前往 Google Ads 并登录，然后依次前往“工具与设置”→“衡量”→“转化”，用于将自定义事件导入为转化。
2. 点击“+”按钮即可添加新的转化操作。

3. 选择“Google Analytics 4 媒体资源 (Firebase)”，然后点击“继续”。

4. 您可以看到标记为转化的所有分析事件。找到我们之前实现的 clicked_counter 事件。

5. 选中并点击“导入并继续”按钮。

将 text_search 设置为转化操作后，您现在可以发布广告系列，以定位可能会触发 text_search 事件的用户。

8. 使用导入的事件发布应用操作广告系列

重要提示：为了发布应用广告系列，您需要在 Google Play 中拥有一个生产级应用。如果您尚未准备好发布应用，请暂时跳过此步骤。

6. 转到当前账号的“广告系列”标签页，然后点击“+”按钮制作新的广告系列。点击新广告系列，然后继续。
7. 这次，我们将发布一个应用宣传广告系列，其中包含“应用安装”选项。

8. 提供应用名称、软件包名称或发布商，找到您的应用。
9. 在“出价”部分，从下拉菜单中选择“应用内操作”，以便 Google Ads 重点关注相应操作。
10. 您可以在提供的列表中找到您的自定义事件。设置目标每次转化费用，并填写其他选项。

11. 配置广告系列设置。这不在本 Codelab 的范围内，因此请参阅这些文档，或通过任何其他渠道联系我们以优化设置。

9. 恭喜

恭喜！您已成功将 Firebase 与 Unity 和 Google Ads 集成！这有助于您提升广告系列的效果。

您学到的内容

• 如何为 Unity iOS 平台配置 Firebase
• 如何使用 Unity 和 Firebase Analytics 记录自定义事件
• 如何导入事件并将其用于操作广告系列。

参考文档

• 将 Firebase 添加到您的 Unity 项目
• GitHub：firebase/quickstart-unity