OpenMediation 迁移准备 - Android

Service

2021年02月03日 14:11

为 SDK v2.0.0 做准备

我们已经由 AdTiming Mediation SDK 迁移至完全开源的OpenMediation SDK，同时提供一些重大更改，并简单重命名一些 API 以及移除已弃用的 API。

您需要重新集成新的OpenMediation SDK以及集成广告网络所需的adapter。

1. 将集成聚合SDK的gradle脚本改为以下代码：

dependencies {
    implementation 'com.openmediation:om-android-sdk:2.0.2'
}

2. 参考Android SDK下载与集成文档的说明，修改Proguard、MultiDex的配置，按照新的初始化API完成SDK初始化相关的代码。

3. 参考广告单元激励视频、插屏广告、原生广告、横幅广告的集成文档，按照新的广告类和方法，修改广告加载、展示相关的代码。可参考本文后续内容中详细列出的SDK API重大变化。

4. 集成广告网络所需的adapter也需要更新，具体请参考集成广告网络部分，这里有集成广告网络所需的详细说明和脚本代码。

更新了初始化 API，支持传递域名、渠道、预加载广告类型等参数，初始化需要依靠 InitConfiguration 类。
移除了互动广告类型及相关 AdTimingInteractiveAd、InteractiveAdListener API。
新增交叉推广广告类型，增加相关 PromotionAd、PromotionAdListener、PromotionAdRect API。

下表列出了已更改或移除和新增的具体类名称。总结如下：

AdTiming Mediation 中的类	OpenMediation 中的类
com.adtiming.mediationsdk.	com.openmediation.sdk.
AdTimingAds	OmAds
InitCallback	InitCallback
banner.AdSize	banner.AdSize
banner.BannerAd	banner.BannerAd
banner.BannerAdListener	banner.BannerAdListener
interactive.AdTimingInteractiveAd	已移除
interactive.InteractiveAdListener	已移除
interstitial.AdTimingInterstitialAd	interstitial.InterstitialAd
interstitial.InterstitialAdListener	interstitial.InterstitialAdListener
nativead.AdIconView	nativead.AdIconView
nativead.AdInfo	nativead.AdInfo
nativead.MediaView	nativead.MediaView
nativead.NativeAd	nativead.NativeAd
nativead.NativeAdListener	nativead.NativeAdListener
nativead.NativeAdView	nativead.NativeAdView
utils.error.AdTimingError	utils.error.Error
utils.model.Scene	utils.model.Scene
video.AdTimingRewardedVideo	video.RewardedVideoAd
video.RewardedVideoListener	video.RewardedVideoListener
	InitConfiguration
	promotion.PromotionAd
	promotion.PromotionAdListener
	promotion.PromotionAdRect

下表列出了版本 2.0.0 中的具体更改。总结如下：

从 OmAds 类中移除了过时的初始化方法，增加了新的初始化方法。
新增交叉推广广告类型，增加相关 PromotionAd、PromotionAdListener、PromotionAdRect API。

类	AdTiming Mediation 中的 API	OpenMediation 中的 API	备注
OmAds	init(Activity, String, InitCallback,AD_TYPE...)	init(Activity, InitConfiguration, InitCallback)
InitConfiguration		new InitConfiguration.Builder() .initHost(String) .appKey(String) .logEnable(boolean) .preloadAdTypes(OmAds.AD_TYPE) .build();	请参阅 SDK 集成
PromotionAd		setAdListener(PromotionAdListener) isSceneCapped(String) getSceneInfo(String) loadAd() isReady() showAd(Activity, PromotionAdRect) showAd(Activity, PromotionAdRect, String) hideAd()	请参阅交叉推广
PromotionAdListener		onPromotionAdAvailabilityChanged(boolean) onPromotionAdShowed(Scene) onPromotionAdShowFailed(Scene, Error) onPromotionAdHidden(Scene) onPromotionAdClicked(Scene)
PromotionAdRect		setWidth(int) setHeight(int) setScaleX(float) setScaleY(float) setAngle(float)

AdTiming 现在是一个独立的 Network，您需要同时接入 AdTiming Network SDK 和 Adapter，具体请参考集成广告网络部分。