Firebase で AI 搭載アプリを構築して実行する方法のデモを、2024 年の Demo Day でご覧ください。ぜひご覧ください。

Android プロジェクトで AdMob を使ってみる

このクイックスタートガイドは、Firebase で構築されたアプリを AdMob を使用して収益化したいパブリッシャーおよびデベロッパーを対象としています。Firebase をアプリに組み込む予定がない場合は、スタンドアロンの AdMob ガイドをご覧ください。

詳しくは、AdMob、Firebase、Google Analytics を併用するメリットをご覧ください。

始める前に

Firebase プロジェクトと Firebase アプリがまだない場合は、Firebase スタートガイドの Android プロジェクトに Firebase を追加するをご覧ください。
Firebase プロジェクトで Google Analytics が有効になっていることを確認します。
- 新しい Firebase プロジェクトを作成する場合は、プロジェクトの作成ワークフローで Google Analytics を有効にします。
- Google Analytics が有効になっていない既存の Firebase プロジェクトがある場合は、 > [プロジェクト設定] の [統合] タブで Google Analytics を有効にできます。
注: Google Analytics 用の Firebase SDK をアプリに追加することは任意ですが、追加することを強くおすすめします。詳しくは、Google Analytics 用の Firebase SDK を追加するメリットをご確認ください。

ステップ 1: AdMob アカウントでアプリを設定する

アプリを AdMob アプリとして登録します。
1. AdMob アカウントにログインまたは登録します。
2. AdMob にアプリを登録します。この手順では、ガイドの後半で必要になる一意の AdMob アプリ ID を使用して、AdMob アプリを作成します。
Mobile Ads SDK をアプリに追加するよう求められます。このタスクの詳しい手順については、このガイドの後半をご覧ください。
AdMob アプリを Firebase アプリにリンクします。

このステップは省略可能ですが、行っていただくことを強くおすすめします。詳しくは、ユーザーに関する指標を有効にし、AdMob アプリを Firebase にリンクするメリットをご覧ください。

AdMob アカウントの [アプリ] ダッシュボードで次の 2 つのステップを行います。
1. ユーザーに関する指標を有効にして、AdMob が AdMob アカウントのキュレートされた分析データを処理、表示できるようにします。また、これは AdMob アプリを Firebase にリンクするために必須の設定でもあります。
2. 既存の Firebase プロジェクトと Firebase アプリに AdMob アプリをリンクします。
  
  Firebase アプリに入力したものと同じパッケージ名を入力してください。Firebase アプリのパッケージ名は、 > [プロジェクト設定] の [マイアプリ] カードで確認できます。

ステップ 2: AdMob アプリ ID を `AndroidManifest.xml` ファイルに追加する

次のように <meta-data> タグを追加して、AdMob アプリ ID をアプリの AndroidManifest.xml ファイルに追加します。

<manifest>
    <application>
        <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ADMOB_APP_ID"/>
    </application>
</manifest>

というメッセージが表示され、アプリがクラッシュします。

ステップ 3: Mobile Ads SDK を追加して初期化する

Google Mobile Ads SDK の依存関係をモジュール（アプリレベル）の Gradle ファイル（通常は <project>/<app-module>/build.gradle.kts または <project>/<app-module>/build.gradle）に追加します。
```
implementation("com.google.android.gms:play-services-ads:23.6.0")
```
広告を読み込む前に、MobileAds.initialize() メソッドを呼び出します。

この呼び出しは SDK を初期化し、初期化の完了後（または 30 秒のタイムアウト後）に完了リスナーをコールバックします。このメソッドの呼び出しはできるだけ早い段階で 1 度だけ行います。可能であればアプリの起動時に呼び出してください。
警告: MobileAds.initialize() の呼び出し時に、Mobile Ads SDK またはメディエーションパートナーの SDK によって広告のプリロードが行われる場合があります。広告を読み込む前になんらかの操作を行う必要がある場合は、必ず Mobile Ads SDK を初期化する前に行ってください。初期化の前に必要なアクションの例を次に示します。
- 欧州経済領域（EEA）のユーザーから同意を得る。
- リクエスト固有のフラグ（tagForChildDirectedTreatment、tag_for_under_age_of_consent など）を設定する。
詳しくは、AdMob ドキュメントをご覧ください）
アクティビティで initialize() メソッドを呼び出す方法の例を次に示します。
Kotlin+KTX
```
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // ...
    MobileAds.initialize(this)
}MainActivity.kt
```
Java
```
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // ...
    MobileAds.initialize(this);
}MainActivity.java
```

ステップ 4: ユーザーに関する指標とアナリティクスデータを表示する

初期化後、Mobile Ads SDK はアプリからのアナリティクスイベントとユーザープロパティのロギングを自動的に開始します。このデータを表示するためにアプリへのコードの追加や広告の実装を行う必要はありません。アナリティクスデータが確認できる場所は、次のとおりです。

AdMob アカウントの [ユーザーに関する指標] カード（[ホーム] または [アプリ] ダッシュボード）では、平均セッション継続時間、ARPU、定着率など、収集されたアナリティクスデータからキュレートされたユーザーに関する指標を表示できます。
Firebase コンソールの [アナリティクス] ダッシュボードでは、集計された統計情報と主要な指標の概要を表示できます。また、Google Analytics 用の Firebase SDK を追加すれば、Firebase コンソールで広告キャンペーンのコンバージョンをマークしたり、カスタムオーディエンスを作成したりもできます。

ARPU および ARPPU 指標の精度を高めるには、これらの指標の収益計算に ecommerce_purchase というアナリティクスカスタムイベントのデータを含めることをおすすめします（詳細）。

ステップ 5: （省略可） Google Analytics と Firebase のその他の機能を使用する

アプリの収益性とユーザーエンゲージメントを向上させるため、より多くの機能を活用します。

Google Analytics 用の Firebase SDK を追加して使用する
- アプリにカスタムイベントロギングを実装します。
- カスタム広告キャンペーンのコンバージョンをマークします。
- ecommerce_purchase イベントデータを ARPU および ARPPU 指標の収益計算に含めます。
詳しくは、AdMob アプリで Google Analytics と Firebase を使用するためのガイドをご覧ください。
アプリで他の Firebase プロダクトを使用する

Google Analytics 用の Firebase SDK を追加したら、他の Firebase プロダクトを使用してアプリ内の広告を最適化します。
- Remote Config を使用すると、アプリのアップデートを公開しなくても、アプリの動作と外観を変更できます。費用はかからず、1 日あたりのアクティブユーザー数に制限はありません。
- A/B Testing では、アプリの UI、機能、エンゲージメントキャンペーンに関する変更点をテストすることで、変更を広範囲にロールアウトする前に、主な指標（収益や定着率など）に影響があるかどうかを確認できます。

アプリの広告収益化を最適化する

少数のユーザーに異なる広告フォーマットや設定を試してから、すべてのユーザーを対象とする広告の実装についてデータドリブンな意思決定を行います。詳細については、次のチュートリアルをご覧ください。
- 新しい広告フォーマットの採用のテスト（概要 | 実装）。
- 広告の頻度を最適化する（概要 | 実装）。