uni.createInterstitialAd(option)

创建插屏广告对象

插屏是一种弹出在屏幕中间的、带有关闭按钮的广告。大部分插屏广告是半屏的，个别广告会全屏。这取决于广告聚合渠道的设置。

• uni-ad的业务介绍：详见

上述文档是uni-app和uni-app x的通用文档，如遇到uni-app x不一致的文档，需以uni-app x文档为准。

开通插屏广告，需在 https://uniad.dcloud.net.cn/ 管理后台开通。

开通时需要进行开发者认证和应用资质审核。

2. 获取和使用广告位id

开通uni-ad后，在uni-ad后台给应用创建插屏广告位后，需要拿到广告位id（adpid），传入下面的api createInterstitialAd中。

3. 配置广告模块

App平台在manifest中配置添加三方广告SDK。具体配置可参考文档。

打正式包或自定义基座后可生效。标准基座包含的是测试广告位，无法为你产生收益。

createInterstitialAd 兼容性

Web	Android	iOS
x	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
option	CreateInterstitialAdOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 adpid string 是 - - 广告位 id

返回值

类型
InterstitialAd

InterstitialAd 的方法

show() : Promise<any>

广告加载成功之后，调用此方法展示广告

show 兼容性

Web	Android	iOS
x	4.31	4.31

返回值

类型
Promise<any>

load() : Promise<any>

加载广告

load 兼容性

Web	Android	iOS
x	4.31	4.31

返回值

类型
Promise<any>

destroy() : void

销毁广告

destroy 兼容性

Web	Android	iOS
x	4.31	4.31

onLoad(callback : AdCallBackEvent) : void

绑定广告 load 事件的监听器

onLoad 兼容性

Web	Android	iOS
x	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
callback	(result: any) => void	是	-	-	-

offLoad(callback : AdCallBackEvent) : void

解除绑定 load 事件的监听器

offLoad 兼容性

Web	Android	iOS
x	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
callback	(result: any) => void	是	-	-	-

onError(callback : AdErrorCallBackEvent) : void

绑定 error 事件的监听器

onError 兼容性

Web	Android	iOS
x	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
callback	(result: IUniAdError) => void	是	-	-	-

IUniAdError 的属性值

名称	类型	必备	默认值	兼容性	描述
errCode	number	是	-	-	错误码 - -5001 广告位标识adpid为空，请传入有效的adpid - -5002 无效的广告位标识adpid，请使用正确的adpid - -5003 广告位未开通广告，请在广告平台申请并确保已审核通过 - -5004 无广告模块，打包时请配置要使用的广告模块 - -5005 广告加载失败，请稍后重试 - -5006 广告已经展示过了，请重新加载 - -5007 广告不可用或已过期，请重新请求 - -5008 广告不可用或已过期，请重新请求 - -5009 广告类型不符，请检查后再试 - -5011 打包或开通的渠道，不支持此类型广告 - -5013 广告播放失败，请重新加载
errSubject	string	是	-	-	统一错误主题（模块）名称
data	any	否	-	-	错误信息中包含的数据
cause	Error	否	-	-	源错误信息，可以包含多个错误，详见SourceError
errMsg	string	是	-	-	-

offError(callback : AdErrorCallBackEvent) : void

解除绑定 error 事件的监听器

offError 兼容性

Web	Android	iOS
x	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
callback	(result: IUniAdError) => void	是	-	-	-

onClose(callback : AdCallBackEvent) : void

绑定 close 事件的监听器

onClose 兼容性

Web	Android	iOS
x	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
callback	(result: any) => void	是	-	-	-

offClose(callback : AdCallBackEvent) : void

解除绑定 close 事件的监听器

offClose 兼容性

Web	Android	iOS
x	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
callback	(result: any) => void	是	-	-	-

onAdClicked(callback : AdCallBackEvent) : void;

绑定广告可点击屏幕区域事件的监听器

onAdClicked 兼容性

Web	Android	iOS
x	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
callback	(result: any) => void	是	-	-	-

Tips

• uni-app x 标准基座插屏广告测试广告位id为1111111113。正式开发需配置自己的广告位id，并且打包自定义基座后生效。
• 插屏广告目前仅支持API形式，暂不支持组件形式。

示例

hello uni-app x

该 API 不支持 Web，请运行 hello uni-app x 到 App 平台体验

扫码体验（手机浏览器跳转到App直达页）

扫码体验

<template>
  <page-head title="插屏广告"></page-head>
  <button :type="btnType" style="margin: 10px;" :disabled="btnDisable" @click="showAd()">{{btnText}}</button>
</template>

<script>
  export default {
    data() {
      return {
        btnText: "",
        btnType: "primary",
        btnDisable: false,
        interstitialAd: null as InterstitialAd | null,
        isAdLoadSuccess: false
      }
    },
    onReady() {
      this.loadAd()
    },
    methods: {
      loadAd() {
        if (this.btnDisable)
          return
        this.btnDisable = true
        this.btnText = "正在加载广告"
        this.btnType = "primary"
        if (this.interstitialAd == null) {
          this.interstitialAd = uni.createInterstitialAd({
            adpid: "1111111113" //此处为测试广告位，实际开发中请在uni-ad后台申请自己的广告位后替换
          })
          this.interstitialAd!.onError((_) => {
            this.btnType = "warn"
            this.btnText = "广告加载失败，点击重试"
            this.btnDisable = false
          })
          this.interstitialAd!.onLoad((_) => {
            this.btnType = "primary"
            this.btnText = "广告加载成功，点击观看"
            this.btnDisable = false
            this.isAdLoadSuccess = true
          })
          this.interstitialAd!.onClose((_) => {
            this.isAdLoadSuccess = false
            this.loadAd()
          })
        }
        this.interstitialAd!.load()
      },
      showAd() {
        if (this.isAdLoadSuccess) {
          this.interstitialAd!.show()
        } else {
          this.loadAd()
        }
      }
    }
  }
</script>

<style>

</style>

参见

• 相关 Bug
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

通用类型

GeneralCallbackResult

名称	类型	必备	默认值	兼容性	描述
errMsg	string	是	-	-	错误信息