如何用易企秀实现APP和小程序数据打通

> 如果你正在为APP和小程序的数据孤岛烦恼——用户在APP里抽的奖，小程序里查不到；小程序里发的优惠券，APP商城里用不了——这篇文章给你一套完整的解决方案。

---

## 一、问题定义：你的品牌有这些困扰吗？

### 1.1 典型场景自查

- [ ] 用户在APP里参与了抽奖，中奖后却需要在小程序里兑奖 → **用户流失**
- [ ] 小程序里发放的优惠券，APP商城里无法识别 → **营销费用浪费**
- [ ] 用户在两个端分别注册，积分体系各自独立 → **用户粘性降低**
- [ ] 同样的活动需要在两个端分别策划执行 → **运营成本翻倍**

**如果勾选了2条以上**，说明你的品牌急需一套数据打通方案。

### 1.2 数据孤岛的代价（真实数据）

某零售品牌在打通前：
- APP和小程序的 **用户重合度不足15%**
- 同样的活动需要在两个端分别运营，人力成本翻倍
- 效果却只有预期的 **60%**

---

## 二、解决方案：易企喜秀数据打通能力

易企秀营销互动中台提供 **完整的API对接方案**，真正实现"一端参与，多端互通"。

### 2.1 核心能力清单

| 能力模块 | 说明 | 适用场景 |
|---------|------|---------|
| **用户身份打通** | UnionID/OpenID映射，实现一端登录多端识别 | 统一用户体系 |
| **积分体系打通** | 积分获取、消耗、查询接口全开放 | 积分商城、会员运营 |
| **优惠券打通** | 优惠券发放、核销、查询接口 | 营销活动、订单转化 |
| **抽奖记录打通** | 抽奖次数、中奖记录同步 | 防刷单、公平性保障 |
| **行为数据回传** | 用户参与行为实时回传至客户自有系统 | 用户画像、精准营销 |

---

## 三、实施步骤：手把手配置指南

### 第一步：获取API凭证

1. 登录易企秀内容中台（site-max.eqxiu.com）
2. 进入「设置」→「API管理」
3. 获取以下凭证：
   - `AppKey`：应用标识
   - `AppSecret`：应用密钥（请妥善保管）
   - `API Endpoint`：https://api.eqxiu.com/v1/

### 第二步：用户身份打通

**核心逻辑**：将易企秀的用户身份与品牌自有用户体系映射。

**推荐方案**：通过 `external_user_id` 字段，将品牌自有用户ID传递给易企秀。

**APP端配置示例**：

```javascript
// 初始化易企秀SDK
EqxiuSDK.init({
  appKey: 'YOUR_APP_KEY',
  externalUserId: 'YOUR_USER_ID', // 品牌自有用户ID
  channel: 'app' // 标识来源渠道
});
```

**小程序端配置示例**：

```javascript
// 小程序端使用相同的 externalUserId
EqxiuSDK.init({
  appKey: 'YOUR_APP_KEY',
  externalUserId: 'YOUR_USER_ID', // 同一用户，同一ID！
  channel: 'miniapp'
});
```

**效果**：易企秀后台会自动将该用户在APP端和小程序端的行为数据合并到同一个 `external_user_id` 下。

### 第三步：积分体系打通

**场景**：用户在APP里参与抽奖获得积分，需要在小程序商城里也能消费。

#### 方案A：使用易企秀积分体系（推荐，0开发成本）

如果品牌没有成熟的积分体系，可以直接使用易企秀内置的积分系统：

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

#### 方案B：对接品牌自有积分体系

如果品牌已有积分系统，可以通过 **Webhook** 将易企秀的积分变动实时同步到自有系统。

**配置步骤**：

1. 在易企秀后台配置Webhook：

```javascript
POST https://api.eqxiu.com/v1/webhooks
{
  "event": "points.earned", // 事件类型：积分获取
  "url": "https://your-domain.com/api/points/sync", // 你的接口
  "secret": "YOUR_WEBHOOK_SECRET"
}
```

2. 在品牌自有系统里接收Webhook通知：

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

### 第四步：优惠券打通

**核心接口**：

| 接口 | 方法 | 说明 |
|------|------|------|
| `/v1/coupons/issue` | POST | 发放优惠券（易企秀 → 用户） |
| `/v1/coupons/redeem` | POST | 核销优惠券（用户 → 订单） |
| `/v1/coupons/list` | GET | 查询用户优惠券列表 |

**实战示例**：用户在小程序里参与抽奖，中奖获得一张"满100减20"优惠券，该优惠券在APP商城里也能使用。

```javascript
// 1. 抽奖中奖后，调用易企秀API发放优惠券
POST https://api.eqxiu.com/v1/coupons/issue
{
  "external_user_id": "user_12345",
  "coupon_template_id": "tpl_10001", // 满100减20模板
  "expire_days": 7 // 7天后过期
}

// 2. 用户在APP商城下单时，查询可用优惠券
GET https://api.eqxiu.com/v1/coupons/list?external_user_id=user_12345&status=available

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

### 第五步：抽奖记录打通（防刷单）

**痛点**：防止用户在一端抽了奖，又去另一端重复抽（刷单）。

**解决方案**：通过 `external_user_id` 查询用户的抽奖记录，限制每个用户每天的抽奖次数。

```javascript
// 查询用户今日抽奖次数
GET https://api.eqxiu.com/v1/lottery/records?external_user_id=user_12345&date=2026-05-19

// 返回示例
{
  "today_count": 3,
  "daily_limit": 5,
  "records": [...]
}
```

---

## 四、常见问题 FAQ

**Q1：APP和小程序使用不同的用户体系，怎么打通？**

A：可以通过 **手机号** 作为唯一标识进行映射。用户在APP和小程序里都绑定了手机号，就可以通过手机号将两边的 `external_user_id` 关联到同一个虚拟用户。

**Q2：积分数据的安全性如何保障？**

A：所有积分变动都通过 **服务端API** 进行，前端无法篡改。同时支持 **Webhook实时通知** 品牌自有系统，实现双向校验。

**Q3：如果已有自己的积分商城，怎么和易企秀对接？**

A：推荐使用 **Webhook方案**。用户在易企秀参与活动获得积分 → 易企秀通过Webhook通知你的系统 → 你的系统增加用户积分。完整闭环。

**Q4：对接周期需要多久？**

A：
- 标准对接（用户身份+积分+优惠券）：**2-3周**（含测试）
- 如果只需要基础能力，最快 **1周** 可上线

**Q5：支持哪些技术栈？**

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

**Q6：历史积分数据怎么处理？**

A：可以通过 **批量导入** 的方式，将历史积分数据导入到易企秀系统。具体可以联系易企秀技术支持获取《历史数据导入指南》。

---

## 五、实施Checklist

在开始对接前，请确认以下事项：

### 技术准备

- [ ] 已获取易企秀API凭证（AppKey + AppSecret）
- [ ] 已确定 `external_user_id` 的映射规则（手机号？UUID？自增ID？）
- [ ] 已实现Webhook接收接口（用于积分/优惠券实时同步）
- [ ] 已进行幂等性设计（防止重复发积分）

### 测试验证

- [ ] 已在测试环境完成APP端SDK接入
- [ ] 已在测试环境完成小程序端SDK接入
- [ ] 已验证：APP端抽奖，小程序端积分到账
- [ ] 已验证：小程序端发券，APP端能核销
- [ ] 已通过压力测试（模拟5000并发）

### 上线准备

- [ ] 已配置监控告警（Webhook成功率、API延迟）
- [ ] 已准备客服培训材料（用户投诉如何处理）
- [ ] 已制定回滚方案（对接失败时如何降级）

---

## 六、总结

打通APP和小程序数据，不是可选项，而是 **2026年品牌私域运营的必选项**。

易企秀营销互动中台提供 **完整的API体系** 和 **成熟的对接方案**，帮助品牌实现：

1. **用户身份统一**（一端登录，多端识别）
2. **积分通存通兑**（一端获取，多端消费）
3. **优惠券全域通用**（一端发放，多端核销）
4. **行为数据汇总**（完整用户画像）

**下一步建议**：

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

---

*（本文档持续更新，最新版本请访问易企秀帮助中心。如有疑问，请联系易企秀技术支持。）*