活动配置:观影券、礼品卡、兑换码
创建观影券类型、批量生成礼品卡、配置兑换码,以及它们与充值、会员、推广的联动。
「活动配置」是营销工具集合,包含 6 个页面,属于需要订阅授权的功能:
| 页面 | 路由 | 作用 |
|---|---|---|
| 观影券管理 | /activityConfig/viewing-ticket |
定义「券类型」(能解锁什么、权限值、有效期) |
| 观影券记录 | /activityConfig/viewing-ticket-records |
观影券发放与使用流水 |
| 礼品卡管理 | /activityConfig/gift-card |
批量生成可兑换的卡号 |
| 礼品卡兑换记录 | /activityConfig/gift-card-redeem-records |
谁在何时兑换了哪张卡 |
| 兑换码配置 | /activityConfig/redeem-code-config |
创建活动口令 |
| 兑换码记录 | /activityConfig/redeem-code-records |
兑换码兑换明细 |
三者的关系:观影券是「附加权益」,可以挂在充值档位、会员套餐、礼品卡、兑换码、推广奖励上发给用户;礼品卡适合生成不同卡号逐张发放;兑换码适合一个口令公开投放。用户在前台的「活动兑换」页输入卡号/口令领取权益。
步骤章节(点击跳转)
观影券类型、礼品卡批量生成、兑换码口令的配置流程,以及各自的记录页和上线检查。
观影券管理
观影券给用户「可解锁视频的次数」。券类型只定义能解锁什么、需要多高权限、是否过期、是否启用;用户拿到多少张由发放入口决定。
新增或编辑观影券
| 配置项 | 说明 |
|---|---|
| 观影券是否启用 | 禁用后不再参与发放和前台使用 |
| 券编码 | 唯一编码,建议英文、数字、下划线,如 normal_ticket、vip_ticket;不能为空、不能重复 |
| 券名称 | 用户和管理员看到的名称,如「普通观影券」 |
| 权限值 | 可解锁内容的等级,必须 ≥ 0;券的权限值需满足视频的权限要求 |
| 排序值 | 列表/下拉排序参考,常用 10、20、30 |
| 适用范围 | 全部视频 / 指定分类(填分类 ID)/ 指定视频(填视频 ID) |
| 是否永久有效 / 统一到期时间 | 关闭永久有效时必须填写;到期后该类型券不可使用 |
| 备注 | 发放渠道、活动说明等 |
适用范围只决定「能不能用于这个视频」,权限值仍会参与判断:一张指定分类券如果权限值不够视频的要求,依然不能解锁。建议让券的权限值与会员类型使用同一套等级(如普通 10、黄金 20、钻石 30)。已被发放或产生流水的券不能删除(系统会阻止)。
用户如何获得与使用
| 发放入口 | 在哪里配置 |
|---|---|
| 充值档位 | 支付管理 → 收费配置 → 推荐充值档位 |
| 会员套餐 / 单片购买优惠套餐 | 支付管理 → 会员套餐 |
| 礼品卡、兑换码 | 本章下文 |
| 推广奖励 | 用户管理 → 用户推广 |
用户在前台使用时,系统检查:持有该券且剩余数量 > 0;券已启用且未超过到期时间;权限值满足视频要求;适用范围覆盖当前视频;该视频是可单片购买的视频且用户尚未购买。满足则在单片购买弹窗出现「观影券解锁」,选用后消耗 1 张并解锁当前视频。用户的账号管理页能看到各类券的剩余数量、适用范围和到期时间。
| 场景 | 推荐配置 |
|---|---|
| 通用活动券(拉新、充值赠送) | 适用范围「全部视频」,权限值与普通付费内容一致 |
| 分类专用券(专题促销) | 「指定分类」+ 活动分类 ID |
| 指定视频券(单片推广、客服补偿) | 「指定视频」+ 视频 ID,权限值至少覆盖该视频要求 |
礼品卡管理
类型与批量生成
| 类型 | 权益 |
|---|---|
| 余额卡 | 增加账户余额 |
| 会员卡 | 指定会员类型 + 会员时长 |
| 混合卡 | 余额 + 会员,三类都可额外附加观影券 |
点击「新增礼品卡」进入批量生产抽屉,配置的是「单张卡模板」,批量生成同一套权益:
| 配置项 | 说明 |
|---|---|
| 批次号 | 2-6 位英文字母,自动转大写,如 VIP、NEWUSER 的缩写 |
| 礼品卡名称 / 类型 | 如「新用户会员体验卡」;类型决定核心权益 |
| 开始时间 / 结束时间 | 为空分别表示「立即可用」「永久有效」;开始不能晚于结束 |
| 余额金额(元) | 余额卡、混合卡必填且 > 0 |
| 会员类型 / 会员时长 | 会员卡、混合卡必填;时长单位:小时、天、周、月、季、年 |
| 观影券 / 赠送数量 | 可选;选券后数量必须 > 0 |
| 批量生成数量 | 1-100,也可点快捷数量 10、20、50、100 |
| 备注 | 投放渠道、规则等 |
生成出的卡默认「未兑换」,每张卡只能成功兑换一次。已生成的卡只允许修改开始/结束时间,不能改卡号、名称和权益——权益错了请停用/删除后重新生成。
状态与操作
| 状态 | 可用操作 |
|---|---|
| 未兑换 | 查看、编辑有效期、停用、删除、导出 |
| 已兑换 | 仅查看详情(含兑换用户、时间) |
| 已过期 | 仅查看详情 |
| 已禁用 | 查看、编辑有效期、启用、删除 |
停用只适用于未兑换的卡;启用只适用于已禁用的卡(仍受有效期限制);删除只适用于未兑换或已禁用的卡;批量停用/删除会自动跳过不可操作的卡。
导出当前页:把当前列表页导出为 CSV,可选列有卡号(必选)、名称、类型、观影券、状态、有效期、创建人、创建时间。导出前先用筛选(卡号、类型、状态、创建人、到期时间、创建时间)定位目标批次,避免把其他活动的卡号一并导出。
前台兑换条件
用户在「活动兑换 → 礼品卡兑换」输入卡号,系统检查:卡号格式正确;类型与卡号匹配;未兑换、未禁用、未过期且已到开始时间;所配会员类型/观影券仍可用。成功后到账余额/会员/观影券,前台展示最近兑换记录。
兑换码配置
礼品卡「一卡一码」,兑换码「一个口令多人领」。
| 配置项 | 说明 |
|---|---|
| 兑换码编号 | 用户输入的口令,不能为空/重复,保存时统一转大写,建议短而易输入,如 NEWUSER2026、VIP7DAY |
| 兑换码名称 | 活动名称,前台兑换结果和记录会展示 |
| 兑换码模式 | 单码(定向、少量发放)/ 通用码(公开口令);模式只用于运营区分,真正限制总次数的是「最多兑换次数」和「用户是否已兑换过」 |
| 兑换类型 | 余额 / 会员 / 混合,必填项同礼品卡 |
| 最多兑换次数 | 填 0 表示不限制总次数(注意活动成本) |
| 观影券 / 数量 | 可选附加权益 |
| 启用状态 | 未准备投放时建议先禁用 |
| 开始/结束时间 | 为空分别表示立即可用 / 永久有效 |
兑换码创建后不提供直接编辑权益的入口,权益配置错了请停用旧码、重新创建。
| 场景 | 推荐 |
|---|---|
| 新用户体验码 | 会员类,1-7 天,限制次数 |
| 社群口令码 | 通用码 + 有效期 + 最多兑换次数控制成本 |
| 客服补偿码 | 单码,小额余额或指定视频券,次数设为 1 |
| 观影券礼包码 | 只附加观影券,配合适用范围 |
记录页
观影券记录、礼品卡兑换记录、兑换码记录用于核对发放与兑换流水,排查「用户说没领到」时优先查看。