此页面由 Cloud Translation API 翻译。

带有 Google Analytics for Firebase 自定义事件的 Google Ads - Android

一、简介

最后更新： 2020-12-14

你将建造什么

在此 Codelab 中，您将学习如何使用 Google Analytics for Firebase (GA4F) 实施事件并通过 Google Ads 启动行动活动。

此 Codelab 侧重于使用 GA4F 实施事件并将事件导入 Google Ads。如果您想了解如何使用 Firebase 构建 Android 应用程序，请参阅Firebase Android Codelab-Build Friendly Chat 。

你会学到什么

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

你需要什么

Android Studio 3.6 或更高版本
Firebase 帐户
谷歌广告帐户

2. 创建并设置一个 Firebase 项目

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

创建一个 Firebase 项目

登录到Firebase 。

在 Firebase 控制台中，单击添加项目（或创建项目），然后根据需要命名您的 Firebase 项目。

单击项目创建选项。如果出现提示，请接受 Firebase 条款。您应该为此项目启用 Google Analytics，因为您需要 Google Analytics 事件来跟踪操作事件和转化。

要了解有关 Firebase 项目的更多信息，请参阅了解 Firebase 项目。

选择谷歌分析账户。如果您有一个，请选择那个或创建一个新的。单击创建项目按钮。

现在 Firebase 项目构建已经完成！

在下一步中，您将了解如何将 Firebase 添加到您的 Android 应用程序。

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

注册应用

在 Firebase 控制台中，选择左侧导航栏中的项目概述，然后单击“通过将 Firebase 添加到您的应用程序开始”下的 Android 按钮

填写必要的信息。

对于 Android 包名称，在 Android studio 中转到 app 目录，打开一个名为build.gradle文件。在文件中，搜索applicationId 。该值是 Android 包名称。复制此值并粘贴。

我们这里不需要 SHA-1 密钥，除非您打算使用Google Sign In或Firebase Dynamic Links （请注意，这些不是本代码实验室的一部分，有关 SHA-1 密钥的更多信息，请参阅本文档。） .

单击注册应用程序按钮。

下载配置文件

单击下载 google-services.json 按钮以下载配置文件google-services.json 。

在 Android 工作室中，转到app目录并将google-services.json文件（您刚刚在上面下载）移动到app程序目录中。返回 Firebase 控制台，单击下一步按钮。

在您的应用中启用 Firebase

您需要Google Services 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，特别是用于 Google Analytics 的 Firebase SDK。

我们将使用 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 分析库的版本。但是如果你想为你的 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按钮来同步您的应用程序。

现在，您已完成将适用于 Google Analytics 的 Firebase SDK 添加到您的 Android 应用程序！

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

5. 使用 Firebase Analytics 记录事件

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

记录事件有两种方式：使用建议事件或自定义事件。

使用建议的事件

Firebase Analytics SDK 定义了许多建议事件，可用于各种类型的应用程序，例如游戏、零售、旅游和电子商务。还有一些建议的事件需要其规定的参数，使用这些参数，您可以最大限度地利用 Firebase 报告中的可用详细信息。（建议活动参考）

在活动顶部声明 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请参考Debugging event部分。

现在您已经完成了将事件记录到您的 Android 应用程序！

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

6. 将 Firebase 事件导入 Google Ads

您的 Firebase-Android 设置已完成，您已准备好启动带有记录的操作事件的应用活动。首先，您需要将 Firebase 关联到 Google Ads。通过将 Firebase 与 Google Ads 相关联，应用广告系列将能够更多地了解受众并促进应用广告系列的学习，这通常会带来更好的效果和转化。