tt.createInterstitialAd
收藏
我的收藏

基础库 1.70.0 开始支持本方法,低版本需做兼容处理。这是一个同步方法。​
注意,目前只能在抖音使用该方法,今日头条等宿主暂不支持。​
创建插屏广告组件,开发者可以在小程序中使用插屏广告获得收入。具体接入方式可参考流量主。​
暂不支持接口查询广告数据,若需要查看,请在控制台,进入指定小程序后,在 【运营】-> 【商业化变现】中查看。​

语法​

js
复制
tt.createInterstitialAd(options)

参数说明​

options​

类型​
默认值​
必填​
说明​
最低支持版本​
object​
是​
广告配置参数​
1.70.0​
具体属性如下:​
属性名​
类型​
默认值​
必填​
说明​
最低支持版本​
adUnitId​
string​
是​
单个广告单元的 id。可从「开放平台控制台-进入对应小程序-运营-商业化变现-广告管理」中获取​
1.70.0​

返回值​

返回值为 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​

扫码体验​

代码示例​

js
复制
const interstitialAd = tt.createInterstitialAd({
adUnitId: "YOUR_AD_UNITID",
});
interstitialAd
.load()
.then(() => {
interstitialAd.show();
})
.catch((err) => {
console.log(err);
});

Bug & Tip​

    Tip:插屏广告组件是一个原生组件,由客户端渲染,前端无感知,层级比普通组件高。​
    Tip:插屏广告组件每次创建都会返回一个全新的实例,默认是隐藏的,需要调用 InterstitialAd.show 将其显示。​
    Tip:对于插屏广告的展示,有一定的频率控制,具体如下: 1. 小程序启动后的前30s(秒),不能展示插屏广告。 2. 已经展示一次插屏广告后,第二次展示需要距离上一次展示60s。 3. 展示过一次激励视频广告后,后续需要展示插屏广告的情况下,需要与激励视频广告的展示间隔60s。​