Android iOS Unity JS API Media API 常见问题

插屏广告接入

类别 信息 备注
文档版本 1.0.0 -
更新日期 2019-04-01 -

1 插屏介绍

1.1 简介

支持多种规格尺寸,支持GIF、图片、图文、动态创意、H5富媒体;插屏广告与横幅广告相比展现尺寸更大,同样能够满足您对大量曝光和用户转化的需求。

1.2 广告播放示例

1.3 广告属性

属性 内容
支持平台 H5
播放尺寸(宽高比) 16:99:163:26:51: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,
    app_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
app_id String
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 = '//qzs.qq.com/qzone/biz/res/i.js';
    h && h.insertBefore(s, h.firstChild)
})();

(本文完)

Copyright © 1998 - 2020 Tencent Inc. All Rights Reserved.
腾讯公司 版权所有 | 加入优量汇