tt.createInterstitialAd
收藏我的收藏
收藏基础库 1.70.0 开始支持本方法，这是一个同步方法。
创建插屏广告组件。
| 前提条件 | 无 |
| 业务背景 | |
| 使用限制 | 注意，目前只能在抖音使用该方法，今日头条等宿主暂不支持。 |
| 注意事项 | •Tip：插屏广告组件是一个原生组件，由客户端渲染，前端无感知，层级比普通组件高。 •Tip：插屏广告组件每次创建都会返回一个全新的实例，默认是隐藏的，需要调用 InterstitialAd.show 将其显示。 •Tip：对于插屏广告的展示，有一定的频率控制，具体如下： 1. 小程序启动后的前30s（秒），不能展示插屏广告。 2. 已经展示一次插屏广告后，第二次展示需要距离上一次展示60s。 3. 展示过一次激励视频广告后，后续需要展示插屏广告的情况下，需要与激励视频广告的展示间隔60s。 |
| 支持沙盒 | 否 |
| 相关教程 | 无 |
语法
tt.createInterstitialAd(params)
参数说明
params 类型说明
object 类型，属性如下：
| 属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
|---|---|---|---|---|---|
| adUnitId | string | 是 | 单个广告单元的 id。可从「开放平台控制台-进入对应小程序-运营-商业化变现-广告管理」中获取 | 1.70.0 |
返回值
| 类型 | 说明 | 最低支持版本 |
|---|---|---|
| object | InterstitialAd | 1.70.0 |
InterstitialAd 参数说明
返回值为 InterstitialAd 类型，属性如下：
属性名 | 类型 | 默认值 | 说明 | 最低支持版本 |
show | Function | | 显示插屏广告 | 1.70.0 |
load | Function | | 加载插屏广告 | 1.70.0 |
destroy | Function | | 销毁插屏广告实例 | 1.70.0 |
onLoad | Function | | 监听插屏广告加载事件 | 1.70.0 |
offLoad | Function | | 取消监听插屏广告加载事件 | 1.70.0 |
onError | Function | | 监听插屏错误事件 | 1.70.0 |
offError | Function | | 取消监听插屏错误事件 | 1.70.0 |
onClose | Function | | 监听插屏广告关闭事件 | 1.70.0 |
offClose | Function | | 取消监听插屏广告关闭事件 | 1.70.0 |
错误码
| errorCode | errMsg | errorType | 说明 | 最低支持版本 |
|---|---|---|---|---|
| 158902 | The adUnitId is invalid | D | adUnitId不存在 | 1.70.0 |
| 158902 | The adUnitId is empty | D | adUnitId为空，传入正确的adUnitId | 1.70.0 |
| 158902 | The adUnitId is closed | D | adUnitId已关闭，请检查是否已关闭adUnitId | 1.70.0 |
| 158902 | The adUnitId is prohibit | D | adUnitId被封禁，oncall处理 | 1.70.0 |
| 158987 | feature is not supported in app | D | 当前宿主不支持，暂时没有支持的计划 | 1.70.0 |
扫码体验
请使用字节宿主APP扫码
代码示例
const interstitialAd = tt.createInterstitialAd({ adUnitId: "YOUR_AD_UNITID", }); interstitialAd .load() .then(() => { interstitialAd.show(); }) .catch((err) => { console.log(err); });
