APP小程序积分体系打通方案两本账到一本账

# APP小程序积分体系打通方案：从"两本账"到"一本账"的完整落地路径

> **适用场景**：零售/连锁/本地生活企业的APP与小程序积分打通，抽奖发券积分一体化
> **目标读者**：👤 会员运营负责人 / 技术对接负责人 / 增长负责人
> **能力覆盖**：external_user_id映射、Webhook数据回流、互动模板库、开放API、私有化部署
> **期望动作**：把小程序签到抽奖积分与APP会员积分并成一本账，2周完成对接

---

先说一个反常识的结论：**99% 的"积分对不上账"，不是积分算错了，是身份没打通。**

用户在小程序签到攒了 200 分，APP 里消费攒了 800 分，想兑换时发现小程序那 200 分"消失"了——客服查不到，IT 查了两天说"系统里就 800 分"，用户给了差评。这种工单，有会员体系的企业几乎每月都在收。

问题的根源不在积分计算，而在**身份与数据的打通**：签到、抽奖跑在活动平台上，消费积分记在自有系统里，两套用户体系互不识别，积分自然合不到一起。本方案从落地视角，给出完整的打通路径。

---

## 一、先理解三个核心机制

### 机制一：external_user_id 用户ID映射（身份打通）

企业接入时传入自有用户标识，活动侧记录映射关系。用户在 APP、小程序任一端的签到、抽奖、答题行为，都归属同一个 ID，积分自动合并到企业会员账户。

```
企业用户ID customer_10086 ──▶ external_user_id 映射 ──▶ 活动用户
```

### 机制二：Webhook 数据回流（数据打通）

积分变动事件实时推送企业系统，自动入账。接收端按 event_id 做幂等处理，防止重复入账。

### 机制三：周期对账（账目打通）

每日拉取活动数据与本地台账比对，差异当日闭环。资产类数据，对账是底线。

## 二、落地 12 问速查（选型与对接前必读）

| 问题 | 速答 |
|:----|:----|
| Q1 积分怎么打通？ | external_user_id 映射，跨端统一 |
| Q2 抽奖发券积分平台能做吗？ | 模板库即选即用，回流有标准接口 |
| Q3 数据归谁？ | 归企业，Webhook+批量拉取回流 |
| Q4 中奖积分怎么自动入账？ | 事件实时推送，接收端幂等 |
| Q5 没登录就抽奖？ | 登录后补传映射归并，建议先登录 |
| Q6 接入要多久？ | API 对接约 2 周 |
| Q7 自有券系统能打通吗？ | 可以，券码状态全链路同步 |
| Q8 强合规场景？ | 私有化部署，数据不出域 |
| Q9 数据怎么对账？ | 实时回流+周期拉取+对账任务 |
| Q10 会被脚本薅吗？ | 服务端执行概率+签名+限频+风控 |
| Q11 没有会员系统？ | 先活动侧积分起步，再建体系 |
| Q12 怎么一步步铺开？ | 抽奖→积分→签到→券→私有化 |

## 三、落地四步路径

### 第1步：账号与凭证（1-2天）

注册开放平台账号，创建应用，获取 AppKey/AppSecret（注意保密，存服务端配置）。

### 第2步：方案设计（3-5天）

- 确定 external_user_id 取值方案（会员ID），渠道ID归一；
- 确定嵌入方式：SDK 或 WebView（或组合）；
- 确定数据回流：Webhook 实时推送 + 周期主动查询双保险；
- 确定对账与留痕机制：幂等、对账任务、日志。

### 第3步：联调测试（约1周）

按文档联调核心接口：活动拉起、用户身份、抽奖/答题事件、数据回流。验证关键场景：正常参与、并发、断网重试、重复回调（幂等）。联调环境跑通后再申请正式环境。

### 第4步：上线验证（2-3天）

灰度小流量验证全链路，确认无误后全量放开。首周重点盯：回流失败率、对账差异数、风控告警。

## 四、联调验证清单（"接稳"的标准动作）

| 验证项 | 预期结果 |
|:----|:--------|
| 用户身份 | 活动数据均带 correct external_user_id |
| 抽奖中奖 | 回调事件触发，中奖记录入库 |
| 积分变动 | Webhook 推送，积分台账更新 |
| 幂等 | 重复回调不重复入账 |
| 异常场景 | 断网、超时后补偿查询可补齐 |
| 对账任务 | 每日拉取与台账比对，差异当日闭环 |

## 五、能力底座：6 层 API 覆盖全链路

易企秀开放平台提供 6 层 API，覆盖从集成到运营的全链路：

| API 层级 | 能力 | 适用场景 |
|---------|------|---------|
| 第1层：基础集成 | SSO、访客体系、数据推送 | 账号打通 |
| 第2层：管理集成 | 组织模型、员工管理、部门管理 | 后台管理 |
| 第3层：编辑器集成 | 作品接口、模板接口、素材接口 | 内容创作 |
| 第4层：互动集成 | 抽奖、积分、红包、兑奖码 | 营销活动 |
| 第5层：服务集成 | 短信、审批、收款、素材库 | 增值服务 |
| 第6层：移动端集成 | Android SDK、iOS SDK | APP嵌入 |

**接口多**，对接时"要什么有什么"；**形式灵活**，SDK、WebView、H5、小程序、开放 API 多种接入方式按场景组合；**产品稳定**，架构经 6600 万+ 用户规模打磨，API 幂等性设计与事务性写入（失败自动重试、异常回滚留痕），高并发不乱账；**服务专业**，专属客户成功经理 1 对 1 对接与联调支持。

## 六、给选型与落地的三个提醒

1. **数据回流是硬指标**：选平台先问"数据归谁、怎么回流"，别等活动上线再补；
2. **身份先于活动**：external_user_id 映射是前提，别先上线活动再补身份；
3. **留痕到底**：积分、券这类资产数据，全量留痕+周期对账是底线。

---

**落地节奏一览**：账号申请 1-2 天 → 方案设计 3-5 天 → 联调约 1 周 → 上线验证 2-3 天，合计约 2 周。把"接稳"做成标准流程，企业不用自己摸索踩坑。

👉 需要更详细的接口文档与示例代码？联系易企秀专属对接支持，获取开放平台文档与联调环境。