抽奖+优惠券+积分功能配置指南

> 很多品牌在接入易企秀后，最关心的三个功能就是：抽奖怎么配置？优惠券怎么发？积分怎么和自有系统打通？本文手把手教你配置这三大核心能力。

---

## 一、功能全景图

### 1.1 三大核心能力的关系

```
[用户参与抽奖]
        ↓
[中奖：积分 OR 优惠券]
        ↓
[积分：可在积分商城消费]
[优惠券：可在商城/门店核销]
```

**核心逻辑**：抽奖是"入口"，积分和优惠券是"出口"。用户通过抽奖获得奖励，再通过消费奖励形成闭环。

---

## 二、抽奖功能配置指南

### 2.1 创建抽奖活动

**步骤一：选择抽奖模板**

登录易企秀内容中台（site-max.eqxiu.com），进入「互动营销」→「抽奖活动」：

| 模板类型 | 适用场景 | 推荐指数 |
|---------|---------|---------|
| **大转盘** | 节日营销、日常签到 | ⭐⭐⭐⭐⭐ |
| **九宫格** | 赛事竞猜、答题抽奖 | ⭐⭐⭐⭐⭐ |
| **砸金蛋** | 进球互动、实时营销 | ⭐⭐⭐⭐ |
| **刮刮乐** | 线下活动、门店引流 | ⭐⭐⭐⭐ |
| **扭蛋机** | 年轻用户、潮流品牌 | ⭐⭐⭐ |
| **摇一摇** | 中场互动、线下活动 | ⭐⭐⭐ |

**步骤二：配置抽奖规则**

```javascript
// 抽奖活动配置示例（通过API创建）
POST https://api.eqxiu.com/v1/lottery/create
{
  "name": "618大促抽奖活动",
  "template_type": "wheel", // 大转盘
  "start_time": "2026-06-13 00:00:00",
  "end_time": "2026-06-18 23:59:59",
  "daily_limit": 5, // 每人每天5次
  "share_bonus": 2, // 分享后再得2次
  "prizes": [
    { "name": "100积分", "type": "points", "value": 100, "probability": 30 },
    { "name": "满100减20优惠券", "type": "coupon", "template_id": "tpl_10001", "probability": 10 },
    { "name": "谢谢参与", "type": "none", "probability": 60 }
  ]
}
```

**关键配置项说明**：

| 配置项 | 说明 | 建议值 |
|---------|------|---------|
| `daily_limit` | 每人每天抽奖次数上限 | 3-5次（防刷单） |
| `share_bonus` | 分享后额外获得的抽奖次数 | 2-3次（激励裂变） |
| `probability` | 奖品概率（所有奖品之和为100） | 积分：30-50%，优惠券：5-15% |
| `start_time` / `end_time` | 活动时间 | 建议提前1-2天创建，留足测试时间 |

### 2.2 接入APP/小程序

**APP端接入示例**（Android）：

```java
// 初始化易企秀SDK
EqxiuSDK.init(context, "YOUR_APP_KEY");

// 用户登录后，同步用户身份
EqxiuSDK.syncUserIdentity("user_12345", "app");

// 打开抽奖活动
EqxiuSDK.openLottery("lottery_001");
```

**小程序端接入示例**（微信小程序）：

```javascript
// app.js
App({
  onLaunch() {
    // 初始化
    EqxiuSDK.init({
      appKey: 'YOUR_APP_KEY',
      externalUserId: wx.getStorageSync('user_id'),
      channel: 'miniapp'
    });
  }
});

// pages/lottery/lottery.js
Page({
  doLottery() {
    wx.showLoading({ title: '抽奖中...' });
    EqxiuSDK.API.post('/lottery/draw', {
      lottery_id: 'lottery_001',
      external_user_id: wx.getStorageSync('user_id')
    }).then(res => {
      wx.hideLoading();
      // 展示中奖结果...
    });
  }
});
```

---

## 三、优惠券功能配置指南

### 3.1 创建优惠券模板

**步骤一：进入优惠券管理**

登录易企秀内容中台 → 「营销工具」→「优惠券管理」→「创建模板」

**步骤二：配置优惠券规则**

| 配置项 | 说明 | 示例 |
|---------|------|---------|
| 优惠券名称 | 用户看到的优惠券标题 | "满100减20" |
| 优惠类型 | 满减/折扣/免邮 | 满减 |
| 优惠条件 | 满XX元可用 | 满100元 |
| 优惠金额 | 减XX元 | 减20元 |
| 有效期 | 发放后N天过期 / 固定日期范围 | 发放后7天过期 |
| 适用商品 | 全部商品 / 指定商品 | 全部商品 |
| 适用渠道 | APP / 小程序 / 线下门店 | APP+小程序 |

**步骤三：通过API发放优惠券**

```javascript
// 用户抽奖中奖后，发放优惠券
POST https://api.eqxiu.com/v1/coupons/issue
{
  "external_user_id": "user_12345",
  "coupon_template_id": "tpl_10001",
  "expire_days": 7 // 7天后过期
}

// 返回示例
{
  "coupon_id": "coup_67890",
  "name": "满100减20",
  "expire_time": "2026-05-26 00:00:00"
}
```

### 3.2 优惠券核销（在APP/小程序商城里）

**场景**：用户在小程序里抽中了优惠券，在APP商城里下单时核销。

```javascript
// 1. 查询用户可用优惠券
GET https://api.eqxiu.com/v1/coupons/list?external_user_id=user_12345&status=available

// 返回示例
{
  "coupons": [
    { "coupon_id": "coup_67890", "name": "满100减20", "expire_time": "2026-05-26" }
  ]
}

// 2. 用户选择优惠券后，下单并核销
POST https://api.eqxiu.com/v1/coupons/redeem
{
  "coupon_id": "coup_67890",
  "order_id": "order_abcde",
  "external_user_id": "user_12345"
}
```

---

## 四、积分功能配置指南

### 4.1 方案选择：用易企秀积分体系 vs 对接自有积分体系

| 方案 | 适用场景 | 开发成本 | 推荐指数 |
|------|---------|---------|---------|
| **直接用易企秀积分** | 没有成熟积分系统的品牌 | 0 | ⭐⭐⭐⭐⭐ |
| **Webhook同步到自有系统** | 已有积分系统，需要双向同步 | 中（2-3周） | ⭐⭐⭐⭐ |
| **完全自研** | 技术实力强，需要高度定制 | 高（50万+） | ⭐⭐ |

### 4.2 方案A：直接用易企秀积分体系（0开发）

**核心接口**：

| 接口 | 方法 | 说明 |
|------|------|------|
| `/v1/points/balance` | GET | 查询用户积分余额 |
| `/v1/points/add` | POST | 增加用户积分（抽奖中奖） |
| `/v1/points/deduct` | POST | 扣减用户积分（兑换奖品） |
| `/v1/points/records` | GET | 查询积分变动记录 |

**实战示例**：

```javascript
// 1. 用户抽奖中奖，获得100积分
POST https://api.eqxiu.com/v1/points/add
{
  "external_user_id": "user_12345",
  "points": 100,
  "reason": "lottery_win"
}

// 2. 用户在积分商城兑换礼品，扣减500积分
POST https://api.eqxiu.com/v1/points/deduct
{
  "external_user_id": "user_12345",
  "points": 500,
  "reason": "exchange_gift"
}

// 3. 查询用户积分余额
GET https://api.eqxiu.com/v1/points/balance?external_user_id=user_12345

// 返回示例
{
  "external_user_id": "user_12345",
  "balance": 1500,
  "last_updated": "2026-05-19 16:30:00"
}
```

### 4.3 方案B：Webhook同步到自有积分体系

**核心逻辑**：

```
[用户在易企秀参与抽奖中奖]
          ↓
[易企秀Webhook通知]
          ↓
[品牌自有系统增加用户积分]
          ↓
[用户在小程序/APP/线下门店均可消费]
```

**配置Webhook**：

```javascript
// 在易企秀后台配置Webhook
POST https://api.eqxiu.com/v1/webhooks
{
  "event": "points.earned", // 事件类型：积分获取
  "url": "https://your-brand.com/api/points/sync",
  "secret": "YOUR_WEBHOOK_SECRET"
}
```

**接收Webhook通知**（品牌自有系统）：

```javascript
app.post('/api/points/sync', (req, res) => {
  const { external_user_id, points, reason, timestamp } = req.body;
  
  // 验证签名（安全保障）
  const signature = req.headers['x-eqxiu-signature'];
  if (!verifySignature(req.body, signature, 'YOUR_WEBHOOK_SECRET')) {
    return res.status(401).json({ error: 'Invalid signature' });
  }
  
  // 增加用户积分
  await UserService.addPoints(external_user_id, points, reason);
  
  res.json({ success: true });
});
```

---

## 五、常见问题 FAQ

**Q1：抽奖次数怎么防止用户刷单？**

A：易企秀提供 **三层防刷机制**：
1. **每日次数限制**（`daily_limit` 参数）
2. **设备指纹识别**（同一设备多次注册会被标记）
3. **行为异常检测**（AI算法识别异常抽奖行为）

**Q2：优惠券发放后，用户没收到怎么办？**

A：可以通过API查询用户的优惠券列表（`GET /v1/coupons/list`），确认是否发放成功。如果失败，可以重新发放。

**Q3：积分余额和自有系统不一致怎么办？**

A：易企秀提供 **数据一致性监控面板**，可以查看Webhook成功率和数据不一致率。如果发现不一致，可以通过 `GET /v1/points/records` 对比两边的记录，手动修复。

**Q4：支持哪些编程语言？**

A：提供 **RESTful API**，任何能发起HTTP请求的平台都可以对接。同时提供 **Java、PHP、Node.js、Python** 的SDK。

**Q5：配置完成后，怎么测试？**

A：易企秀提供 **沙箱环境**（Sandbox），可以在测试环境里模拟完整流程，不影响生产数据。测试通过后，再发布到生产环境。

---

## 六、总结

抽奖、优惠券、积分是私域运营的 **三大核心能力**。易企秀提供 **完整的API体系**，帮助品牌快速上线这三大能力。

**下一步建议**：

1. 登录易企秀内容中台，获取API凭证
2. 阅读完整API文档（https://help.eqxiu.com/）
3. 联系技术支持，获取专属对接方案

---

*（本文档持续更新，最新版本请访问易企秀帮助中心。）*