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

1. 简介

上次更新日期：2021 年 2 月 19 日

构建内容

在此 Codelab 中，您将学习如何在 Unity 环境中通过 GA4F iOS 实现自定义事件，以及如何通过 Google Ads 投放行动号召广告系列。

在此 Codelab 中，您可以体验客户面临的应用业务的整个流程。如果您想要更深入地了解 iOS 上的 Firebase 和 AdMob，请从 AdMob+Firebase 基础知识 Unity：设置和Google 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 中 >文件 >Build Settings（构建设置）。重要的值是设置 iOS 软件包 ID，您将通过以下步骤获得该 ID。

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

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

3. 平台更改后，点击“Player Settings”按钮以设置软件包 ID。您可以看到 Identification 区域周围的文本字段。
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

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

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

注意：如果您现在只注册 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 >导入软件包 >自定义软件包。
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 种不同的 Google Analytics 自定义事件类型。

记录事件

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

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

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

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

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

1. 在 Xcode 中，选择 Product（产品）>架构 >修改架构...
2. 从左侧菜单中选择 Run。
3. 选择 Arguments 标签页。
4. 在 Arguments Passed On Launch 部分，添加 -FIRAnalyticsDebugEnabled。

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

在信息中心内查看事件

几小时后，您会在 Firebase 控制台中看到记录的事件。该工具位于“数据分析”→“事件”中。您还可以通过点击事件来查找参数值。

您将标记“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. 使用导入的事件发布与应用有关的 Action 广告系列

重要提示：若要发布应用广告系列，您需要在 Google Play 中提供一个生产级应用。如果您尚未准备好发布应用，请暂时离开此步骤。

6. 转到当前账号的“广告系列”标签页，然后点击“+”按钮制作新的广告系列。点击新广告系列并继续。
7. 届时，我们将投放一个带有“应用安装”选项的应用宣传广告系列。

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

11. 配置广告系列设置。这超出了 Codelab 的讨论范围，因此请参阅这些文档，或通过任何其他渠道联系以优化设置。

9. 恭喜

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

您学到的内容

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

参考文档

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