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

1. 簡介

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

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

在這些情況下，應用程式更新可能無法正常運作。因為更新需要一段時間才會完全發布給使用者。此外，跨多個應用程式版本執行實驗相當困難。

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

課程內容

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

軟硬體需求

Unity 2018.4.4f1 以上版本
Xcode 10 以上版本 (用於建構 iOS 目標)
Google 帳戶
搭載 Android 5.0 以上版本的測試裝置，以及用來連接裝置的 USB 傳輸線；或是執行 AVD(Android 虛擬裝置) 的 Android 模擬器，以及支援 Play 商店/Google API 的系統映像檔
搭載 iOS 8.0 以上版本的 iOS 裝置或模擬器

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

新手

中級

熟練

您對 Firebase 的經驗程度如何？

新手

中級

熟練

2. 設定開發環境

下載程式碼

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

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

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

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

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

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

準備必要檔案

「Awesome Drawing Quiz」使用多個開放原始碼，因此必須編譯並執行專案。

開啟終端機，然後移至存放區根目錄。接著，從終端機執行 ./gradlew :prepareThirdPartyFiles (Windows 上的 gradlew.bat :prepareThirdPartyFiles)，將必要檔案複製到專案中。

匯入範例應用程式

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

現在應該已在 Unity 中開啟專案。

新增 Google Mobile Ads Unity 外掛程式

如要在 Unity 應用程式中放送 AdMob 廣告，您必須將 Google Mobile Ads Unity 外掛程式新增至專案。

下載 Google Mobile Ads Unity 外掛程式 3.18.1 套件。(請注意，本程式碼研究室可能與其他版本的外掛程式不相容)
在「Awesome Drawing Quiz」Unity 專案中。在專案中，依序前往「Assets」>「Import Package」>「Custom Package」。
將下載的 GoogleMobileAds.unitypackage 匯入專案。

您也需要設定 AdMob 營利應用程式 ID。在 Unity 編輯器中，依序選取選單中的「Assets」>「Google Mobile Ads」>「Settings」。

按一下「Google AdMob」部分下方的「已啟用」核取方塊，啟用 AdMob。然後輸入 AdMob 應用程式 ID，如下所示：

Android：ca-app-pub-3940256099942544~3048611032
iOS：ca-app-pub-3940256099942544~2753522596

將 Firebase 設定檔新增至 Unity 專案

在「Awesome Drawing Quiz」專案的總覽畫面中，按一下「設定」圖示。
在「一般」分頁下方，選取每個 Android 和 iOS 應用程式，下載 google-service.json (適用於 Android) 和 GoogleService-Info.plist (適用於 iOS) 檔案。
將這兩個設定檔移至 Unity 專案的「Assets」資料夾。

新增 Firebase Analytics SDK

下載 Firebase Unity SDK 5.5.0，然後解壓縮至方便使用的位置。(如果已下載 SDK，請略過這個步驟)
開啟「Awesome Drawing Quiz」Unity 專案，然後依序前往「Assets」>「Import Package」>「Custom Package」。
在已解壓縮的 SDK 中，匯入 Firebase Analytics SDK (dotnet4/FirebaseAnalytics.unitypackage)。
在「Import Unity package」視窗中，按一下「Import」。

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 遠端設定 SDK

下載 Firebase Unity SDK 5.5.0，然後解壓縮至方便使用的位置。
開啟「Awesome Drawing Quiz」Unity 專案，然後依序前往「Assets」>「Import Package」>「Custom Package」。
從解壓縮的 SDK 匯入遠端設定 SDK (dotnet4/FirebaseRemoteConfig.unitypackage)。
在「Import Unity package」視窗中，按一下「Import」。

匯入 Firebase.RemoteConfig

修改 Main.cs，允許您使用 Firebase.RemoteConfig 中的型別，而不必使用完整名稱。

Scenes/Main.cs

...

using AwesomeDrawingQuiz.Game;

// TODO: Import Firebase.RemoteConfig (102)
using Firebase.RemoteConfig;

namespace AwesomeDrawingQuiz.Scene {
    ...
}

初始化並擷取遠端設定值

修改 Main.cs 中的 InitAndFetchRemoteConfig() 方法，初始化遠端設定執行個體，如下所示。請注意，GameSettings.KEY_REWARD_AMOUNT 會保留遠端設定中的參數名稱。(您將在本程式碼研究室中宣告這個欄位)

Scenes/Main.cs

private Task InitAndFetchRemoteConfig() {
    // TODO: Initialize and Fetch values from the Remote Config (102)
    Dictionary<string, object> defaults = new Dictionary<string, object>();
    defaults.Add(GameSettings.KEY_REWARD_AMOUNT, 1);
    FirebaseRemoteConfig.SetDefaults(defaults);

    if (Debug.isDebugBuild) {
        ConfigSettings config = new ConfigSettings();
        config.IsDeveloperMode = true;
        FirebaseRemoteConfig.Settings = config;
        return FirebaseRemoteConfig.FetchAsync(System.TimeSpan.Zero);
    } else {
        return FirebaseRemoteConfig.FetchAsync();
    }
}

您會看到 FirebaseRemoteConfig 執行個體已設為在偵錯模式中從伺服器擷取最新值，以利開發程序。(IsDeveloperMode = true 勝 FetchAsync(System.TimeSpan.Zero) 負)

啟用擷取的遠端設定值

成功擷取遠端設定值後，請啟用這些值，讓應用程式可以使用。請按照下列方式修改 ActivateRemoteConfigValues() 方法。

Scenes/Main.cs

private void ActivateRemoteConfigValues() {
    // TODO: Activate fetched Remote Config values (102)
    FirebaseRemoteConfig.ActivateFetched();
}

修改 Start() 方法

如要讓應用程式在啟動時擷取及啟用遠端設定值，請按照下列方式修改 Main.cs 檔案中的 Start() 方法。

Scenes/Main.cs

void Start () {
    ...
    Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
        ...
    }).ContinueWith(task => { 
        // TODO: Call InitAndFetchRemoteConfig() (102)
        InitAndFetchRemoteConfig();
    }).ContinueWith(task => {
        // TODO: Call ActivateRemoteConfigValues() (102)
        ActivateRemoteConfigValues();

        // Enable 'Start a game' button
        UnityMainThreadDispatcher.Instance()
            .Enqueue(() => buttonStartGame.interactable = true);
    });
    #else
    QuizAnalytics.SetScreenName(QuizAnalytics.SCREEN_MAIN);

    // TODO: Call InitAndFetchRemoteConfig() (102)
    InitAndFetchRemoteConfig().ContinueWith(task => {
        // TODO: Call ActivateRemoteConfigValues() (102)
        ActivateRemoteConfigValues();
    });
    #endif
}

從遠端設定擷取獎勵金額

修改 GameSettings 類別，從遠端設定擷取獎勵金額。

Game/GameSettings.cs

// TODO: Import Firebase.RemoteConfig (102)
using Firebase.RemoteConfig;

namespace AwesomeDrawingQuiz.Game {
    public class GameSettings {

        ...
        
        // TODO: Apply reward amount from the Remote Config (102)
        public const string KEY_REWARD_AMOUNT = "reward_amount";

        public static GameSettings Instance {
            get {
                return instance;
            }
        }

        ...

        public int RewardAmount {
            get {
                // TODO: Apply reward amount from the Remote Config (102)
                return (int) FirebaseRemoteConfig.GetValue(KEY_REWARD_AMOUNT).LongValue;
            }
            private set { }
        }
    }
}