营销类场景
2024.03.13 15:46:30
公共参数和接口参数详情参考普通场景下的请求参数。
不同场景下建议传递不同的extData,普通场景见普通场景、社交类场景见社交场景、电销类场景见电销场景、支付类场景见支付场景
1. 抽奖时(触发抽奖事件时)
用户点击开启抽奖
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
sourceChannel | string | 建议参数 | 用户进入活动的渠道,字段内容可自定义。如无,可传空 | |
preCondition | string | 建议参数 | 标记用户是否已经满足抽奖条件,比如:0满足;1不满足。如无,可传空 |
2. 抽奖结果
用户参与抽奖活动,抽奖结束后
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
result | int | 强烈建议 | 抽奖结果(是否中奖),比如:0没中奖,1中奖 | |
awardID | string | 建议参数 | 用户获取到的奖品ID,可自定义。如无,可传空 | |
awardValue | int | 建议参数 | 奖品折算后的价值(不一定对应人民币等货币单位)。如无,可传空 |
3. 领券
用户领取优惠券
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
couponType | string | 强烈建议 | 用户领取的优惠券的类型。如无,可传空 | |
couponValue | int | 强烈建议 | 优惠券金额(货币:人民币,计量单位:元) | |
couponSource | string | 建议参数 | 优惠券来源类型,可自定义。如无,可传空 | |
validity | int | 建议参数 | 优惠券有效时长(-1表示长久有效) |
4. 抢红包
用户参加抢红包活动、社区里面抢红包
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
prize | int | 强烈建议 | 红包金额(货币:人民币,计量单位:元) | |
redPacketType | string | 建议参数 | 红包来源,可自定义。如无,可传空 | |
redPacketOwner | string | 建议参数 | 如果红包来源用户,则传递发红包者的用户ID |
5. 发起拼团
用户发起拼团
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
groupID | string | 强烈建议 | 团ID | |
commodityID | string | 强烈建议 | 团商品ID | |
commodityPrize | int | 建议参数 | 商品单价(货币:人民币,计量单位:元) | |
discounts | int | 建议参数 | 团商品优惠金额(货币:人民币,计量单位:元) |
6. 参与拼团
用户参与拼团
- extData Json内容:
参数名 | 类型 | 传入说明 | 描述 | 备注 |
---|---|---|---|---|
groupID | string | 强烈建议 | 团ID | |
commodityID | string | 强烈建议 | 团商品ID | |
groupOwner | string | 强烈建议 | 团拥有者账号ID | |
commodityPrize | int | 建议参数 | 商品单价(货币:人民币,计量单位:元) | |
discounts | int | 建议参数 | 团商品优惠金额(货币:人民币,计量单位:元) |