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

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

AdMob、Firebase、Google アナリティクスを併用するメリットについては、こちらをご覧ください。

始める前に

Firebase プロジェクトと Firebase アプリがまだない場合は、Firebase スタートガイドの Android プロジェクトに Firebase を追加するをご覧ください。
Firebase プロジェクトで Google アナリティクスが有効になっていることを確認します。
- 新しい Firebase プロジェクトを作成する場合は、プロジェクトの作成ワークフローで Google アナリティクスを有効にします。
- Google アナリティクスが有効になっていない既存の Firebase プロジェクトがある場合は、 > [プロジェクト設定] の [統合] タブで Google アナリティクスを有効にできます。
注: Google アナリティクス用の Firebase SDK をアプリに追加することは任意ですが、追加することを強くおすすめします。Google アナリティクス用の 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:22.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 アナリティクス用の Firebase SDK を追加すれば、Firebase コンソールで広告キャンペーンのコンバージョンをマークしたり、カスタムオーディエンスを作成したりもできます。

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

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

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

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

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

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

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

ステップ 6: アプリに実装する広告フォーマットを選択する

AdMob にはさまざまな広告フォーマットが用意されており、アプリのユーザーエクスペリエンスに合わせて最適なフォーマットを選択できます。広告フォーマットのボタンをクリックすると、AdMob のドキュメントで詳しい実装手順を確認できます。

デバイス画面の上部か下部に表示される長方形の広告です。

ユーザーがアプリを操作している間は画面に残り、一定の時間が経過すると自動的に更新されます。モバイル広告を初めて利用する場合、この広告から開始するのが最適です。

バナー広告を実装する

インタースティシャル

ユーザーが閉じるまでアプリのインターフェース上に表示されるフルスクリーン広告です。

アプリの実行フロー間で違和感のないタイミング（ゲームでレベルが切り替わるときやタスクの完了直後など）に使用するのが最適です。

インタースティシャル広告を実装する

ネイティブ

アプリの外観に合わせてカスタマイズできる広告です。

ネイティブ広告はコンポーネントベースの広告フォーマットで、レイアウトがアプリのデザインと一致するように、配置方法と配置場所を決定できます。フォント、色、その他の詳細を選択して、自然かつコンテンツの邪魔にならないように広告を表示し、ユーザーエクスペリエンスを向上させることができます。

ネイティブアドバンス広告を実装する

リワードベース

短い動画を視聴したり体験プレイ広告やアンケートを操作したユーザーに特典を提供する広告です。

リワード（または「リワードベース」）広告は、無料ユーザーから収益を得るために効果的です。

リワード広告を実装する

リワード広告を実装する（新しい API）