一、功能介绍

服务器回调是指用户在看完激励视频达到奖励下发条件时，穿山甲服务端会向开发者服务端发送一个验证申请，开发者服务端收到请求后判断是否给用户奖励，返回给穿山甲服务器true/false，最终客户端会通过onRewardArrived回调透传奖励下发结果，开发者根据回调进行奖励发放或者通过服务端接口验证结果进行奖励发放。

注意事项：

当选择需要服务器判断时，开发者需在平台上填写奖励回调URL。不同的代码位可以使用相同的接口去进行有效性验证的。
服务器回调模式不是必须的，只是增加了一次第三方服务器验证判断(穿山甲服务端只是透传验证请求，不会在中间过程添加校验逻辑)，为了保障开发者利益和用户体验，开发者可以在验证环节增加自己的校验逻辑，具体的奖励发放由客户端完成。

二、流程概览

步骤1-2：穿山甲平台开启回调功能并配置回调地址，开发者通过客户端的AdSlot接口透传用户参数信息；

步骤3-6：穿山甲服务端拉取信息并拼接参数访问开发者服务端回调URL，开发者自行判断是否发放奖励，服务端判断过程可根据需求添加sign签名验证逻辑。

步骤7-8：开发者服务端将判断结果返回穿山甲服务端，CSJ服务端会通过onRewardArrived->isRewardValid透传到客户端

步骤9：穿山甲客户端给到开发者奖励回调，开发者根据回调结果进行奖励下发具体如下：

三、开启流程

在穿山甲平台选中激励视频代码位，点击编辑，开启「服务端激励回调」，并配置回调相关参数

安全性考虑建议使用https协议的接口
使用域名接口，IP地址的URL穿山甲部分机房可能无法正常访问，导致收不到回调。

四、回调方式说明

穿山甲服务端会以 GET 方式请求开发者的回调链接（开发者可自行拼接内部唯一标识字段），并拼接以下参数回传：user_id=%s&trans_id=%s&reward_name=%s&reward_amount=%d&extra=%s&sign=%s

字段名称	字段定义	字段类型	备注
sign	签名	string	签名
user_id	tagid	string	透传开发者请求广告时传入的userId并通过开发者提供的回调链接回传，开发者服务端判断是否下发奖励
trans_id	交易	string	完成观看的唯一交易 ID
reward_amount	奖励数量	int	媒体平台创建代码位时配置的数值
reward_name	奖励名称	sting	媒体平台创建代码位时配置的名称
extra	Extra	string	调用 SDK 传入并透传，如无需要则为空

sign签名生成方式

开发者收到穿山甲服务端激励回调时，可以通过sign对参数进行校验；签名生成规则为：用trans_id 和Security Key 按照"SecurityKey:trans_id"形式拼接为 string，用sha256 算法加密生成的string得到sign签名；

Security Key：您在穿山甲媒体平台新建/编辑激励视频代码位获取
transId：交易 id

复制

Python 示例：

复制

约定返回参数

服务器回调url是一个get请求，开发者服务端默认返回的是一个json字符串{"isValid": true}

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

1、Android 使用示例

复制

2、iOS 使用示例

依据返回的verify（YES/NO）为依据进行激励视频的发放处理

复制

本篇目录