本頁面由 Cloud Translation API 翻譯而成。

開始使用

將 Google Mobile Ads SDK 整合到應用程式中，來顯示廣告及賺取收益整合 SDK 後選擇廣告格式 (例如原生或獎勵影片廣告)，然後按照步驟實際執行這些工作

事前準備

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

應用程式必要條件

請確認應用程式的版本檔案使用下列的值：
- SDK 最低版本 21 或更高
- 以下編譯 SDK 版本： 33 或更高

設定應用程式

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

Groovy

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

新增 Ad Manager 應用程式 ID，格式為 Ad Manager 網頁介面加入應用程式的 AndroidManifest.xml 檔案。方法是新增含有以下項目的 <meta-data> 標記： android:name="com.google.android.gms.ads.APPLICATION_ID"。您可以您在網頁介面中應用程式 ID Ad Manager 。適用對象 android:value，請插入自己的 Ad Manager 應用程式 ID，。
```
<manifest>
  <application>
    
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>
```
在實際應用程式中，請將範例應用程式 ID 換成實際 Ad Manager 應用程式 ID。如果下列情況，您可以使用範例 ID 您只是在 Hello World 應用程式中用 SDK 進行實驗。

另請注意，無法一字不完全地新增 <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 為目標版本，則需新增「com.google.android.gms.permission.AD_ID」權限 Google Mobile Ads SDK 的 AndroidManifest.xml 檔案存取廣告 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 權限聲明，想瞭解如何停用此功能，可以參考這篇 Google Play 文章。

初始化 Google Mobile Ads SDK

載入廣告前，請呼叫 MobileAds.initialize()。

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

Google Mobile Ads SDK 或中介服務合作夥伴 SDK 可能會預先載入廣告做出決定如果需要向歐洲使用者取得同意聲明歐洲經濟區 (EEA)，請設定任何請求專屬標記，例如 setTagForChildDirectedTreatment() 或 setTagForUnderAgeOfConsent(), 或否則請在初始化廣告前完成 Google Mobile Ads SDK。

以下範例說明如何在背景呼叫 initialize() 方法中的執行緒：

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}