《广告系统》

获取广告插件对象

local agent = AgentManager:getInstance()
local ads_plugin = agent:getAdsPlugin()

设置监听

用户系统存在回调信息,需要设置监听类,重写监听方法。

ads_plugin:setAdsListener(onAdsResult)

开发者需要实现 onAdsResult 方法。

local function onAdsResult(code, msg)
    print("on ads result listener.")
    print("code:"..code..",msg:"..msg)
end

广告类型

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

插屏广告

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

精品推荐

精品推荐。

积分墙

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

相关接口

回调信息

回调信息 code msg
接受到广告 kAdsReceived null 或者错误信息的简单描述
广告显示 kAdsShown null 或者错误信息的简单描述
广告隐藏 kAdsDismissed null 或者错误信息的简单描述
积分扣除成功 kPointsSpendSucceed null 或者错误信息的简单描述
积分扣除失败 kPointsSpendFailed null 或者错误信息的简单描述
网络错误 kNetworkError null 或者错误信息的简单描述
未知错误 kUnknownError null 或者错误信息的简单描述
积分墙积分改变 kOfferWallOnPointsChanged 回调积分值
激励视频回调 kRewardedVideoWithReward 奖励信息回调 JSON 字符串
应该内购买回调 kInAppPurchaseFinished 应用内购信息回调 JSON 字符串
广告被点击回调 kAdsClicked null 或者错误信息的简单描述
广告扩展回调 kAdsExtension null 或者错误信息的简单描述

广告类型

开发者可以通过 bool 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
local ads_plugin = AgentManager:getInstance():getAdsPlugin()
if ( ads_plugin:isAdTypeSupported(AdsType.AD_TYPE_FULLSCREEN) ) then
    ads_plugin:showAds(AdsType.AD_TYPE_FULLSCREEN)
end

预加载广告

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

ads_plugin:preloadAds(AdsType.AD_TYPE_FULLSCREEN)

显示广告

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

ads_plugin:showAds(AdsType.AD_TYPE_FULLSCREEN)

隐藏广告

hideAds(adsType, idx)
通过传递要隐藏的广告类型,隐藏相应的广告。
参数说明:adsType 为广告类型,idx 为打包工具对应的配套参数 ID。
举例说明:

ads_plugin:hideAds(AdsType.AD_TYPE_FULLSCREEN)

积分查询

接口名:
queryPoints()
可通过该接口查询积分,返回 number。

ads_plugin:queryPoints()

扣除积分

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

ads_plugin:spendPoints(100)

【评论区】