Android 第三方广告聚合框架:自己开发的APP怎样收益?

TogetherAd

TogetherAd 封装了多种广告的 SDK,可以自行控制请求各种广告次数的比例,

目前支持的广告

百度Mob、腾讯GDT、科大讯飞

功能介绍

多种平台随机展示

因为各个平台分发广告的量实际上有可能不够用,所以多种广告根据一定比例随机展示会使收益最大化

控制个平台广告的展示比例

因为各个平台分发广告的量是不一样的,比如广点通分配1000次,百度只有100次,那么展示广点通和百度广告的次数必然是10:1才能使收益最大化

广告失败切换

如果某个平台的广告请求失败或没有量,会自动在其他广告中随机出一种再次请求,这样可以尽可能多的展示广告,使收益最大化

效果图

集成方法

第一种: Gradle 集成 项目根目录下 build.gradle 中

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}
复制代码

Module 目录下 build.gradle 中

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')
}
复制代码

使用方法

Java 调用姿势
  1. 自定义广告位 新建一个名字叫做 TogetherAdConst 的类,这个类用来定义所有广告的位置,例:开屏广告、列表信息流 ... 等等
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,也被当做请求广告时的参数

  1. 初始化
//初始化百度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);
复制代码
  1. 开屏广告的调用姿势
/**
 * 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
    }
});
复制代码
  1. 信息流广告的调用姿势
/**
 * 信息流广告会随机返回其中一种平台的广告集合,一般用于列表中广告的展示
 * 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 点击事件需要自行根据各平台的文档处理
});
复制代码
  1. 前贴广告的调用姿势
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
    }
});
复制代码
  1. 插屏广告调用姿势
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
    }
});
复制代码
Kotlin 调用姿势
  1. 自定义广告位 新建一个名字叫做 TogetherAdConst 的类,这个类用来定义所有广告的位置,例:开屏广告、列表信息流 ... 等等
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,也被当做请求广告时的参数

  1. 初始化
//初始化百度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)
复制代码
  1. 开屏广告的调用姿势
/**
 * 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
    }
})
复制代码
  1. 信息流广告的调用姿势
/**
 * 信息流广告会随机返回其中一种平台的广告集合,一般用于列表中广告的展示
 * 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 点击事件需要自行根据各平台的文档处理
})

复制代码
  1. 前贴广告的调用姿势
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
    }
})
复制代码
  1. 插屏广告调用姿势
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"

  1. 随机广告配置必须符合这样的格式
    "xxx:m,yyy:n,zzz:i"

  2. AdRandomUtil 这个类只会识别特定的 key ( 例:baidu、gdt、adview )
    "baidu:2,gdt:8" <==> "baidu:2,gdt:8,abc:3" ( abc 会被忽略 )

  3. 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 有疑问?

可以到 TogetherAd 的 Github 提交Issues ,或添加 TogetherAd 交流群 : 688291767

转载于:https://juejin.im/post/5c85e7b05188257fdd0bd634

  • 0
    点赞
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值