若要讨论我们的产品并提供反馈，请加入 Google 广告和效果衡量社区服务器中的官方 AdMob Discord 频道。

开始使用

请选择平台： Android iOS Unity Flutter

要展示广告并赚取收入，第一步是将 Google 移动广告 SDK 集成到应用中。集成 SDK 后，您可以选择一种广告格式，如原生广告或激励视频广告，然后按照相应步骤植入广告。

准备工作

为了让您的应用做好准备，请完成以下部分中的步骤。

应用要满足的前提条件

确保您应用的 build 文件使用以下版本号：
- 最低 SDK 版本为 23 或更高版本
- 编译 SDK 版本为 34 或更高版本

在您的 AdMob 账号中设置您的应用

完成以下步骤，将您的应用注册为 AdMob 应用：

登录或注册 AdMob 账号。
在 AdMob 中注册您的应用。此步骤将创建一个具有唯一 AdMob 应用 ID 的 AdMob 应用，本指南稍后需要用到此 ID。

配置您的应用

在 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 移动广告 SDK 的依赖项添加到应用级 build 文件中：

Kotlin

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

Groovy

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

点击 Sync Now。如需详细了解同步，请参阅将项目与 Gradle 文件同步。
将您的 AdMob 应用 ID（可在 AdMob 网页界面中找到）添加到应用的 AndroidManifest.xml 文件中。为此，请添加包含 android:name="com.google.android.gms.ads.APPLICATION_ID" 的 <meta-data> 代码。您可以在 AdMob 网页界面中找到您的应用 ID。对于 android:value，请插入您自己的 AdMob 应用 ID 并加上英文双引号。
```
<manifest>
  <application>
    
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="SAMPLE_APP_ID"/>
  </application>
</manifest>
```
请将 SAMPLE_APP_ID 替换为您的 AdMob 应用 ID。在测试期间，请使用上例中显示的示例应用 ID。

另请注意，如果未能完全按照所示添加 <meta-data> 代码，会导致崩溃，并显示以下消息：
```
Missing application ID.
```
（可选）为之前的版本声明 AD_ID 权限，以便与 Android 13 兼容。

如果您的应用使用 Google 移动广告 SDK 版本 20.4.0 或更高版本，您可以跳过此步骤，因为 SDK 会自动声明 com.google.android.gms.permission.AD_ID 权限并可在广告 ID 可用时随时访问。

对于使用 Google 移动广告 SDK 版本 20.3.0 或更低版本，并且以 Android 13 为目标平台的应用，则必须在 AndroidManifest.xml 文件中添加 com.google.android.gms.permission.AD_ID 权限，Google 移动广告 SDK 才能访问广告 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 移动广告 SDK

加载广告之前，请先调用 MobileAds.initialize() 来初始化 Google 移动广告 SDK。

此方法会初始化 SDK，并在 Google 移动广告 SDK 和适配器初始化完成后或 30 秒超时后，调用完成监听器。此操作仅需执行一次，最好是在应用启动时执行。

在初始化时，Google 移动广告 SDK 或中介合作伙伴 SDK 可能会预加载广告。如果您需要获得欧洲经济区 (EEA) 用户的同意，请设置专门用于特定请求的标记（例如 setTagForChildDirectedTreatment() 或 setTagForUnderAgeOfConsent()），或者在加载广告之前采取其他相关操作，并确保在初始化 Google 移动广告 SDK 之前先完成这些操作。

以下示例展示了如何在 Activity 中的后台线程中调用 initialize() 方法：

Java

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

Kotlin

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