スタートガイド

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

始める前に

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

アプリの前提条件

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

    • 最小 SDK バージョン: 19 以上
    • SDK バージョン 33 以降をコンパイルする

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:22.6.0'
    }
    
  3. AdMob アプリ ID(AdMobウェブ インターフェースで識別される)をアプリの 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>
    

    実際のアプリでは、サンプルアプリ ID を実際の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 を初期化する

広告を読み込む前に、アプリで Google Mobile Ads SDK を初期化します。 MobileAds.initialize() これは 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 に用意されているさまざまな広告フォーマットの使い方を示しています。