moduleQuhe

/* Title: moduleQuhe Description: moduleQuhe */

概述

moduleQuhe 插件概述

moduleQuhe 聚合了众多知名广告联盟,插件囊括了开屏、插屏、激励视频的广告样式; Android 广告插件最低支持到 5.0 版本, 若版本过低, 可能会导致部分功能无法使用; 商务或技术支持微信号:wxid6quhead

使用此插件之前建议先配置 config.xml 文件,配置完毕,需通过云端编译生效,配置方法如下:

  • 名称:QuHeConfig
  • 参数:init、model
  • 配置示例:
<feature name="QuHeConfig">
    <param name="init" value="true"/>
    <param name="model" value="0" />
</feature>
  • 字段描述:

    init:(必须配置)广告初始化模式:【true:app启动时自动初始化】【false:不执行自动初始化】

    model:广告请求模式: //0【轮流模式】:CSJ-KS-GDT,KS-CSJ-GDT,GDT-CSJ-KS //1【优先CSJ模式】:CSJ-KS-GDT //2【优先KS模式】:KS-CSJ-GDT //3【优先GDT模式】:GDT-CSJ-KS

插件接口

开屏广告

通过调用 tb_splash({params},callback(ret)) 加载开屏广告

params

暂无参数

  • 描述:暂无参数

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    tag: 1,        //数字类型;-1:请求失败||0:广告被关闭||1:请求成功||2:广告展现||3:广告被点击
    msg: "请求成功" 
}

示例代码

    //开屏
    function tb_splash(){
        var modulequhe = api.require('moduleQuhe');
        var param = {};
        modulequhe.tb_splash(param, function(ret){
            var tag = ret.tag;
            var msg = ret.msg;
            if(-1 == tag){
                //请求错误
                api.toast({msg:msg});
            }else if(0 == tag){
             	//关闭
            }else if(1 == tag){
                //请求成功
                api.toast({msg:msg});//单号
            }else if(2 == tag){
                //展现
            }else if(3 == tag){
                //点击
            }else if(4 == tag){
                //激励视频发送奖励(仅激励视频有此回调)
            }
        });
    }

插屏广告

通过调用 tb_interaction({params},callback(ret)) 加载半屏插屏广告; 通过调用 tb_interactionFull({params},callback(ret)) 加载全屏插屏广告;

params

orientation:

  • 类型:数字类型
  • 描述:屏幕方向;1:竖屏||2:横屏

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    tag: 1,        //数字类型;-1:请求失败||0:广告被关闭||1:请求成功||2:广告展现||3:广告被点击
    msg: "请求成功" 
}

示例代码

    //半屏插屏
    function tb_interaction(){
    var modulequhe = api.require('moduleQuhe');
        var param = {orientation:1};
        modulequhe.tb_interaction(param, function(ret){
            var tag = ret.tag;
            var msg = ret.msg;
            if(-1 == tag){
                //请求错误
                api.toast({msg:msg});
            }else if(0 == tag){
             	//关闭
            }else if(1 == tag){
                //请求成功
                api.toast({msg:msg});//单号
            }else if(2 == tag){
                //展现
            }else if(3 == tag){
                //点击
            }else if(4 == tag){
                //激励视频发送奖励(仅激励视频有此回调)
            }
        });
    }

    //全屏插屏
    function tb_interaction_full(){
    var modulequhe = api.require('moduleQuhe');
        var param = {orientation:1};
        modulequhe.tb_interactionFull(param, function(ret){
            var tag = ret.tag;
            var msg = ret.msg;
            if(-1 == tag){
                //请求错误
                api.toast({msg:msg});
            }else if(0 == tag){
             	//关闭
            }else if(1 == tag){
                //请求成功
                api.toast({msg:msg});//单号
            }else if(2 == tag){
                //展现
            }else if(3 == tag){
                //点击
            }else if(4 == tag){
                //激励视频发送奖励(仅激励视频有此回调)
            }
        });
    }

激励视频广告

通过调用 tb_loadPlayRewardVideo({params},callback(ret)) 加载激励视频广告

params

userId:

  • 类型:字符串
  • 描述:app用户id或者android设备唯一标识(必填)

orientation:

  • 类型:数字类型
  • 描述:屏幕方向;1:竖屏||2:横屏

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    tag: 1,        //数字类型;-1:请求失败||0:广告被关闭||1:请求成功||2:广告展现||3:广告被点击||4:奖励达成
    msg: "请求成功" 
}

示例代码

    //激励视频
    function tb_loadPlayRewardVideo(){
        var modulequhe = api.require('moduleQuhe');
        var param = {userId:"app用户id或者android设备唯一标识", orientation:1};
        modulequhe.tb_loadPlayRewardVideo(param, function(ret){
            var tag = ret.tag;
            var msg = ret.msg;
            if(-1 == tag){
                //请求错误
                api.toast({msg:msg});
            }else if(0 == tag){
             	//关闭
            }else if(1 == tag){
                //请求成功
                api.toast({msg:msg});//单号
            }else if(2 == tag){
                //展现
            }else if(3 == tag){
                //点击
            }else if(4 == tag){
                //激励视频发送奖励(仅激励视频有此回调)
                api.alert({msg:"奖励达成"});
            }
        });
    }

其他方法

手动初始化广告SDK

通过调用 tb_init() 手动初始化广告SDK

示例代码

    function tb_init(){
        var modulequhe = api.require('moduleQuhe');
        modulequhe.tb_init();
    }
是否仍需要帮助? 请保持联络!
最后更新于 2024/11/18