在應用程式中整合 Google Mobile Ads SDK (Beta 版)，是刊登廣告賺取收益的第一步。整合 SDK 後，您可以選擇廣告格式 (例如原生或獎勵影片廣告)，然後按照步驟導入。
事前準備
如要讓應用程式做好準備，請完成下列各節的步驟。
應用程式必要條件
請確認應用程式的版本檔案使用下列的值：
- SDK 為
24以上版本 - 編譯 SDK 為
35以上版本
- SDK 為
- 如果是 Kotlin 應用程式，請使用最低 Kotlin 版本 1.9。
在 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 (Beta 版) 的依附元件加進應用程式層級的建構檔：
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01' }
按一下「立即同步處理」。如要進一步瞭解同步處理作業，請參閱「使用 Gradle 檔案同步處理專案」。
初始化 Google Mobile Ads SDK (Beta 版)
呼叫 MobileAds.initialize() 初始化 Google Mobile Ads SDK (Beta)。這項作業必須在背景執行緒中呼叫，否則可能會導致「應用程式無回應」(ANR) 錯誤。
Kotlin
import com.google.android.libraries.ads.mobile.sdk.MobileAds import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig 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 Google Mobile Ads SDK (beta) on a background thread. MobileAds.initialize( this@MainActivity, // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 InitializationConfig.Builder("SAMPLE_APP_ID").build() ) { // Adapter initialization is complete. } // Other methods on MobileAds can now be called. } } }
Java
import com.google.android.libraries.ads.mobile.sdk.MobileAds; import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig; public class MainActivity extends AppCompatActivity { protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); new Thread( () -> { // Initialize Google Mobile Ads SDK (beta) on a background thread. MobileAds.initialize( this, // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 new InitializationConfig.Builder("SAMPLE_APP_ID") .build(), initializationStatus -> { // Adapter initialization is complete. }); // Other methods on MobileAds can now be called. }) .start(); } }
這個方法會初始化 SDK，並在 Google Mobile Ads SDK (Beta 版) 和轉接程式初始化完成後 (或 30 秒逾時後)，呼叫完成事件監聽器。這項操作只要執行一次，最佳時機是應用程式啟動時。
Google Mobile Ads SDK (Beta 版) 或中介服務合作夥伴 SDK 可能會在初始化時預先載入廣告。如須向歐洲經濟區的使用者取得同意聲明，請設定適用的請求標記 (例如 RequestConfiguration.TagForChildDirectedTreatment 或 RequestConfiguration.TagForUnderAgeOfConsent)，或在載入廣告前採取相關行動。請務必在初始化 Google Mobile Ads SDK (Beta 版) 前完成上述步驟。
選取廣告格式
Google Mobile Ads SDK (Beta 版) 已匯入完成，現在您可以開始導入廣告。 AdMob 提供多種廣告格式，您可以根據應用程式的使用者體驗，選擇最適合的格式。
橫幅廣告
橫幅廣告單元會占用應用程式的部分版面來顯示矩形廣告，且會固定在一段時間後自動重新整理。也就是說，即便使用者停留在應用程式的同一個畫面，每隔一段時間還是會看見新的廣告。這也是最容易導入的廣告格式。
插頁式
您可以將插頁式廣告單元安插至使用者操作應用程式的空檔或轉換點 (例如通過遊戲應用程式關卡後)，在應用程式介面上顯示全版廣告。
已獲得獎勵
啟用獎勵廣告單元，使用者就能透過玩遊戲、參加問卷調查或觀看影片等方式，贏得應用程式內獎勵，例如金幣、額外生命值或積分。您可以為不同的廣告單元設定不同的獎勵，並指定使用者獲得的獎勵價值和道具。
插頁式獎勵廣告
插頁式獎勵廣告是全新的獎勵廣告格式，您可以在應用程式自然轉換時自動顯示這類廣告，向使用者發放錢幣或額外生命等獎勵。
與獎勵廣告不同的是，插頁式獎勵廣告不需等使用者選擇觀看即可放送。
獎勵廣告會顯示選擇觀看的提示，插頁式獎勵廣告則是顯示獎勵簡介畫面，使用者可選擇不觀看廣告。
應用程式開啟頁面廣告
「應用程式開啟頁面廣告」這種格式會在使用者開啟或切換回應用程式時顯示。廣告會疊在載入畫面上。