文档中心 > 店铺动态卡片-开发指引

尖货抢购

更新时间:2024/08/01 访问次数:6711

利用小程序引流,在小程序内完成尖货抢购。用户先进来商品排队,品牌根据排队信息,以及自定义的筛选算法,选择出符合条件能购买的用户。不符合条件的用户将不能购买。

 

一、流程说明

 

1.商家或者服务商创建尖货活动;

2.用户参与活动,加入排队;

3.商家或者服务商根据自定义的规则标记中签用户;

4.活动结束,中签用户可以购买商品,未中签用户不能购买。

 

1.客户端流程

image

2.服务端流程

image

 

二、应用创建

 

选择创建「购物小程序(自研接入)」,选择类目「商品导购」-「交易创新」-「尖货新品」,点击【确认类目】按钮。

 

image

2.png

 

三、服务端开发

1. 创建尖货活动

 

调用taobao.opentrade.activity.sync接口创建活动。

 

2. 查询活动信息

 

调用taobao.opentrade.activity.query查询活动信息。

 

3. 标记/取消中签用户

 

调用taobao.opentrade.queue.users.mark接口,可以标记中签用户(可以购买尖货的用户),也可以取消中签用户。

 

4. 查询排队信息

 

调用taobao.opentrade.queue.query接口,可以查看排队信息,包括哪些用户参与了排队,哪些用户中签了。

 

四、应用开发

 

应用开发的前提:

1)应用创建成功之后,选择创建[消费者端应用]

2)目前品牌尖货并未对所有商家或者服务商开放,需要联系运营小二授权品牌尖货能力。

 

1. 配置品牌尖货插件

 

在app.json文件中配置品牌尖货插件。

 

{
    "pages": [
        "pages/index/index"
    ],
    "plugins": {
        "brandOpenTrade": {
            "version": "*",
            "provider": "3000000002169551"
        }
    },
    "window": {
        "defaultTitle": "My App"
    }
}

 

2. 初始化应用,获取用户授权

 

在app.js文件中获取初始化参数,例如商品id,同时调用my.authorize接口,获取用户授权。

 

my.authorize({
  scopes: 'scope.userInfo',
  fail: (res) => {
    console.log('fail', res)
  },
  success: (res) => {
    console.log('success', res)
  }
})

 

3. 用户参与活动,加入排队

 

调用插件的joinQueue方法,让当前登录用户加入排队。

 

方法参数

name

require

explain

itemld

Y

商品id

skdld

N

商品SKU

quality

N

购买商品的数量,可不传,不传为1

activityld

N

活动ID

var plugin = requirePlugin("brandOpenTrade");
joinQueue(){
  plugin.joinQueue({
    itemId:624596639351,
    skuId:0,
    quality:1,
    activityId:"hs-test-activity-id",
    success(v){
      console.log('suc', v)
    },
    fail(v){
      console.log('fail', v)
    }
  })
}
 

 

4. 查询用户排队信息

 

调用插件的hasJoinQueue,判断当前用户是否加入排队。

 

方法参数

name

require

explain

itemld

Y

商品id

skdld

N

商品SKU

activityld

N

活动ID

hasJoinQueue(){
  plugin.hasJoinQueue({
    itemId: 624596639351,
    skuId: 0,
    activityId: "hs-test-activity-id",
    success(v){
      console.log('suc', v);
    },
    fail(v){
      console.log('fail', v);
    }
  })
}
 

 

5. 查询用户中签信息

 

调用插件的queryQueue方法,获取当前用户中签情况。

 

方法参数

 

name

require

explain

itemld

Y

商品id

activityld

N

尖货活动id

queryQueue(){
  plugin.queryQueue({
    itemId: 624596639351,
    activityId:0,
    success(v){
      my.alert({content:v.result})
    },
    fail(v){
      my.alert({content:v})
    }
  })
}

 

五、商家操作

 

应用上线后,商家访问个性化定制平台,就可以看到用来实现高级定制的商家应用。商家可以导入商品,将商品与应用进行绑定,注意只有未上架的商品才可以导入

 

image

 

点击导入商品,输入商品id即可导入商品。

FAQ

关于此文档暂时还没有FAQ
返回
顶部