激励视频广告

1. 加载广告

let rewardAd = new ATRewardVideoAd("your placement id");
this.rewardAd = rewardAd;
rewardAd.setAdListener({
    onAdLoaded: (): void => { },
    onAdShow: (adInfo: ATAdInfo): void => { },
    onAdClick: (adInfo: ATAdInfo): void => { },
    onAdClose: (adInfo: ATAdInfo): void => { },
    onAdReward: (adInfo: ATAdInfo): void => { },
    onAdLoadFailed: (adError: ATAdError): void => { },
    onAdVideoPlayStart: (adInfo: ATAdInfo): void => { },
    onAdVideoPlayEnd: (adInfo: ATAdInfo): void => { },
    onAdVideoPlayFailed: (adError: ATAdError, adInfo?: ATAdInfo | undefined): void => { },
    onAdOtherStatus: (adInfo?: ATAdInfo): void => { }
});

const localExtraMap: Record<string, Object> = {};
//支持透传以下参数给广告平台：比如userId，详见AT_LOCAL_EXTRA_KEY
localExtraMap[AT_LOCAL_EXTRA_KEY.USER_ID] = "your user id"; 
// 仅针对快手平台的广告配置
localExtraMap[ATKSConfig.VIDEO_AUTO_PLAY_TYPE_KEY] = 3; //设置不自动播放

rewardAd.loadAd({
    context: getContext(), 
    localExtraMap: localExtraMap
});

 

2. 展示广告

if (rewardAd.isAdReady()) {
    rewardAd.showAd(getContext(), {
      windowStage: DemoConstants.windowStage    //在UIAbility的onWindowStageCreate(windowStage: window.WindowStage)中获取
    });
}

 

3. API说明

● ATRewardVideoAd

激励视频广告的操作类，负责广告加载、监听、显示等。

方法	说明
ATRewardVideoAd(placementId: string)	广告的初始化方法 placementID：激励视频样式的广告位，通过后台创建激励视频广告位获取的
setAdListener(listener: ATRewardVideoAdListener)	设置广告位层级的广告监听回调 listener：广告位事件回调的接口类
loadAd(adLoadConfig?: ATRewardVideoAdLoadConfig)	发起广告加载 adLoadConfig：加载广告配置
isAdReady()	判断当前广告位是否存在可展示的广告 返回值：true=存在可展示的广告，false=不存在可展示的广告
showAd(context?: Context, adShowConfig?: ATRewardVideoAdShowConfig)	展示广告，传入展示广告时的自定义参数 adShowConfig：展示广告配置，包括自定义参数
getAdCaches()	查询当前广告位的所有缓存信息的ATAdInfo对象
getTopAdInfo()	获取当前广告位优先级最高的广告缓存信息 ATAdInfo对象

 

● ATRewardVideoAdListener

广告位层级的广告事件回调

方法	说明
onAdLoaded: ()	广告加载成功回调
onAdShow: (adInfo: ATAdInfo)	广告展示回调
onAdClick: (adInfo: ATAdInfo)	广告点击回调
onAdClose: (adInfo: ATAdInfo)	广告关闭回调
onAdReward: (adInfo: ATAdInfo)	下发激励的时候会触发此回调，建议您在此回调中下发奖励
onAdLoadFailed: (adError: ATAdError)	广告加载失败回调
onAdVideoPlayStart: (adInfo: ATAdInfo)	广告开始播放回调
onAdVideoPlayEnd: (adInfo: ATAdInfo)	广告播放结束回调
onAdVideoPlayFailed: (adError: ATAdError, adInfo?: ATAdInfo)	广告播放失败回调
onAdOtherStatus: (adInfo?: ATAdInfo)	广告其他状态的回调