本页面介绍了当前版本和之前版本的迁移。
从 v22 迁移到 v23
最低 Android API 级别为 21
从版本 23.0.0 开始,Google 移动广告 SDK 要求所有应用都必须
Android API 级别 21 或更高级别才能运行。要调整 API 级别,请将
将应用级 build.gradle
文件中 minSdkVersion
的值设置为 21 或更高。
移除/替换的已弃用方法
v22.0.0 中的 API | v23.0.0 中的 API |
---|---|
AdRequest.Builder.addTestDevice() | RequestConfiguration.Builder.setTestDeviceIds() |
AdRequest.Builder.tagForChildDirectedTreatment() | RequestConfiguration.Builder.setTagForChildDirectedTreatment() |
AdRequest.Builder.setIsDesignedForFamilies() | RequestConfiguration.Builder.setMaxAdContentRating() |
AdFormat.UNKNOWN | 无替代项 |
AdLoader.Builder.forUnifiedNativeAd() | AdLoader.Builder.forNativeAd() |
AdLoader.Builder.forCustomTemplateAd() | AdLoader.Builder.forCustomFormatAd() |
AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.formats .NativeAdOptions)
|
AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.nativead .NativeAdOptions)
|
void MobileAds.setSameAppKeyEnabled() | boolean MobileAds.putPublisherFirstPartyIdEnabled() |
从 v21 迁移到 v22
使用 MobileAds.getVersion() 获取 Google 移动广告 SDK 版本
版本 22.0.0 中移除了 MobileAds.getVersionString()
方法,取而代之的是
/
MobileAds.getVersion()
。
新方法会返回预期的外部版本号,例如,
22.0.0
。有关此变化的更多信息,请参见使用新的 Google 移动
广告 SDK getVersion()
方法。
已移除或替换的方法
下表列出了版本 22.0.0 中的具体更改。
v21.0.0 | v22.0.0 |
---|---|
MobileAds.getVersionString() | MobileAds.getVersion() |
NativeCustomFormatAd.getVideoMediaView() | NativeCustomFormatAd.getMediaContent() |
NativeCustomFormatAd.getVideoController() | NativeCustomFormatAd.getMediaContent().getVideoController() |
AdRequest.Builder.setAdInfo() | AdRequest.Builder.setAdString() |
MediationRewardedVideoAdAdapter | 适配器 |
MediationRewardedVideoAdListener | |
com.google.android.gms.ads.mediation.VersionInfo | com.google.android.gms.ads.VersionInfo |
com.google.android.gms.ads.doubleclick.AppEventListener | com.google.android.gms.ads.admanager.AppEventListener |
从 v20 迁移到 v21
将 minSdkVersion 更新为 19 或更高版本
从版本 21.0.0 开始,Google 移动广告 SDK 要求所有应用都必须
在 Android API 级别 19 或更高级别上运行。要调整 API 级别,请将
minSdkVersion
值设置为 19 或更高版本。
强制执行严格的可为 null 性
为准备强制执行严格的可为 null 性,@NonNull
注解
添加了之前未明确定义可为 null 性的所有 API。
此变更可能会破坏 Kotlin 应用和使用 Java null 检查的应用
框架(如果存在 null 安全违规行为且之前未处理过)
安全地使用 null
值(请参阅 Kotlin 文档,了解
null 安全
)。
移除了 addNetworkExtras() 方法
addNetworkExtras()
方法,用于将额外参数作为
SDK 中已废弃针对特定广告联盟适配器的 NetworkExtras
实例
并且将在版本 21.0.0 中移除。使用
addNetworkExtrasBundle()
方法。AdRequest.Builder
移除了地理位置方法
以下地理位置方法将在版本 21.0.0 中移除:
AdRequest.Builder
类中的setLocation(Location location)
方法 用于为中介定位设置用户所在的地理位置。AdRequest
类中的getLocation()
方法,该方法会返回用户的 地理位置定位信息之前传递给setLocation(Location location)
方法。MediationAdConfiguration
类中的getLocation()
方法, 如果由AdRequest
定义,则返回用户所在位置。
Google 不会使用位置数据来定位广告。您应该使用 第三方 API 在发生以下情况时向第三方广告联盟提供信息: 必填字段。
弃用自定义事件接口
借助自定义事件,发布商可以 AdMob 中介 来设置不 AdMob的其中一个 支持的广告来源。
所有自定义
事件
弃用了这些界面,取而代之的是
Adapter
类和
MediationAdLoadCallback
界面。
下表列出了应使用的相应类或接口 针对从版本 21.0.0 开始的每个自定义事件接口:
从 v19 迁移到 v20
我们在版本 20.0.0 中进行了多项重大更改。19.7.0 版推出 许多新的 API,并废弃或重命名了许多类,以便为版本做好准备 20.0.0.本指南重点介绍了版本 20.0.0 中的主要更改。
全屏广告格式 API 更新
从版本 20.0.0 开始,插页式广告、激励广告、插页式激励广告和 开屏广告格式已经过标准化处理,以遵循一致的 API 设计。
所有全屏广告格式 API 均遵循以下原则:
- 静态加载方法
- 类似的加载回调或处理程序机制
- 依赖于
FullScreenContentCallback
用于展示回调的类
移除旧版 RewardedVideoAd API
较新的
RewardedAd
API 于 2019 年 3 月首次推出,已成为
API 使用超过 18 个月。与旧版相比,新版 SDK 具备更多增强功能
RewardedVideoAd
API,包括能够加载多个激励广告
。
SDK 版本 20.0.0 中移除了旧版 RewardedVideoAd
API。
弃用智能横幅广告,取而代之的是自适应横幅广告
智能横幅广告已被弃用 弃用自适应横幅广告 广告。自适应横幅广告可提供卓越的效果和更大的灵活性, 设置广告宽度。如果您希望继续使用全宽横幅广告 仍使用自适应横幅广告,如以下代码段所示:
Java
public class MyActivity extends AppCompatActivity { ... private AdSize getFullWidthAdaptiveSize() { Display display = getWindowManager().getDefaultDisplay(); DisplayMetrics outMetrics = new DisplayMetrics(); display.getMetrics(outMetrics); float widthPixels = outMetrics.widthPixels; float density = outMetrics.density; int adWidth = (int) (widthPixels / density); return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth); } }
Kotlin
class MyActivity : AppCompatActivity() { ... private val adaptiveAdSize: AdSize get() { val display = windowManager.defaultDisplay val outMetrics = DisplayMetrics() display.getMetrics(outMetrics) val density = outMetrics.density var adWidthPixels = ad_view_container.width.toFloat() if (adWidthPixels == 0f) { adWidthPixels = outMetrics.widthPixels.toFloat() } val adWidth = (adWidthPixels / density).toInt() return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth) } }
移除退出应用回调
已移除适用于所有广告格式的 onAdLeftApplication
回调函数
/
ProcessLifecycleOwner
。
如果使用操作系统级 API,无论用户何时离开您的应用,无论他们
是否属于广告互动
请注意,onAdLeftApplication
回调本应不是广告
并且依靠此回调来报告点击次数不会产生
准确的指标例如,点击“广告选项”图标会启动
外部浏览器调用了回调函数,但未计为一次点击。
重命名类
下表列出了已更改或移除的具体类名称。步骤简述:
- 与
UnifiedNativeAd
相关的大多数类均已重命名为NativeAd
。 MobileAds.Settings
、NativeExpressAdView
、NativeAppInstallAd
移除了NativeContentAd
以及InstreamAd
类和视图。- 所有带
Publisher
前缀的类均已替换为AdManager
前缀。 InterstitialAd
软件包名称已更改。
19.5.0 中的类 | 20.0.0 中的类 |
---|---|
com.google.android.gms.ads. | com.google.android.gms.ads. |
reward.RewardedVideoAd | rewarded.RewardedAd |
reward.RewardedVideoAdListener | 激励广告.RewardedAdLoadCallback 和 FullScreenContentCallback |
reward.RewardItem | rewarded.RewardItem |
rewarded.RewardedAdCallback | OnUserEarnedRewardListener |
formats.UnifiedNativeAdView | nativead.NativeAdView |
formats.UnifiedNativeAd | nativead.NativeAd |
formats.UnifiedNativeAdAssetNames | nativead.NativeAdAssetNames |
formats.UnifiedNativeAd.OnUnifiedNativeAdLoadedListener | nativead.NativeAd.OnNativeAdLoadedListener |
formats.AdChoicesView | nativead.AdChoicesView |
formats.NativeAd.AdChoicesInfo | nativead.NativeAd.AdChoicesInfo |
formats.MediaView | nativead.MediaView |
formats.NativeAdViewHolder | nativead.NativeAdViewHolder |
formats.NativeAdOptions | nativead.NativeAdOptions |
formats.NativeCustomTemplateAd | nativead.NativeCustomFormatAd |
formats.NativeCustomTemplateAd |
nativead.NativeCustomFormatAd |
MobileAds.Settings | 已移除 |
doubleclick.PublisherAdRequest | admanager.AdManagerAdRequest |
doubleclick.PublisherAdView | admanager.AdManagerAdView |
formats.PublisherAdViewOptions | formats.AdManagerAdViewOptions |
doubleclick.PublisherInterstitialAd | admanager.AdManagerInterstitialAd |
InterstitialAd | interstitial.InterstitialAd |
NativeExpressAdView | 已移除 |
instream.InstreamAd | 已移除 |
mediation.admob.AdMobExtras | 已移除 |
Correlator | 已移除 |
search.SearchAdRequest | 已移除 |
AdRequest.TagForUnderAgeOfConsent 接口 | 已移除 |
AdRequest.MaxAdContentRating 接口 | 已移除 |
formats.NativeAppInstallAd | native.NativeAd |
formats.NativeAppInstallAdView | native.NativeAdView |
mediation.NativeAppInstallAdMapper | mediation.UnifiedNativeAdMapper |
formats.NativeContentAd | native.NativeAd |
formats.NativeContentAdView | native.NativeAdView |
mediation.NativeContentAdMapper | mediation.UnifiedNativeAdMapper |
移除/替换的方法
下表列出了版本 20.0.0 中的具体更改。总结:
- 从 MobileAds 类中移除了过时的初始化方法。
- 已移除
AdRequest.Builder()
类中的某些方法 或移到了RequestConfiguration
类。 - 更新了 RewardedAd 和 InterstitialAd API,以与 全屏格式。
- 移除了 Correlator 功能。
类 | v19.5.0 中的 API | v20.0.0 中的 API | 备注 |
---|---|---|---|
AdSize | getPortraitBanner |
getPortraitAnchored |
|
getLandscapeBanner |
getLandscapeAnchored |
||
getCurrentOrientation |
getCurrentOrientationAnchored |
||
MobileAds | initialize(Context, String) | MobileAds.initialize(Context, OnInitializationComplete |
现在,在 AndroidManifest.xml 中设置应用 ID。 |
initialize(Context, String, MobileAds.Settings) | initialize(Context, OnInitializationComplete |
Settings 类已弃用。 | |
getRewardedVideo |
已移除 | 请改用 RewardedAd API。 | |
AdListener | onAdFailedToLoad(int) | onAd |
|
onAdLeftApplication() | 已移除 | 全屏广告格式使用 FullscreenContentCallback 代替 AdListener,并且 FullscreenContentCallback 上没有等效方法。通过 方法已从 AdListener 删除。 | |
VideoController | getAspectRatio() | MediaContent.getAspectRatio() | |
AdRequest | getGender() | 已移除 | |
getBirthday() | 已移除 | ||
getNetworkExtras() | 已移除 | ||
setManualImpressions |
已移除 | ||
updateCorrelator() | 已移除 | 请参阅 广告内容过滤。 | |
AdRequest.Builder | setBirthday() | 已移除 | |
setGender() | 已移除 | ||
setIsDesignedForFamilies() | 已移除 | 请参阅指南。 | |
addTestDevice() | RequestConfiguration |
请参阅启用测试广告。 | |
tagForChildDirectedTreatment() | RequestConfiguration |
请参阅 广告内容过滤。 | |
setTagFor |
RequestConfiguration |
||
setMaxAdContentRating() | RequestConfiguration |
||
AdView | getMediationAdapter |
ResponseInfo |
现在可通过 AdView 方法 getResponseInfo() 获取 ResponseInfo 对象。 |
NativeAdOptions | setImageOrientation() | setMediaAspectRatio() | |
getImageOrientation | getMediaAspectRatio() | ||
RewardedAd | loadAd(AdRequest, RewardedAdLoadCallback) | RewardedAd.load(Context, String, AdRequest, RewardedAdLoadCallback) | 现在,RewardedAd 与其他广告使用相同的静态加载方法 全屏格式。 |
loadAd(PublisherAdRequest, RewardedAdLoadCallback) | RewardedAd.load(Context, String, AdManagerAdRequest, RewardedAdLoadCallback) | ||
isLoaded() | 已移除 | 静态加载方法中的回调会提供已加载的广告。 | |
show(Activity, RewardedAdCallback) | show(Activity, OnUserGainedRewardListener) | 此 show 方法遵循更广泛的全屏广告格式方法。 | |
RewardedAdLoadCallback | onRewardedAd |
onAd |
|
onRewardedAd |
onAd |
||
onRewardedAdLoaded() | onAdLoaded(RewardedAd) | ||
AppOpenAdLoadCallback | onAppOpenAd |
onAd |
|
onAppOpenAd |
onAd |
||
onAppOpenAd |
onAdLoaded(AppOpenAd) | ||
RewardedInterstitialAdLoad |
onRewardedInterstitialAd |
onAd |
|
onRewardedInterstitialAd |
onAd |
||
onRewardedInterstitialAd |
onAd |
||
InterstitialAd | new InterstitialAd() | InterstitialAd.load(Context, String, AdRequest, InterstitialAdLoadCallback) | InterstitialAd 现在使用与 其他全屏广告格式。 |
setAdListener() | |||
DynamicHeightSearchAd |
getNetworkExtras() | 已移除 | NetworkExtras 类已废弃。 |
AdLoader | forContentAd() | 已移除 | |
forAppInstallAd() | 已移除 | ||
withCorrelator() | 已移除 | ||
getMediationAdapter |
已移除 |