在 Google Ads 中使用 Google Analytics for Firebase 自定义事件 - Android

1. 简介

上次更新日期：2020 年 12 月 14 日

构建内容

在此 Codelab 中，您将学习如何使用 Google Analytics for Firebase(GA4F) 实现事件，以及如何通过 Google Ads 投放行动号召广告系列。

此 Codelab 将重点介绍如何使用 GA4F 实现事件，以及如何在 Google Ads 中导入事件。如果您想了解如何使用 Firebase 构建 Android 应用，请参阅 Firebase Android Codelab - 构建友好型聊天。

学习内容

  • 如何创建 Firebase 项目
  • 如何在 Android 应用中实现 Firebase SDK
  • 如何创建事件和参数。
  • 如何将 Firebase 中的事件导入 Google Ads
  • 使用自定义事件投放 Google Ads 行动号召广告系列。

所需条件

  • Android Studio 3.6 或更高版本
  • Firebase 账号
  • Google Ads 账号

2. 创建和设置 Firebase 项目

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

创建 Firebase 项目

  1. 登录 Firebase。

在 Firebase 控制台中，点击“添加项目”（或“创建项目”），然后根据需要为 Firebase 项目命名。

8525e77df3536fbb.png

  1. 点击各个项目创建选项。如果系统提示，请接受 Firebase 条款。您应该为此项目启用 Google Analytics（分析），因为需要使用 Google Analytics（分析）事件来跟踪操作事件和转化。

e58151a081f0628

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

  1. 选择 Google Analytics（分析）账号。如果有，则选择一个账号或创建一个新账号。点击“创建项目”按钮。

ac928e5947ba7cbf.png

  1. 现在，Firebase 项目构建已完成！

在下一步中，您将学习如何将 Firebase 添加到您的 Android 应用。

3. 将 Firebase 添加到您的 Android 应用

注册应用

  1. 在 Firebase 控制台中，选择左侧导航栏中的“项目概览”，然后点击“将 Firebase 添加至您的应用即可开始使用”下的 Android 按钮

6cbb33ad3e7c9132.png

  1. 填写必要信息。

3b7d3b33d81fe8ea

对于 Android 软件包名称，在 Android Studio 中，转到应用目录，打开文件名 build.gradle。在文件中搜索 applicationId。这个值是 Android 软件包名称。复制并粘贴该值。

除非您打算使用 Google 登录或 Firebase Dynamic Links，否则我们在这里不需要 SHA-1 密钥（请注意，这些链接不属于此 Codelab，如需详细了解 SHA-1 密钥，请参阅此文档。）

  1. 点击“注册应用”按钮。

下载配置文件

  1. 点击“下载 google-services.json”按钮，下载配置文件 google-services.json。

52f08aa18c8d59d0.png

  1. 在 Android Studio 中，转到 app 目录，然后将您刚刚下载的 google-services.json 文件移至 app 目录中。返回 Firebase 控制台，点击“下一步”按钮。

在您的应用中启用 Firebase

  1. 您需要使用 Google 服务 Gradle 插件来读取 Firebase 生成的 google-services.json 文件。
  2. 在 Android Studio 中，打开 <project>/build.gradle，然后在文件中添加以下几行代码：
buildscript { 
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
   }
   dependencies {
      ...
      // Add this line
      classpath 'com.google.gms:google-services:4.3.4'
   }
}

allprojects {
   ...
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
      ...
      }
   }
}
  1. 打开 <project>/<app-module>/build.gradle，然后在文件中添加以下几行代码：
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

现在，您已将 Firebase 添加到您的 Android 应用！

在下一步中，您将学习如何将 Firebase SDK 添加到您的应用。

4.将 Firebase SDK 添加到您的应用

在此步骤中，您将添加 Firebase SDK，具体来讲就是添加 Firebase SDK for Google Analytics。

我们将使用 Firebase Android BoM，让您可以通过指定 BoM 的版本来管理在应用中使用的 Firebase 库版本。如需了解特定 BoM 版本的对应 Firebase 库版本，请查看该 BoM 版本的版本说明。

  1. 打开 <project>/<app-module>/build.gradle，然后在文件中添加以下几行代码：
dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx'

如您所见，如果仅指定 BoM 的版本，则无需指定 Firebase Analytics 库的版本。但是，如果您希望为 Firebase 库使用所需的版本，而不管 BoM 中指定了哪个版本，只需按如下方式指定所需版本：

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'
  1. 现在，点击 Sync Now 按钮以同步您的应用。937206076c88ae5c.png

现在，您已将 Firebase SDK for Google Analytics 添加到您的 Android 应用！

在下一步中，您将学习如何在 Android 应用中记录 Firebase 事件。

5. 使用 Firebase Analytics 记录事件

在此步骤中，您将学习如何在 Android 应用中使用 Firebase Analytics 记录事件。

您可以通过以下 2 种方式记录事件：使用推荐事件或自定义事件。

使用推荐事件

Firebase Analytics SDK 定义了许多推荐事件，可用于游戏、零售、旅游和电子商务等各类应用。此外，还有一些推荐事件需要其指定参数，您可以利用这些参数，最大限度地在 Firebase 报告中获得可用详细信息。（推荐事件参考文档）

  1. 在 activity 的顶部声明 FirebaseAnalytics 对象：
private lateinit var firebaseAnalytics: FirebaseAnalytics
  1. 在 onCreate() 方法中初始化该对象：
firebaseAnalytics = Firebase.analytics
  1. 使用 logEvent() 方法开始记录事件。当用户在应用中购买商品时，以下代码会记录 PURCHASE 事件：
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
   param(FirebaseAnalytics.Param.VALUE, 10)
   param(FirebaseAnalytics.Param.CURRENCY, "USE")
}

使用自定义事件

如果您需要的事件未涵盖在推荐事件范围内，可以使用自定义参数记录您自己的自定义事件：

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

调试事件

您可以在 Firebase 控制台中查看有关您的事件的汇总数据和报告。但是，更新会全天定时进行，您在登录应用后无法立即查看这些事件。

如需立即进行测试和调试，您可以使用 Firebase Debugview。使用 DebugView 可以近乎实时地查看您的应用在开发设备上记录的事件数据。如需了解 DebugView，请参阅调试事件部分。

现在，您已经完成了将事件记录到 Android 应用的操作！

在下一步中，您将学习如何将这些事件导入 Google Ads。

6. 将 Firebase 事件导入 Google Ads

您的 Firebase-Android 设置已完成，您现在可以使用记录的操作事件发布应用广告系列了。首先，您需要将 Firebase 与 Google Ads 相关联。将 Firebase 与 Google Ads 相关联后，应用广告系列将能够更好地了解受众群体，并强化应用广告系列的学习效果，而这通常能提升效果和转化。

  1. 点击“项目概览”旁边的按钮以转到 Firebase 设置。

412830708c61fdc0

  1. 在“集成”标签页中，您会看到“Google Ads”和“关联”按钮。依次点击“关联”和“继续”。

796c921fb2b873ae.png

  1. 选择您要关联的 Google Ads 账号。

现在，您已成功将 Firebase 与 Google Ads 相关联。让我们将 Firebase 事件导入 Google Ads。

导入 Firebase 事件

  1. 在 Firebase 控制台中，前往“事件”菜单，然后标记您要作为转化导入的事件。

a5f302ba01a1863c.png

  1. 现在，转到 Google Ads，并登录与 Firebase 相关联的帐号。
  2. 在 Google Ads 中，依次点击“工具”→“衡量”→“转化”7acf268d7e799a7e
  3. 点击“+”按钮 d0eed72946d038d8.png
  4. 依次选择“应用”→“Google Analytics（分析）4 媒体资源 (Firebase)”，然后点击“继续”。983f06edb15724de
  5. 您可以查看标记为转化的所有分析事件。找到您要导入的事件。在本例中，选择我们之前实现的 delete_item 事件。点击“导入并继续”按钮。f9bdee80c0d40999
  6. 您已成功从 Firebase 导入转化事件。be75f6a11913236

现在，您已将 Firebase 事件导入到 Google Ads 中。

在下一步中，您将学习如何使用刚刚导入的事件投放行动号召广告系列。

7. 使用导入的事件投放与应用有关的 Action 广告系列

  1. 前往当前 Google Ads 账号中的“应用广告系列”标签页，然后点击“+”按钮，制作新的广告系列。

19856a65ab999ad7

  1. 我们将发布一个应用宣传广告系列，其中包含“应用安装”选项。在底部选择要推广的应用，然后点击“继续”。8146b5a7a4f961bd.png
  2. 在“出价”部分中，如果您在下拉菜单中选择“应用内操作”，则可以查看事件。选择您想要关注的一个或多个事件。

b75e410c7dbdfec8.png

  1. 完成其余广告系列设置。

8. 恭喜

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

您学到的内容

  • 如何配置适用于 Android 的 Firebase Analytics
  • 如何在 Android 应用中使用 Firebase Analytics 记录事件。
  • 如何导入事件并将其用于行动号召广告系列。