菜单

插屏广告

1. 加载广告

复制代码

let interstitialAd = new ATInterstitialAd("your placement id");
this.interstitialAd = interstitialAd;
interstitialAd.setAdListener({
  onAdLoaded: (): void => { },
  onAdShow: (adInfo: ATAdInfo): void => {
    const showCustomExt = adInfo.getShowCustomExt();
  },
  onAdClick: (adInfo: ATAdInfo): void => { },
  onAdClose: (adInfo: ATAdInfo): void => { },
  onAdLoadFailed: (adError: ATAdError): void => { },
  onAdVideoPlayStart: (adInfo: ATAdInfo): void => { },
  onAdVideoPlayEnd: (adInfo: ATAdInfo): void => { },
  onAdVideoPlayFailed: (adError: ATAdError, adInfo?: ATAdInfo): void => { }
})

const localExtraMap: Record<string, Object> = {};
// 仅针对快手平台的广告配置
localExtraMap[ATKSConfig.VIDEO_AUTO_PLAY_TYPE_KEY] = 3; //设置不自动播放

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

2. 展示广告

复制代码

if (interstitialAd.isAdReady()) {
    interstitialAd.showAd(getContext(), {
      windowStage: DemoConstants.windowStage,
      localExtraMap: {
        'show_custom_ext': 'your custom ext'
      }
    });
}

3. API说明

● ATInterstitialAd

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

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

● ATInterstitialAdListener

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

方法	说明
onAdLoaded: ()	广告加载成功回调
onAdShow: (adInfo: ATAdInfo)	广告展示回调，可通过 adInfo.getShowCustomExt() 获取展示透传内容
onAdClick: (adInfo: ATAdInfo)	广告点击回调
onAdClose: (adInfo: ATAdInfo)	广告关闭回调
onAdLoadFailed: (adError: ATAdError)	广告加载失败回调
onAdVideoPlayStart: (adInfo: ATAdInfo)	广告开始播放回调
onAdVideoPlayEnd: (adInfo: ATAdInfo)	广告播放结束回调
onAdVideoPlayFailed: (adError: ATAdError, adInfo?: ATAdInfo )	广告播放失败回调

● ATAdInfo

广告信息对象

方法	说明
getShowCustomExt(): string	获取展示广告时通过 show_custom_ext 透传的自定义字符串，未传返回空字符串，v6.3.40版本开始支持该方法

注：show_custom_ext 参数说明

show_custom_ext 通过 showAd 的 localExtraMap 传入，与 Android 字段名一致。
show_custom_ext 为非必填参数，仅对本次展示生效，每次 showAd 需重新传入。

上一个

激励视频广告

下一个

开屏广告

最近修改: 2026-10-10Powered by

大纲