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 项目
- 登录 Firebase。
在 Firebase 控制台中,点击“添加项目”(或“创建项目”),然后根据需要为 Firebase 项目命名。
- 点击各个项目创建选项。如果系统提示,请接受 Firebase 条款。您应该为此项目启用 Google Analytics,因为您需要使用 Google Analytics 事件来跟踪操作事件和转化情况。
如需详细了解 Firebase 项目,请参阅了解 Firebase 项目。
- 选择 Google Analytics 账号。如果您有,请选择该项目,或者创建一个新项目。点击“创建项目”按钮。
- 现在,Firebase 项目构建已完成!
在下一步中,您将学习如何将 Firebase 添加到您的 Android 应用。
3. 将 Firebase 添加到您的 Android 应用
注册应用
- 在 Firebase 控制台中,选择左侧导航栏中的“项目概览”,然后点击“将 Firebase 添加至您的应用即可开始使用”下的“Android”按钮。
- 填写必要信息。
对于 Android 软件包名称,请在 Android Studio 中前往应用目录,打开文件名为 build.gradle
的文件。在该文件中,搜索 applicationId
。此值是 Android 软件包名称。复制此值并将其粘贴到。
除非您打算使用 Google 登录或 Firebase Dynamic Links,否则我们在这里不需要 SHA-1 密钥(请注意,这些不在此 Codelab 中;如需详细了解 SHA-1 密钥,请参阅此文档。)
- 点击“Register App”(注册应用)按钮。
下载配置文件
- 点击“下载 google-services.json”按钮,下载配置文件
google-services.json
。
- 在 Android Studio 中,前往
app
目录,将您刚刚下载的google-services.json
文件移至app
目录中。返回 Firebase 控制台,点击“下一步”按钮。
在您的应用中启用 Firebase
- 您需要使用 Google 服务 Gradle 插件来读取 Firebase 生成的
google-services.json
文件。 - 在 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
...
}
}
}
- 打开
<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 库版本。如需了解哪些 Firebase 库版本映射到特定的 BoM 版本,请查看相应 BoM 版本的版本说明。
- 打开
<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'
- 现在,点击
Sync Now
按钮同步您的应用。
现在,您已成功将 Firebase SDK for Google Analytics 添加到 Android 应用!
在下一步中,您将学习如何在 Android 应用中记录 Firebase 事件。
5. 使用 Firebase Analytics 记录事件
在此步骤中,您将了解如何在 Android 应用中使用 Firebase Analytics 记录事件。
您可以通过以下 2 种方式记录事件:使用建议的事件或自定义事件。
使用推荐事件
Firebase Analytics SDK 定义了一些推荐事件,可用于游戏、零售、旅游和电子商务等各类应用。此外,还有一些推荐事件需要使用预设参数,您可以利用这些参数在 Firebase 报告中尽可能提供更详细的信息。(推荐事件参考文档)
- 在 activity 顶部声明 FirebaseAnalytics 对象:
private lateinit var firebaseAnalytics: FirebaseAnalytics
- 在
onCreate()
方法中初始化该对象:
firebaseAnalytics = Firebase.analytics
- 使用
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 相关联,应用广告系列将能够详细了解受众群体并增进应用广告系列的学习,这通常有助于提升效果和转化。
将 Firebase 与 Google Ads 相关联
- 点击“Project Overview”旁边的按钮,转到 Firebase Settings。
- 在“集成”标签页中,您会看到“Google Ads”和一个“关联”按钮。点击“关联”和“继续”。
- 选择您要关联的 Google Ads 账号。
现在,您已完成 Firebase 与 Google Ads 的关联。我们来将 Firebase 事件导入 Google Ads。
导入 Firebase 事件
- 在 Firebase 控制台中,前往“事件”菜单,然后将要导入的事件标记为转化。
- 现在,前往 Google Ads,然后登录您与 Firebase 关联的账号。
- 在 Google Ads 中,依次选择“工具”→“衡量”→“转化”
- 点击 + 按钮
- 依次选择“应用”→“Google Analytics 4 媒体资源 (Firebase)”,然后点击“继续”。
- 您可以看到标记为转化的所有分析事件。找到要导入的活动。在本例中,选择我们之前实现的
delete_item
事件。点击“导入并继续”按钮。 - 您已成功从 Firebase 导入转化事件。
现在,您已完成将 Firebase 事件导入 Google Ads 的操作。
在下一步中,您将了解如何使用您刚刚导入的事件投放行动号召广告系列。
7. 使用导入的事件发布与应用有关的 Action 广告系列
- 前往当前 Google Ads 账号中的“应用广告系列”标签页,然后点击 + 按钮,制作新的广告系列。
- 我们将发布一个应用宣传广告系列,其中包含“应用安装”选项。在底部,选择您要宣传的应用,然后点击“继续”。
- 在“出价”部分,如果您在下拉菜单中选择“应用内操作”,则可以查看事件。选择您要重点关注的事件。
- 完成其余的广告系列设置,然后就大功告成了。
8. 恭喜
恭喜,您已成功将 Firebase 与 Google Ads 集成!这将有助于您提升广告系列的效果。
您学到的内容
- 如何配置 Firebase Analytics for Android
- 如何在 Android 应用中使用 Firebase Analytics 记录事件。
- 如何导入事件并将其用于行动号召广告系列。