# TogetherAd

**Repository Path**: gaocang/TogetherAd

## Basic Information

- **Project Name**: TogetherAd
- **Description**: No description available
- **Primary Language**: Kotlin
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 13
- **Created**: 2020-06-03
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TogetherAd

TogetherAd 是全部由 Kotlin 编写的 Android 开源项目。( Java 编写的 Android 项目也可调用 )

能够帮助 Android 开发者``快速``、``便捷``、``灵活``的接入国内多家主流广告 SDK。

欢迎 **Star** 、**Fork**、**Issues**

> 新版本 3.x 已发布。
>  [2.x版本](https://github.com/ifmvo/TogetherAd/tree/2.x) 不再开发新功能，只会更新各个平台SDK版本，以及修复bug。

[点击下载 Demo APK 尝鲜](https://www.pgyer.com/4jeV) 或者扫描下面二维码下载

<img src="img/QR-code.png"  height="200" width="200">

## 特色功能

### 1. 主流SDK随意搭配组合

实际项目中，往往会接入多家广告SDK，以实现收益最大化的目的。

``TogetherAd``帮助开发者将其集成在一起，开发者可以任选组合进行搭配使用

### 2. 支持权重配置

因为各个平台分发广告的量以及价格都是不一样的，所以需要动态配置请求的比例。

例如：有三家广告平台 A、B、C，你认为 A 的单价和收入都是最高的，想要多展示一点。

那么可以配置他们的权重：A：B：C = 2：1：1

``TogetherAd`` 会根据配置的权重随机请求一家平台的广告，如果请求广告的总数是 40000 次。

那么每家平台请求的次数就会趋近于：A: 20000, B:10000, C:10000

### 3. 支持失败切换

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

## 使用方法

根据自身需求``任选``以下 1 至 3 个依赖，随意组合搭配

```
dependencies {

    //穿山甲（ 头条 ）
    implementation 'com.matthewchen.togetherad:csj:3.0.3-2.9.5.6'
    
    //优量汇（ 腾讯广点通 ）
    implementation 'com.matthewchen.togetherad:gdt:3.0.3-4.211.1081'
    
    //百青藤 ( 百度 Mob )
    implementation 'com.matthewchen.togetherad:baidu:3.0.3-5.83'
    
}
```

> 版本号的规则：TogetherAd版本-对应广告商的SDK版本号

[准备工作及初始化](doc/prepare.md)

[开屏广告](doc/splash.md)

[原生自渲染](doc/native.md)

[激励广告](doc/reward.md)

[Banner横幅广告](doc/banner.md)

## 更多

### 扩展

``TogetherAd``目前支持的广告平台有：穿山甲、广点通、百青藤。

如果你想接入其他广告平台，或者自己有API组装。可参考[这里进行自定义扩展](doc/extend.md)。

### 相关文档收集

[广点通接入文档](https://developers.adnet.qq.com/doc/android/access_doc)

[广点通错误码对照](https://developers.adnet.qq.com/backend/error_code.html)

[穿山甲文档](http://partner.toutiao.com/doc?id=5dd0fe756b181e00112e3ec5)

[百青藤v5.85接入文档](https://baidu-ssp.gz.bcebos.com/mssp/sdk/BaiduMobAds_MSSP_bd_SDK_android_v5.85.pdf)

>会尽量保持最新。如果发现有新版本也可联系我，我会及时更新，感激！！

### [更新日志](doc/update_log.md)

### 致谢

[PlayerBase](https://github.com/jiajunhui/PlayerBase)

### License

MIT

### 有疑问？欢迎 VX 联系我，也可加入 TogetherAd QQ 交流群

<img src="img/Wechat.jpeg"  height="200" width="200">
</br>
<img src="img/QQ.png"  height="265" width="200">