本頁面由 Cloud Translation API 翻譯而成。

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 Emulator，且系統映像檔支援 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」專案的總覽畫面中，按一下「Settings」圖示。
在「General」分頁中，選取要下載 google-service.json 檔案的 Android 應用程式。
將設定檔移至專案的 app 目錄。

3. 從控制台開啟 Firebase 專案

在進行下一個步驟前，請先從 Firebase 控制台開啟您在 AdMob + Firebase 指南「設定 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 中的遠端設定功能，你不必更新應用程式就能調整這些值。也就是說，你可以變更應用程式行為，不必強迫使用者下載更新程式，

在本程式碼研究室中，您將瞭解如何使用遠端設定，在不更新應用程式的情況下調整獎勵數量 (觀看獎勵影片廣告後要揭露的字母數)。

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

首先，請將 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 檔案同步處理。選取「檔案」>將專案與 Gradle 檔案同步處理選單，將專案與 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"
  }
}