このページは Cloud Translation API によって翻訳されました。

スタートガイド

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

始める前に

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

アプリの前提条件

アプリのビルドファイルで次の値が使用されていることを確認します。
- 最小 SDK バージョン: 19 以降
- SDK バージョン 33 以降をコンパイルする

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

次の手順でアプリを AdMob アプリとして登録します。

AdMob アカウントにログインまたは登録します。
AdMob にアプリを登録します。このステップでは、このガイドの後半で必要になる一意の AdMob アプリ ID を使用して、AdMob アプリを作成します。

アプリを設定する

プロジェクトレベルの build.gradle ファイルで、buildscript セクションと allprojects セクションの両方に Google の Maven リポジトリと Maven セントラルリポジトリを含めます。
```
buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}
```
Google Mobile Ads SDK の依存関係をモジュールのアプリレベルの Gradle ファイル（通常は app/build.gradle）に追加します。
```
dependencies {
  implementation 'com.google.android.gms:play-services-ads:23.0.0'
}
```
AdMob アプリ ID（AdMobウェブインターフェースで識別される）をアプリの AndroidManifest.xml ファイルに追加します。そのためには、android:name="com.google.android.gms.ads.APPLICATION_ID" を持つ <meta-data> タグを追加します。アプリ ID は AdMob ウェブインターフェースで確認できます。android:value の場合は、ご自身の AdMob アプリ ID を引用符で囲んで挿入します。
```
<manifest>
  <application>
    
    <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> タグを追加しないと、クラッシュして次のメッセージが表示されます。
```
Missing application ID.
```
（省略可）以前のバージョンが 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"/>

   
   <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 を初期化します。

このメソッドは SDK を初期化し、Google Mobile Ads SDK とアダプタの初期化の両方が完了したとき、または 30 秒のタイムアウト後に完了リスナーを呼び出します。この処理は 1 回だけ行います（アプリの起動時に行うのが理想的です）。

広告の初期化時に、Google Mobile Ads SDK またはメディエーションパートナーの SDK によって広告がプリロードされる場合があります。欧州経済領域（EEA）のユーザーから同意を得る必要がある場合は、広告を読み込む前に、リクエストに固有のフラグ（ setTagForChildDirectedTreatment()、setTagForUnderAgeOfConsent()、など）を設定してから、Google Mobile Ads SDK を初期化する前に同意を取得してください。

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

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) {}
  }
}