設定 Google Mobile Ads SDK

選取平台： Android (Beta 版)

Android iOS Unity Flutter

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

事前準備

請執行下列各節的步驟，完成應用程式前置作業。

應用程式必要條件

請確認應用程式的版本檔案為下列值：
- SDK 為 23 以上版本
- 編譯 SDK 為 35 以上版本

設定應用程式

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

Groovy

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

按一下「立即同步處理」。如要進一步瞭解同步處理作業，請參閱「使用 Gradle 檔案同步處理專案」。
在應用程式的 AndroidManifest.xml 檔案中，加入 Ad Manager 網頁介面顯示的 Ad Manager 應用程式 ID。方法是新增含 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="SAMPLE_APP_ID"/>
  </application>
</manifest>
```
將 SAMPLE_APP_ID 替換為您的 Ad Manager 應用程式 ID。測試時，請使用前一個範例顯示的範例應用程式 ID。

此外，請注意，如果未完全按照顯示方式新增 <meta-data> 代碼，會導致當機並顯示以下訊息：
```
Missing application ID.
```
(選用) 請宣告 AD_ID 權限，讓舊版可與 Android 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，您必須在 AndroidManifest.xml 檔案中新增 com.google.android.gms.permission.AD_ID 權限，Google Mobile Ads 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 Mobile Ads SDK

請先呼叫 MobileAds.initialize()，初始化 Google Mobile Ads SDK 後，才能載入廣告。

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

如果您使用中介服務，請等到系統呼叫完成處理常式後，再載入廣告。這可確保所有中介服務轉接程式都完成初始化。

Google Mobile Ads SDK 或中介服務合作夥伴 SDK 可能會在初始化時預先載入廣告。如需取得歐洲經濟區 (EEA) 使用者同意聲明，務必在初始化 Google Mobile Ads SDK 前，設定適用的要求專屬標記 (如 setTagForChildDirectedTreatment() 或 setTagForUnderAgeOfConsent())，或在載入廣告前採取相關行動。

以下範例說明如何在 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@MyActivity) {}
}MyActivity.kt