广告执行说明文档

1.广告的类型

广告类型分为：开屏，插屏，模板，视频，自渲染 5大类。

开屏：每次进入应用，或从后台返回至应用时，弹出的开屏广告

image.png

插屏：悬浮在窗口上的弹窗广告

image.png

模板：广告平台提供布局与点击，返回一个完整的View。客户端将其添加到ViewGroup中，以快速集成的广告类型

image.png

自渲染：广告平台提供广告全部素材，客户端自定义布局与点击区域。上述开屏，插屏，模板三种类型，广告布局与点击区域不可更改，自渲染可完全自定义。

image.png

视频：广告平台提供的视频，加载与播放均由平台处理。客户端负责调起，接收播放成功或失败的回调即可

image.png

2.广告的分级规则，以上类型按规则展示

 "pos_id":"1",
                "data1":[
                    {
                        "circle_number":"4",
                        "data2":[
                            {
                                "id":"2239",
                                "advertise_pt":"1",
                                "show_num":"1",
                            },
                            {
                                "id":"2317",
                                "advertise_pt":"11",
                                "show_num":"1",
                            },
                            {
                                "id":"2271",
                                "advertise_pt":"9",
                                "show_num":"1",
                            },
                            {
                                "id":"2330",
                                "advertise_pt":"11",
                                "show_num":"1",
                            }
                        ]
                    },
                    {
                        "circle_number":"0",
                        "data2":[
                            {
                                "id":"2282",
                                "advertise_pt":"9",
                                "show_num":"1",
                            }
                        ]
                    }
                ],
                "check":"becf7b523dd72a34c82ef8e66eff913d"
            },

广告每次展示后切换，下一次要展示哪个平台广告，有这样的展示规则：

从上至下，每一个id对应一个类型广告。advertise_pt对应广告平台，show_num为该平台广告展示次数，circle_number为该组循环次数

show_num或circle_number 为0时，代表无限循环。

如上，展示顺序应为：2239-2317-2271-2330-2239-2317-2271-2330-2239-2317-2271-2330-2239-2317-2271-2330-2282-2282-2282...

执行坐标的定义：此时展示哪一个广告，从而得知下一次展示哪个，如上2239坐标为1；2317坐标为2，以此类推。

3.广告计划的保存和读取

按第二条，依次展示的广告，在退出程序重启后，应保存此时的执行坐标。

在进入程序时，首先判断是否有缓存的广告数据和坐标，如有优先使用缓存。如没有，从服务器获取广告数据。

4.广告的重置规则

当天0点后，不论昨天计划执行到哪里，计划重新执行（即执行坐标全部清0）。当获取服务器数据有变化时，有变化的那个广告位，计划重新执行。其余无变化广告位，执行坐标不变。

5.广告对应详细参数介绍

                    private String id;
                    //只有广点通广告用到的appid
                    private String gdt_app_id;
                    //广告位置ID，对应类AdPosId
                    private String location_id;
                    //广告平台，对应类AdType
                    private String advertise_pt;
                    //本次广告平台展示次数
                    private int show_num;
                    //广告平台用于请求广告的sdkKey
                    private String sdk_key;
                    //只有banner广告用到的轮播时间
                    private int loop_time;
                    //用于获取间隔多少次展示类型的广告，间隔是多少
                    private int other;
                    //用于判断同一个广告平台的不同广告类型，如同属头条的，全屏视频和激励视频
                    private String sdk_type;
                    //当前组执行坐标
                    private int workIndex;
                    //判断是下载/插屏/详情页，类型三种type，用于默认广告/直客广告 类型
                    private int type;
                    //默认广告的标题
                    private String game_title;
                    //默认广告的详情
                    private String game_desc;
                    //默认广告的图片
                    private String game_img;
                    //默认广告的详情页链接
                    private String game_link;

                    //新版本没有用到
                    private int is_download;
                    //没有用到
                    private int isclose;
                    //没有用到
                    private String sdk_id;
                    //没有用到
                    private String loop_type;

6.广告Type对应类型

        public class AdType {

    public static final String GDT_TYPE = "1"; //广点通

    public static final String TT_TYPE = "2"; //头条

    public static final String FALCON_TYPE = "3";//已不再使用

    public static final String ADX_TYPE = "4";//已不再使用

    public static final String WIND_TYPE = "7";//已不再使用

    public static final String BAI_DU_TYPE = "8";//百度

    public static final String WY_TYPE = "9";//万裕

    public static final String GDT_TYPE2 = "10"; //广点通2

    public static final String H5_TYPE = "6";//h5

    public static final String SOUGOU_TYPE = "11";//搜狗

    public static final String ZK_TYPE = "12";//直客广告

    public static final String KS_TYPE = "13";//快手

}