ご利用開始

このガイドは、AdMob で Android アプリを収益化することをご希望のパブリッシャー様のうち、Firebase を使用されていない方を対象としています。アプリで Firebase を使用する予定がある場合（または使用を検討している場合）は、このガイドの Firebase を使った AdMob 向けのバージョンをご確認ください。

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

前提条件

Android Studio 3.2 以降を使用している
minSdkVersion 16 以上
compileSdkVersion 28 以上

推奨: Google AdMob アカウントを作成して、アプリを登録している

Mobile Ads SDK のインポート

アプリで Google Mobile Ads SDK をインポートするには、Google の Maven リポジトリを参照する Gradle 依存関係を使用します。まず、google() がプロジェクトレベルの build.gradle ファイルの allprojects セクションで参照されていることを確認します。

プロジェクトレベルの build.gradle の例（抜粋）

allprojects {
    repositories {
        google()
    }
}

次に、お客様のアプリレベルの build.gradle ファイルを開き、「dependencies」セクションを探します。

アプリレベルの build.gradle の例（抜粋）

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'androidx.appcompat:appcompat:1.0.2'
    implementation 'com.google.android.gms:play-services-ads:20.0.0'
}

上の例の太字の行（Mobile Ads SDK の最新バージョンと、関連する追加の依存関係を読み込むように Gradle に指示する行）を追加します。作業が終わったらファイルを保存し、Gradle 同期を実施します。

AndroidManifest.xml を更新する

下記のように android:name="com.google.android.gms.ads.APPLICATION_ID" を含む <meta-data> タグを追加して、AdMob アプリ ID（AdMob 管理画面で識別される）をアプリの AndroidManifest.xml ファイルに追加します。

アプリ 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>

Mobile Ads SDK を初期化する

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

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

MainActivity の例（抜粋）

Java

package ...
import ...
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

package ...
import ...
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) {}
    }
    ...
}

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