TogetherAd: A Kotlin repository from huangdehui2013

TogetherAd 封装了多种广告的 SDK，可以自行控制请求各种广告次数的比例，TogetherAd Pro 版本对广告位方面进行优化，可以实现自定义广告位

目前支持的广告

百度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:lastVersion'
}

使用方法

Java
Kotlin

关于 Log

如果你看不到广告或者广告展示异常，你可以在 Logcat 中过滤 TogetherAd 你就会看到类似下面这样的日志：

2019-03-12 14:18:40.238 8724-8724/xxx D/TogetherAd: AdRandomUtil: 广告的配置：baidu:0,gdt:9,xunfei:1
2019-03-12 14:18:40.239 8724-8724/xxx D/TogetherAd: AdRandomUtil: 随机到的广告: gdt
2019-03-12 14:18:40.909 8724-8724/xxx D/TogetherAd: TogetherAdSplash: gdt: 准备好了
2019-03-12 14:18:45.970 8724-8724/xxx D/TogetherAd: TogetherAdSplash: gdt: 曝光成功了
2019-03-12 14:18:45.972 8724-8724/xxx D/TogetherAd: TogetherAdSplash: gdt: 消失了

随机广告配置的规则

假如有 BAIDU，GDT，CSJ 这三种广告，实际的配置字符串应该是这样的："baidu:3,gdt:3,csj: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，CSJ 这三种广告（实际的配置字符串："baidu:3,gdt:3,csj:4" ）

第一次随机到了 GDT，如果 GDT 请求失败，将 GDT 的 key 使用一个通用的字符串替换，再从其他的广告中再随机
此时的配置字符串："baidu:3,HIDE:3,csj:4"

第二次随机到了 BAIDU，如果 BAIDU 也请求失败了，将 BAIDU 的 key 使用一个通用的字符串替换，再从其他的广告中再随机
此时的配置字符串："HIDE:3,HIDE:3,csj:4"
......
直到请求某个广告成功后停止
如果所有的广告全部失败，此时的配置字符串："HIDE:3,HIDE:3,HIDE:4"

计划功能

目前虽然可以满足公司现有项目的需求，但是还有很多方面还需要改善和优化，例：

提供自定义前贴广告的布局功能
可选择性添加广点通、百度、穿山甲的广告

接下来一一实现

特殊处理

前贴其实就是使用信息流+倒计时进行处理
广点通和穿山甲的插屏广告也是使用信息流 + 关闭按钮的方式伪装出来的

huangdehui2013/TogetherAd