uni-AD App端激励视频服务器回调使用指南

HBuilderX 2.7.0 版本起，uni-AD的激励视频广告支持穿山甲的服务器回调功能
HBuilderX 3.1.15 版本起，uni-AD的激励视频广告支持优量汇、快手的服务器回调功能

概述

激励视频服务端回调是指在用户看完激励视频达到奖励条件时，广告平台服务端会向开发者服务端发送一个验证请求，同时客户端会给出onVerify回调，开发者根据回调进行奖励发放，不同的广告平台onVerify回调和服务端验证请求时机不一样(比如：穿山甲的onVerify回调是在服务端验证请求之后进行的，优量汇和快手都是同时进行的)，因为优量汇和快手的奖励回调onVerify事件和服务端验证请求是同时发送的，且开发者后台收到验证请求可能会有延迟或网络原因上的失败，所以开发者需要平衡用户体验与奖励验证。

相对来讲服务器回调将更加安全，可以依赖广告平台的反作弊机制来避免用户模拟观看广告完成的事件。

开通服务器回调

1. 登录uni-AD后台
2. 找到应用对应的广告位，配置激励视频
3. 选择服务空间，如果没有点击新增即可
4. 选择 业务在传统服务器, 输入接收服务器回调的http地址

App端创建激励视频广告时传入回调参数

uni-app项目

https://uniapp.dcloud.io/api/a-d/rewarded-video

5+ App（WAP2APP）项目

创建激励视频广告plus.ad.createRewardedVideoAd时传入服务器回调数据urlCallback，示例如下：

  adReward = plus.ad.createRewardedVideoAd({  
    adpid: '1507000689',  
    urlCallback: {  
      userId: 'test111111',   //可选的透传参数  
      extra: 'testdata'   //可选的透传参数  
    }  
  });

调用激励视频广告对象的onVerify监听服务器是否发送验证请求
穿山甲：

adReward.onVerify(function(e){  
   console.log('服务器发送验证请求且回调校验完成');  
   var provider= e.provider;  
   var valid = e.isValid;   //获取校验结果  
  //valid为true表示通过了服务器的校验，false表示可能没有通过服务器的校验，或是服务器延迟或失败(此时需增加逻辑：轮询向服务器请求并验证结果)  
});

优量汇：

adReward.onVerify(function(e){  
   console.log('服务器已发送验证请求');  
   var provider= e.provider;  
   var transId = e.transId;   
  需增加逻辑：轮询向服务器请求并验证结果  
});  

快手：

adReward.onVerify(function(e){  
   console.log('服务器已发送验证请求');  
   var provider= e.provider;  
  需增加逻辑：轮询向服务器请求并验证结果  
});