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

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 Emulator，且系統映像檔支援 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 行動廣告 Unity 外掛程式

若要在 Unity 應用程式上放送 AdMob 廣告，您必須在專案中加入 Google 行動廣告 Unity 外掛程式。

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

您還需要設定 AdMob 應用程式 ID。在 Unity 編輯器中，依序選取「Assets」(資產) >「Google 行動廣告 >選單中的「設定」。

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

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

將 Firebase 設定檔加入 Unity 專案

在「Awesome Drawing Quiz」專案的總覽畫面中，按一下「Settings」圖示。
在「General」分頁中，選取各個 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」Assets >匯入套件 >自訂套件：
在已解壓縮的 SDK 中匯入 Firebase Analytics SDK (dotnet4/FirebaseAnalytics.unitypackage)。
在「Import Unity package」(匯入 Unity 套件) 視窗中，按一下「Import」。

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

下載 Firebase Unity SDK 5.5.0，然後將檔案解壓縮並方便使用。
開啟 Awesome Drawing Quiz Unity 專案，前往「Assets」Assets >匯入套件 >自訂套件：
從已解壓縮的 SDK 中匯入遠端設定 SDK (dotnet4/FirebaseRemoteConfig.unitypackage)。
在「Import Unity package」(匯入 Unity 套件) 視窗中，按一下「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 { }
        }
    }
}