使用 Google Analytics 自定义事件和 Flutter 发布 Google Ads 广告系列

1. 简介

上次更新日期：2021 年 1 月 25 日

构建内容

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

我们将使用默认 Flutter 应用，其中包含一个简单的计数器 widget。我们将向有可能点击该计数器微件的潜在用户宣传我们的应用。

学习内容

• 如何在 Flutter 中初始化 GA4F。
• 如何创建自定义事件和参数
• 如何将 Firebase 中的事件导入 Google Ads。
• 如何使用自定义事件投放行动号召广告系列

所需条件

• Android Studio 3.6 或更高版本
• Xcode（用于实现 iOS 支持）
• Firebase 账号
• Google Ads 账号

2. 启动新的 Flutter 项目

创建一个简单的模板化 Flutter 应用。您将为此 Codelab 修改此起始应用。

启动 Android Studio。

注意：如果您的 IDE 中没有“New Flutter Project”选项，请确保您已安装 Flutter 和 Dart 插件。

1. 如果您没有打开的项目，请从欢迎页面中选择 Start a new Flutter app（启动新的 Flutter 应用）。否则，请选择文件 >新建 >新建 Flutter 项目。
2. 选择 Flutter Application 作为项目类型，然后点击 Next。
3. 验证 Flutter SDK 路径是否指定了相应 SDK 的位置（如果文本字段为空，请选择 Install SDK）。
4. 输入项目名称，然后点击下一步。
5. 使用 Android Studio 建议的默认软件包名称，然后点击 Next。
6. 点击 Finish。
7. 等待 Android Studio 安装相应 SDK 并创建项目。

3. 创建和设置 Firebase 项目

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

创建 Firebase 项目

1. 登录 Firebase。

在 Firebase 控制台中，点击“添加项目”（或“创建项目”），然后将您的 Firebase 项目命名为 Firebase-Flutter-Ads 或您喜欢的任何名称。

2. 点击相应的项目创建选项。在系统提示是否接受 Firebase 条款时选择“接受”。您应为此项目启用 Google Analytics，因为您需要使用 Google Analytics 事件来跟踪操作事件并分析转化数据。

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

4. 针对具体平台的 Firebase 配置 (Android)

配置 Android

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

您将在以下屏幕中看到对话框。

2. 要提供的重要值是 Android 软件包名称，您可以使用以下步骤获取该名称。

提示：如需详细了解软件包和应用 ID，请参阅设置应用 ID。

3. 在 Flutter 应用目录中，打开 android/app/src/main/AndroidManifest.xml 文件。
4. 在 manifest 元素中，找到 package 属性的字符串值。这个值是 Android 软件包名称（类似于 com.yourcompany.yourproject）。复制这个值。
5. 在 Firebase 对话框中，将复制的软件包名称粘贴到 Android package name 字段中。
6. 除非您打算使用 Google 登录或 Firebase Dynamic Links，否则此处不需要 SHA-1 密钥（请注意，这些并非此 Codelab 的一部分）。如果您打算从 Google Play 导入 in_app_purchase 数据，则稍后必须设置该密钥。
7. 点击注册应用。
8. 还是在 Firebase 中，按照说明下载配置文件 google-services.json。

9. 转到 Flutter 应用目录，将您刚刚下载的 google-services.json 文件移至 android/app 目录中。
10. 返回 Firebase 控制台，跳过其余的步骤，然后返回 Firebase 控制台的主页面。
11. 最后，您需要使用 Google 服务 Gradle 插件来读取 Firebase 生成的 google-services.json 文件。
12. 在 IDE 或编辑器中，打开 android/app/build.gradle，然后将以下代码行添加为文件的最后一行：

apply plugin: 'com.google.gms.google-services'

13. 打开 android/build.gradle，然后在 buildscript 标记内添加一个新的依赖项：

buildscript { 
   repositories {
      // ...
   }
   dependencies {
      // ...
      Classpath 'com.google.gms:google-services:4.3.3'
   }
}

14. 如果您的应用仍在运行，请将其关闭并重新构建，以允许 Gradle 安装依赖项。

您的 Flutter 应用已针对 Android 配置完毕！对于 iOS，您可能需要参阅此 Codelab（了解如何将 Firebase 用于 Flutter）

5. 在 Flutter 中配置 Firebase Analytics

在此步骤中，您将开始使用名为 firebase_analytics 的 Firebase Analytics 软件包，其中包含 Firebase Analytics 功能。

pubspec 文件管理着一个 Flutter 应用的资源。在 pubspec.yaml 中，将 firebase_analytics: ^6.2.0（firebase_analytics 6.2.0 或更高版本）附加到依赖项列表中：

dependencies: 
   flutter: 
      sdk: flutter 
   cupertino_icons: ^0.1.2 
   firebase_analytics: ^6.2.0   # add this line

在 Android Studio 的编辑器视图中查看 pubspec 时，点击 Packages get。这会将此软件包提取到您的项目中。您应该会在控制台中看到以下内容：

flutter packages get 
Running "flutter packages get" in startup_namer... 
Process finished with exit code 0

执行 Pub get 还会自动生成 pubspec.lock 文件，其中包含提取到项目的所有软件包的列表及其版本号。

注意：对于特定的 Firebase 版本，首次初始化 FirebaseAnalytics 类时会显示 java.lang.IllegalArgumentException: Service not registered（请参阅 GitHub 问题 1662）.

在 lib/main.dart 中，导入新软件包：

import 'package:firebase_analytics/firebase_analytics.dart';

在 MyApp 类中，通过调用构造函数启动 FirebaseAnalytics 对象。

class MyApp extends StatelessWidget {
 static FirebaseAnalytics analytics = FirebaseAnalytics();
   ...
}

现在，您可以触发一些自定义事件日志了！

6. 使用 Firebase Analytics 记录自定义事件

如果您要在 Flutter 应用中生成新模板，则会在默认的 State 类中看到 _counter 变量和 _incrementCounter() 方法。现在，对于过于热情的用户，您希望在对增量按钮的点击超过五次时记录自定义事件。之后，我们会投放应用广告系列来吸引潜在的热情用户

首先，我们需要将已初始化的分析对象传递给 Stateful widget。首先，向 MyHomePage 构造函数添加一个分析参数。

MyHomePage({Key key, this.title, this.analytics}) : super(key: key);

此外，在调用此构造函数时，您也需要添加一个分析参数。

home: MyHomePage(
   title: 'Flutter Demo Home Page',
   analytics: analytics,
),

现在，您可以使用 logEvent() 方法轻松记录事件。添加该方法并递增 _counter 变量。

void _incrementCounter() {
 setState(() {
   _counter++;

   //add this
   if(_counter > 5) { 
     widget.analytics.logEvent(name: "clicked_counter"); 
   }

 });
}

现在，您的应用已准备好触发自定义事件日志！

您还可以使用预构建的事件触发方法。

现在一切都已就绪。在 Android Studio 中，运行“main.dart”。

（可选）通过参数向 Firebase Analytics 发送其他信息

您可以通过参数发送其他信息。可以在 Analytics 报告中注册自定义参数，用于生成报告。它们也可以在可应用于每个报告的受众群体定义中用作过滤条件。如果您的应用已关联到 BigQuery 项目，系统还会在 BigQuery 中找到自定义参数（请参阅 BigQuery Export for Firebase）。

在这里，我们会把 _counter 值设置为参数。

void _incrementCounter() {
 setState(() {
   _counter++;

   if(_counter > 5) {
     widget.analytics.logEvent(name: "clicked_counter", parameters: {'count' : _counter});
   }
 });
}

检查和调试事件

几小时内，您就可以在 Firebase 控制台中看到记录的事件。只需在 Firebase 控制台的“Analytics”部分点击事件标签页即可。您还可以点击事件 clicked_counter，查看事件中的值。

通过将标记为转化开关向右滑动，将clicked_counter标记为转化。

如果该事件位于“转化”标签页中，则表示您已成功将该事件标记为转化。Google Ads 现在可以从 Firebase 导入此事件。

出于调试目的，请使用 Firebase DebugView。如需了解详情，请参阅调试事件。

7. 在 Google Ads 中导入分析事件

完成 Firebase-Flutter 设置后，您就可以发布包含操作事件的应用广告系列了。首先，将 Firebase 与 Google Ads 相关联。将 Firebase 与 Google Ads 相关联后，应用广告系列即可导入 Firebase 事件。这样，Google Ads 就能帮助 Google Ads 详细了解受众群体，从而提升应用广告系列的效果。

1. 点击 Project Overview 旁边的按钮，转到 Firebase 设置。
2. 在集成标签页中，您将看到 Google Ads 和一个关联按钮。点击关联，然后点击继续。

3. 选择 Google Ads 账号。

注意：如果目标事件未标记为转化事件，Google Ads 将无法导入该事件。请确保该事件已正确标记为转化。

现在，Firebase 部分已完成。

转到 Google Ads。

1. 登录，然后前往工具和设置 >衡量 >转化：将自定义事件作为转化导入。
2. 点击 + 按钮添加新的转化操作。

3. 选择 Google Analytics 4 媒体资源 (Firebase)，然后点击继续。

4. 您可以看到标记为转化的所有分析事件。找到我们之前实现的 clicked_counter 事件。

5. 检查相应操作，点击导入，然后点击继续。

将 clicked_counter 设置为转化操作后，您便可以发布操作广告系列，以定位可能会触发 clicked_counter 事件超过 5 次的用户。

8. 使用导入的事件发布与应用有关的 Action 广告系列

重要提示：为了成功发布应用广告系列，您需要在 Google Play 中获取一个生产级应用。不过，如果您尚未准备好发布，可暂时跳过此步骤。

6. 转到当前账号的“广告系列”标签，然后点击 + 按钮制作新的广告系列。点击[新广告系列]，然后点击继续。
7. 使用应用安装选项投放应用宣传广告系列。

8. 输入应用名称、软件包名称或发布商，找到您的应用。
9. 在出价部分的下拉菜单中选择应用内操作。
10. 在提供的列表中找到您的自定义事件。设置目标每次转化费用，然后完成所有其他选项。

11. 完成广告系列的设置。

9. 恭喜

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

您学到的内容

• 如何配置 Firebase Analytics for Flutter。
• 如何在 Flutter 应用中使用 Firebase Analytics 记录自定义事件。
• 如何导入事件并将其用于操作广告系列。