AdMob+Firebase 102 Unity: アプリを更新せずにアプリの動作を調整

1. はじめに

Google Play ストアでアプリを公開した後、アプリ内のいくつかのパラメータの値を調整する必要があるとします。通常は、アプリの新しいバージョンを再公開し、ユーザーもスマートフォンでアプリを更新する必要があります。

一般的に、アプリに長期的な変更をコミットする場合は、アプリの更新が機能します。しかし、アプリ内のいくつかのパラメータの値を頻繁に調整する場合はどうでしょうか？また、最適なアプリ構成を見つけるためにテストを実施したい場合はどうすればよいでしょうか？

このような場合、アプリの更新は正常に機能しません。アップデートがユーザーに完全に反映されるまでには時間がかかるためです。また、複数のアプリバージョンでテストを実施するのは非常に困難です。

また、アプリのユーザージャーニーが意図したとおりに機能しているかどうかを判断するにはどうすればよいですか？Google Play Console のユーザーコメントをご利用ください。ただし、明確な判断を下すには十分な精度が得られない場合があります。

学習内容

Firebase 向け Google アナリティクスでファネルを作成する方法
Firebase Remote Config の使用方法
Firebase A/B テストの実行方法

必要なもの

Unity 2018.4.4f1 以降
Xcode 10 以降（iOS のターゲットをビルドするため）
Google アカウント
Android 5.0 以降を搭載したテストデバイス（デバイスを接続するための USB ケーブル付き）、または Play ストア/Google API をサポートするシステムイメージを搭載した AVD（Android 仮想デバイス）を実行する Android エミュレータ
iOS 8.0 以降を搭載した iOS デバイスまたはシミュレータ

AdMob の使用経験についてお答えください。

初心者

中級者

上級者

ご自身の Firebase 使用経験をどのように評価されますか。

初心者

中級者

上級者

2. 開発環境をセットアップする

コードをダウンロードする

次のボタンをクリックして、この Codelab のすべてのコードをダウンロードします。

ダウンロードした zip ファイルを解凍すると、これにより、admob-firebase-codelabs-unity-master という名前のルートフォルダが展開されます。

または、コマンドラインから GitHub リポジトリのクローンを作成します。

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

リポジトリには、次の 4 つのフォルダが含まれています。

101-base - この Codelab で作成する開始コード。
101-complete_and_102-base - この Codelab の完成したコードと 102 Codelab のスターター。
102-complete - 102 Codelab の完成したコード。

必要なファイルを準備する

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 パッケージをダウンロードします。（この Codelab は、プラグインの他のバージョンと互換性がない場合があります）。
Awesome Drawing Quiz Unity プロジェクト。プロジェクトで、[Assets] > [Import Package] > [Custom Package] を選択します。
ダウンロードしたプロジェクトに GoogleMobileAds.unitypackage をインポートします。

AdMob アプリ ID も設定する必要があります。Unity Editor で、メニューから [Assets]（アセット）> [Google Mobile Ads]（Google モバイル広告）> [Settings]（設定）を選択します。

[Google AdMob] セクションの [Enabled]（有効）チェックボックスをオンにして、AdMob を有効にします。次に、AdMob アプリ ID を次のように入力します。

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

Unity プロジェクトに Firebase 構成ファイルを追加する

Awesome Drawing Quiz プロジェクトの概要画面で、設定アイコンをクリックします。
[全般] タブで、Android アプリと iOS アプリをそれぞれ選択して、google-service.json（Android 用）ファイルと GoogleService-Info.plist（iOS 用）ファイルをダウンロードします。
両方の構成ファイルを Unity プロジェクトの Assets フォルダに移動します。

Firebase アナリティクス SDK を追加する

Firebase Unity SDK 5.5.0 をダウンロードし、適切な場所で解凍します。（SDK をすでにダウンロードしている場合は、この手順をスキップしてください）
Awesome Drawing Quiz Unity プロジェクトを開き、[Assets] > [Import Package] > [Custom Package] の順に選択します。
解凍した SDK から Firebase アナリティクス SDK（dotnet4/FirebaseAnalytics.unitypackage）をインポートします。
[Import Unity package] ウィンドウで [Import] をクリックします。

3. コンソールから Firebase プロジェクトを開く

次のステップに進む前に、AdMob+Firebase 101 Codelab の 「Firebase プロジェクトを設定する」ステップで作成したプロジェクトを Firebase コンソールから開きます。

4. アプリイベントのファネルを作成する

アプリ内のユーザーアクティビティをトラッキングするために追加したアプリイベントがいくつかあるかもしれません。各アプリイベントのレポートを読むことで、イベントに関連付けられた詳細情報（合計数、ユーザーあたりの平均数、ユーザー属性など）を取得できます。

ただし、特定のイベントに焦点を当てるのではなく、一連のイベントの完了率を確認したい場合はどうすればよいでしょうか。Firebase 向け Google アナリティクスでは、目標到達プロセスを使用して、一連のアプリ内イベントの完了率を視覚化し、最適化できます。

目標到達プロセスを作成する

目標到達プロセスを作成するには:

Firebase コンソールに移動し、先ほど作成した Awesome Drawing Quiz プロジェクトを選択します。
[ファネル] をクリックします。
[新しい目標到達プロセス] をクリックします。
目標到達プロセスの名前と説明を入力します。
目標到達プロセスのステップとして使用する、最初の 2 つのイベントを選択します。
追加したステップごとに [別のイベントを追加] をクリックし、イベントを選択します。
[作成] をクリックします。

上記の手順に沿って、次のファネルを作成します。

#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 を使用して、アプリのアップデートなしで報酬額（リワード動画広告の視聴後に開示される文字数）を調整する方法を学びます。

Firebase Remote Config SDK を追加する

Firebase Unity SDK 5.5.0 をダウンロードし、適切な場所で解凍します。
Awesome Drawing Quiz Unity プロジェクトを開き、[Assets] > [Import Package] > [Custom Package] の順に選択します。
解凍した SDK の中から Remote Config SDK（dotnet4/FirebaseRemoteConfig.unitypackage）をインポートします。
[Import Unity package] ウィンドウで [Import] をクリックします。

Firebase.RemoteConfig をインポートする

完全修飾名を使用しなくても Firebase.RemoteConfig の型を使用できるように、Main.cs を変更します。

Scenes/Main.cs

...

using AwesomeDrawingQuiz.Game;

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

namespace AwesomeDrawingQuiz.Scene {
    ...
}

Remote Config の値を初期化して取得する

Main.cs の InitAndFetchRemoteConfig() メソッドを変更して、次のように Remote Config インスタンスを初期化します。GameSettings.KEY_REWARD_AMOUNT には、Remote Config のパラメータの名前が格納されます。（このフィールドは、この Codelab でまもなく宣言します）

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)）

取得した Remote Config の値を有効にする

Remote Config 値を正常にフェッチしたら、それらの値を有効にしてアプリで使用できるようにする必要があります。ActivateRemoteConfigValues() メソッドを次のように変更します。

Scenes/Main.cs

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

Start() メソッドを変更する

アプリの起動時にアプリが Remote Config の値をフェッチして有効にするようにするには、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
}

Remote Config から報酬額を取得する

GameSettings クラスを変更して、Remote Config から報酬額を取得します。

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

コンソールから Remote Config パラメータを作成する

次に、報酬額の新しい Remote Config パラメータを作成して、その値をオンザフライで調整できるようにします。

新しいパラメータを作成するには、Firebase コンソールに移動し、先ほど作成した Awesome Drawing Quiz プロジェクトを選択します。[Remote Config -> 最初のパラメータを追加] ボタンをクリックします。

パラメータに reward_amount という名前を付け、デフォルト値を 1 に設定します。[パラメータを追加] ボタンをクリックします。

[変更を公開] ボタンをクリックして、変更をユーザーに公開します。

6. Remote Config を使用してアプリの動作を変更する

Awesome Drawing Quiz の報酬額を、アプリのコードを更新することなく Firebase コンソールで設定できるようになりました。

このセクションでは、リワード広告を視聴した後にアプリでヒントとして 2 文字を表示するように、報酬額を 1 から 2 に変更します。

reward_amount パラメータのデフォルト値を更新

Firebase コンソールに移動し、先ほど作成した Awesome Drawing Quiz プロジェクトを選択します。[Remote Config] をクリックし、リストから reward_amount をクリックします。次に、デフォルト値を 2 に変更し、[更新] ボタンをクリックします。

[変更を公開] ボタンをクリックして、変更をユーザーに公開します。

アプリの動作の変更を確認する

アプリの動作変更を確認するには、プロジェクトを再度実行します。リワード広告の視聴が完了すると、Remote Config コンソールで設定したとおり、アプリで報酬として2 文字が表示されます。

リワード広告を視聴する前

報酬として 2 つの文字を公開

7. 報酬額を最適化するテストを作成します。

アプリのアップデートを公開しなくても、報酬の金額を変更できるようになりました。ただし、変更した量がアプリにとって適切かどうかを判断するにはどうすればよいでしょうか？

Firebase A/B Testing を使用すると、アプリを更新したり、各テストのパフォーマンスを実行して追跡するための別のツールを構築したりすることなく、テストを実施してアプリの全体的なユーザーエクスペリエンスを最適化できます。

テストを設計する

新しいテストを作成する前に、テストの明確な目標を設定する必要があります。新しいテストを作成する前に、次のチェックリストを確認してください。

What（何を最適化したいか）: 最適化したい内容を明確にします。（ゲームの難易度、広告のタイミングや表示など）
理由: テストを実施するビジネス上の目標は何ですか？（例: 広告収入を最大化する、ユーザー維持率を高めるなど）
対象: テストの対象となるのは誰ですか？（例: すべてのユーザー、特定のユーザーオーディエンスなど）

この Codelab では、Awesome Drawing Quiz の 1 日あたりのユーザーエンゲージメントを最大化するために、報酬額の値を最適化するテストを作成します。

テストを作成する

Firebase コンソールで Awesome Drawing Quiz プロジェクトを開きます。[A/B テスト] メニューを選択し、[テストを作成] ボタンをクリックします。

[Remote Config] を選択して、Remote Config テストを作成します。

次のスクリーンショットに示すように、テストに「Amount of the Reward」という名前を付けます。

ターゲティングオプションを設定します。この Codelab では、Awesome Drawing Quiz のユーザーの 100% を対象にします。

テストの主な目的は、1 日のユーザーエンゲージメントを最大化する最適な値を見つけることであるため、追跡するメインの指標として [1 日のユーザーエンゲージメント] を選択します。

最後に、コントロールグループとバリエーショングループを設定して、どちらのグループのパフォーマンスが高いかを確認します。コントロールグループから reward_amount を選択し、その値を変更しないままにします。バリエーショングループの名前を「Less reward」に変更し、reward_amount の値を 1 に変更します。