開始使用

選取平台： Android iOS Unity Flutter

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

事前準備

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

應用程式必要條件

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

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

Groovy

dependencies {
  implementation 'com.google.android.gms:play-services-ads:24.5.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 搭配運作。

如果應用程式使用 20.4.0 以上版本的 Google Mobile Ads SDK，則可略過這個步驟，因為 SDK 會自動宣告 com.google.android.gms.permission.AD_ID 權限，並在廣告 ID 可用時存取該 ID。

如果應用程式使用 20.3.0 版或更舊版本的 Google Mobile Ads SDK，且以 Android 13 為目標平台，則必須在 com.google.android.gms.permission.AD_ID 檔案中新增 AndroidManifest.xml 權限，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 可能會預先載入廣告。如需向歐洲經濟區的使用者取得同意聲明，請在載入廣告前，設定任何要求專屬標記，例如 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