Bidding Android iOS JS Media API 常见问题

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)
})();

 文档反馈

腾讯公司 版权所有