菜单

激励视频

1.1 API说明

类名：ATCocosSdk

API	参数说明	功能说明
loadRewardedVideoAd	const char * placementId, cocos2d::ValueMap parameters	用于load激励视频广告，unitId为广告位id；parameters可为第三方平台设置信息，用于激励
showRewardedVideoAd	const char * placementId	展示指定广告位的激励视频广告
showRewardedVideoAdInScenario	const char * placementId, const char * scenario	展示指定广告位的激励视频广告，其中scenario是广告展示场景，可从后台创建场景参数
isRewardedVideoAdReady	const char * placementId	判断指定广告位的广告是否加载完成
checkRewardedVideoAdStatus	const char * placementId	获取当前广告位的状态（Json字符串）： 1、isLoading：是否正在加载 2、isReady：是否有广告缓存（与isRewardedVideoAdReady作用相同） 3、AdInfo：当前优先级最高的广告缓存信息
setRewardedVideoAdListener	ATCocosRewardedVideoAdListener * listener, const char * placementId	设置回调对象

1.2 Listener回调方法说明

接口名：ATCocosRewardedVideoAdListener

API	参数说明	功能说明
onRewardedVideoLoadSuccess	const char * placementId	广告加载完成
onRewardedVideoLoadFailed	const char * placementId, const char * errorString	广告加载失败， errorString为加载失败的原因
onRewardedVideoClickedWithExtra	const char * placementId,const char * extra	激励视频产生点击 extra包含当前广告的其他信息
onRewardedVideoPlayStartWithExtra	const char * placementId,const char * extra	视频播放开始 extra包含当前广告的其他信息
onRewardedVideoPlayEndWithExtra	const char * placementId,const char * extra	视频播放结束 extra包含当前广告的其他信息
onRewardedVideoShowFailWithExtra	unitId: char, errorMsg: char ,const char * extra	视频播放失败， errorMsg为加载失败的原因 extra包含当前广告的其他信息
onRewardedVideoCloseWithExtra	const char * placementId, bool isRewarded,const char * extra	视频关闭， isRewarded为是否产生激励，可能出现因延迟激励导致没有正常激励 extra包含当前广告的其他信息
onRewardedVideoDidRewardSuccessWithExtra	const char * placementId,const char * extra	是否产生激励 extra包含当前广告的其他信息

1.3 调用示例

1、加载广告

 ATCocosSdk::setRewardedVideoAdListener(this, rvPlacementId);

 cocos2d::ValueMap extra;
 //如果需要通过开发者的服务器进行奖励的下发（部分广告平台支持服务器激励），则需要传递下面两个key
//ATCocosSdk::KEY_USER_ID必传，用于标识每个用户;ATCocosSdk::KEY_MEDIA_EXT为可选参数，传入后将透传到开发者的服务器
 extra[ATCocosSdk::KEY_USER_ID] = "test_user_id";//可选
 extra[ATCocosSdk::KEY_MEDIA_EXT] = "test_user_data";//可选
 ATCocosSdk::loadRewardedVideoAd(rvPlacementId, extra);

2、展示广告

if(ATCocosSdk::isRewardedVideoAdReady(rvPlacementId)){
    ATCocosSdk::showRewardedVideoAd(rvPlacementId);

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

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

大纲