# 营销活动

「营销活动」是 Raise 的营销与促销管理应用。你可以在应用中创建发券与抽奖活动、生成与导入券码、在核销台进行线下门店核销、处理实物与课程包兑奖，并查看活动的领取、核销与成交漏斗。访客在绑定的站点页面上领券和抽奖，员工在应用中完成配置、核销与履约。

## 谁能用

营销活动通过权限控制操作范围。助手不能直接改活动，写入须经你确认后执行。

| 权限标签 | 清单说明 | 默认分配 |
|---|---|---|
| 「查看活动」 | 查看活动、券、奖池与参与记录（数据范围：本人创建的、归属部门内的、全部） | 成员、分析员 |
| 「创建与修改活动、奖池、补货」 | 创建与修改活动、券、奖池，补货、导入与生成券码，维护门店 | 成员且仅本人活动 |
| 「发布、暂停与结束活动」 | 发布活动、暂停、恢复与结束；启用新的奖池版本 | 无（管理员） |
| 「核销」 | 在核销台核销券（数据范围：所属部门的门店） | 成员 |
| 「撤销核销」 | 撤销已核销的券，需要写明原因 | 无（管理员） |
| 「处理兑奖」 | 处理实物与课程包奖品的兑奖：填写收货信息、发货、完成、销毁个人信息 | 成员 |
| 「查看统计」 | 查看活动统计与漏斗 | 成员、分析员 |

权限在界面上的表现：
- 组织管理员拥有全部权限且数据范围为「全部」；审计员拥有只读权限，无写入权限。
- 若你访问超出数据范围的活动，系统提示「没有找到，或你没有权限查看」。
- 若缺少对应权限，系统提示「你的角色没有」后接对应权限标签再接「权限」。
- 仅拥有「核销」权限的人员（如门店收银员）进入应用后直接进入「核销台」，不显示活动列表。

## 怎么打开

1. 在[工作台](/guide/workspace)左侧进入「增长」套件，点击「活动」页签（应用壳标题显示为「活动」）。
2. 在浏览器中输入地址访问：`https://campaign.apps.{base}`。

工作台或助手打开活动、券、核销或兑奖时，会落到对应页面。

应用顶部导航包含以下入口：
- 核心页面：「核销台」「活动」「兑奖」（角标显示待填地址与待发货的待处理笔数）。
- 图标入口：「统计」「设置」。

访客在绑定的[站点](/apps/site)页面上参与领券、抽奖与兑奖，不登录本应用。

## 界面一览

![「活动」列表，已有进行中的券活动](/shots/campaign-list.webp)

图：「活动」列表，已有进行中的券活动

1. 「核销台」：到店核销优惠券
2. 页内导航：「活动」列表
3. 「兑奖」：实物奖品的地址与发货
4. 「新建活动」：先建草稿，再加券和奖池
5. 按状态筛选：草稿、进行中、已暂停、已结束

| 页面 / 区域 | 主要内容与功能 |
|---|---|
| 「活动」列表 | 展示活动卡片列表。提供「新建活动」按钮；支持按「全部」「草稿」「进行中」「已暂停」「已结束」筛选；提供「搜索活动名称」搜索框；卡片展示活动起止时间、状态徽章、券数量、抽奖标识、参与资格、绑定站点以及「浏览」「领取」「抽奖」「核销」「成交」五步漏斗概况。 |
| 新建与编辑 | 分为「基本信息」「参与资格」「券」「抽奖」「机会规则」「发布前检查」六个配置分区。底部显示保存状态，提供「创建草稿」或「保存」按钮。 |
| 活动详情 | 包含「概览」「券码」「奖品与库存」「参与记录」「中奖名单」「兑奖」选项卡。顶部提供「编辑」「发布」「恢复」「暂停」「结束」「删除」操作按钮。 |
| 「概览」 | 展示「参与情况」指标卡（浏览、领取、抽奖、核销、成交）与漏斗图；展示规则说明、参与资格、耗尽规则、抽奖机会规则、中奖名单公示设置与活动包含的券与奖品列表。 |
| 「券码」 | 展示券码池进度与领用数量；提供「补货」「导入券码」「导出」操作；支持按状态筛选与搜索券码明细。 |
| 「奖品与库存」 | 展示当前生效奖池的奖品名称、类型、权重、中奖概率、库存与已抽中数；提供奖品「补货」入口；展示「库存流水」与历史下线版本。 |
| 「参与记录」 | 切换查看「领取记录」与「抽奖记录」；抽奖记录支持「只看中奖」与「导出抽奖记录」；单条抽奖记录提供「复盘」抽奖权重区间与计算逻辑。 |
| 「中奖名单」 | 员工端查看完整中奖记录；提示活动页前端脱敏公示状态。 |
| 「核销台」 | 专供收银核销。多家门店时顶部出现「选择门店」下拉（自动记住上次选择）；只有一家时只显示店名。输入框支持扫码枪自动录入或手动输码；展示券信息与有效期；满减券和折扣券都要填「订单金额（元）」计算实付；核销成功生成核销单号；成功卡和「最近核销」行按钮是「撤销」，已核销卡片才是「撤销这次核销」；右侧展示该门店「最近核销」记录。无店时整页空态「你还没有可以核销的门店」。 |
| 「兑奖处理」 | 处理实物与课程包兑奖。包含「待填地址」「待发货」「已发货」「已完成」「发放失败」「已取消」状态页签；抽屉展示收货信息与物流详情；提供填写地址、发货、标记到店自提完成、重试发放、取消兑奖与销毁收货信息操作。 |
| 「统计」 | 查看单个活动的统计报表。选择「最近 7 天」或「最近 30 天」；展示浏览、领取、抽奖、核销、成交五项核心指标；提供每日参与曲线图、活动漏斗图、券领取与核销分布图、各奖品的公示概率与实际占比对比图，并支持展开数据表格。 |
| 「设置」 | 展示只读的平台「奖品价值上限」；管理门店列表，支持添加门店、修改门店名称与部门编号、启用或停用门店。 |

## 常用操作

### 添加门店

1. 确认你拥有「创建与修改活动、奖池、补货」权限。
2. 在应用顶栏右上角点击「设置」。
3. 点击「添加门店」。
4. 填写门店信息：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「门店名称」 | 是 | 填写门店名称。输入框最多 60 字，保存时最多 40 字，占位提示「例如：南山店」。同名门店不能重复创建 |
   | 「对应部门（可空）」 | 否 | 填写组织中的部门编号。配置后，核销权限限定为该部门的员工才能核销该门店的券；留空则仅拥有全门店核销权限的人员可核销 |
5. 点击「添加」。保存后门店出现在列表中，状态默认为启用。

> **提示**
>
> 若组织中尚未添加任何门店，核销台整页显示「你还没有可以核销的门店」，不能核销；券的适用门店也会默认对所有门店开放。

### 新建活动草稿

![「新建活动」：先填基本信息并创建草稿](/shots/campaign-new.webp)

图：「新建活动」：先填基本信息并创建草稿

1. 「基本信息」：规则说明发布前必填
2. 「券」：草稿建好后才能添加
3. 活动名称：员工和顾客都会看到
4. 「创建草稿」：先存草稿，再加券和奖池

1. 在顶栏点击「活动」，进入活动列表。
2. 点击右上角「新建活动」。
3. 在「基本信息」分区填写活动基础配置：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「活动名称」 | 是 | 填写活动名称（最多 80 字），输入框提示「员工和顾客都会看到，如「国庆满减券」」 |
   | 「开始时间」 | 否 | 选择开始时间。不填表示活动发布后马上开始 |
   | 「结束时间」 | 否 | 选择结束时间。不填表示长期有效。若填写，结束时间必须晚于开始时间 |
   | 「规则说明」 | 是 | 填写对顾客展示的活动规则，输入框提示「参加的人看得到，写清怎么参加、怎么领奖。」 |
   | 「主办方」 | 否 | 填写主办方全称（最多 80 字），建议在规则说明中一并体现 |
   | 「绑定站点（可空）」 | 否 | 填入[站点](/apps/site)编号。绑定后活动页面将发布在该站点上；仅做线下发券时可不绑定 |
4. 在「参与资格」分区选择允许参加的人群：
   - 「任何人」：打开页面即可参加，无需登录或留手机号。
   - 「验证身份的人」：参加前需通过微信授权或手机验证码确认为真人（新建时默认推荐）。
   - 「仅已有客户」：仅限已在客户名单中的人员参加。
5. 点击底栏「创建草稿」。创建成功后提示「草稿已创建，接着添加券和奖池」。

**规则说明提醒**

「规则说明」下方会提示是否提到了「活动时间」「奖项设置」「兑奖方式」「主办方」。这仅为提醒提示，系统不会审核文字内容，也不会因未提及而阻止发布。

### 添加优惠券

![草稿活动上「添加券」：满减券的名称、形式和门槛](/shots/campaign-voucher.webp)

图：草稿活动上「添加券」：满减券的名称、形式和门槛

1. 券的名称：顾客看得到
2. 券的形式：满减、折扣、服务券或兑换码
3. 「满减券」：满多少减固定金额
4. 减多少钱
5. 使用门槛：订单满多少才能用

1. 进入活动编辑页面，点击「券」分区。
2. 点击「添加券」。
3. 在弹窗中填写券信息：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「券的名称」 | 是 | 填写券名称（最多 60 字），输入框提示「顾客看得到，例如「新客满 100 减 20」」 |
   | 「券的形式」 | 是 | 选择券类型：「满减券」「折扣券」「服务券」「兑换码」 |
   | 「减多少钱」 / 「减百分之几」 | 是 | 满减券填写立减金额；折扣券填写减免比例（1 到 99 的整数，例如 10 表示减 10%，即 9 折） |
   | 「最多减多少钱」 | 否 | 折扣券可选填写优惠金额上限，留空表示不设上限 |
   | 「使用门槛」 | 否 | 填写订单满多少元可用。减免金额不得大于门槛金额。留空表示无门槛 |
   | 「有效期」 | 是 | 选择「领取后 N 天」（填写 1 到 3650 的整数天数）或「固定起止日期」（选择有效开始与结束日期） |
   | 「总量」 | 否 | 填写预生成券码的数量。留空表示不限量，领券时实时生成 |
   | 「每人限领」 | 是 | 填写单人限领张数（1 到 100 的整数） |
   | 「领取窗口（可空）」 | 否 | 设置领券的开始与结束时间。留空表示活动期间随时可领 |
   | 「适用门店」 | 否 | 勾选允许核销的门店。不勾选表示全部门店均可核销 |
4. 点击「添加券」。保存后券卡片展示在列表中，默认处于「启用」状态。

> **注意**
>
> 活动一旦发布并运行过，券的优惠内容与规则不能再做修改，只能通过开关切换「启用」状态。若需调整条款，请新建一张券并将旧券关闭。

### 配置抽奖与奖池

1. 进入活动编辑页面，点击「抽奖」分区。
2. 配置抽奖设置：
   - 「奖品发完后」：选择「归给「谢谢参与」（推荐）」或「其他奖按比例分走」。
   - 「公开中奖名单」：开启后活动页滚动展示脱敏名单，可选择「名单怎么显示中奖人」为「昵称」或「手机号后四位」。
3. 点击「添加抽奖」，系统生成一个空的草稿奖池版本。打开编辑器时会预填一行「谢谢参与」（权重 90）和一行券奖品（权重 10），并标为未保存。
4. 在草稿奖池中配置奖品：
   - 「这一版的备注（可空）」：填写员工可见的备注说明（最多 120 字）。
   - 可再点「添加「谢谢参与」」加空奖行。奖池中必须包含至少一行「谢谢参与」。
   - 点击「添加奖品」添加中奖奖品（单个奖池最多 20 个奖品）：
     | 字段 | 必填 | 说明 |
     |---|---|---|
     | 奖品名称 | 是 | 填写奖品名称（如「一等奖 · 空气炸锅」） |
     | 「类型」 | 是 | 选择「谢谢参与」「券」「权益包」「实物」 |
     | 「权重」 | 是 | 填写大于等于 0 的整数权重，系统会实时计算中奖概率 |
     | 「库存」 | 否 | 填写库存数量，留空表示不限库存。空奖不支持设置库存 |
     | 「价值」 | 否 | 填写奖品参考价值，用于系统校验是否超过平台价值上限 |
     | 类型专属配置 | 是 | 券需选择已创建的「奖品券」；权益包需填写「权益发放方」（[会员](/apps/membership)填 `membership.package`）与「权益包编号」；实物需填写「兑奖说明（怎么领奖、寄送地址由谁填）」 |
5. 点击「保存奖池」，提示「奖池已保存」。
6. 检查实时计算的概率与奖池问题，确认无误后点击「生效」。在弹出的确认窗口中点击「确认生效」。生效后权重锁定不可修改。

### 设置抽奖机会规则

1. 在活动编辑页面点击「机会规则」分区。
2. 填写机会参数：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「每人每天基础次数」 | 是 | 填写每日默认赠送的抽奖次数。界面校验 0 到 1000 的整数，保存时服务端要求 0 到 100。填 0 表示只能通过分享获得抽奖机会 |
   | 「分享一次加几次」 | 是 | 填写顾客每成功分享一次增加的抽奖次数 |
   | 「分享每天最多加几次」 | 是 | 填写每天通过分享可额外获得的最大抽奖次数上限。若分享加次数大于 0，必须设置此上限 |
3. 点击底栏「保存」。

### 发布活动

1. 在活动编辑页面点击「发布前检查」分区，或在活动详情页点击「发布」。
2. 查看系统列出的检查项：
   - 「阻止发布」：必须先解决对应问题（如未填规则说明、未设置券或奖品、奖池权重为 0、缺少「谢谢参与」等），否则无法发布。
   - 「提醒」：建议关注的项目（如未填写主办方、未设置结束时间等），不影响发布。
   - 「通过」：已符合要求的项目。
3. 解决全部阻止项后，点击「发布活动」。
4. 在编辑页确认弹窗「发布这个活动？」中，点击「确认发布」。若从活动详情点「发布」，确认框标题是「发布」后接活动名加问号。
5. 编辑页成功提示「活动已发布」；详情页成功提示「活动已发布，访客现在可以参加了」。活动状态变更为「进行中」。若发布时没有已生效的奖池，系统会自动将最新的草稿奖池升为生效。

> **注意**
>
> 活动发布后将立即对外公开，访客可以开始领券与抽奖。发布过的活动无法直接删除，后续只能执行暂停或结束操作。

### 暂停、恢复与结束活动

1. 确认你拥有「发布、暂停与结束活动」权限。
2. 进入活动详情页：
   - **暂停活动**：点击「暂停」，弹窗提示「访客不能再领券、抽奖；已领的券仍可核销。可随时恢复。」，点击「暂停」。暂停后状态变更为「已暂停」。
   - **恢复活动**：在已暂停状态下点击「恢复」，确认框是「恢复这个活动？」，点「恢复」后服务端再跑发布前检查，状态恢复为「进行中」。
   - **结束活动**：点击「结束」，弹窗提示「结束后不能恢复，访客不能再领券、抽奖；已领的券仍有效。」，点击「结束活动」。状态变更为「已结束」。

> **危险**
>
> 活动一旦「结束」将不可撤销，无法重新恢复或启动。若需重新开展活动，必须新建活动。

### 券码补货与批量导入

1. 进入活动详情页，点击「券码」选项卡。
2. 选择对应的优惠券：
   - **生成新码（补货）**：点击「补货」，输入「补多少个」（单次最多 50 000 个），点击确认。系统将在原券码池基础上追加生成新码。
   - **批量导入券码**：点击「导入券码」，可手动在输入框按行粘贴券码，或点击「选择文件」上传 `.csv` 或 `.txt` 文件（文件 ≤5 MB，单次最多 200 000 个，自动读取第一列并跳过标题行）。系统识别有效码、重复码与格式错误码后，点击「导入」。
   - **导出券码**：点击「导出」，下载包含券码、状态、来源与领取时间的 CSV 文件。

### 奖品库存补货

1. 进入活动详情页，点击「奖品与库存」选项卡。
2. 在生效奖池列表中找到需要补库存的奖品，点击操作列的「补货」。
3. 在弹出的补货对话框（标题为「补货：」后接奖品名）中填写：
   - 「补货原因」：必填，至少 2 个字（例如「新到一批货，补 50 份」）。
   - 「补多少」：填写大于 0 的整数数量。
4. 点击确认。补货成功后库存增加，操作记录自动写入下方的「库存流水」中。补货操作只能增加库存，不能减少库存。

### 在核销台核销优惠券

![核销台：选门店、输入券码](/shots/campaign-desk.webp)

图：核销台：选门店、输入券码

1. 页头：「核销台」
2. 门店：核销记在哪一家
3. 券码：扫描枪或手输，回车查找

1. 在顶栏点击「核销台」（收银人员进入应用后默认落在此页）。
2. 多家门店时，在顶部「选择门店」下拉框中确认或选择当前所在的门店；只有一家时只显示店名。
3. 在「券码」输入框中使用扫码枪扫码，或手动输入顾客出示的券码按回车（系统会自动去除空格并转换为大写字母）。
4. 系统查询后展示券状态卡片：
   - 若状态为「可以核销」，查看券名称、优惠说明、有效期与适用门店。
   - 若为满减券或折扣券，在「订单金额（元）」输入框中填入顾客的消费金额，界面将显示本单优惠金额与顾客实付金额。
5. 点击大按钮「核销」。核销成功后界面展示「核销成功」、大号「核销单号」、核销时间、门店与操作人。
6. 点击「核销下一张」继续处理下一位顾客。

> **提示**
>
> 若查询提示「没有找到这张券，请核对券码」，请检查是否输错字符，尤其注意区分数字 0 与字母 O、数字 1 与字母 I 或 L。扫码枪无法识别时可手动输入。

### 撤销核销

1. 确认你拥有「撤销核销」权限（默认仅管理员拥有）。
2. 在核销成功卡片上点击「撤销」，或在核销台右侧「最近核销」列表中找到误核销的记录，点击「撤销」。已核销卡片上的按钮是「撤销这次核销」。
3. 在弹窗「撤销这次核销」中填写「撤销原因」（必填，至少 2 个字，如「收银时点错了，顾客没有消费」）。
4. 点击「确认撤销」。撤销成功后系统提示「已撤销，这张券恢复可用」，该券恢复为可用状态，顾客可再次使用。已撤销的核销单不能重复撤销。

### 处理实物奖品兑奖与发货

1. 在顶栏点击「兑奖」，进入兑奖处理列表（角标显示待处理笔数）。
2. 根据奖品流转阶段进行操作：
   - **代填或修改收货信息**：在「待填地址」页签中点击对应记录打开抽屉，点击「填写收货信息」或「修改收货信息」，输入收件人姓名、电话与收货地址（地址至少 6 个字），点击保存。保存后记录移入「待发货」。
   - **发货**：在「待发货」页签中点击记录打开抽屉，点击「发货」，填写「快递公司」与「快递单号」，点击「确认发货」。记录移入「已发货」。
   - **到店自提**：若中奖顾客选择到店领取实物，在「待发货」抽屉中点击「已到店领取，标记完成」，记录直接移入「已完成」。
   - **标记完成**：在「已发货」抽屉中，确认物品送达后点击「标记完成」。
   - **取消兑奖**：若顾客主动放弃或地址无法送达，在待发货状态下点击「取消」，填写取消原因后确认。取消后无法恢复。

### 处理课程包发放失败与重试

1. 当抽中的奖品为权益包（课程包）时，系统会自动向[会员](/apps/membership)应用发起发放。
2. 若中奖人当时尚未办理会员，系统将拒绝发放，该记录进入兑奖列表的「发放失败」页签。
3. 联系中奖顾客协助其办理会员身份。
4. 顾客成为会员后，在「发放失败」列表中打开抽屉，点击「重试发放」。发放成功后状态变更为「已完成」。

### 销毁收货信息

1. 确认你拥有「处理兑奖」权限。
2. 针对已发货或已完成兑奖的实物奖品记录，在详情抽屉中点击「销毁收货信息」。
3. 弹出确认弹窗「销毁收货信息？」，系统提示「收件人、电话、地址将永久销毁；兑奖状态和处理记录保留。」。
4. 点击「销毁」。界面只有这一次确认。销毁后收件人姓名、电话与地址彻底删除，兑奖状态与处理日志保留供审计查验。助手提出销毁时才会再要你验证身份。

> **危险**
>
> 收货信息销毁后不可恢复。尚未发货的奖品切勿执行销毁，否则必须联系顾客重新填写。

### 查看统计与复盘抽奖

1. 在顶栏右上角点击「统计」（需同时具备「查看统计」与「查看活动」权限）。
2. 在顶部下拉框中选择要分析的活动，选择时间范围为「最近 7 天」或「最近 30 天」。
3. 查看顶部五项核心指标卡：「浏览」（绑定站点产生的请求数）、「领取」、「抽奖」、「核销」与「成交」。
4. 查阅图表：
   - 「每天的领取、抽奖和核销」趋势图。
   - 「活动漏斗」人次图。
   - 「每种券的领取和核销」分布图。
   - 「各奖品的公示概率与实际占比」对比图。点击图表下方的「查看数据」可查阅详细数值。
5. **复盘抽奖算法**：进入活动详情页的「参与记录」选项卡，切换至「抽奖记录」，点击任一记录的「复盘」。系统会展示当时的随机数数值、总权重、各奖品当时占用的权重区间，以及该随机数落入的具体区间说明。

### 搜索与删除草稿活动

1. **搜索与筛选**：在活动列表顶部，点击「按状态筛选」切换「全部」「草稿」「进行中」「已暂停」「已结束」；在「搜索活动名称」输入框中输入关键字，列表自动筛选。
2. **删除草稿**：
   - 仅限从未发布过的草稿活动可以删除。
   - 进入活动详情页，点击右上角「删除」。
   - 在弹窗「删除这个草稿？」中确认说明「草稿及其券、奖池会一起删掉，不能找回。」，点击「删除」。草稿活动被永久删除。

## 状态说明

### 活动生命周期状态

```
草稿 ──发布──> 进行中 ──暂停──> 已暂停
                │               │
                ├───恢复────────┘
                │
                └───结束───────> 已结束（不可恢复）
```

| 状态 | 说明 | 允许的操作 |
|---|---|---|
| 「草稿」 | 活动尚未对外公开，仅内部有权限人员可见。 | 可修改全部基础信息、券、奖池与规则；可删除草稿；检查通过后可发布。 |
| 「进行中」 | 活动已对外公开，访客可以领券与抽奖。已领取的券可在核销台核销。 | 仅可修改活动名称、延后结束时间、调整中奖名单展示方式；不能新增券，不能提前结束时间；已有券只能开关「启用」；可暂停或结束活动。 |
| 「已暂停」 | 活动暂时停止对外领券与抽奖。已领取的券在有效期内仍可正常核销。 | 可添加新券、新建奖池版本；已运行过的券不能改条款，只能开关「启用」；可恢复为进行中；可直接结束活动。 |
| 「已结束」 | 活动已终止。访客无法再领券或抽奖；已领取的券在有效期内仍可继续核销，未完成的兑奖可继续处理。 | 不能再修改，不能恢复，不能删除。若需重新开展请新建活动。 |

### 奖池版本状态

奖池采用版本管理：
- `草稿`：新创建的奖池版本。在此阶段可添加奖品、设置权重与库存。
- `生效中`：当前活动实际运行的奖池。对外公示的权重锁定，不能直接修改。若需调整奖品或概率，须新建草稿版本，待编辑完成后执行启用替换。
- `已下线`：曾生效但已被新版本替换的历史奖池。仅供记录与数据复盘查验。

### 兑奖状态流转

- 实物奖品：`待填地址` →（填入收件信息）→ `待发货` →（发货填单）→ `已发货` →（送达确认）→ `已完成`。在「待发货」状态下若顾客到店自提，可直接标记为「已完成」。若顾客放弃可变更为「已取消」。
- 课程包（权益包）：中奖后由系统自动发放，发放成功直接进入 `已完成`；若中奖人非会员导致发放被拒，进入 `发放失败`，顾客开通会员后点击「重试发放」成功变更为 `已完成`。

### 券核销状态

在核销台查询券码时，常见状态如下：
- `可以核销`：券有效且在有效期与可用门店范围内，可输入金额核销。
- `这张券已经核销过了`：该券已被核销。卡片会显示核销人、时间与门店。
- `这张券已过期`：已超出券设置的有效期限。
- `还没到使用时间`：尚未达到券的生效开始日期。
- `这家门店不能核销这张券`：券限定了适用门店，当前核销台选择的门店不在允许范围内。
- `这张券已退回` / `这张券已作废`：券已失效，无法核销。

## 让助手帮你做

助手在营销活动应用中仅具备读取权限，无法绕过界面直接发起底层接口写入。助手可以通过起草[草稿](/agent/drafts)或发起[动作确认](/agent/confirm)协助你完成业务。

你可以这样对助手说：
> 帮我创建一个国庆大促的活动草稿，参与资格设为验证身份的人。
> 给国庆大促活动添加一张满 200 减 30 的满减券，总量 2000 张。
> 帮我把国庆活动的抽奖奖池加一个空气炸锅实物奖，权重设为 10。
> 检查国庆活动是否满足发布条件，没问题就发布。
> 暂时暂停国庆大促活动。
> 核销券码 ABCD1234EF，订单金额 260 元。
> 帮我把顺丰速运单号 SF12345678 填到中奖人发货信息里。

### 交互模式与确认机制

| 操作类别 | 界面动作 | 交互方式 | 风险级别 |
|---|---|---|---|
| 活动与券草稿起草 | 「新建活动」「修改活动」「新建券」「修改券」「新建奖池版本」「编辑奖池」「添加门店」「修改门店」 | 助手起草[草稿](/agent/drafts)，由你在应用的审阅页接受 | 低 |
| 活动生命周期控制 | 「发布活动」「暂停」「恢复」「结束活动」「生效」 | 助手在对话中发起[动作确认](/agent/confirm)，由你逐项确认后以本人身份执行 | 高 |
| 券码与库存维护 | 「补货」「导入券码」 | 助手在对话中发起[动作确认](/agent/confirm)后执行 | 低 |
| 核销与撤销 | 「核销」「撤销这次核销」 | 助手在对话中发起[动作确认](/agent/confirm)后执行 | 高 |
| 兑奖与履约 | 「填写收货信息」「发货」「标记完成」「重试发放」「取消兑奖」 | 助手在对话中发起[动作确认](/agent/confirm)后执行 | 低 / 高 |
| 敏感数据与删除 | 「删除活动草稿」「删除券」「销毁收货信息」 | 助手在对话中发起[动作确认](/agent/confirm)，销毁信息需二次验证 | 高 |

## 设置

拥有「创建与修改活动、奖池、补货」权限的管理员可以在顶栏「设置」页面中进行管理：

| 设置项 | 作用 | 取值范围 / 说明 | 谁能改 |
|---|---|---|---|
| 「奖品价值上限」 | 单个奖品的价值不能超过该设定值。超过上限的活动无法通过发布检查 | 平台统一定义（默认 ¥50,000），本应用内只读显示 | 平台管理员统一配置，应用内不可改 |
| 「门店」 | 维护可核销的门店列表。券可限定部分门店可用；核销员只能核销所属部门对应的门店 | 最多维护 500 家门店。门店名称输入框最多 60 字、保存时最多 40 字，并填写对应部门编号 | 拥有「创建与修改活动、奖池、补货」权限的成员 |

## 注意事项

- **规格与数量限制**：
  - 每个组织最多创建 500 个活动。
  - 每个活动最多添加 20 种券、50 个奖池版本；单个奖池最多容纳 20 个奖品。
  - 单次生成券码上限为 50 000 个；单张券总发行量上限为 5 000 000 张。
  - 批量导入券码文件大小不得超过 5 MB，单次最多导入 200 000 个券码。
  - 组织最多创建 500 家门店。
- **不可恢复与不可修改操作**：
  - 活动一旦发布对外，不能删除，只能暂停或结束。活动结束后不可恢复。
  - 进行中的活动只能延后结束时间，不能提前结束时间；不能添加新券；不能直接修改已生效奖池的权重。
  - 奖池生效后权重锁定，修改必须新建版本后启用替换。
  - 只有从未发布过的草稿活动可以删除，删除后券与奖池草稿一并清空，不能找回。
  - 销毁收货信息后，中奖人姓名、电话与收货地址连同密钥彻底删除，无法恢复。
- **权限与数据范围隔离**：
  - 活动查看与管理受数据范围控制（本人创建、归属部门、全部）。
  - 收银人员核销受部门门店权限限制，无法跨门店核销未授权门店的券。
  - 统计页面需同时拥有「查看统计」与「查看活动」权限方可正常列出活动报表。
- **跨应用协同**：
  - [站点](/apps/site)：活动须绑定站点后，访客方可在对应站点页面领券、抽奖与填写收货信息；浏览量由站点请求统计汇入。
  - [会员](/apps/membership)：课程包奖品发放依赖会员体系，非会员中奖会进入发放失败队列，待开通会员后手动重试。
  - 线上订单抵扣与线下门店核销共享券码状态，同一张券不可重复核销；线上抵扣不计入本应用的线下核销台统计。

## 目前不支持

- 拼团、秒杀、砍价等营销玩法。
- 活动模板市场与 A/B 测试。
- 抽奖保底机制、内定中奖人或按人调整中奖概率。
- 积分奖励、红包与现金类奖品。
- 在本应用内进行线上订单的抵扣操作。
- 在应用界面中直接调整平台的奖品价值上限。
- 访客短信验证码发送与未登录访客的设备指纹防刷。
- 门店部门选择器下拉选择（当前需手动填写部门编号）。

## 常见问题

#### 为什么活动进行中无法添加新券或修改抽奖概率？
为了保障对外公示规则的严肃性与合规性，活动进行中禁止添加新券，生效奖池的权重也被严格锁定。如果你需要调整券或概率，必须先在活动详情页点击「暂停」活动。暂停后可添加新券或新建奖池版本（已有券仍不能改条款），确认生效后再点击「恢复」活动。

#### 活动结束后可以重新恢复进行吗？
不能。活动一旦点击「结束」，状态将永久变更为「已结束」，系统不支持恢复或重新启动。如果需要再次开展同类活动，请点击「新建活动」重新创建草稿并发布。

#### 收银员在核销台查询券码时提示「没有找到这张券，请核对券码」是什么原因？
常见原因包括：券码输错了一位、误将数字 0 与字母 O 或数字 1 与字母 I/L 混淆、该券码尚未被访客领取、或者扫码枪读取格式不全。建议核对顾客手机上的原始券码重新手动输入。

#### 实物奖品发货完成后，为什么建议执行「销毁收货信息」？
为了保护中奖顾客的个人隐私并满足合规要求，实物奖品发货完成或送达后，拥有权限的人员可以在抽屉中点击「销毁收货信息」。系统会彻底删除中奖人的姓名、电话和地址，同时保留兑奖状态与处理日志，既保护了顾客隐私，又不影响内部审计。

#### 为什么抽奖统计里的「实际占比」和奖池的「公示概率」不完全一致？
抽奖采用服务端固定随机算法。抽奖次数较少时，小样本下的实际中奖比例与理论概率存在统计偏差属正常现象。此外，若活动设置了「奖品发完后」为「归给「谢谢参与」」，当某个奖品库存发完后，其后续抽中份额会转移至「谢谢参与」，导致「谢谢参与」的实际抽取比例高于公示概率。