调用抽奖,异步接口。若使用TidaSDK自带UI,则不用关心结果是什么,直接将结果缓存下来。调用Tida.showDrawResult时传入回调结果即可。 若需要定制化UI,需要将对应奖品结果数据进行自行定制开发
注意:抽奖是否中奖判断一定需要正向判断,即判断对应中奖时一定要解析结果集里面对应的awardType才能真正认定为中了该奖品
返回结果里面的bool型值会被转成字符串类型,需要特别注意
商家奖池权益平台: https://mouton.admin.tmall.com/benefitplatform/index 需要商家帐号或其子帐号登录,选择:“自建活动-->互动到店配置”,按照指引完成奖池配置。配置完成后会生成对应的抽奖码。
商家奖池仅支持红包与优惠券,若其它类型的奖品需要走官方奖池,那么需要品牌商与官方对应的运营小二协调资源配置
/**
* 展示中奖信息
*
* @memberOf Tida
* @name draw
* @param option {Object} 参数参数
* @param option.asac {string} 安全码
* 每个需要抽奖的应用需要申请安全码,找与你对接的运营小二索要。
* @param option.campaignId {string} 抽奖码,若由官方出具的奖池,需要传入该字段
* @param option.interactId {string} 抽奖码,商户在配置奖池后可以在详情中拿到
* @param option.shopId {string} 店铺ID
*
* @param callback {function} 抽奖回调 结果数据因奖品类型不同,extra内字段不同,详见奖品结果数据
*
*/
Tida.draw(option,function(result){
// 伪代码 假设有个array类型变量为drawResultList 存储只为展示用
drawResultList.push(result);
});
奖品结果数据
// awardType: 优惠券interactCoupon,商品优惠券interactItemCoupon
{
"data": {
"awardId": "5441858",
"awardName": "0822测试优惠券",
"awardType": "interactCoupon",
"extValue1": "263693041",
"extValue2": "610445430",
"extValue3": "5.01",
"extValue4": "5.0",
"extValue5": "{\"startDate\":\"2016-08-22 00:00:00\",\"shopName\":\"B2C小店68\",\"shopId\":\"58498830\",\"endDate\":\"2016-12-31 23:59:59\"}",
"extra": {
"ext1": "5.0",
"ext2": "{\"startDate\":\"2016-08-22 00:00:00\",\"shopName\":\"B2C小店68\",\"shopId\":\"58498830\",\"endDate\":\"2016-12-31 23:59:59\"}",
"sellerId": "263693041",
"value": "5.0",
"attribute": "{\"startDate\":\"2016-08-22 00:00:00\",\"shopName\":\"B2C小店68\",\"shopId\":\"58498830\",\"endDate\":\"2016-12-31 23:59:59\"}",
"startFee": "5.01"
},
"groupId": "1",
"isWin": "true",
"nick": "t**1",
"reason": "",
"winningRecordId": "2756324022",
"winningTime": "2016-09-19 14:45:42"
},
"succ": "true"
}
//awardType: mouCommonFpRedEnvelope和fpRedEnvelope 都是红包
{
"succ": "true",
"data": {
"awardId": 2540609,
"awardName": "支付宝红包",
"awardType": "mouCommonFpRedEnvelope", // 糊口类型
"extra": { // 奖品结果数据
"value": "0.1" // 红包面额
},
"groupId": 1,
"isWin": true, // 是否中奖 注意true可能是字符串类型的true
"nick": "b**d",
"reason": "",
"winningRecordId": 783478103,
"winningTime": 1444362224769
}
}
//awardType: 定向优惠 finalPrice
{
"succ": "true",
"data": {
"nick": "t**2",
"groupId": "1",
"isWin": "true",
"reason": "",
"winningRecordId": "778457001",
"winningTime": "2015-10-08 09:58:08",
"awardId": "2560569",
"awardType": "finalPrice",
"awardName": "【天猫官方测试请不要拍不发货不退款后果自负】倩儿测试赠品2",
"extValue1": "42756234974",
"extValue2": "0.01",
"extValue3": "263693041",
"extValue4": "2.0",
"extValue5": "{\"picUrl\":\"//img.alicdn.com/bao/uploaded/i4/TB1pEUzGXXXXXXBXpXXXXXXXXXX_!!0-item_pic.jpg\",\"itemUrl\":\"//detail.tmall.com/item.htm?id\\u003d42756234974\"}",
"extra": {
"oPrice": "2.0",
"price": "0.01",
"ext1": "2.0",
"ext2": "{\"picUrl\":\"//img.alicdn.com/bao/uploaded/i4/TB1pEUzGXXXXXXBXpXXXXXXXXXX_!!0-item_pic.jpg\",\"itemUrl\":\"//detail.tmall.com/item.htm?id\\u003d42756234974\"}",
"pic": "{\"picUrl\":\"//img.alicdn.com/bao/uploaded/i4/TB1pEUzGXXXXXXBXpXXXXXXXXXX_!!0-item_pic.jpg\",\"itemUrl\":\"//detail.tmall.com/item.htm?id\\u003d42756234974\"}",
"itemId": "42756234974"
}
}
}