Git Product home page Git Product logo

bayescom / easyads-android Goto Github PK

View Code? Open in Web Editor NEW
168.0 7.0 37.0 67.25 MB

🔥持续更新🔥EasyAds,全球热门的开源聚合SDK广告软件。帮助App开发者便捷接入国内多家主流广告 SDK包括:字节穿山甲、腾讯优量汇、百度百青藤、快手联盟。几行代码就可以快速实现开屏、Banner横幅、插屏、激励视频、原生信息流、全屏等广告形式。

Home Page: http://easyads.bayescom.cn

License: GNU General Public License v2.0

Java 100.00%
android ad gdt csj baidu ks easyads androidad gromore topon

easyads-android's Introduction

EasyAds-Android 快速指引

1. 支持的SDK平台及广告位

SDK平台 开屏 激励视频 横幅 插屏(弹窗) 模板信息流 全屏视频 draw信息流
穿山甲
优量汇
百青藤
快手

2. 快速接入

下面介绍EasyAds的快速接入方法,开发中也可以参考Example下的示例工程,快速了解。

2.1 引入SDK

方式一(推荐): 使用Gradle 添加依赖,在项目根目录的build.gradle 文件中添加 JitPack 仓库

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

在项目module目录下的build.gradle 文件中添加SDK内容依赖

    dependencies {
        //EasyAds sdk(必须)
        implementation "com.github.bayescom:EasyAds-Android:1.2.1"

        //穿山甲广告SDK(建议)
        implementation "com.pangle.cn:mediation-sdk:6.1.2.5"
        //优量汇广告SDK(建议)
        implementation "com.qq.e.union:union:4.575.1445"
        //百度广告SDK(可选)
        implementation(name: "Baidu_MobAds_SDK_9352", ext: "aar")
//        //快手广告SDK(可选)
        implementation(name: "kssdk-ad-3363", ext: "aar")
    }

方式二

EasyAds项目以Library的形式导入APP项目工程。

2.2 SDK分发策略配置

配置SDK的分发策略,可方便的实现流量的切分操作,实现多SDK的混合执行策略。

在EasyAds中,我们通过JSON文件的方式配置SDK的分发策略,开发者可根据自身流量分发的需求,按照EasyAds中提供的JSON配置格式及方法设置流量分发策略。

以开屏广告对接穿山甲和优量汇两个SDK为例,配置选择80%流量穿山甲->优量汇的顺序请求,20%流量优量汇->穿山甲的顺序请求,配置如下所示。

其中,suppliers字段下配置媒体在穿山甲和优量汇平台申请的广告代码位信息,rules字段下配置流量分发策略及比例;

策略JSON的配置说明详细见:SDK策略配置JSON说明

不同广告位的JSON策略配置示例见:不同广告位JSON配置示例

{
  "rules": [
    {
      "tag": "A",
      "sort": [
        1,
        2
      ],
      "percent": 80
    },
    {
      "tag": "B",
      "sort": [
        2,
        1
      ],
      "percent": 20
    }
  ],
  "suppliers": [
    {
      "tag": "csj",
      "adspotId": "穿山甲广告位ID",
      "appId": "穿山甲应用ID",
      "index": 1
    },
    {
      "tag": "ylh",
      "adspotId": "优量汇广告位ID",
      "appId": "优量汇应用ID",
      "index": 2
    }
  ]
}

注: 为了方便开发者配置流量分发策略,我们也提供了在线可视化的便捷工具EasyTools,方便生成广告位的策略配置JSON。

2.3 获取广告

以下步骤,为获取广告的必要步骤,适用于所有广告位。 不同广告位置的不同实现,可参考Example示例

2.3.1 初始化广告对象

初始化广告对象EasyAdXXX,以开屏为例

EasyAdSplash easySplash = new EasyAdSplash(mActivity, adContainer, listener);

2.3.2 设置执行策略

调用共有方法setData(String strategyJson),给当前位置广告赋予执行策略,即2.2步骤中生成的SDK分发策略配置。

easySplash.setData(FileUtil.getJson(mActivity, "splash_config.json"));

2.3.3 调用获取广告

方式一:请求并展示广告

easySplash.loadAndShow();

方式二:先发起请求广告:

easySplash.loadOnly();

待广告成功拉取后,开发者可根据业务需求在合适的时机,决定调用展示广告方法。(注意:广告会存在有效期,过久未调用展示,会导致广告失效)

easySplash.show();

2.3.4 各广告位集成实现

3. 进阶设置

3.1 SDK全局配置

App多广告位情况下,想要优化SDK的广告位配置,可参考SDK全局配置优化管理你的众多广告位。

3.2 自定义广告SDK渠道

想要使用其他的广告SDK,自定义广告SDK渠道可以帮你轻松加入任何广告SDK。

4. SDK错误码 & 常见问题

调试遇到问题?欢迎查询SDK错误码及常见问题FAQ,帮助你快速解决对接中遇到的问题。

SDK错误码

常见问题

技术支持

QQ群: EasyAds开源社区群

QQ群二维码:

image

邮件技术支持:[email protected]

easyads-android's People

Contributors

bayescom avatar flayone avatar lightyear5235 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

easyads-android's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.