重构后的内容: H5 SDK 接入文档 广告关键词 版本号 更新时间 备注 支持设备调试 1.0.8 15527649518 新增调试模式「3.1.4 在线调试」,修复第三方浏览器广告播放问题,并开放接入环境。 1.0.7 15527649518 H5 SDK地址变更。 1.0.6 15527649518 1.0.5 15527649518 因环境变化,反作弊功能得到提升。 1.0.4 15527649518

  1. 提升反作弊和广告质量,H5 SDK取消imei、idfa上报api。 2.原生广告 1.0.3 15527649518
  2. 新增原生自定义模板样式使用广告说明。 激励视频 1.0.2 15527649518
  3. 新增H5 SDK激励视频接入说明。
  4. banner2.0\插屏2.0接入说明 文档版本 1.0.1 15527649518
  5. 优化自定义模板广告接入说明。 1.0.0 15527649518
  6. 文档创建 广告类型和环境建议 1.1 广告类型说明 以下是优量汇H5广告支持的场景类型,你可以根据你自身的产品流量和用户场景,选择适合的广告类型接入:
  • banner广告:游戏、视频、阅读等固定区域,简单。
  • 插屏广告:主要提供弹框广告,简单。
  • 模板广告:提供左右图文、上下图文、纯图、三小图等样式,具体访问原生模板广告接入;可与网站列表、表格、内容等形态融入,简单。
  • 激励视频广告:小游戏、阅读、播放等激励场景,中等。 浏览器环境 优量汇H5 SDK运行环境 系统环境:Android、iOS(仅支持QQ浏览器) 开发者环境:App内使用的浏览器; 第三方环境:系统浏览器、手机Chrome、Opera浏览器、UC 浏览器、百度浏览器等,用户需关闭广告拦截功能、开启 Cookie。开启Cookie:请确保浏览器Cookie功能开启,否则会影响广告召回。网络协议:请开发者网站务必使用https访问,因http有安全隐患,广告召回会降低填充率,严格情况会停止广告返回。 H5 广告位创建流程 2.1 接入步骤 3.H5 SDK接入流程 2.2 H5 广告接入步骤详解 2.2.1 新建H5媒体路径: 流量合作 => 我的媒体 => 新建媒体 => 选择应用平台和商店 => H5平台 H5媒体创建流程及SDK接入规范 在创建H5媒体之前,会员需要完成以下步骤:
  1. 网站域名校验和ICP备案。请按照平台提示进行网站域名校验(绑定),目前我们提供的验证方式有两种。
  2. 注意广告域名校验规则如下:www.qq.com, qq.com, adnet.qq.come.qq.com, qq.com, adnet.qq.come.qq.com。 接下来是新建广告位的两种方法:
  • 通过流量合作 -> 我的广告位,点击新建广告位,进入新建页面,选择对应的媒体完成创建。

  • 通过流量合作 -> 我的媒体,找到对应的媒体在对应的操作栏选择新建广告位即可添加该媒体对应的广告位。 然后是选择广告场景:

  • 点击新建广告位后,可以创建banner、插屏、和原生广告位。 获取JS示例代码并部署JS代码,发布网页,测试、上线。将代码复制到自己网页源码的对应位置,并进行联调测试。在测试完成并确认无误后,发布包含广告代码的网页,上线广告。 最后是H5 SDK接入规范:

  • 申明全局命名空间:window.TencentGDT = window.TencentGDT || [];

  • 广告位申明ObjectpushTencentGDTpush TencentGDT.push({ placement_id: ‘11**99’, // String,广告位id appid: ‘appid’, // String,应用ID type: ‘rewardVideo’, // String,广告类型,请根据广告类型填写对应的type值 display_type: ‘banner’, // String,显示类型,例如:banner、插屏广告等 onComplete: function(res) { // Function,广告位初始化回调方法,已激励视频接入为例 if(res.code == 0) { // 如果代码为0,表示成功初始化 // 激励视频实例化,注意:插屏广告、模板广告方位为:renderAd var video = new TencentGDT.NATIVE.rewardVideoAd(function(res) { // 激励视频回调参数 console.log(res); // 输出结果 }); // 激励视频加载方法 video.loadAd(); // 激励视频播放方法 video.showAd(); } } }); API说明: 参数 类型 必要 说明 placement_id String 必填 广告位id app_id String 必填 muidtype String 选填 1-imei,2-ifa,3-mac muid String 选填 Android:md5(imei);iOS:md5(idfa),详见:「3.1.4 在线调试」 type String 必填 广告位类型,选项包括,原生模板:native、激励视频:rewardVideo display_type String 选填 banner、插屏广告必须填写display_type,具体值见各个广告文档说明 onComplete Function 选填 广告回调方法,执行初始化、视频加载、视频播放相关的回调都在此方法回调捕获 type值: native:原生广告、原生模板广告 在开发和测试移动应用时,确保广告的顺利加载和正确显示至关重要。以下是根据提供的内容重构的广告接入步骤和注意事项:

    3.1.3 加载H5 SDK

    首先,确保在HTML文档中已经引入了必要的脚本文件。接着,通过以下JavaScript代码实现加载H5 SDK的功能:

(function () {
var doc = document,
h = doc.getElementsByTagName('head')[0],
s = doc.createElement('script');
s.async = true;
s.src = '//qzs.gdtimg.com/union/res/union_sdk/page/h5_sdk/i.js';
h.parentNode.insertBefore(s, h);
})();

以上步骤完成后,即可按照指定的广告类型进行广告接入。

3.1.4 在线调试

如需进行线上广告调试,可以通过配置muidtypemuid参数来实现。例如,Android设备获取15位imei号码后,可以执行以下操作:

  • Android获取15位 imei:15527649518

  • 使用MD5加密算法对小写的imei号码进行加密,得到32位的小写加密值:md5加密获得 32 位小写加密值:52eeda664857fb35a35119df208ebce0

  • 将得到的加密值作为muid参数传入,例如:muid: 52eeda664857fb35a35119df208ebce0 请注意,调试完成后,记得删除muidtypemuid,或使用用户真实的muid,否则在生产环境中使用非真实的muid会导致账户被封禁。

    4. 广告场景接入

    4.1 banner广告

  • 在应用中集成合适的banner广告组件,并设置相应的参数。 4.2 插屏广告

  • 在应用启动过程中插入预加载的插屏广告。 4.3 H5激励视频广告

  • 利用H5技术展示激励视频广告,确保广告内容与应用主题一致且符合平台规范。 4.4 原生模板广告

  • 使用原生模板为广告创建自定义视图,并在适当时机展示。 4.5 原生自渲染广告

  • 利用原生组件实现广告的自动渲染和更新。

    5 测试报错原因查找

    5.1 JS报错

  • 检查返回值中的最后三位数字以确定错误原因。例如,如果返回值为104,则可能的错误原因是:

原因
104

请确保在遇到任何问题时,及时查阅相关文档或联系技术支持团队以获得帮助。 在广告投放中,我们可能会遇到各种问题,比如adposcount为空、posid为空、count/posw/posh为空等。这些问题可能会导致广告无法正常显示,影响用户体验。因此,我们需要及时处理这些问题,确保广告能够正常运行。 同时,我们还需要注意广告的展示方式。例如,对于原生广告,我们需要提供拉取广告的回调函数,以便开发者根据广告数据长度来判断广告是否拉取成功。而对于插屏广告,由于其不会弹出浮层进行广告渲染,因此不会出现无广告填充的白屏现象。 此外,我们还需要考虑收益优化建议。例如,提升广告价值可以通过开启Cookie功能来获取较好的广告填充率。同时,我们也需要注意广告位设置的建议,如建议放置Banner广告或原生广告在消息流页和正文页等位置。这些建议可以帮助我们更好地展示广告,提高收益。 总之,我们在广告投放过程中需要关注各种问题,并采取相应的措施来解决它们。只有这样,我们才能确保广告能够正常运行,为用户提供更好的体验。