菜单

开屏广告

1. 加载广告

let splashAd = new ATSplashAd("your placement id");
splashAd.setAdListener({
  onAdLoaded: (isTimeout: boolean): void => { },
  onAdShow: (adInfo: ATAdInfo): void => { },
  onAdClick: (adInfo: ATAdInfo): void => { },
  onAdClose: (adInfo: ATAdInfo): void => { },
  onAdLoadTimeout: (): void => { },
  onAdLoadFailed: (adError: ATAdError): void => { }
});

const localExtraMap: Record<string, Object> = {};
// 仅针对快手平台的广告配置
localExtraMap[ATKSConfig.VIDEO_AUTO_PLAY_TYPE_KEY] = 1; //设置自动播放
//设置宽高,单位/vp
localExtraMap[AT_LOCAL_EXTRA_KEY.AD_WIDTH] = px2vp(display.getDefaultDisplaySync().width);
localExtraMap[AT_LOCAL_EXTRA_KEY.AD_HEIGHT] = px2vp(display.getDefaultDisplaySync().height);

splashAd.loadAd({
  context: getContext(),
  fetchAdTimeout: 5000,
  localExtraMap: localExtraMap,
});

 

2. 展示广告

BuildATSplashAdView(this.splashAd!, {
  windowStage: DemoConstants.windowStage  //在UIAbility的onWindowStageCreate(windowStage: window.WindowStage)中获取
})

 

3. API说明

● ATSplashAd

开屏广告的操作类,负责广告加载、监听、显示等。

方法 说明
ATSplashAd(placementId: string) 广告的初始化方法
placementID:开屏样式的广告位,通过后台创建开屏广告位获取的
setAdListener(listener: ATSplashAdListener) 设置广告位层级的广告监听回调
listener:广告位事件回调的接口类
loadAd(adLoadConfig?: ATSplashAdLoadConfig) 发起广告加载
adLoadConfig:加载广告配置
BuildATSplashAdView(ATSplashAd) 展示广告
isAdReady() 判断当前广告位是否存在可展示的广告
返回值:true=存在可展示的广告,false=不存在可展示的广告
getPlacementId() 获取广告位ID
getAdListener() 获取广告位层级的广告监听回调
getAdCaches() 查询当前广告位的所有缓存信息的ATAdInfo对象
getTopAdInfo() 获取当前广告位优先级最高的广告缓存信息 ATAdInfo对象

 

● ATSplashAdListener

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

方法 说明
onAdLoaded: () 广告加载成功回调
onAdShow: (adInfo: ATAdInfo) 广告展示回调
onAdClick: (adInfo: ATAdInfo) 广告点击回调
onAdClose: (adInfo: ATAdInfo) 广告关闭回调
onAdLoadFailed: (adError: ATAdError) 广告加载失败回调
onAdLoadTimeout() 广告加载超时回调

 

 

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