本頁面由 Cloud Translation API 翻譯而成。

開始使用

在應用程式中整合 Google Mobile Ads SDK 是顯示廣告及賺取收益的第一步。整合 SDK 後，您可以選擇廣告格式 (例如原生或獎勵影片)，並按照步驟導入。

事前準備

如要讓應用程式做好準備，請完成下列各節的步驟。

應用程式必要條件

請確認應用程式的版本檔案使用下列的值：
- 最低 SDK 版本為 21
- 編譯 34 以上版本的 SDK

設定應用程式

在 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 的依附元件加進應用程式層級的 build 檔案：

Kotlin

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

Groovy

dependencies {
  implementation 'com.google.android.gms:play-services-ads:23.5.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 Mobile Ads SDK 20.4.0 以上版本20.4.0，您可以略過這個步驟，因為 SDK 會自動宣告 com.google.android.gms.permission.AD_ID 權限，並在廣告 ID 可用時存取廣告 ID。

如果應用程式使用 Google Mobile Ads SDK 20.3.0 以下版本，且指定 Android 13 為目標版本，則必須在 AndroidManifest.xml 檔案中新增 com.google.android.gms.permission.AD_ID 權限，讓 Google Mobile Ads SDK 存取廣告 ID：20.3.0
```
<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

在載入廣告之前，請呼叫 MobileAds.initialize() 來初始化 Google Mobile Ads SDK。

這個方法會在 Google Mobile Ads SDK 和轉接器初始化完成後，或在 30 秒逾時後，初始化 SDK 並呼叫完成事件監聽器。這項操作只需執行一次，最好是在應用程式啟動時執行。

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