菜单

激励视频广告

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; //设置不自动播放
// 穿山甲透参:仅支持单个json对象格式,不可以嵌套json对象
localExtraMap[ATTTConfig.MEDIA_EXTRA_KEY] = '{"a":"123","b":1}'; 
// v6.3.20及以上快手、华为、GDT等广告源透参 和 ATSDK 激励视频服务器回调透参,若格式保持json可仅传USER_CUSTOM_DATA
localExtraMap[AT_LOCAL_EXTRA_KEY.USER_CUSTOM_DATA] = 'your extra info';

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) 广告其他状态的回调
上一个
广告样式
下一个
插屏广告
最近修改: 2026-06-29Powered by