此页面由 Cloud Translation API 翻译。

开始使用

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

准备工作

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

应用要满足的前提条件

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

配置您的应用

在 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:23.6.0")
}

Groovy

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

将您的 Ad Manager 应用 ID（可在 Ad Manager 网站界面中找到）添加到应用的 AndroidManifest.xml 文件中。为此，请添加包含 android:name="com.google.android.gms.ads.APPLICATION_ID" 的 <meta-data> 标记。您可以在 Ad Manager 网站界面中找到您的应用 ID。对于 android:value，请插入您自己的 Ad Manager 应用 ID，并用英文引号括起来。
```
<manifest>
  <application>
    
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="
/<network_code>~<application_id>"/>
  </application>
</manifest>
```
在真实应用中，请将示例应用 ID 替换为您的实际 Ad Manager 应用 ID。如果您只是想在 Hello World 应用中试用 SDK，则可以使用示例 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

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