始める

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

始める前に

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

アプリの前提条件

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

    • minSdkVersion/19 以上
    • compileSdkVersion/33 以上

アプリを設定する

  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.5.0'
    }
    
  3. Ad Manager アプリ ID(Ad Managerウェブ インターフェースで識別される)をアプリの AndroidManifest.xml ファイルに追加します。追加するには、android:name="com.google.android.gms.ads.APPLICATION_ID" を含む <meta-data> タグを追加します。アプリ ID は Ad Manager ウェブ インターフェースで確認できます。android:value の場合は、ご自身のアプリ ID を Ad Manager 引用符で囲んで挿入します。

    <manifest>
      <application>
        <!-- Sample Ad Manager 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 ではなく、実際の Ad Manager アプリ 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 がインポートされ、広告を実装できるようになりました。 Ad Manager にはさまざまな広告フォーマットが用意されているため、アプリのユーザー エクスペリエンスに最適なものを選択できます。

デバイス画面の上部か下部に表示される長方形の広告です。アプリの操作中は画面に表示され続けますが、一定時間が経過すると自動的に更新されるよう設定できます。モバイル広告を初めてお使いの場合は、この広告から始めることをおすすめします。

バナー広告を実装する

インタースティシャル

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

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

ネイティブ

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

Google アド マネージャーでは、ネイティブ広告を実装する方法として、ネイティブ スタイルとカスタム レンダリングの 2 種類が用意されています。

ネイティブ スタイルは、ネイティブ広告をできるだけ簡単に実装できるように設計されているため、このフォーマットを初めて使用する場合に最適です。カスタム レンダリングは、プレゼンテーションをより自由に作成できるよう設計されています。

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

特典

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

リワード広告を実装する

補足資料

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