版本資訊

版本 發布日期 附註
1.6.0 2026-10-22
  • 更新廣告檢查器的共用工作表，在匯出廣告請求和回應時，提供文字預覽、複製按鈕和直接共用建議。
  • 修正獎勵廣告和插頁式獎勵廣告的錯誤：OnUserEarnedRewardListener.onUserEarnedReward() 方法可能會在 AdEventCallback.onAdDismissedFullScreenContent() 方法之後叫用。
  • 將 com.google.android.play:hsdp 依附元件更新至 2.2.0 版，修正 java.lang.IllegalStateException 停止運作的問題。
  • 更新消費者 ProGuard 規則，防止在啟用 R8 完整模式時，androidx.work.WorkManagerInitializer 類別發生 java.lang.RuntimeException 異常終止。
  • 修正顯示中介服務全螢幕廣告時，可用的 Activity 情境未傳遞至第三方 SDK 的錯誤。
1.5.0 2026-09-24
  • 新增 SwipeableInterstitialAd 格式的信號產生和算繪 API。這項功能目前為非公開測試版。請與您的客戶經理聯絡，並要求存取權。
  • 在圖示廣告請求中新增 excludedAppIds API，讓發布商可選擇從圖示廣告回應中排除應用程式 ID 清單。
1.4.0 2026-08-20
1.3.1 2026-07-29
  • 修正錯誤並提升效能，改善受限功能。
1.3.0 2026-07-21
  • 已變更 AdView.loadAd()，在廣告單元停用自動重新整理功能時，暫停自動重試失敗的廣告請求。
  • 如果多個原生廣告或圖示廣告的廣告請求沒有可用的廣告，SDK 現在會傳回 NO_FILL 錯誤，而非 INTERNAL_ERROR。
  • 新增資訊清單旗標，用於停用廣告檢查器。
  • 新增 Ad.getAdUnitId() 方法，用於識別請求廣告時使用的廣告單元 ID。
  • 新增 InitializationConfig.Builder.disableSdkCrashReporting() 方法，可手動停用 GMA Next-Gen SDK 中的預設當機處理常式。根據預設，SDK 仍會將當機問題委派給其他已註冊的處理常式 (例如 Crashlytics)。
  • 搭配自訂事件廣告來源使用中介服務時，ResponseInfo.getAdapterClassName() 現在會傳回自訂事件類別名稱，而非 com.google.ads.mediation.customevent.CustomEventAdapter。
1.2.1 2026-06-15
  • 針對使用 WebView API for Ads 的應用程式，修正 SDK 無法向支援的廣告代碼 (AdSense 程式碼、Google 發布商廣告代碼、HTML5 適用的 IMA) 提供信號的問題。這個問題是由於在背景執行緒上不正確呼叫 Webkit 方法所致。
1.2.0 2026-06-11
1.1.1 2026-05-27
  • 修正問題：獎勵廣告連播在轉換期間可能凍結，導致使用者無法關閉廣告。
1.1.0 2026-05-18
1.0.1 2026-04-30
  • 修正問題：使用 window.open() 的廣告或含有 target="_blank" 的連結無法開啟到達網頁。
1.0.0 2026-04-14
0.25.0-beta01 2026-03-24
0.24.0-beta03 2026-03-07
  • 修正以下問題：廣告載入失敗後，AdView.destroy() 無法停止重試載入廣告。
  • 在 NativeAdMapper 和 UnifiedNativeAdMapper 中新增零引數建構函式，提升與 Kotlin 的相容性。
  • 在 IconAd 介面中新增 packageName 屬性。
  • 新增選項，強制 SDK 使用 Cronet (而非 OkHttp) 執行網路作業。如要解決使用 OkHttp 5 的專案中的執行階段錯誤，建議強制使用 Cronet 執行網路作業。如要強制使用 Cronet，請在呼叫 MobileAds.initialize() 時，將 InitializationConfig.Builder 中的 force_use_cronet 額外項目設為 true：
    val config = InitializationConfig.Builder()
  .setExtras(bundleOf("force_use_cronet" to true))
  .build()
MobileAds.initialize(this, config)
  • 新增 Java 11 支援。如要使用 Java 11，請將下列程式碼新增至 build.gradle 檔案中的 android 區塊：
    android {
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_11
    targetCompatibility JavaVersion.VERSION_11
  }
  kotlinOptions {
    jvmTarget = '11'
  }
}
0.24.0-beta02 2026-03-03
  • 解決第三方依附元件類別載入問題，這項問題會影響伺服器對伺服器廣告請求信號的產生。
0.24.0-beta01 2026-02-13
0.23.0-beta01 2026-01-26
  • Android Gradle 外掛程式 (AGP) 最低需求版本更新為 8.3.0。
  • 修正從 Kotlin 呼叫 AdView 建構函式時，會擲回 java.lang.NoSuchMethodError 的錯誤。
  • 修正錯誤：執行刊登序列時，系統未叫用自訂事件轉接程式。
  • 更新 RtbSignalData，在可用時提供 Activity Context 給 RtbAdapter.collectSignals()。
  • 將 androidx.webkit 依附元件更新至 1.15.0 版。
  • User Messaging Platform SDK 依附元件更新至 4.0.0 版。
  • 還原 AdPreloader.getConfiguration() 和 AdPreloader.getConfigurations() 的淘汰項目。
0.22.0-beta04 2025-12-04
  • 修正 SDK 0.22.0-beta02 版的問題：Java 17 預先發布版中繼資料不正確地包含在類別檔案中。
0.22.0-beta03 2025-11-25
0.22.0-beta02 2025-11-24
0.22.0-beta01 2025-11-20
  • 更新橫幅廣告 API：
  • 修正中介服務廣告中的錯誤：系統未遵循 NativeAdRequest.Builder.setAdChoicesPlacement()，導致 AdChoices 圖示位置不正確。
  • Android Gradle 外掛程式 (AGP) 最低需求版本從 8.2.0 降至 7.3.1。
  • 已淘汰 AdPreloader.getConfigurations() 和 AdPreloader.getConfiguration(preloadId)。沒有替代項目。
0.21.0-beta01 2025-10-08
  • 新增 InitializationConfig.Builder.disableMediationAdapterInitialization() 方法。請在初始化 GMA Next-Gen SDK 之前呼叫這個方法，停用中介服務轉接程式初始化。
  • 改善 WebView 初始化作業，減少 ANR 發生。
  • 將 androidx.webkit 依附元件從 1.13.0 降級至 1.12.1。
  • 移除 androidx.work 套件使用的 android.permission.RECEIVE_BOOT_COMPLETED 權限。
  • 修正 NativeAdMapper 類別中命名錯誤的欄位。
0.20.0-beta01 2025-09-19
  • 修正錯誤：部分原生影片廣告無法自動播放。
0.19.0-beta01 2025-08-14
  • 降級兩個依附元件的版本。
    • androidx.work:work-runtime從 2.10.0 降至 2.7.0。
    • androidx.core:core and androidx.core:core-ktx從 1.15.0 降級至 1.12.0。
  • 將 ResponseInfo 的 loadedAdSourceResponse 屬性重新命名為 loadedAdSourceResponseInfo。
  • 修正錯誤：使用者可透過返回按鈕，提早關閉部分全螢幕廣告。
  • 凡是可使用這項功能的發布商，現在都能為所有廣告格式設定刊登位置 ID。
  • 在原生中介服務轉接程式的 NativeAdMapper 中，新增 destroy() 回呼。
0.18.0-beta01 2025-07-17
  • 修正原生中介服務錯誤，該錯誤會導致參照 com.google.android.gms.ads.NativeAd.MediaView 的轉接程式無法放送廣告。
  • 以 @JvmStatic 為 MobileAds.registerCustomTabsSession() 加註。
  • 修正錯誤：使用 AdMob 聯播網刊登序列載入的橫幅廣告會停止重新整理。
0.17.0-alpha02 2025-06-23
  • 修正原生中介服務出價錯誤：導入出價但未導入刊登序列的轉接程式 (例如 Meta Audience Network)，一律無法顯示原生廣告。
  • 修正中介服務轉接程式針對單一廣告請求叫用多個 MediationAdLoadCallback 方法時，會發生當機的問題。
0.17.0-alpha01 2025-06-18
  • 0.17.0-alpha01 版是意外發布的版本，不含預期的新功能。請改用 0.17.0-alpha02。
0.16.0-alpha01 2025-05-23
  • 您不必再啟用 Java 8+ API 脫糖支援。
  • 將 User Messaging Platform SDK 依附元件更新至 3.2.0 版。
  • 修正原生廣告中介服務錯誤，避免參照 com.google.android.gms.ads.formats.MediaView 類別的轉接程式發生當機。
  • 廣告預先載入：新增 getNumAdsAvailable()，並淘汰 numAdsAvailable()。
  • 從 SDK 的資訊清單檔案中移除 android.adservices.AD_SERVICES_CONFIG 屬性標記，避免 設定 API 專屬廣告服務的應用程式發生合併衝突。
0.15.1-alpha01 2025-04-28
  • 現在必須啟用 Java 8+ API 脫糖支援。
  • 如果是使用 Kotlin 開發的應用程式，最低 Kotlin 版本需求從 2.1 降至 1.9。
0.15.0-alpha01 2025-04-24
  • 原生廣告：新增載入多則原生廣告的支援。
    • 新增 NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback) 方法，可一次請求多則廣告。
    • 新增 NativeAdLoaderCallback.onAdLoadingCompleted() 回呼，在所有原生廣告載入完成時觸發。
    • 為支援 Kotlin 非同步載入，新增了會傳回 Flow<NativeAdLoadResult> 的 NativeAdLoader.load(NativeAdRequest, numberOfAds) 方法。
  • 將 kotlinx-coroutines-android 依附元件從 1.7.3 版更新至 1.9.0 版。
0.14.0-alpha01 2025-03-20
  • 如果使用無效的應用程式 ID 初始化 SDK，廣告請求就會失敗。
  • AdPreloader.start() 方法不再需要 PreloadCallback 回呼。
  • 透過 PreloadConfiguration 資料類別建立物件時，bufferSize 屬性為選用。如要讓 Google 最佳化緩衝區空間，請勿設定 bufferSize 屬性。
  • 已移除 PreloadConfiguration 資料類別中的 maxAdsPerSession 屬性。
  • 在 NativeAdOptions 類別中新增 shouldRequestMultipleImages 和 shouldReturnUrlsForImageAssets 屬性。
0.13.0-alpha01 2025-02-26
  • 新增 MediationRewardedAdCallback.onUserEarnedReward() 並淘汰 MediationRewardedAdCallback.onUserEarnedReward(RewardItem)。
  • 新增廣告預先載入 API。
0.12.0-alpha01 2025-01-22
  • 修正 AdRequest、AdRequest.Builder、SignalRequest 和 SignalRequest.Builder 內部分方法經過模糊處理的錯誤。
  • 針對沒有 Ad Manager 應用程式 ID 的 WebView API for Ads 使用者，新增了可在 SDK 初始化期間傳遞的 InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID。
  • 支援在 Ad Manager 廣告請求中結合原生廣告和橫幅廣告。
0.11.0-alpha01 2024-12-12
  • User Messaging Platform SDK 依附元件更新至 3.1.0 版。
  • 支援原生廣告的自訂點擊手勢。
  • 新增支援功能：手動計算 Ad Manager 預訂橫幅廣告的曝光次數。
0.10.0-alpha01 2024-11-08
  • 新增 VideoOptions 和 RequestConfiguration 的 DSL 函式，改善 Kotlin 支援功能。
  • 新增對 Publisher Privacy Treatment API 的支援，並搭配 RequestConfiguration.setPublisherPrivacyPersonalizationState()。
  • 新增 Kotlin 暫停 API，用於載入廣告及產生信號。
  • 移除 IconAd.LoadAdResult，並替換為 AdLoadResult。
  • 修正原生影片廣告無法啟動 OMID 工作階段的問題。
0.9.0-alpha01 2024-10-02
0.8.0-alpha01 2024-08-22
  • 更新 User Messaging Platform SDK 依附元件至 3.0.0 版。
  • 原生廣告：
    • 原生廣告格式的正式發布版本。
    • 新增在 MediaContent 素材資源中放送影片的支援。
    • 新增影片生命週期回呼。
    • 新增影片播放自訂控制項。
    • 為原生和自訂原生廣告啟用 Open Measurement。
  • 建構 SignalRequest 時，signalType 現在是必填欄位。
0.6.0-alpha01 2024-06-20
  • 新增程式碼， 可透過脫糖程序使用 Java 8+ API。如果應用程式使用的 minSdkVersion 低於 26，則必須啟用 Java 8+ API 脫糖支援。
  • 支援不含影片素材資源的原生和自訂原生廣告格式。
  • 新增 MRAID 第 3 版支援。
  • 新增 User Messaging Platform SDK 2.2.0 版的依附元件。
  • Google 錯誤的錯誤網域已從 com.google.android.gms.ads 更新為 com.google.android.libraries.ads.mobile.sdk。
  • 新增 MobileAds.isInitialized() 方法，用於檢查 SDK 是否已初始化。
  • 新增 BannerAd.isCollapsible()，用於檢查傳回的橫幅廣告是否可收合。
  • 新增 MobileAds.registerCustomTabsSession()，提升自訂分頁廣告的營利成效。
  • OnInitializationCompleteListener 已重新命名為 OnAdapterInitializationCompleteListener。
  • AdapterResponseInfo 已重新命名為 AdSourceResponseInfo。
  • AdRequest.Builder.putAdNetworkExtrasBundle() 已重新命名為 AdRequest.Builder.putAdSourceExtrasBundle()。
  • 修正錯誤：出價轉接程式類別未正確例項化。
0.3.0-alpha01 2024-03-20
  • GMA Next-Gen SDK 的初始版本。
  • 支援橫幅、插頁式、獎勵、插頁式獎勵廣告和應用程式開啟頁面廣告。
  • 支援所有廣告格式的中介服務。為目前 Mobile Ads SDK 編寫的轉接程式，與 GMA Next-Gen SDK 向前相容。
  • 新增 Open Measurement SDK 1.4.10 版的依附元件。