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

始める

Google Mobile Ads SDK のアプリへの統合は、広告を表示して収益を得ることができます。SDK を統合すると、次のことが可能になります。広告フォーマット（ネイティブ動画、リワード動画など）を選択し、手順に沿って実装します。

始める前に

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

アプリの前提条件

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

アプリを設定する

Gradle の設定ファイルに、 Google の Maven リポジトリ Maven セントラルリポジトリ:

Kotlin

pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include(":app")

Groovy

pluginManagement {
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
  }
}

rootProject.name = "My Application"
include ':app'

Google Mobile Ads SDK の依存関係をアプリレベルのビルドに追加するファイル:

Kotlin

dependencies {
  implementation("com.google.android.gms:play-services-ads:23.3.0")
}

Groovy

dependencies {
  implementation 'com.google.android.gms:play-services-ads:23.3.0'
}

Ad Manager アプリ ID を Ad Manager ウェブインターフェースを使用して、 AndroidManifest.xml ファイル。これを行うには、<meta-data> タグを追加します。 android:name="com.google.android.gms.ads.APPLICATION_ID"。詳しくは、ウェブインターフェースでアプリ ID を確認します。 Ad Manager 対象 android:value 様、ご自身の Ad Manager アプリ ID を挿入してください、引用符で囲みます。
```
<manifest>
  <application>
    
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>
```
実際のアプリでは、サンプルアプリ ID を実際の Ad Manager アプリ ID。次の場合にサンプル ID を使用できます。 Hello World アプリで SDK を試すだけなので

また、示された結果どおり <meta-data> タグを追加していないことに注意してください。次のメッセージが表示されてクラッシュします。
```
Missing application ID.
```
（省略可）宣言以前のバージョンを Android で動作させるための AD_ID 権限 13.

アプリで 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 を対象としている場合は、に対する com.google.android.gms.permission.AD_ID 権限 Google Mobile Ads SDK の AndroidManifest.xml ファイルを変更して、広告 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 権限の申告、詳しくは、こちらの Play コンソールに関する記事をご覧ください。

Google Mobile Ads SDK を初期化する

広告を読み込む前に、次を呼び出して Google Mobile Ads SDK を初期化します。 MobileAds.initialize()。

このメソッドは 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);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

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

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}