用户资产数字化 · 数据格式与调用规范
用途：卡若AI 与玩值电竞/存客宝后台共用的用户资产数字化统一格式；确保后台用户数据清晰、可深度调用，含 RFM、联系方式、消费记录、主播/电竞绑定、消费能力关系。
维护：卡若AI 运营中枢；玩值电竞、存客宝、老坑爹等数据源对齐本规范后写入各自独立副本或库表。
更新：2026-02-26
一、用户资产数字化格式（单条用户记录）
以下字段为「一条用户资产数字化」记录的标准结构，后台库表/独立副本均按此设计，便于统一查询与深度调用。
1.1 身份与标识
| 字段名 |
类型 |
说明 |
必填 |
userId / userAssetId |
string |
用户唯一标识（存客宝/系统内部 ID 或 unionId） |
是 |
name |
string |
姓名/昵称 |
是 |
source |
string |
数据来源标识，如 ckb / lkdie / quwanzhi / game_deep |
建议 |
1.2 联系方式（须在库内清晰可查）
| 字段名 |
类型 |
说明 |
必填 |
phone |
string |
手机号 |
建议 |
wechatId |
string |
微信号（企微/个微） |
建议 |
email |
string |
邮箱 |
可选 |
contactRemark |
string |
联系方式备注（如「优先微信」） |
可选 |
1.3 RFM 格式（统一结构，可深度聚合）
| 字段名 |
类型 |
说明 |
必填 |
rfm.recency |
string (ISO 日期) 或 number (时间戳) |
R：最近一次消费/互动时间 |
建议 |
rfm.frequency |
number |
F：消费或互动次数（订单数、互动次数） |
建议 |
rfm.monetary |
number |
M：累计消费金额（元） |
建议 |
rfm.score |
string 或 number |
可选：R/F/M 综合分或分层（如 A/B/C/D/E/S） |
可选 |
1.4 用户估值（值多少钱）
| 字段名 |
类型 |
说明 |
必填 |
valuation |
number |
单用户估值（元） |
建议 |
valuationAt |
string (ISO 日期) |
估值计算/快照时间 |
可选 |
1.5 详细地址
| 字段名 |
类型 |
说明 |
必填 |
province |
string |
省 |
建议 |
city |
string |
市 |
建议 |
district |
string |
区 |
可选 |
address |
string |
详细地址 |
可选 |
addressSource |
string |
来源：如 ckb_import / order_shipping / device_ip |
可选 |
1.6 消费记录（可展开或汇总）
| 字段名 |
类型 |
说明 |
必填 |
totalSpent |
number |
累计消费金额（元），与 RFM.M 一致 |
建议 |
orderCount |
number |
订单数，与 RFM.F 可一致 |
建议 |
firstOrderAt |
string (ISO 日期) |
首单时间 |
建议 |
lastOrderAt |
string (ISO 日期) |
末次消费时间，与 R 一致 |
建议 |
consumptionRecords |
array 或 link |
消费明细（可另表存储，此处为关联或最近 N 条） |
可选 |
1.7 用户旅程（关键节点）
| 字段名 |
类型 |
说明 |
必填 |
firstTouchAt |
string (ISO 日期) |
首次添加/注册/触达时间 |
建议 |
firstOrderAt |
string (ISO 日期) |
首单时间 |
建议 |
lifecycleStage |
string |
生命周期阶段：如 new / nurture / mature / churn |
可选 |
tags |
string[] |
标签/分层：如 LV2_体验、成熟期、来源_抖音 |
可选 |
1.8 主播/电竞绑定（与主播列表可关联）
| 字段名 |
类型 |
说明 |
必填 |
boundStreamerId |
string |
当前绑定主播 ID（玩值电竞侧为主播唯一标识） |
可选 |
boundStreamerName |
string |
当前绑定主播名称（冗余便于列表展示） |
可选 |
boundExpiresAt |
string (ISO 日期) |
绑定过期时间 |
可选 |
boundAt |
string (ISO 日期) |
绑定时间 |
可选 |
gameCategory |
string |
所属电竞/游戏品类：如 魔兽、英雄联盟、三角洲 |
可选 |
说明：主播列表侧需能按 boundStreamerId 聚合，查出「该主播下绑定的用户列表」；用户侧可查「该用户绑在哪个主播、哪个电竞」；二者关系清晰可深度调用。
1.9 消费能力关系（用于分层与运营）
| 字段名 |
类型 |
说明 |
必填 |
tier |
string |
消费能力分层：如 金融客户 A/B/C/D/E/S 级、或 LV1～LV5 |
可选 |
avgOrderAmount |
number |
客单价（元） |
可选 |
repurchaseCount |
number |
复购次数 |
可选 |
1.10 元数据
| 字段名 |
类型 |
说明 |
必填 |
importBatchId |
string |
导入批次号（复制到副本时用） |
建议 |
createdAt / updatedAt |
string (ISO 日期) |
创建/更新时间 |
建议 |
二、后台数据来源与分到卡若AI 的对应关系
以下数据源（来自后台 KR 等库）按「用户资产数字化」格式整理后，可复制到独立副本并供卡若AI/玩值电竞统一调用；不直接映射覆盖现有业务 users 表。
| 后台数据源（示例） |
记录量级 |
在本规范中的用途 |
分到卡若AI 的方式 |
| 存客宝用户资产 |
约 19.6 万 |
用户主记录、联系方式、基础 RFM |
按 §1 格式导出/复制到 ckb_user_assets 或卡若AI 可读的存储，卡若AI 通过规范字段名深度调用 |
| 用户估值 |
约 1437 万 |
单用户估值、R/F/M 结果 |
补足到用户资产记录的 valuation、rfm 字段 |
| 用户资产整合 |
约 1437 万 |
多源整合视图，与「用户估值」联合使用 |
同上，作为补足来源 |
| 游戏_深度用户有过语音聊天、魔兽等 |
约 10.5 万 |
电竞/游戏行为、可关联主播与品类 |
补足 gameCategory、可选绑定主播；老坑爹等电竞项目用户形式 |
| 老坑爹商店/论坛（lkdie） |
商店 31、论坛 2480 |
老坑爹体系用户、消费与互动 |
按 §1 格式纳入副本，source=lkdie，可与玩值电竞主播/电竞绑定关系联合展示 |
| 黑科技 quwanzhi.com |
231 |
玩值系行为数据 |
同上，source=quwanzhi，可关联电竞/主播 |
| 金融客户_厦门_A～S 级 |
A 426～S 1417 等 |
消费能力分层（tier）、RFM 分级 |
补足 tier、rfm.score，用于消费能力关系分析 |
原则：上述数据在后台保持清晰；导出或同步时按本规范 §1 字段名与类型写入独立副本；卡若AI 与玩值电竞后台统一按本规范做查询、聚合、与主播列表关联，实现深度调用。
三、主播列表与用户关系的深度调用
- 主播维：主播列表可展示「该主播下绑定用户数、绑定用户列表（userId/姓名/联系方式/RFM/消费能力）」；数据来源为带
boundStreamerId 的用户资产记录。
- 用户维：单用户可查「当前绑定主播 ID/名称、所属电竞品类、绑定过期时间」；来源即 §1.8 字段。
- 调用方式：后台 API 或库表查询按
boundStreamerId 聚合、按 userId 查详情；玩值电竞侧 streamerBindings 与独立副本用户资产可做只读关联（如通过 userId/手机/微信号关联），不互相覆盖。
四、消费能力关系的深度调用
- 按 tier 分层：如 A/B/C/D/E/S 或 LV1～LV5，用于名单筛选、运营策略、融资展示。
- 按 RFM 聚合：按
rfm.monetary、rfm.frequency 排序/分桶，得到高价值、高复购用户列表。
- 按游戏/电竞：
gameCategory 与 boundStreamerId 联合，可分析「某电竞或某主播下的用户消费能力分布」。
五、与玩值电竞、卡若AI 的衔接
| 项目 |
说明 |
| 玩值电竞 |
独立副本（如 ckb_user_assets）结构与本规范 §1 对齐；用户管理/报表只读该副本；主播列表与用户绑定关系按 §3 实现；详见《玩值电竞_存客宝用户资产数字化与用户管理对接方案》。 |
| 卡若AI |
本规范存放在卡若AI 工作台，作为「用户资产数字化」的权威结构定义；需要查用户价值、RFM、联系方式、主播绑定、消费能力时，统一按本规范字段名与类型对接各数据源或副本。 |
| 老坑爹/其他项目 |
老坑爹等用户数据按 §1 格式补足后写入各自或统一副本，source 标识来源；主播/电竞绑定与消费能力关系同上。 |
文档版本：v1.0
维护：卡若AI 运营中枢；与玩值电竞存客宝方案、后台实际表结构同步更新。
