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

1. はじめに

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

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

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

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

この Codelab で問題（コードのバグ、文法的な誤り、不明確な表現など）が見つかった場合は、Codelab の左下隅にある [誤りを報告] から問題を報告してください。

学習内容

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

必要なもの

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

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

初心者

中級者

上級者

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

初心者

中級者

上級者

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

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

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

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

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

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

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

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

スターターアプリをインポートする

Android Studio を起動し、ウェルカム画面で [Import project] を選択します。次に、ダウンロードしたコードから 101-complete_and_102-base ディレクトリを選択します。

これで、Android Studio でプロジェクトが開きます。

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

Awesome Drawing Quiz プロジェクトの概要画面で、設定アイコンをクリックします。
[全般] タブで、Android アプリを選択して google-service.json ファイルをダウンロードします。
構成ファイルをプロジェクトの app ディレクトリに移動します。

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

Remote Config をアプリの依存関係に追加する

まず、Firebase Remote Config をアプリの依存関係に追加しましょう。

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 ファイルと同期します。

Remote Config パラメータのデフォルト値を設定する

Remote Config から値を取得するには、ネットワーク接続が必要です。ネットワークが利用できない場合に備えて、各 Remote Config パラメータのデフォルト値を定義する必要があります。

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 は Remote Config のパラメータの名前です。

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

AwesomeDrawingQuiz.kt を変更して、GameSettings クラスが RemoteConfig インスタンスへの参照を保持するようにします。

RemoteConfig インスタンスは、デバッグモードでサーバーから最新の値を取得するように構成されており、開発プロセスに役立ちます。（fetch(0L) を呼び出して最小フェッチ間隔を 0 秒に設定します）

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 クラスを変更して、Remote Config から報酬額を取得します。

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

コンソールから 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 に変更します。