Banner 广告接入
| 类别 | 信息 | 备注 |
|---|---|---|
| 文档版本 | 1.0.0 | - |
| 更新日期 | 2019-04-01 | - |
1 广告介绍
1.1 简介
Banner广告（又称横幅广告）支持支持GIF、图片、图文 、文字链、H5富媒体；既能够满足您对大量曝光的需求，也支持应用直达，满足您对用户转化的需求。
1.2 广告播放示例
1.3 广告属性
| 属性 | 内容 |
|---|---|
| 支持平台 | H5 |
| 播放尺寸 | 6.4:1 |
| 广告形态 | 纯图、图文、纯文 |
| 关闭 | 用户可关闭 |
2 接入步骤
2.1 接入准备
准备阶段，请先访问：“h5广告位创建流程” ，完成广告位创建。
2.2 接入H5 SDK
具体的H5 SDK接入方式请访问：“H5 SDK接入流程”，完成H5 SDK接入。
2.3 API
H5 SDK接入完成后，初始化BannerAPI。
TencentGDT.push({
placement_id,
app_id,
type: 'native',
display_type: 'banner', // 播放类型: banner广告
carousel: 6000, // 轮播时间，> 3000数字类型，否则轮播会被取消
containerid: 'banner_2_0', // 广告容器
onComplete: function(res) {
console.log(res.ret); // 返回码
}
});
API说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| placement_id | String | 是 | 广告位id |
| app_id | String | 是 | |
| type | String | 是 | 广告位类型，请填写 "native" |
| display_type | String | 是 | 广告播放类型， 请填写"banner" |
| carousel | Number | 选填 | 轮播时长，banner轮播间隔最短时间为6秒（6000ms），小于6s默认为不轮播 |
| containerid | String | 是 | 广告容器标签Id |
| onComplete | Function | 选填 | 广告播放回调方法，当广告每一次播放，都会通过回调触达开发者。 |
广告播放回调返回码说明
| 返回码 | 说明 |
|---|---|
| 0 | 广告返回和渲染成功 |
| 100001 | containerid 不能为空，请输入广告容器id |
| 100002 | 返回的广告模板为空，请检查请求返回数据具体定位问题 |
完整的接入代码示例
// 腾讯广告全局申明只需运行一次
window.TencentGDT = window.TencentGDT || [];
// 广告位声明，多个广告位执行多次push
TencentGDT.push({
placement_id: '1122334455', // 广告位id，请从联盟平台广告位获取
app_id: '112233',
type: 'native', // 广告类型
display_type: 'banner', // 广告播放类型: banner广告
carousel: 6000, // 轮播时间：6000 ~ 60000ms之间
containerid: 'banner_2_0', // 广告容器id
onComplete: function(res) {
if (res.ret == 0) {
console.log('广告播放成功');
} else {
console.log('广告播放失败')
}
}
});
// 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)
})();