激励广告

提示

本篇文档的API是二次集成的API，内部集成了数据上报

您依然可以使用createRewardedAd的方式创建激励广告，但需要自己实现打点上报

初始化激励广告

version>=1.0.0

• 不支持java/oc直接调用

Unity

public static void InitRewardedVideoAd(RewardedAdInitParam param = null);

CocosCreator

export function initRewardedVideoAd(params?: AdParam): void;

AdParam参数

参数	类型	说明	默认值
adUnitId	string	广告位id	''

展示激励广告

version>=1.0.0

• 不支持java/oc直接调用

Unity

public static void ShowRewardedVideoAd(RewardedAdShowParam param);

CocosCreator

export function showRewardedVideoAd(params: RewardedVideoAdShowParam): void;

RewardedVideoAdShowParam参数

参数	类型	说明	默认值
adUnitId	string	广告位id	第一次初始化广告时的广告位id
positionTag	string	广告点位，用于统计	必传
timeout	int	超时时间，单位毫秒	10000
scene	string	广告点位所在场景，比如关卡内、关卡外等	default
position	number	后台广告位统计用，非必传	0
result	Ation(int)	1：完播 0: 中途关闭 -1: 加载失败 -2: 展示失败, version=1.0.x	null
extra	Object	激励额外打点参数,version>=1.1.0
start	Action	激励广告开始播放回调
success	onSuccess	正常关闭且存在奖励,version>=1.1.0
fail	OnFail	展示失败,version>=1.1.0
complete	Action	调用完成,version>=1.1.0

中断

version>=1.0.0

• 不支持java/oc直接调用

Unity

public static void InterruptRewardedVideoAd(string adUnitId = null);

CocosCreator

export function InterruptRewardedVideoAd(adUnitId?: string): void;

参数说明

参数	类型	说明	默认值
adUnitId	string	广告位id	第一次初始化广告时的广告位id

• 注意事项

仅在加载阶段可以中断，广告展示后无法中断

获取当前广告位状态

version>=1.0.0

• 不支持java/oc直接调用

Unity

public static int GetRewardedVideoAdStatus(string adUnitId = null);

CocosCreator

export function getRewardedVideoAdStatus(adUnitId?: string): number;

参数说明

参数	类型	说明	默认值
adUnitId	string	广告位id	第一次初始化广告时的广告位id

返回值

参数	类型	说明	说明
	int	广告状态	0：空闲 1：加载中 2：展示中