diff --git a/docs/api/ad/rewarded-video-ad.md b/docs/api/ad/rewarded-video-ad.md index 1a828bcf8387002f16a354af7663461dc8474fdc..1283e311d2862d5a9c1cae571e8023f4a6d0ed23 100644 --- a/docs/api/ad/rewarded-video-ad.md +++ b/docs/api/ad/rewarded-video-ad.md @@ -146,6 +146,79 @@ rewardedVideoAd.onClose(res => { }) ``` + +### 服务器回调(App平台 HBuilderX 2.6.8,仅穿山甲支持) + +激励视频广告可以支持广告服务器到业务服务器的回调,用于业务系统判断是否提供奖励给观看广告的用户。配置服务器回调后,当用户成功看完广告时,广告服务器会访问配置的回调链接,通知用户完成观看激励视频。 + +相对来讲服务器回调将更加安全,可以依赖广告平台的反作弊机制来避免用户模拟观看广告完成的事件。 + +如何使用 +1. 申请激励视频广告位时开启服务器回调 +2. 创建激励视频广告时传入回调参数 + + +urlCallback示例 + +``` +rewardedVideoAd = uni.createRewardedVideoAd({ + adpid: '', + urlCallback: { + amount: '6', + name: 'RewardVideoAD1', + userId: 'testuser', + extra: 'testdata' + } +}); +``` + +### 服务器回调数据说明 + +当最终用户观看激励视频广告完成后,广告服务器会议GET方式请求业务服务器的回调链接,并拼接以下参数回传: +`user_id=%s&trans_id=%s&reward_name=%s&reward_amount=%d&extra=%s&sign=%s` + +|字段名称|说明|字段类型|备注| +:-|:-|:-|:-| +|sign|签名|String|签名信息| +|user_id|用户id|String |调用API传入的userId| +|trans_id|交易id|String |广告平台生成的唯一交易ID| +|reward_amount|奖励数量|String |广告后台配置或调用API传入的amount| +|reward_name|奖励名称|String|广告后台配置或调用API传入的name| +|extra|自定义数据,可以为空|String|透传给回调服务器的数据,调用API传入的extra| + +#### 签名信息 + +在uni-AD广告平台申请激励视频广告位通过后,如果开启服务器回调则会生成appSecurityKey。 +appSecurityKey用于签名校验服务器回调请求的合法性(请务必保管好),sign字段值生成规则为:sign=sha256(appSecurityKey,trans_id) +Python示例: + +``` +import hashlib + +if __name__ == "__main__": + trans_id = "6FEB23ACB0374985A2A52D282EDD5361u6643" + app_security_key = "7ca31ab0a59d69a42dd8abc7cf2d8fbd" + check_sign_raw = "%s:%s" % (app_security_key, trans_id) + sign = hashlib.sha256(check_sign_raw).hexdigest() +``` + +#### 回调请求返回数据约定 + +返回json数据,字段如下: + +|字段名称|说明|字段类型|备注| +:-|:-|:-|:-| +|isValid|校验结果|Blean|判定结果,是否发放奖励| + +示例 +``` +{ + "isValid": true +} +``` + + + ### app平台错误码 code|message| diff --git a/docs/uniCloud/release.md b/docs/uniCloud/release.md index 2ae054ca14f925e3b5e69a5c9225035f9534c906..2646f84d82a20f992c35c473d515a9105df84852 100644 --- a/docs/uniCloud/release.md +++ b/docs/uniCloud/release.md @@ -1,5 +1,18 @@ # uniCloud 更新日志 ====================================== +#### 2020-03-26 +* 【web 控制台】 + + 新增 腾讯云服务空间,需发送邮件获取体验资格 + + 新增 云函数运行日志 + + 新增 云存储权限 + + 新增 公共模块 + + 阿里云 优化 文件存储上传体验 + + 阿里云 优化 云数据库搜索体验 + + 阿里云 修复 删除索引报错的Bug + + 阿里云 修复 云存储文件后缀为大写文件不显示的Bug + + 阿里云 修复 云数据库字段为空或为 null 时显示错误的Bug + + #### 2020-03-04 * 【web 控制台】 + 阿里云 新增 云数据库分页