開始使用

選取平台： 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.5.0")
}

Groovy

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