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：设置和分析基础知识。

学习内容

• 如何在 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 的“File”（文件）>“Build Settings”（构建设置）中。重要的是设置 iOS 软件包 ID，您可以使用以下步骤获取该 ID。

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

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

3. 更改平台后，点击“Player Settings”（播放器设置）按钮以设置 bundle 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

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

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（资源）> 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 种不同的 Google 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”>“事件”中。您还可以通过点击事件来查找参数值。

您可以通过将“标记为转化”开关向右滑动，将“文本_搜索”标记为转化。

您可以通过 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. 在“出价”部分，在 Dropbox 中选择“应用内操作”，让 Google Ads 重点关注操作。
10. 您可以在提供的列表中找到您的自定义事件。设置目标每次转化费用，并填写其他选项。

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

9. 恭喜

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

您学到的内容

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

参考文档

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