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

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

构建内容

在此 Codelab 中,您将学习如何使用 Google Analytics for Firebase (GA4F) 实现自定义事件,以及如何通过 Google Ads for Flutter 应用发布操作广告系列。

我们会将默认的 Flutter 应用与一个简单的计数器微件结合使用。我们的目的是向有可能点击该计数器微件的潜在用户宣传我们的应用。

bdbf1fc3cbf49ac7.png

学习内容

  • 如何在 Flutter 中初始化 GA4F。
  • 如何创建自定义事件和参数。
  • 如何将 Firebase 中的事件导入 Google Ads。
  • 使用自定义事件发布操作广告系列。

所需条件

  • Android Studio 3.6 或更高版本
  • Xcode(用于实现 iOS 支持)
  • Firebase 帐号
  • Google Ads 帐号

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

启动 Android Studio。

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

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

创建 Firebase 项目

  1. 登录 Firebase

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

e9a8e1b1c7c52125.png

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

e58151a081f0628.png

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

3e5b8f1b6ca538c4.png

配置 Android

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

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

3b7d3b33d81fe8ea.png

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

52f08aa18c8d59d0.png

  1. 转到 Flutter 应用目录,将您刚刚下载的 google-services.json 文件移至 android/app 目录中。
  2. 返回 Firebase 控制台,跳过其余的步骤,然后返回 Firebase 控制台的主页面。
  3. 最后,您需要使用 Google 服务 Gradle 插件来读取 Firebase 生成的 google-services.json 文件。
  4. 在 IDE 或编辑器中,打开 android/app/build.gradle,然后将以下代码行添加为文件的最后一行:
apply plugin: 'com.google.gms.google-services'
  1. 打开 android/build.gradle,然后在 buildscript 标记内添加一个新的依赖项:
buildscript {
   repositories {
      // ...
   }
   dependencies {
      // ...
      Classpath 'com.google.gms:google-services:4.3.3'
   }
}
  1. 如果您的应用仍在运行,请将其关闭并重新构建,以允许 Gradle 安装依赖项。

您的 Flutter 应用已针对 Android 配置完毕!对于 iOS,不妨查看此 Codelab(了解 Firebase for Flutter

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

pubspec 文件管理着一个 Flutter 应用的资源。在 pubspec.yaml 中,将 firebase_analytics: ^6.2.0firebase_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 文件,其中包含提取到项目的所有软件包的列表及其版本号。

lib/main.dart 中,导入新软件包:

import 'package:firebase_analytics/firebase_analytics.dart';

在 MyApp 类中,您需要通过调用相应构造函数来启动 FirebaseAnalytics 对象。

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

现在,您可以触发一些自定义事件日志!

如果您要在 Flutter 应用中生成新的模板,则会在默认 State 类中看到 _counter 变量和 _incrementCounter() 方法。现在,您需要在某些热情用户点击增量按钮超过五次时记录自定义事件。

之后,我们会发布应用广告系列,专门吸引潜在的热情用户,让他们深入参与到应用中。

首先,我们需要将已初始化的分析对象传递给有状态微件。第一步是向 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");
   }

 });
}

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

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

f0742c956977df1d.png

现在一切都已就绪。在 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,查看其中的值。

32b01a1412ab2ba5.png

您可以通过将“标记为转化”开关向右滑动,将 clicked_counter 标记为转化。

e6b420a73db88f03.png

如需查看相应事件是否已标记为转化,请仔细检查一下!如果您确认相应事件已位于“转化”标签页中,则说明您已成功将该事件标记为转化。将此事件标记为转化后,Google Ads 就可以从 Firebase 导入此事件。

不过,出于调试目的,您可以使用 Firebase DebugView。如需了解详情,请参阅调试事件

完成 Firebase-Flutter 设置后,您可以随时发布带有操作事件的应用广告系列。首先,您需要将 Firebase 关联到 Google Ads。通过将 Firebase 关联到 Google Ads,应用广告系列可导入 Firebase 事件。这样,Google Ads 就能帮助 Google Ads 详细了解受众群体,从而提升应用广告系列的效果。

  1. 点击“项目概览”旁边的按钮转到 Firebase“设置”。
  2. 在“集成”标签页中,您会看到“Google Ads”和对应的“关联”按钮。点击“关联”和“继续”。

b711bf2e94fa0895.png

  1. 选择 Google Ads 帐号。

现在,Firebase 部分已完成。

转到 Google Ads

  1. 登录并转到“工具与设置”→“衡量”→“转化”,用于将自定义事件导入为转化。
  2. 点击“+”按钮即可添加新的转化操作。

73cec8d2e80eab03.png

  1. 选择“Google Analytics(分析)4 媒体资源 (Firebase)”,然后点击“继续”。

4b1d8f6a712b2ac6.png

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

ba1bbe6b2924fac8.png

  1. 选中并点击“导入并继续”按钮。

ab35e341dff32e48.png

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

  1. 转到当前帐号的“广告系列”标签页,然后点击“+”按钮制作新的广告系列。点击“新广告系列”,然后继续。
  2. 您将发布一个应用宣传广告系列,其中包含“应用安装”选项。

af98c44d1476558.png

  1. 输入应用名称、软件包名称或发布商,找到您的应用。
  2. 在“出价”部分,从下拉菜单中选择“应用内操作”。
  3. 您可以在提供的列表中找到您的自定义事件。设置目标每次转化费用,并填写其他选项。

885956ad00592eb3.png

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

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

您学到的内容

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