文档中心 > JSSDK文档

抽奖

更新时间:2017/08/07 访问次数:24684
抽奖

调用抽奖,异步接口。若使用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"
        }
    }
}

FAQ

Tida.draw抽奖常见错误码

应用内多次抽奖(Tida.draw)逻辑的展示处理

返回
顶部