激励视频服务端验证

激励视频服务端验证功能需要优推 Android SDK 版本为3.9.0及其以上，优推iOS SDK 版本为2.12.0及其以上。

1.激励视频服务端验证

服务端验证是对应用内激励视频广告观看行为进行的额外验证，可规避欺骗客户端回调来奖励用户的功能。

开发者可以使用服务端验证对每一次激励视频广告观看行为进行验证。每次用户完整观看激励视频广告之后，优推SDK会通过开发者设置代码位时提供的回传URL地址，将此次观看行为进行信息回传。开发者可参考服务端回传信息，自行判断进行奖励的下发。

2.设置服务器端验证

a. 开启步骤

开发者可按照如下步骤接入：

(1) 登录优推广告平台，前往优推广告页面，流量管理功能，选择代码位列表，新建代码位激励视频代码位；

(2) 服务端验证选择【需要服务端验证】;

(3) 设置回调信息，包括回调URL、奖励数量等。

b. 填写参数介绍

使用服务端回调需要开发者填写和获取一些参数。

• 奖励名称：开发者自定义的奖励名称。建议不超过128字符
• 奖励数量
• 回调URL地址：优推ADN SDK 在激励视频播放完成后，以GET方式请求开发者填写的回调地址用于通知开发者。一般链接如下

http://www.mysite.com/granting.php?appUserId=__USER_ID__&rewardName=__REWARD_NAME__&rewardAmount=__REWARD_AMOUNT__&transId=__TRANS_ID__&placementId=__PLACEMENT_ID__&appId=__APPID__&sign=__SIGN__&extraInfo=__EXTRAINFO__&price=__PRICE__

• Security key：用于给回调信息签名。点击重置按钮可重新生成。

c. 服务端回传参数说明

服务端回调支持以下信息的回传，需要开发者在回调URL中包含对应参数宏。

参数	宏	含义
userId	__USER_ID__	开发者定义的用户id，一般通过初始化或者请求方法传入。 用于开发者校验用户真实性和计数
transId	__TRANS_ID__	请求id，用于标识广告展示的唯一性
appId	__APPID__	应用id
placementId	__PLACEMENT_ID__	代码位id
price	__PRICE__	广告展示单价，单位分，币种CNY
extraInfo	__EXTRAINFO__	开发者传入的自定义信息。一般通过初始化或者请求方法传入
sign	__SIGN__	校验数据准确性，唯一性，校验码值。sign生成规则： Sign = sha256(securityKey:transId)
rewardName	__REWARD_NAME__	奖励名称
rewardAmount	__REWARD_AMOUNT__	奖励数量

d. 回调响应

开发者通过了服务端验证后，需要返回以下json 数据

{"isValid":true}

字段名称	字段定义	字段类型	备注
isValid	校验结果	bool	判定结果，是否发放奖励