TogetherAd 封裝了多種廣告的 SDK,能夠自行控制請求各類廣告次數的比例,git
百度Mob、騰訊GDT、科大訊飛github
多種平臺隨機展現bash
由於各個平臺分發廣告的量實際上有可能不夠用,因此多種廣告根據必定比例隨機展現會使收益最大化app
控制個平臺廣告的展現比例dom
由於各個平臺分發廣告的量是不同的,好比廣點通分配1000次,百度只有100次,那麼展現廣點通和百度廣告的次數必然是10:1才能使收益最大化maven
廣告失敗切換ide
若是某個平臺的廣告請求失敗或沒有量,會自動在其餘廣告中隨機出一種再次請求,這樣能夠儘量多的展現廣告,使收益最大化gradle
第一種: Gradle 集成 項目根目錄下 build.gradle 中ui
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}
複製代碼
Module 目錄下 build.gradle 中this
dependencies {
implementation 'com.github.ifmvo:TogetherAd:lastest_version'
}
複製代碼
第二種: 本地導入 aar 集成 點擊下載 TogetherAd-1.1.4.aar 文件後,放入 Module 目錄下的 libs 文件夾中 Module 目錄下 build.gradle 中
dependencies {
implementation(name: 'TogetherAd-1.1.4', ext: 'aar')
}
複製代碼
public class TogetherAdConst {
//開屏
public static final String AD_SPLASH = "ad_splash";
//插屏
public static final String AD_TIEPIAN_LIVE = "ad_flow_tiepian_live";
//首頁信息流
public static final String AD_FLOW_INDEX = "ad_flow_index";
//直播播放器前貼
public static final String AD_INTER = "ad_inter";
......
}
複製代碼
自定義的廣告位用於初始化廣告位ID,也被當作請求廣告時的參數
//初始化百度Mob廣告
Map<String, String> baiduIdMap = new HashMap<>();
baiduIdMap.put(TogetherAdConst.AD_SPLASH, "相應的廣告位ID");
baiduIdMap.put(TogetherAdConst.AD_INTER, "xxxxxx");
baiduIdMap.put(TogetherAdConst.AD_FLOW_INDEX, "xxxxxx");
baiduIdMap.put(TogetherAdConst.AD_VIDEO_PRE, "xxxxxx");
TogetherAd.INSTANCE.initBaiduAd(getApplicationContext(), "你的Baidu_MobAds的APPID", baiduIdMap);
//初始化騰訊廣點通廣告
Map<String, String> gdtIdMap = new HashMap<>();
gdtIdMap.put(TogetherAdConst.AD_SPLASH, "相應的廣告位ID");
gdtIdMap.put(TogetherAdConst.AD_INTER, "xxxxxxxxxxxx");
gdtIdMap.put(TogetherAdConst.AD_FLOW_INDEX, "xxxxxxxxxxxx");
gdtIdMap.put(TogetherAdConst.AD_VIDEO_PRE, "xxxxxxxxxxxx");
TogetherAd.INSTANCE.initGDTAd(getApplicationContext(), "你的GDT的APPID", gdtIdMap);
//初始化科大訊飛廣告
Map<String, String> iFlyIdMap = new HashMap<>();
iFlyIdMap.put(TogetherAdConst.AD_SPLASH, "相應的廣告位ID");
iFlyIdMap.put(TogetherAdConst.AD_INTER, "xxxxxxxxxxxx");
iFlyIdMap.put(TogetherAdConst.AD_FLOW_INDEX, "xxxxxxxxxxxx");
iFlyIdMap.put(TogetherAdConst.AD_VIDEO_PRE, "xxxxxxxxxxxx");
TogetherAd.INSTANCE.initXunFeiAd(getApplicationContext(), iFlyIdMap);
複製代碼
/**
* mContext 上下文
* splashConfigStr: 各平臺的展現比例,會根據這個比例隨機請求某個平臺的廣告,比例越大展現的機率就越大
* 例如: "baidu:1,gdt:1,xunfei:1" (baidu、gdt、xunfei 等key區分大小寫)
* adConstStr: 廣告位 例如:TogetherAdConst.AD_SPLASH
* adsParentLayout: 展現開屏廣告的容器 ( 廣告平臺要求:容器大小不低於屏幕的75% )
* adListener: 監聽器廣告狀態回調
*/
TogetherAdSplash.INSTANCE.showAdFull(mContext, splashConfigStr, adConstStr, adsParentLayout, new TogetherAdSplash.AdListenerSplashFull() {
@Override
public void onStartRequest(@NotNull String s) {
//開始請求廣告以前,channel:gdt、baidu、xunfei
}
@Override
public void onAdClick(@NotNull String s) {
//廣告被點擊以後,channel:gdt、baidu、xunfei
}
@Override
public void onAdFailed(@Nullable String s) {
//廣告加載失敗
}
@Override
public void onAdDismissed() {
//廣告倒計時結束
}
@Override
public void onAdPrepared(@NotNull String s) {
//廣告請求成功,準備展現,channel:gdt、baidu、xunfei
}
});
複製代碼
/**
* 信息流廣告會隨機返回其中一種平臺的廣告集合,通常用於列表中廣告的展現
* mContext 上下文
* listConfigStr: 各平臺的展現比例,會根據這個比例隨機請求某個平臺的廣告,比例越大展現的機率就越大
* 例如: "baidu:1,gdt:1,xunfei:1" (baidu、gdt、xunfei 等key區分大小寫)
* adConstStr: 廣告位 例如:TogetherAdConst.AD_FLOW_INDEX
* adListener: 監聽器廣告狀態回調
*/
TogetherAdFlow.INSTANCE.getAdList(mContext, "baidu:1,gdt:1,xunfei:1", adConstStr, new TogetherAdFlow.AdListenerList() {
@Override
public void onAdFailed(@Nullable String s) {
//廣告加載失敗
}
@Override
public void onAdLoaded(@NotNull String s, @NotNull List<?> list) {
//廣告請求成功,準備展現
//channel:gdt、baidu、xunfei
//adList:某個平臺的廣告List,list裏面的object:NativeMediaADData 是廣點通,NativeResponse 是百度,NativeADDataRef 是科大訊飛
//能夠經過多類型列表進行展現,詳細可借鑑 Demo 中的 IndexFragment
}
@Override
public void onStartRequest(@NotNull String s) {
//開始請求廣告以前,channel:gdt、baidu、xunfei
}
// onClick 點擊事件須要自行根據各平臺的文檔處理
});
複製代碼
TogetherAdPreMovie.INSTANCE.showAdPreMovie(this, "baidu:1,gdt:1,xunfei:1", TogetherAdConst.AD_TIEPIAN_LIVE, adsParentLayout, new TogetherAdPreMovie.AdListenerPreMovie() {
@Override
public void onAdClick(@NotNull String s) {
//廣告被點擊以後,channel:gdt、baidu、xunfei
}
@Override
public void onAdFailed(@Nullable String s) {
//廣告加載失敗
}
@Override
public void onAdDismissed() {
//廣告倒計時結束
}
@Override
public void onAdPrepared(@NotNull String s) {
//廣告請求成功,準備展現,channel:gdt、baidu、xunfei
}
@Override
public void onStartRequest(@NotNull String s) {
//開始請求廣告以前,channel:gdt、baidu、xunfei
}
});
複製代碼
TogetherAdInter.INSTANCE.showAdInter(this, Config.interAdConfig(), TogetherAdConst.AD_INTER, false, mRlInterAd, new TogetherAdInter.AdListenerInter() {
@Override
public void onStartRequest(@NotNull String s) {
//開始請求廣告以前,channel:gdt、baidu、xunfei
}
@Override
public void onAdClick(@NotNull String s) {
//廣告被點擊以後,channel:gdt、baidu、xunfei
}
@Override
public void onAdFailed(@Nullable String s) {
//廣告加載失敗
}
@Override
public void onAdDismissed() {
//廣告倒計時結束
}
@Override
public void onAdPrepared(@NotNull String s) {
//廣告請求成功,準備展現,channel:gdt、baidu、xunfei
}
});
複製代碼
class TogetherAdConst {
companion object {
//開屏
const val AD_SPLASH = "ad_splash"
//插屏
const val AD_INTER = "ad_inter"
//首頁信息流
const val AD_FLOW_INDEX = "ad_flow_index"
//視頻播放前貼
const val AD_VIDEO_PRE = "ad_video_pre"
//xxxxxxxx
const val XXX_XXX_XXX = "xxx_xxx_xxx"
......
}
}
複製代碼
自定義的廣告位用於初始化廣告位ID,也被當作請求廣告時的參數
//初始化百度Mob廣告
val baiduIdMap = mutableMapOf<String, String?>(
TogetherAdConst.AD_SPLASH to "2543740",
TogetherAdConst.AD_INTER to "2543741",
TogetherAdConst.AD_FLOW_INDEX to "2715031",
TogetherAdConst.AD_TIEPIAN_LIVE to "5985131"
)
TogetherAd.initBaiduAd(applicationContext, "ee93e58e", baiduIdMap)
//初始化騰訊廣點通廣告
val gdtIdMap = mutableMapOf<String, String?>(
TogetherAdConst.AD_SPLASH to "8030228893573270",
TogetherAdConst.AD_INTER to "4090620883979242",
TogetherAdConst.AD_FLOW_INDEX to "4010231735332811",
TogetherAdConst.AD_TIEPIAN_LIVE to "4060449650093530"
)
TogetherAd.initGDTAd(applicationContext, "1106572734", gdtIdMap)
//初始化科大訊飛廣告
val xunFeiIdMap = mutableMapOf<String, String?>(
TogetherAdConst.AD_SPLASH to "FD0AC8FDE5CE0B317A6C4077E68D34CC",
TogetherAdConst.AD_INTER to "6FD44C667D5EFD97730CC1E3F174D965",
TogetherAdConst.AD_FLOW_INDEX to "EE2009111A1DF0BCA9DAD3723A95602F",
TogetherAdConst.AD_TIEPIAN_LIVE to "93D157AAFA8B7EF64165B1F0ECEE2623"
)
TogetherAd.initXunFeiAd(applicationContext, xunFeiIdMap)
複製代碼
/**
* mContext 上下文
* splashConfigStr: 各平臺的展現比例,會根據這個比例隨機請求某個平臺的廣告,比例越大展現的機率就越大
* 例如: "baidu:1,gdt:1,xunfei:1" (baidu、gdt、xunfei 等key區分大小寫)
* adConstStr: 廣告位 例如:TogetherAdConst.AD_SPLASH
* adsParentLayout: 展現開屏廣告的容器 ( 廣告平臺要求:容器大小不低於屏幕的75% )
* adListener: 監聽器廣告狀態回調
*/
TogetherAdSplash.showAdFull(mContext, splashConfigStr, adConstStr, adsParentLayout, object : TogetherAdSplash.AdListenerSplashFull {
override fun onStartRequest(channel: String) {
//開始請求廣告以前,channel:gdt、baidu、xunfei
}
override fun onAdClick(channel: String) {
//廣告被點擊以後,channel:gdt、baidu、xunfei
}
override fun onAdFailed(failedMsg: String?) {
//廣告加載失敗
}
override fun onAdDismissed() {
//廣告倒計時結束
}
override fun onAdPrepared(channel: String) {
//廣告請求成功,準備展現,channel:gdt、baidu、xunfei
}
})
複製代碼
/**
* 信息流廣告會隨機返回其中一種平臺的廣告集合,通常用於列表中廣告的展現
* mContext 上下文
* listConfigStr: 各平臺的展現比例,會根據這個比例隨機請求某個平臺的廣告,比例越大展現的機率就越大
* 例如: "baidu:1,gdt:1,xunfei:1" (baidu、gdt、xunfei 等key區分大小寫)
* adConstStr: 廣告位 例如:TogetherAdConst.AD_FLOW_INDEX
* adListener: 監聽器廣告狀態回調
*/
TogetherAdFlow.getAdList(mContext, "baidu:1,gdt:1,xunfei:1", adConstStr, object : TogetherAdFlow.AdListenerList {
override fun onAdFailed(failedMsg: String?) {
//廣告加載失敗
}
override fun onAdLoaded(channel: String, adList: List<*>) {
//廣告請求成功,準備展現
//channel:gdt、baidu、xunfei
//adList:某個平臺的廣告List,list裏面的object:NativeMediaADData 是廣點通,NativeResponse 是百度,NativeADDataRef 是科大訊飛
//能夠經過多類型列表進行展現,詳細可借鑑 Demo 中的 IndexFragment
}
override fun onStartRequest(channel: String) {
//開始請求廣告以前,channel:gdt、baidu、xunfei
}
// onClick 點擊事件須要自行根據各平臺的文檔處理
})
複製代碼
TogetherAdPreMovie.showAdPreMovie(this, "baidu:1,gdt:1,xunfei:1", TogetherAdConst.AD_TIEPIAN_LIVE, adsParentLayout, object : TogetherAdPreMovie.AdListenerPreMovie {
override fun onAdClick(channel: String) {
//廣告被點擊以後,channel:gdt、baidu、xunfei
}
override fun onAdFailed(failedMsg: String?) {
//廣告加載失敗
}
override fun onAdDismissed() {
//廣告倒計時結束
}
override fun onAdPrepared(channel: String) {
//廣告請求成功,準備展現,channel:gdt、baidu、xunfei
}
override fun onStartRequest(channel: String) {
//開始請求廣告以前,channel:gdt、baidu、xunfei
}
})
複製代碼
TogetherAdInter.showAdInter(this, Config.interAdConfig(), TogetherAdConst.AD_INTER, false, mRlInterAd, object : TogetherAdInter.AdListenerInter {
override fun onStartRequest(channel: String) {
//開始請求廣告以前,channel:gdt、baidu、xunfei
}
override fun onAdClick(channel: String) {
//廣告被點擊以後,channel:gdt、baidu、xunfei
}
override fun onAdFailed(failedMsg: String?) {
//廣告加載失敗
}
override fun onAdDismissed() {
//廣告倒計時結束
}
override fun onAdPrepared(channel: String) {
//廣告請求成功,準備展現,channel:gdt、baidu、xunfei
}
})
複製代碼
假若有 BAIDU,GDT,ADVIEW 這三種廣告,實際的配置字符串應該是這樣的:"baidu:3,gdt:3,adview:4"
隨機廣告配置必須符合這樣的格式
"xxx:m,yyy:n,zzz:i"
AdRandomUtil 這個類只會識別特定的 key ( 例:baidu、gdt、adview )
"baidu:2,gdt:8" <==> "baidu:2,gdt:8,abc:3" ( abc 會被忽略 )
key 區分大小寫
"BAIDU:2,GDT:8" ≠ "baidu:2,gdt:8"
"Baidu:2,Gdt:8" ≠ "baidu:2,gdt:8"
假若有 BAIDU,GDT,ADVIEW 這三種廣告 ( 實際的配置字符串:"baidu:3,gdt:3,adview:4" )
第一次隨機到了 GDT,若是 GDT 請求失敗,將 GDT 的 key 使用一個通用的字符串替換,再從其餘的廣告中再隨機
此時的配置字符串:"baidu:3,HIDE:3,adview:4"
第二次隨機到了 BAIDU,若是 BAIDU 也請求失敗了,將 BAIDU 的 key 使用一個通用的字符串替換,再從其餘的廣告中再隨機
此時的配置字符串:"HIDE:3,HIDE:3,adview:4"
......
直到請求某個廣告成功後中止
若是全部的廣告所有失敗,此時的配置字符串:"HIDE:3,HIDE:3,HIDE:4"
能夠到 TogetherAd 的 Github 提交Issues ,或添加 TogetherAd 交流羣 : 688291767