ご利用開始

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

アプリに Google Mobile Ads SDK を統合することは、広告を表示して収益を得るための第一歩です。SDK を統合したら広告フォーマット(ネイティブ、動画リワードなど)を選択し、手順に沿って実装してください。

始める前に

アプリを準備するには、以下のセクションに示す手順を完了します。

アプリの前提条件

  • Android Studio 3.2 以降を使用している
  • アプリのビルドファイルで次の値が使用されていることを確認します。

    • minSdkVersion19 以上
    • compileSdkVersion28 以上

AdMob アカウントでアプリを設定する

アプリを AdMob アプリとして登録する手順は次のとおりです。

  1. AdMob アカウントにログインまたは登録します。

  2. AdMob にアプリを登録します。この手順では、ガイドの後半で必要になる固有の AdMob アプリ ID を使用して、AdMob アプリを作成します。

アプリを設定する

  1. プロジェクト レベルの build.gradle ファイルで、buildscript セクションと allprojects セクションの両方に Google' Maven リポジトリMaven セントラル リポジトリを含めます。

    buildscript {
        repositories {
            google()
            mavenCentral()
        }
    }
    
    allprojects {
        repositories {
            google()
            mavenCentral()
        }
    }
    
  2. Google Mobile Ads SDK の依存関係をモジュールレベルのアプリレベルの Gradle ファイル(通常は app/build.gradle)に追加します。

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:21.3.0'
    }
    
  3. アプリに、 AdMob アプリ ID(AdMob UI)で識別されるAndroidManifest.xmlファイルを追加します。追加するには、android:name="com.google.android.gms.ads.APPLICATION_ID" を持つ <meta-data> タグを追加します。アプリ ID は AdMob の管理画面で確認できます。android:value の場合は、ご自身の AdMob アプリ ID を引用符で囲んで挿入します。

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

    実際のアプリでは、上記のものではなく、実際の AdMob アプリ ID を使用します。Hello World アプリで SDK を試すだけであれば、上記のサンプルのアプリ ID を使用できます。

    また、前述のように <meta-data> タグを追加しなかった場合、次のメッセージが表示されてクラッシュします。

    The Google Mobile Ads SDK was initialized incorrectly.
    

    (省略可)以前のバージョンが Android 13 と連携するように、AD_ID 権限を申告します。

    アプリで Google Mobile Ads SDK バージョン 20.4.0 以降を使用している場合、SDK は自動的に com.google.android.gms.permission.AD_ID 権限を申告し、利用可能な広告 ID にアクセスできるため、この手順は省略できます。

    Google Mobile Ads SDK バージョン 20.3.0 以前を使用し、Android 13 をターゲティングしているアプリの場合、広告 ID にアクセスするには、Google Mobile Ads SDK の AndroidManifest.xml ファイルに com.google.android.gms.permission.AD_ID 権限を追加する必要があります。

    <manifest>
        <application>
            <meta-data
                android:name="com.google.android.gms.ads.APPLICATION_ID"
                android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    
            <-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
            <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
    
        </application>
    </manifest>
    

    権限を無効にする方法など、com.google.android.gms.permission.AD_ID 権限の申告について詳しくは、こちらの Google Play Console に関する記事をご覧ください。

Google Mobile Ads SDK を初期化する

広告を読み込む前に、MobileAds.initialize() を呼び出して、アプリで Google Mobile Ads SDK を初期化します。初期化が完了したら(または 30 秒のタイムアウト後に)、完了リスナーがコールバックされます。この処理が必要なのは 1 回のみで、アプリの起動時に行うのが理想的です。

MobileAds.initialize() を呼び出すと、Google Mobile Ads SDK かメディエーション パートナーの SDK によって広告が事前に読み込まれる場合があります。欧州経済領域(EEA)内のユーザーから同意を得る必要がある場合は、リクエスト固有のフラグ(tagForChildDirectedTreatmenttag_for_under_age_of_consent など)を設定するか、広告が読み込まれる前になんらかの対応策を取ったうえで、Google Mobile Ads SDK を初期化するようにしてください。

アクティビティで initialize() メソッドを呼び出す方法の例を次に示します。

MainActivity の例(抜粋)

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        MobileAds.initialize(this, new OnInitializationCompleteListener() {
            @Override
            public void onInitializationComplete(InitializationStatus initializationStatus) {
            }
        });
    }
}

Kotlin

import com.google.android.gms.ads.MobileAds

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        MobileAds.initialize(this) {}
    }
}

メディエーションを使用している場合は、完了ハンドラが呼び出されるまで待ってから広告を読み込むと、すべてのメディエーション アダプタが確実に初期化されます。

広告フォーマットを選択

これで、Google Mobile Ads SDK がインポートされ、広告を実装する準備が整いました。AdMob さまざまな種類の広告フォーマットが用意されており、アプリのユーザー エクスペリエンスに最適なものを選択できます。

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

バナー広告を実装する

インタースティシャル

ユーザーが閉じるまでアプリのインターフェース上に全画面表示される広告です。ゲームのレベルが切り替わる合間やタスクが完了した直後など、アプリの実行の流れが自然に一時停止するタイミングでの使用に適しています。

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

ネイティブ

アプリのデザインに合わせてカスタマイズできる広告です。広告の配置場所やスタイルを指定できるため、アプリのデザインに溶け込んだレイアウトが可能になります。

ネイティブ広告を実装する

特典

短い動画を視聴し、体験プレイ広告やアンケートを操作したユーザーに特典を進呈する広告です。無料アプリの収益化に使用されます。

リワード広告を実装する

参考情報

GitHub の Google モバイル広告リポジトリは、この API に用意されているさまざまな広告フォーマットの使い方を示しています。