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

1. 简介

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

构建内容

在此 Codelab 中，您将学习如何在 Unity 环境中使用 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 Custom Event”。
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 中，依次选择“文件”>“build 设置”。要设置的重要值是 iOS 软件包 ID，您可以使用以下步骤获取该 ID。

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

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

3. 更改平台后，点击“Player Settings”按钮以设置软件包 ID。您可以在标识 区域附近看到文本字段。
4. “软件包标识符”字段的值就是 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 会自动为您记录一些 事件，您无需为此添加任何代码。如果您的应用需要收集其他数据，则 Google Analytics 最多可以记录 500 种不同类型的自定义事件。

记录事件

配置 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 控制台中看到记录的事件。它位于“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