插屏广告接入
| 类别 | 信息 | 备注 |
|---|---|---|
| 文档版本 | 1.0.0 | - |
| 更新日期 | 2019-04-01 | - |
1 插屏介绍
1.1 简介
支持多种规格尺寸，支持GIF、图片、图文、动态创意、H5富媒体；插屏广告与横幅广告相比展现尺寸更大，同样能够满足您对大量曝光和用户转化的需求。
1.2 广告播放示例
1.3 广告属性
| 属性 | 内容 |
|---|---|
| 支持平台 | H5 |
| 播放尺寸（宽高比） | 16:9、9:16、3:2、6:5、1:1 |
| 广告形态 | 纯图、图文、纯文 |
| 关闭 | 用户可关闭 |
2 接入步骤
2.1 接入准备
准备阶段，请先访问：“h5广告位创建流程” ，完成广告位创建。
2.2 接入H5 SDK
具体的H5 SDK接入方式请访问：“H5 SDK接入流程”，完成H5 SDK接入。
2.3 API
H5 SDK接入完成后，初始化插屏API。
TencentGDT.push({
placement_id,
type: 'native',
display_type: 'interstitial', // 播放类型：插屏
count: 1, //拉取广告的数量，必填，默认是1，最高支持10
onComplete: function(res) {
if (res && res.ret === 0) {
TencentGDT.NATIVE.renderAd(res.data[0]) // 调用渲染接口
} else {
console.log(res.ret);
}
}
});
API说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| placement_id | String | 是 | 广告位id |
| type | String | 是 | 广告位类型，请填写 "native" |
| display_type | String | 是 | 广告播放类型， 请填写"interstitial" |
| onComplete | Function | 否 | 广告播放回调方法，当广告每一次播放，都会通过回调触达开发者。 |
回调返回码
| 返回码 | 说明 |
|---|---|
| 0 | 广告返回成功，可调用TencentGDT.NATIVE.renderAd方法渲染插屏 |
| 100002 | 返回的广告模板为空，请检查请求返回数据具体定位问题 |
完整的接入代码示例
// 腾讯广告全局申明只需运行一次
window.TencentGDT = window.TencentGDT || [];
// 广告示例声明，多个广告位，请多次声明
TencentGDT.push({
placement_id,
app_id,
type: 'native',
display_type: 'interstitial', // 播放类型：插屏
count: 1,//拉取广告的数量，必填，默认是3，最高支持10
onComplete: function(res) {
if (res && res.ret === 0) {
TencentGDT.NATIVE.renderAd(res.data[0])
} else {
// 加载广告API，当广告使用完成，或无广告，可使用loadAd再次拉取广告
// 注意：拉取广告频率每分钟不要超过20次，否则会被广告接口过滤，影响广告位填充率
setTimeout(function() {
TencentGDT.NATIVE.loadAd(placement_id)
}, 3000)
}
}
});
// H5 SDK接入全局只需运行一次
(function () {
var doc = document,
h = doc.getElementsByTagName('head')[0],
s = doc.createElement('script');
s.async = true;
s.src = 'https://qzs.gdtimg.com/union/res/union_sdk/page/h5_sdk/i.js';
h && h.insertBefore(s, h.firstChild)
})();