腾讯优量汇广告使用指南
WARNING
请注意,当前域名 https://dev.weixin.qq.com/docs/framework
文档已不维护,请前往微信文档中心 找到对应的新文档继续使用
一、使用前须知
1、账号准备
多端应用已支持 App 的「开屏广告」和「激励广告」,而该能力是基于腾讯优量汇-流量管理服务实现,开发者需前往腾讯优量汇官方注册账号,并创建媒体和广告位。为方便开发者更好地理解整体逻辑,需认真阅读本章节的内容:
- 首先,前往腾讯优量汇控制台注册开发者账号,并完成企业资质认证
- 前往「流量合作」创建媒体和广告位,获得相应的 媒体 id 和 广告位 id,具体使用上请查看下文的说明
2、关于 SDK 版本要求
- 开屏广告:iOS SDK 需使用版本号 ≥ 1.0.20;Android SDK 需使用版本号 ≥ 1.0.14
- 激励广告:iOS SDK 需使用版本号 ≥ 1.3.21;Android SDK 需使用版本号 ≥ 1.3.17
即,开发者需升级 SDK 版本至上述要求的版本方可使用 GDT SDK 相关能力
3、注意事项
- GDT SDK 会对 bundleId 进行校验,如果 bundleId 与创建媒体是填的不一致,则无法成功展示广告。
- 即,为正常拉取广告,开发者构建 IPA 时需选择「证书签名」,不可选择「临时签名」;
- 以及,该多端应用已经绑定移动应用,即构建 IPA 时显示的 bundleId 不是官方分配的测试版 bundleId
- 此外, 新创建的广告位,30 分钟后才能开始拉取到广告,开发者需知悉
- 最后,腾讯优量汇账号需完成企业资质认证,创建的 appid,placementId 才能正常拉取到广告,也需开发者知悉
- 补充说明:开启了腾讯优量汇广告的 App 暂不支持上架 Google Play,即如的 App 需上架 Google Play ,不要勾选「GDT SDK 」
4、关于合规指南
根据监管部门要求,使用 SDK 时必须在《隐私政策》中告知终端用户 SDK 使用用途,并且在终端用户未同意《隐私政策》前不得初始化任何 SDK。请确保你开发或运营的应用有符合监管要求的《隐私政策》文本。同时请你务必明确告知终端用户您的应用使用了广告服务。并需遵守下方相关的协议
二、开屏广告操作指南
本章节的操作指南仅包含开发者工具上的操作,更多关于腾讯优量汇控制台操作可前往其官网进行查看相关指引
- 腾讯优量汇 - 账号注册
- 腾讯优量汇 - 新建媒体
- 腾讯优量汇 - 新建广告位,新建广告位的时候选择「开屏广告」
开发者工具的操作指引如下:
- 在
project.miniapp.json
中配置启用「GDT SDK」,并填入对应的媒体 id 和广告 id
- 从 iOS >= 1.2.9 开始,开发者可在设置开屏广告后,设置是否默认展示开屏广告。SDK 也提供 wx.miniapp.setEnableAdSplash 让开发者实现自定义控制。
三、激励广告操作指南
本章节的操作指南仅包含开发者工具上的操作,更多关于腾讯优量汇控制台操作可前往其官网进行查看相关指引
- 腾讯优量汇 - 账号注册
- 腾讯优量汇 - 新建媒体
- 腾讯优量汇 - 新建广告位,新建广告位的时候选择「激励视频广告」
开发者工具的操作指引如下:
- 在
project.miniapp.json
中配置启用「GDT SDK」,并填入对应的媒体 id
- 然后调用
wx.miniapp.createRewardedVideoAd
创建激励视频广告组件,其中 adUnitId 即为广告位 id
3.1 wx.miniapp.createRewardedVideoAd
创建激励视频广告组件,即调用该方法创建的激励视频广告是一个单例。调用示例可参考wx.createRewardedVideoAd
参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
adUnitId | string | 是 | 广告位 id | |
multiton | boolean | 否 | 是否启用多例模式,只支持 false |
返回值
参考小程序的RewardedVideoAd