广告系统接口

来自AnySDK 文档
跳转至: 导航搜索

广告类型

Banner广告

Banner广告使用屏幕的一小部分空间来吸引用户通过点击获得更丰富的全屏体验(例如网站或应用商店页面)

插屏广告

插屏广告是一些在用户触摸下通常会向用户呈现全屏应用内浏览体验的小型广告。

精品推荐

精品推荐

积分墙

积分墙是在一个应用内展示各种积分任务(下载安装推荐的优质应用、注册、填表等),以供用户完成任务获得积分的页面。用户在嵌入积分墙的应用内完成任务,该应用的开发者就能得到相应的收入。

相关接口

设置广告系统回调监听

广告系统存在回调信息,需要设置监听。

AnySDKAds.getInstance().setListener(new AnySDKListener() {
    @Override
    public void onCallBack(int arg0, String arg1) {
        Log.d(String.valueOf(arg0), arg1);
        switch (arg0) {
        case AdsWrapper.RESULT_CODE_AdsReceived://接收到广告回调
        break;
        case AdsWrapper.RESULT_CODE_AdsShown://广告显示回调      
        break;
        case AdsWrapper.RESULT_CODE_AdsDismissed://广告隐藏回调
        break;
        case AdsWrapper.RESULT_CODE_PointsSpendSucceed://积分墙消费成功
        break;
        case AdsWrapper.RESULT_CODE_PointsSpendFailed://积分墙消费失败
        break;
        case AdsWrapper.RESULT_CODE_NetworkError://网络出错
        break;
        case AdsWrapper.RESULT_CODE_UnknownError://未知错误
        break;
        case AdsWrapper.RESULT_CODE_OfferWallOnPointsChanged://积分墙积分改变
        break;
        default:
        break;
        }
    }
});

回调信息

回调信息 code msg
接收到广告 RESULT_CODE_AdsReceived null或者错误信息的简单描述
广告显示 RESULT_CODE_AdsShown null或者错误信息的简单描述
广告隐藏 RESULT_CODE_AdsDismissed null或者错误信息的简单描述
积分扣除成功 RESULT_CODE_PointsSpendSucceed null或者错误信息的简单描述
积分扣除失败 RESULT_CODE_PointsSpendFailed null或者错误信息的简单描述
网络错误 RESULT_CODE_NetworkError null或者错误信息的简单描述
未知错误 RESULT_CODE_UnknownError null或者错误信息的简单描述
积分墙积分改变 RESULT_CODE_OfferWallOnPointsChanged 回调积分值

广告类型

开发者可以通过 bool isAdTypeSupported(std::string functionName) 判断该广告SDK是否支持该类型的广告

广告类型 标示符
Banner AD_TYPE_BANNER
插屏广告 AD_TYPE_FULLSCREEN
精品推荐 AD_TYPE_MOREAPP
积分墙 AD_TYPE_OFFERWALL
	
AnySDKAds ads = AnySDKAds.getInstance();
if(ads.isAdTypeSupported(AdsWrapper.AD_TYPE_FULLSCREEN) )
{
    ads.hideAds(AdsWrapper.AD_TYPE_FULLSCREEN);
}

预加载广告

void preloadAds(int adsType,int idx);
void preloadAds(AdsType adsType);
功能介绍通过传递要显示的广告类型,显示相应的广告
参数说明:adsType为广告类型,idx为打包工具对应的配套参数id
举例说明
AnySDKAds ads = AnySDKAds.getInstance();
if(ads.isAdTypeSupported(AdsWrapper.AD_TYPE_FULLSCREEN) )
{
    ads.preloadAds(AdsWrapper.AD_TYPE_FULLSCREEN);
}

显示广告

void showAds(AdsType adsType) ;
void showAds(AdsType adsType,int idx) ;
功能介绍通过传递要显示的广告类型,显示相应的广告
参数说明:adsType为广告类型,idx为打包工具对应的配套参数id
举例说明
AnySDKAds ads = AnySDKAds.getInstance();
if(ads.isAdTypeSupported(AD_TYPE_FULLSCREEN) )
{
    ads.showAds(AdsWrapper.AD_TYPE_FULLSCREEN);
}

隐藏广告

void hideAds(AdsType adsType) ;
void hideAds(int adsType,int idx);
通过传递要隐藏的广告类型,隐藏相应的广告
参数说明:adsType为广告类型,idx为打包工具对应的配套参数id
举例说明
AnySDKAds ads = AnySDKAds.getInstance();
if(ads.isAdTypeSupported(AD_TYPE_FULLSCREEN) )
{
    ads.hideAds(AdsWrapper.AD_TYPE_FULLSCREEN);
}

积分查询

接口名:
float queryPoints()
可通过该接口查询积分

扣除积分

接口名:
void spendPoints(int points)
可通过该接口扣除积分