AdMob+Firebase 102 Android：无需更新即可优化应用行为

1. 简介

假设您需要在 Play 商店中发布应用后调整应用中某些参数的值。通常，您应重新发布新版应用，并且用户也应在手机上更新应用。

一般来说，如果您想对应用进行持久性更改，应用更新会很有用。不过，如果您要经常调整应用中某些形参的值，该怎么办？或者，如果您想运行一些实验来找到最佳应用配置，该怎么办？

在这些情况下，应用更新将无法正常运行。因为更新需要一些时间才能完全传播给用户。此外，跨多个应用版本运行实验也相当具有挑战性。

此外，您如何确定应用的用户历程是否按预期运行？您可以参考 Play 管理中心内的用户评论。不过，它可能不够精确，无法做出明确的决定。

如果在此 Codelab 操作期间遇到任何问题（代码错误、语法错误、措辞含义不明等），都可以通过 Codelab 左下角的报告错误链接报告相应问题。

学习内容

如何在 Google Analytics for Firebase 中创建漏斗
如何使用 Firebase Remote Config
如何运行 Firebase A/B 测试

所需条件

Android Studio 4.1 或更高版本
Google 账号
搭载 Android 5.0 或更高版本的测试设备，以及用于连接设备的 USB 线；或者运行 AVD（Android 虚拟设备）的 Android 模拟器，且该模拟器具有支持 Play 商店/Google API 的系统映像

您如何评价自己在 AdMob 方面的经验水平？

新手水平

中等水平

熟练水平

您如何评价自己在 Firebase 方面的经验水平？

新手水平

中等水平

熟练水平

2. 设置开发环境

下载代码

点击以下按钮可下载本 Codelab 的所有代码：

解压下载的 ZIP 文件。此操作将解压缩名为 admob-firebase-codelabs-android-master 的根文件夹。

…或从命令行克隆 GitHub 代码库。

$ git clone https://github.com/googlecodelabs/admob-firebase-codelabs-android

该代码库包含以下四个文件夹：

101-base - 您在此 Codelab 中用作基础的起始代码。
101-complete_and_102-base - 此 Codelab 完成后的代码以及 102 Codelab 的起始代码。
102-complete - 102 Codelab 完成后的代码。

导入起始应用

启动 Android Studio，然后在欢迎界面中选择“导入项目”。然后，从下载的代码中选择 101-complete_and_102-base 目录。

现在，您应该已在 Android Studio 中打开该项目。

将 Firebase 配置文件添加到 Android 项目

在 Awesome Drawing Quiz 项目的概览界面中，点击“设置”图标。
在常规标签页下，选择要下载 google-service.json 文件的 Android 应用。
将配置文件移至项目中的 app 目录中。

3. 在控制台中打开 Firebase 项目

在继续执行下一步之前，请从 Firebase 控制台中打开您在 AdMob+Firebase 101 Codelab 的“设置 Firebase 项目”步骤中创建的项目。

4. 创建应用事件漏斗图

您可能添加了一些应用事件来跟踪应用内的用户活动。通过读取每个应用事件的报告，您可以获取与该事件关联的详细信息，例如总次数、每位用户的平均次数、受众特征等。

不过，如果您想查看一系列事件的完成率，而不是专注于特定事件，该怎么办？在 Google Analytics for Firebase 中，您可以使用漏斗来直观呈现并优化一系列应用事件的完成率。

创建漏斗

要创建渠道，请执行以下操作：

前往 Firebase 控制台，然后选择您之前创建的 Awesome Drawing Quiz 项目。
点击漏斗。
点击新建渠道。
输入渠道名称和说明。
选择要在渠道中用作步骤的前两个事件。
点击添加其他事件以添加更多步骤，然后选择相应事件。
点击创建。

按照上述步骤创建以下漏斗：

#1 漏斗名称：级别成功率事件：level_start、level_success

#2 漏斗名称：激励广告完成率事件：ad_reward_prompt、ad_reward_impression、ad_reward

#3 漏斗名称：游戏完成率事件：game_start、game_complete

查看漏斗分析

创建一些漏斗后，您可以在 Firebase 控制台的漏斗菜单中访问它们。点击列表中的漏斗名称，即可查看每个漏斗的详细分析。

例如，点击关卡成功率。系统会显示如下所示的漏斗详细信息：

从上面的屏幕截图中，您可以看到在开始关卡（触发 level_start 事件）后通关（触发 level_success 事件）的用户百分比。在此处，您可以看到 46.2% 的用户已通关。

点击事件数后，系统会显示基于事件数量的指标，如下所示：

根据上图中的指标，在相应时间段内，有 116 次尝试（触发了 level_start 事件）和 57 次通关（触发了 level_success 事件）。

由于基于事件的完成率(49.1%) 略高于基于用户的完成率(46.2%)，因此可以说，有少数人的表现优于其他人。

5. 将 Remote Config 集成到应用中

由于您可以根据应用事件和漏斗图获取一些有关应用的分析洞见，因此您可能需要优化应用。这通常包括对应用中的参数值进行微调。如需修改这些参数的值，您需要更新应用，以便将更改应用于用户。

通过使用 Firebase 中的 Remote Config，您无需更新应用即可调整这些值，这意味着您无需强制用户下载更新，即可更改应用行为，从而避免打扰用户。

在此 Codelab 中，您将学习如何使用 Remote Config 使奖励金额（观看激励视频广告后要公开的字母数）可调整，而无需更新应用。

将 Remote Config 添加到应用依赖项

我们先将 Firebase Remote Config 添加到应用依赖项中。

app/build.gradle

apply plugin: 'com.android.application'

android {
    ...
}

dependencies {
    ...

    // TODO: Add Firebase Remote Config dependency (102)
    implementation 'com.google.firebase:firebase-config-ktx'

    ...
}

...

将您的项目与 Gradle 文件同步

为确保您的应用拥有所有依赖项，请将项目与 Gradle 文件同步。选择 File > Sync Project with Gradle Files 菜单，以将项目与 Gradle 文件同步。

设置 Remote Config 参数的默认值

从 Remote Config 中提取值需要网络连接。如果网络不可用，您应为每个 Remote Config 参数定义一个默认值。

在 res/xml 文件夹下创建 remote_config_defaults.xml 文件。然后，设置奖励金额的默认值（reward_amount)），如下所示。

res/xml/remote_config_defaults.xml

<?xml version="1.0" encoding="utf-8"?>
<defaultsMap>
    <entry>
        <key>reward_amount</key>
        <value>1</value>
    </entry>
</defaultsMap>

请注意，reward_amount 是 Remote Config 中参数的名称。

从 Remote Config 中提取奖励金额

修改 AwesomeDrawingQuiz.kt，使 GameSettings 类能够保存对 RemoteConfig 实例的引用。

请注意，RemoteConfig 实例已配置为在调试模式下从服务器提取最新值，以帮助完成开发流程。（通过调用 fetch(0L) 将最小提取间隔设置为 0 秒）

AwesomeDrawingQuiz.kt

class AwesomeDrawingQuiz : Application() {

    ...

    // COMPLETE: Provide FirebaseRemoteConfig instance (102)
    private fun provideGameSettings() = GameSettings(provideRemoteConfig())

    // COMPLETE: Add a function that provides a FirebaseRemoteConfig instance (102)
    private fun provideRemoteConfig(): FirebaseRemoteConfig {
        val rc = Firebase.remoteConfig.apply {
            setDefaultsAsync(R.xml.remote_config_defaults)
        }
        val fetchTask = if (BuildConfig.DEBUG) rc.fetch(0L) else rc.fetch()
        fetchTask.addOnCompleteListener {
            if (it.isSuccessful) {
                Log.d("AwesomeDrawingQuiz", "Remote config value fetched")
                rc.activate()
            }
        }
        return rc
    }
}

然后，更改 GameSettings 类以从 Remote Config 中提取奖励金额。

GameSettings.kt

// TODO: Add FirebaseRemoteConfig as a class member
class GameSettings(private val rc: FirebaseRemoteConfig) {

  ...

  // TODO: Apply reward amount from the Remote Config (102)
  val rewardAmount: Int
    get() = rc.getLong(KEY_REWARD_AMOUNT).toInt()

  companion object {
    ...

    // TODO: Add a key for 'reward_amount' Remote Config parameter (102)
    private const val KEY_REWARD_AMOUNT = "reward_amount"
  }
}