开屏广告

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)中获取
  bottomViewBuilder: myBuilder  // 可选，穿山甲、优量汇广告时生效(参考Demo)
})

注：bottomView高度设置说明 ATSplashAdShowConfig: bottomViewBuilder

• 优量汇广告竖屏下bottomView必须小于等于20%，否则会被裁剪
• 穿山甲广告高度不超过屏幕高度一半会影响广告曝光
• 如果需要展示穿山甲广告 bottomView，展示时输入bottomVIewBuilder且在splashAd.loadAd时设置广告高度localExtraMap[AT_LOCAL_EXTRA_KEY.AD_HEIGHT]

 

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()	广告加载超时回调