《广告系统》

广告类型

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;
        case AdsWrapper.RESULT_CODE_RewardedVideoWithReward://激励视频回调
            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 null 或者错误信息的简单描述
激励视频回调 RESULT_CODE_RewardedVideoWithReward 奖励信息回调 JSON 字符串
应该内购买回调 RESULT_CODE_InAppPurchaseFinished 应用内购信息回调 JSON 字符串
广告被点击回调 RESULT_CODE_AdsClicked null 或者错误信息的简单描述
广告扩展回调 RESULT_CODE_ADSEXTENSION null 或者错误信息的简单描述

广告类型

开发者可以通过 boolean isAdTypeSupported(adType) 判断该广告 SDK 是否支持该类型的广告。

广告类型 标识符
Banner AD_TYPE_BANNER
插屏广告 AD_TYPE_FULLSCREEN
精品推荐 AD_TYPE_MOREAPP
积分墙 AD_TYPE_OFFERWALL
激励视频广告 AD_TYPE_REWARDEDVIDEO
原生广告 AD_TYPE_NATIVEEXPRESS
改进版原生广告 AD_TYPE_NATIVEADVANCED
AnySDKAds ads = AnySDKAds.getInstance();
if(ads.isAdTypeSupported(AdsWrapper.AD_TYPE_FULLSCREEN) )
{
    ads.hideAds(AdsWrapper.AD_TYPE_FULLSCREEN);
}

预加载广告

void preloadAds(AdsType adsType);
void preloadAds(int adsType,int idx);
功能介绍通过传递要显示的广告类型,显示相应的广告。
参数说明:adsType 为广告类型,idx 为打包工具对应的配套参数 ID。
举例说明:

AnySDKAds ads = AnySDKAds.getInstance();
if(ads.isAdTypeSupported(AdsWrapper.AD_TYPE_FULLSCREEN) )
{
    ads.preloadAds(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()
可通过该接口查询积分,返回 float。

ads.queryPoints();

扣除积分

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

ads.spendPoints(100);

【评论区】