設定 Google Mobile Ads SDK

選取平台： Android (Beta 版)

Android iOS Unity Flutter

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

事前準備

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

應用程式必要條件

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

在 AdMob 帳戶中設定應用程式

請完成下列步驟，將應用程式註冊為 AdMob 營利應用程式：

登入或註冊 AdMob 帳戶。
向 AdMob 註冊應用程式。這個步驟會建立 AdMob 營利應用程式，並產生專屬的 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 Mobile Ads SDK 的依附元件加到應用程式層級的建構檔：

Kotlin

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

Groovy

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

按一下「立即同步處理」。如要進一步瞭解同步處理作業，請參閱「使用 Gradle 檔案同步處理專案」。
在應用程式的 AndroidManifest.xml 檔案中，加入 AdMob 營利應用程式 ID (可在 AdMob 網頁介面中找到)。如要這樣做，請新��含 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 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 秒逾時後)，呼叫完成事件監聽器。這項操作只要執行一次，最佳時機是應用程式啟動時。

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

Google Mobile Ads SDK 或中介服務合作夥伴 SDK 可能會在初始化時，預先載入廣告。如須向歐洲經濟區的使用者取得同意聲明，請設定適用的請求標記 (例如 setTagForChildDirectedTreatment() 或 setTagForUnderAgeOfConsent())，或在載入廣告前採取相關行動。請務必在初始化 Google Mobile Ads 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