AdMob+Firebase 102 Android：不更新應用程式即可調整應用程式行為

1. 簡介

假設您在 Play 商店發布應用程式後，需要調整應用程式中的某些參數值。通常您應該重新發布新版應用程式，並要求使用者更新手機上的應用程式。

一般來說，如果您想對應用程式進行長期變更，可以更新應用程式。不過，如果您要經常調整應用程式中某些參數的值，該怎麼做呢？或者，您想進行一些實驗，找出最佳應用程式設定嗎？

在這種情況下，應用程式更新可能無法順利進行。因為更新作業需要一段時間才會完全傳播給使用者。此外，跨多個應用程式版本執行實驗相當困難。

此外，您要如何判斷應用程式的使用者歷程是否正常運作？您可能會參考 Play 管理中心的使用者留言。不過，這可能不夠精確，無法做出明確的決策。

進行本程式碼研究室時，如果你遇到任何問題 (例如程式碼錯誤、文法錯誤或用詞不明確等)，請透過程式碼研究室左下角的「回報錯誤」連結回報問題。

課程內容

如何在 Google Analytics for Firebase 中建立漏斗
如何使用 Firebase 遠端設定
如何執行 Firebase A/B 測試

軟硬體需求

Android Studio 4.1 以上版本
Google 帳戶
搭載 Android 5.0 以上版本的測試裝置，以及用來連接裝置的 USB 傳輸線；或是執行 AVD(Android 虛擬裝置) 的 Android 模擬器，以及支援 Play 商店/Google API 的系統映像檔

您對 AdMob 的使用經驗程度為何？

新手

中級

熟練

您對 Firebase 的經驗程度如何？

新手

中級

熟練

2. 設定開發環境

下載程式碼

點選下方按鈕即可下載這個程式碼研究室的所有程式碼：

將下載的 ZIP 檔案解壓縮。這會解壓縮名為「admob-firebase-codelabs-android-master」的根資料夾。

...或從指令列複製 GitHub 存放區。

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

存放區包含下列四個資料夾：

101-base：您將在本程式碼研究室中建構的起始程式碼。
101-complete_and_102-base：本程式碼研究室的完成程式碼，以及 102 程式碼研究室的範例程式碼。
102-complete：102 程式碼研究室的完成程式碼。

匯入範例應用程式

啟動 Android Studio，然後在歡迎畫面中選擇「Import project」。然後從下載的程式碼中選取 101-complete_and_102-base 目錄。

現在應該已在 Android Studio 中開啟專案。

將 Firebase 設定檔新增至 Android 專案

在「Awesome Drawing Quiz」專案的總覽畫面中，按一下「設定」圖示。
在「一般」分頁下方，選取要下載 google-service.json 檔案的 Android 應用程式。
將設定檔移至專案的 app 目錄。

3. 從控制台開啟 Firebase 專案

在繼續下一個步驟之前，請從 Firebase 控制台開啟專案，該專案是在 AdMob + Firebase 101 程式碼研究室的「設定 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. 將遠端設定整合至應用程式

您可以根據應用程式事件和漏斗取得應用程式的洞察資料，因此可能需要最佳化應用程式，通常包括微調應用程式中的參數值。如要修改這些參數的值，您必須更新應用程式，變更才能套用至使用者。

使用 Firebase 中的遠端設定，您不必更新應用程式就能調整這些值，也就是說，不必強制使用者下載更新，就能變更應用程式行為，避免打擾使用者。

在本程式碼研究室中，您將瞭解如何使用 Remote Config，調整獎勵金額 (觀看獎勵影片廣告後揭露的字母數量)，不必更新應用程式。

將遠端設定新增至應用程式依附元件

首先，將 Firebase 遠端設定新增至應用程式依附元件。

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 檔案同步處理。

設定遠端設定參數的預設值

從遠端設定擷取值時，必須連上網路。如果網路無法連線，您應為每個遠端設定參數定義預設值。

在 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 是遠端設定中的參數名稱。

從遠端設定擷取獎勵金額

修改 AwesomeDrawingQuiz.kt，讓 GameSettings 類別保留對 RemoteConfig 例項的參照。

請注意，RemoteConfig 執行個體已設為在偵錯模式中從伺服器擷取最新值，以利開發程序。(呼叫 fetch(0L)，將最短擷取間隔設為零秒)

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 類別，從遠端設定擷取獎勵金額。

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"
  }
}