Giter Club home page Giter Club logo

xiaotujinbnb / easyads-android Goto Github PK

View Code? Open in Web Editor NEW

This project forked from bayescom/easyads-android

0.0 0.0 0.0 60.41 MB

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

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

License: GNU General Public License v2.0

Java 100.00%

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.1"

        //穿山甲广告SDK(建议)
        implementation(name: "open_ad_sdk_4908", ext: "aar")
        //优量汇广告SDK(建议)
        implementation(name: "GDTSDK_4492", ext: "aar")
        //百度广告SDK(可选)
        implementation(name: "Baidu_MobAds_SDK_9241", ext: "aar")
        //快手广告SDK(可选)
        implementation(name: "kssdk-ad-3334", 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

flayone avatar lightyear5235 avatar

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.