Loyalty 客户数据导入操作手册

一、核心流程总览（以Smile为例）

Smile 系统导出客户数据 → Loyalty 系统下载导入模板 → 按模板规则清洗匹配数据 → 上传文件至 Loyalty 系统 → 系统自动格式校验 → 启动 Loyalty 数据导入 → 查看导入历史与结果 → 失败数据下载错误报告→修正后重导

二、详细操作步骤

（一）从Smile中导出客户信息

1. 操作路径：登录Smile APP → 进入「Customers（客户）」模块 → 点击「Filter and export（筛选并导出）」→ 选择「Download results（下载结果）」→ 勾选导出字段（需包含Points Balance、Member status、VIP tier）→ 选择「.CSV」格式下载文件。

2. 导出文件包含核心信息：客户姓名、邮箱、积分余额、会员状态、VIP等级、地址等（示例数据含邮箱、街道地址、所在城市/省份等）。

（二）安装Loyalty客户导入模板

1. 操作路径：登录Loyalty系统 → 进入「Settings（设置）」→ 找到「Customer data import（客户数据导入）」→ 点击「Download Template（下载模板）」，获取预格式化的CSV模板。

2. 模板核心字段（固定格式）：Email（必填）、Birthday（可选）、Available Points（可选）、VIP Tier（可选）。

（三）数据清洗与格式匹配

1. 核心要求：将Smile导出的CSV文件数据，按Loyalty模板的字段对应整理，所有字段必须正确格式化（错误格式的行将被跳过）。
2. 字段对应规则：
3. • Email：直接匹配Smile导出文件中的「Email」字段（必填，需确保无空值、格式正确，如[email protected]）；
   • Birthday：可选，格式示例「1990-1-15」（年-月-日，无则留空，不更新该字段）；
   • Available Points：可选，填写数字（无则留空，不更新积分）；
   • VIP Tier：可选，填写等级名称（如Gold、Silver、Platinum，无则留空，不更新等级）。
3. 注意事项：清洗后的数据文件需保留CSV格式，且字段顺序与模板一致。

（四）上传并导入数据

1. 操作路径：在Loyalty的「Customer data import」页面 → 点击「Select File（选择文件）」（或拖拽文件）→ 上传清洗后的CSV文件 → 系统验证通过后，点击「Start Import（开始导入）」。

• 验证提示：上传后系统会显示「Validation Passed（验证通过）」，并展示数据行数（Columns列数、Data Rows行数）。

（五）查看导入结果与错误处理

1. 导入状态查看：在「Import history（导入历史）」中，可查看每次导入的详细信息（开始时间、成功行数、失败行数、总行数）。

1. 结果说明：
2. • 成功示例：导入10行数据，显示「Success: 10 rows, Failed: 0 rows」，数据实时更新至Loyalty系统；

1. • 失败处理：若存在错误，显示「Failed: X rows」，点击「Download Error Report（下载错误报告）」，查看具体错误原因（如邮箱格式错误、VIP等级名称无效等），修正后重新导入。

三、关键注意事项

1. 导入前提：Loyalty系统中需已存在该客户信息（邮箱匹配），否则对应数据无法导入。
2. 字段规则：
3. 1. 必填字段「Email」不可为空，格式需符合标准（如[email protected]）；
   2. 可选字段不填写则不更新对应信息，填写错误则该行跳过；
   3. VIP Tier需填写系统支持的等级名称（如Gold/Silver/Platinum，不可自定义）。
3. 积分更新逻辑：
4. 1. 若导入积分＞当前积分：系统会记录积分增加量（如当前1129，导入1500，记录「+371」，最终显示1500）；
   2. 若导入积分＜当前积分：系统会记录积分减少量，最终显示导入的数值。
4. 数据生效时间：Smile导出数据的更新可能需要最长24小时同步，建议导出后确认数据最新再进行清洗导入。

四、导入结果示例

积分更新示例（客户[email protected]）