歡迎加入 Google 廣告與評估社群伺服器的官方 Ad Manager Discord 頻道，與成員一起討論產品並提供意見回饋。

開始使用

選取平台： Android iOS Unity Flutter

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

事前準備

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

應用程式必要條件

請確認應用程式的版本檔案為下列值：
- SDK 為 23 以上版本
- 編譯 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 Mobile Ads SDK 的依附元件，加進應用程式層級的建構檔：

Kotlin

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

Groovy

dependencies {
  implementation 'com.google.android.gms:play-services-ads:24.7.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="
/<network_code>~<application_id>"/>
  </application>
</manifest>
```
接著，將 /<network_code>~<application_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，可能會在初始化時預先載入廣告。如需向歐洲經濟區的使用者取得同意聲明，請在載入廣告前，設定任何請求專屬標記，例如 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@MyActivity) {}
}MyActivity.kt