一、功能介绍

1. 功能概述

GroMore 平台应用广告位粒度支持开启【服务端奖励回调】功能，开发者开启回调功能并在客户端传入参数后，用户观看激励视频过程中，开发者服务端可以收到GroMore 服务端返回的参数信息并进行奖励下发判断，GroMore 根据判断结果返回回调。

提示：服务端奖励回调非必选，是对激励视频观看进行的额外验证，仅增加一层第三方验证判断，具体的奖励发放仍然由客户端完成，GroMore 服务端只透传验证请求，不会在中间增加校验逻辑。

2. 交互逻辑说明

开发者开启服务端回调功能并完成 userID 及自定义透传参数传入后，在用户观看激励视频过程中， GroMore 服务端会拼接参数信息并访问开发者服务端向开发者确认是否发放奖励，根据开发者服务端返回的 true/false，给到开发者是/否发放奖励的回调，示意图如下。

2. 交互示意图

图释：

步骤1-2：GroMore 后台开启回调功能并配置相关参数；开发者通过客户端的接口传入用户参数信息

步骤3-6：GroMore 服务端拉取信息并拼接参数访问开发者服务端回调URL，开发者自行判断是否发放奖励

步骤7-8：开发者服务端将判断结果返回GroMore 服务端，GroMore 服务端会透传给 GroMore 客户端

步骤9：GroMore 客户端给到开发者奖励回调，开发者根据回调结果进行奖励下发

注：该功能在应用广告位层级配置，如广告位已开启GroMore 的服务端回调，代码位层级不需要再单独配置各家ADN的服务端回调，重复配置可能会导致奖励发放异常，建议统一在 GroMore 侧配置。

二、使用流程

1. 开启「服务端激励回调」

• 新建广告位入口：创建广告位类型为「激励视频」时，可直接勾选「服务端激励回调」，并配置回调相关参数
• 存量广告位入口：【应用管理】页面中点击对应激励广告位的「⋮」->「编辑广告位」，勾选「服务端激励回调」并配置回调相关参数（回调说明参考第三部分）

提示：回调URL建议使用https协议的域名接口，避免穿山甲部分机房因无法正常访问ip地址的URL而无法收到回调

2. 传入参数

• 开发者在代码中通过融合SDK的API 传入UserID(用户唯一ID)和用户自定义数据，这些参数最终将通过回调URL 回传给开发者 （参考第三部分示例）

3. 判断奖励发放

• 用户观看完激励视频后，GroMore 服务端将通过设置的回调URL 通知开发者，由开发者自行判断并下发奖励

三、回调说明&实现示例

1. 回调说明

• GroMore 会以GET方式请求开发者的回调URL，并拼接参数回传，可参考>>开发者回调URL示例
• 字段说明：

• sign签名规则说明：开发者收到GroMore 服务器激励回调时，可以通过sign对参数进行校验；签名生成规则为：用trans_id 和 m-key 按照"m-key:trans_id"形式拼接为 string，用sha256 算法加密生成的string得到sign签名；m-key可通过【穿山甲媒体平台】找到【GroMore 聚合管理】入口，搜索对应的广告位ID，编辑该广告位获取安全密钥即可。
• sign签名示例：

• 约定返回参数：

**注意：按照SDK要求需要服务器判断的回调URL是一个get请求 默认返回的是一个json字符串

• 返回参数示例：

• 错误码说明：

2. 实现示例

Android端

iOS端

常见问题FAQ

【Q】在GroMore 广告位id下，我们还添加了其他广告平台的广告进代码位当中（例如快手和优量汇），那在这种情况下，是不是也不用在其他平台去配置服务器回调呢？还是说其他广告平台的广告需要我们单独去做激励视频S2S的校验判断？

【A】不需要，统一在GroMore 侧配置 ；在GroMore 的广告位id 、下面配置服务器回调，所有的广告都会统一走GroMore 的服务器回调，不需要单独在ADN平台配置服务器回调 ；如果想要单独使用ADN的服务器回调，就不需要使用GroMore 的，单独在ADN的服务器设置回调URL就可以了

【Q】激励视频服务端回调,对于服务端地址，有什么要求吗？

【A】符合对接文档要求即可，另外，不建议设置ip地址的链接，将回调地址更换为域名路径，使用ip地址可能部分穿山甲机房无法访问成功

【Q】开启了GroMore 激励回调但服务器没收到消息是什么问题？

【A】服务器回调只要设置了回调URL，GroMore 都会进行访问，一般收不到回调可能的原因是回调URL没有办法访问或拼接参数之后无法访问，可以先自行排查，如有修改回调URL，正常15分钟-30分钟左右生效

【Q】服务器接收到同一个广告多次回调请求的情况是什么原因？

【A】GroMore 在网络环境不好的情况下会有重试请求，可以根据transid做一下去重

附：

GroMore 目前支持服务端激励回调，优先推荐使用，当配置GroMore 服务端回调功能时无需在代码位层级配置各adn的服务端回调，二者配置其一即可；如未使用GroMore 服务端激励回调功能，开发者如需要服务端回调需要在三方adn后台开启相关功能并设置相关参数，支持服务端奖励发放三方ADN说明文档如下：

• 穿山甲：https://www.csjplatform.com/supportcenter/5416
• 优量汇：https://developers.adnet.qq.com/doc/android/union/union_reward_video
• 快手：https://static.yximgs.com/udata/pkg/KS-Android-KSAdSDk/doc/4701b963d40a77bc0f45fd71d30b57da.pdf
• Sigmob：https://doc.sigmob.com/Sigmob%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97/%E5%B9%B3%E5%8F%B0%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97/%E6%BF%80%E5%8A%B1%E8%A7%86%E9%A2%91%E6%9C%8D%E5%8A%A1%E7%AB%AF%E9%AA%8C%E8%AF%81/