菜单

插屏广告

1. 插屏广告调用说明

1.1 API说明

类名：ATCocosSdk

API	参数说明	功能说明
loadInterstitialAd	const char * placementId	用于load插屏广告， unitId为广告位id
showInterstitialAd	const char * placementId	展示指定广告位的插屏广告
showInterstitialAdInScenario	const char * parameters， const char * scenario	展示指定广告位的插屏广告，其中scenario是广告展示场景，可从后台创建场景参数
isInterstitialAdReady	const char * parameters	判断指定广告位的广告是否加载完成
checkInterstitialAdStatus	const char * placementId	获取当前广告位的状态（Json字符串）： 1、isLoading：是否正在加载 2、isReady：是否有广告缓存（与isInterstitialAdReady作用相同） 3、AdInfo：当前优先级最高的广告缓存信息
setInterstitialAdListener	ATCocosInterstitialAdListener * listener	设置回调对象

1.2 Listener回调方法说明

接口：ATCocosInterstitialAdListener

API	参数说明	功能说明
onInterstitalLoadSuccess	const char * placementId	广告加载完成
onInterstitalLoadFailed	const char * placementId, const char * errorString	广告加载失败 errorString为加载失败的原因
onInterstitalClickedWithExtra	const char * placementId, const char * extra	广告产生点击 extra包含当前广告的其他信息
onInterstitalShowWithExtra	const char * placementId,const char * extra	广告展示 extra包含当前广告的其他信息
onInterstitalCloseWithExtra	const char * placementId,const char * extra	广告关闭 extra包含当前广告的其他信息
onInterstitalPlayStartWithExtra	const char * placementId,const char * extra	视频开始播放 extra包含当前广告的其他信息
onInterstitalPlayEndWithExtra	const char * placementId,const char * extra	视频结束播放 extra包含当前广告的其他信息

1.3 调用示例

1、加载广告

 ATCocosSdk::setInterstitialAdListener(this, interPlacementId);
 //v5.6.8新增，只针对Sigmob平台，Sigmob的激励视频广告源当做插屏使用
 cocos2d::ValueMap extra;
 //extra[ATCocosSdk::KEY_USE_REWARDED_VIDEO_AS_INTERSTITIAL] = false;
 extra[ATCocosSdk::KEY_USE_REWARDED_VIDEO_AS_INTERSTITIAL] = true;

 ATCocosSdk::loadInterstitialAd(interPlacementId, extra);

2、展示广告

 if(ATCocosSdk::isInterstitialAdReady(interPlacementId)){
     ATCocosSdk::showInterstitialAd(interPlacementId);

     //分场景进行展示广告
    //ATCocosSdk::showInterstitialAd(interPlacementId, YourScenario);
 }else{
     CCLOG("ATCocosSdk::isInterstitialAdReady is false");
 }

最近修改: 2025-05-30Powered by

大纲