04 · 营销工具¶
入口路径：后台 → 营销工具 目标读者：运营 / 副组长 / 客服主管 核心问题：怎么生成兑换码？怎么找回流失用户？怎么给在线 PWA/H5/APK 用户发推送通知？ 资料来源：
营销工具.png+营销工具子项.png+兑换码.png+创建兑换码.png+用户回访.png+客户端通知.png+创建客户端通知.png最后更新：2026-05-11 作者：Bob/Aimee
一、模块定位¶
"营销工具"是面向玩家的拉新、留存、唤回三件套：
| 子项 | 用途 | 触达对象 | 频率限制 |
|---|---|---|---|
| 兑换码 | 拉新 / 补偿 / 活动奖励发放 | 全体用户 / 指定 VIP / 指定渠道 | 无限制，按"生成数量"控量 |
| 用户回访 | 流失用户筛查与召回 | 按"最近 N 天未登录"过滤 | 查询型，无下发限制 |
| 客户端通知 | 实时推送（FCM 通道） | 全体已授权通知的用户 | 每天最多 5 条（图中右下提示） |
二、兑换码¶
2.1 功能定位¶
兑换码 = 预生成的现金 / 福利券，玩家在前台输入"兑换码"领取。常用于：
- 微信 / Telegram 私聊发码做线下拉新
- 客服对风控误伤玩家做手工补偿
- VIP 专属感恩回馈、节日福利
2.2 列表页¶
顶部筛选区¶
| 字段 | 含义 |
|---|---|
| 金额 ≥ | 数字过滤，找"单码面额 ≥ X" |
| 创建时间 | 开始 / 结束（GMT+8） |
| 使用对象 | 全部 / ❓ 子选项（应至少有"全体/指定层级/指定渠道"） |
| 状态 | 全部 / ❓ 应有：未使用/部分使用/全部用完/已过期 |
| 使用状态 | 全部 / ❓ |
| 类型 | 全部 / 现金 / ❓（可能含 宝箱 / 奖券 / 礼品） |
按钮：查询 / 导出 Excel / 创建（绿色）
表格列（12 列）¶
| 列 | 说明 |
|---|---|
| 类型 | 兑换类型（如"现金"） |
| 兑换码 | 系统生成的码（字符串） |
| 创建时间 GMT+8 | |
| 有效期 GMT+8 | 过期后自动失效 |
| 状态 | 在线 / 已过期 / 已用完 |
| 使用对象 | 全体用户 / VIP X / 渠道 X |
| 使用情况 | 已被多少人领取 |
| 可兑换次数 | 单码可被领取的总次数（即"生成数量"） |
| 已兑换 | 实际已领数 |
| 金额/类型 | 单码面额 + 类型 |
| 打码要求/数量 | 领取后必须打码多少倍 |
| 创建人 / 自定义 | 操作人 + 备注 |
2.3 创建兑换码弹窗¶
| 字段 | 截图当前值 / 含义 |
|---|---|
| 兑换类型 | 现金（下拉） ❓ 其他选项待用户确认（应至少有"宝箱/奖券"） |
| 使用对象 | 全体用户（下拉） ❓ 应可选"指定层级/指定渠道/指定 UID" |
| 生成数量 | 1（一次生成多少个不同的码） |
| 单码使用次数 | 1（每个码可被几个玩家领取，> 1 = 通用码） |
| 可兑换金额 | 1 ₱（单码面额） |
| 打码要求 | 0 ₱（领后必须打码量，0 = 立即可提） |
| 有效期 | 2026-05-14（日期选择器） |
| 谷歌验证码 | 必填 ✅（强校验，2FA 防滥发） |
| 确定 | 蓝色提交按钮 |
关键业务规则¶
| 规则 | 说明 |
|---|---|
| 单码 vs 通码 | "生成数量=N, 单码次数=1" → N 个一次性码（推荐做 1v1 私聊） "生成数量=1, 单码次数=N" → 1 个码 N 人领（适合公开活动） |
| 谷歌验证强制 | 每次创建都要 6 位 Google Authenticator 码，与 01-身份验证 联动 |
| 打码要求 | 写 0 = 当现金；写 ≥ 1 倍 = 赠金套娃 |
| 不可撤销 | 截图未见"作废"按钮 ❓ 待用户确认 |
2.4 典型操作流¶
flowchart TD
A["副组长决定补偿玩家 100 ₱"] --> B["营销工具 → 兑换码 → 创建<br/>生成数量=1, 单码次数=1, 金额=100 ₱<br/>打码要求=0（立即可提）<br/>有效期=今天 +3 天<br/>谷歌验证：输 6 位数 → 确定"]
B --> C["复制刚生成的"兑换码"字符串"]
C --> D["客服私聊：发码 + 「请前台→兑换码→输入此码」指引"]
D --> E["第二天列表查"使用情况"是否 1/1（已兑换）"]2.5 待确认¶
- 兑换类型下拉完整选项（现金/宝箱/奖券/礼品）❓
- 使用对象下拉完整选项（全体/层级/渠道/UID 列表）❓
- 作废 / 修改 / 延期入口在哪 ❓ 截图未见
- 单码次数上限？通码批量被刷怎么风控（速率/IP 限制）❓
- 一次最多能生成多少码（生成数量上限）❓
三、用户回访¶
3.1 功能定位¶
按"多少天没登录"过滤流失用户，导出后做短信 / Whatsapp / 客户端推送召回。
💡 副组长视角：这一页是"沉睡用户挖掘机"。日常运营每周跑一次，圈出 30 天 / 60 天未登录的高价值玩家，丢给客服做唤回话术。
3.2 筛选页¶
筛选条件¶
| 字段 | 含义 |
|---|---|
| 注册来源 | 全部来源 / ❓ 推广渠道下拉 |
| 充提差范围 | "充值 - 提款" 净值区间（找"输得多的玩家"） |
| 最近 ___ 天未登录 | 关键字段：写 30 / 60 / 90 |
| 注册时间 | GMT+8 |
| 登陆时间 | GMT+8 |
| 统计时间 | 统计窗口 |
按钮：查询 / 导出 Excel
表格列¶
用户 / 用户层级 / VIP 等级 / 注册时间 / 登陆时间 / 注册来源 / 余额 / 直充加款 / 直充加款次数 / 直充扣款 / 直充扣款次数 / 订单充值 / 赠送 / 订单提现 / 存提差 / 投注 / ❓ 更多列
📌 "直充" vs "订单充值"区别：参考 07-系统直充（待写）—— 直充是后台手工调账，订单充值是玩家走通道。两者分开追踪。
3.3 典型操作流¶
flowchart TD
A["周一例会拿"30 天沉睡 + 累计充值 ≥ 500" 的清单"] --> B["用户回访 → 最近 30 天未登录"]
B --> C["充提差范围：> 500 ₱（输得多的，召回价值高）"]
C --> D["查询 → 导出 Excel"]
D --> E["把 Excel 给客服，按"用户"列发 Whatsapp 个性化召回"]
E --> F["顺便给名单生成"兑换码"做礼包刺激"]3.4 待确认¶
- 充提差字段算的是"全部累计"还是某窗口期内？
- 注册来源下拉对应哪个推广渠道字段？（联动 13-推广渠道）
- 是否能按"VIP 等级"过滤？截图筛选区未见，但表格有该列。
- 列表"用户"列是否可直接点击进入个人资料？
四、客户端通知¶
4.1 功能定位¶
走 FCM（Firebase Cloud Messaging） 通道，给已授权通知的 H5 / PWA / 智能 APK 用户发推送消息。
⚠️ 重要说明（截图原文）："所有设备类型，包含 H5、PWA 和智能 APK 用户，只要授权了通知，都可以收到消息推送，供业主免费使用。"
4.2 列表页¶
页面元素：
| 元素 | 说明 |
|---|---|
| 刷新（蓝） | 刷新发送状态 |
| 创建通知 (0/5)（绿） | 当天还可发送的额度（每天上限 5 条） |
表格列：创建时间 / 操作人 / 推送用户 / 送达数量 / 已点击用户 / 推送标题 / 推送内容 / 状态 / 备注
4.3 创建通知弹窗¶
| 字段 | 限制 |
|---|---|
| 推送类型 | 全体用户（固定，不可选） |
| 推送标题 | 文本（推送横幅 title） |
| 推送内容 | 多行文本（推送正文） |
| 备注 | 业主内部记录 |
关键红字警告（截图原文）¶
⚠️ 注意：推送太频繁可能会被谷歌屏蔽，导致被停止服务
今天已创建：0 / 5
4.4 风控红线¶
| 红线 | 后果 |
|---|---|
| 一天发超过 5 条 | 后台直接拦截，不让点确定 |
| 连续高频推送 | 被 Google 屏蔽整个 FCM Project，全平台用户都收不到 |
| 内容涉黄/赌博露骨 | 同样被 FCM 风控 |
📌 关联文档：FCM 接入与凭证申请详见 13-推广渠道（推广渠道下有 FCM 推送子菜单）+ iGaming 多平台批量推送实战。
4.5 典型操作流¶
flowchart TD
A["活动开始前 30 分钟做最后一波唤醒"] --> B["副组长 → 营销工具 → 客户端通知 → 创建通知<br/>标题：「Lucky Wheel · ₱ 50000 GRAND PRIZE」<br/>内容：「The wheel goes live in 30 mins. Don't miss out!」<br/>备注：「2026-05-11 周末 LuckyWheel 暖场」"]
B --> C["确定 → 计数变 1/5"]
C --> D["列表观察：送达数 / 已点击 / 状态"]4.6 待确认¶
- 推送类型是否真的不能筛选（只能全体）？还是 ❓ 隐藏选项？
- 送达数量 vs 已点击字段精度（推送 SDK 上报口径）？
- 5 条/天额度的 reset 时间？GMT+8 0 点？
- 是否支持定时推送？还是只能立即发？
- 是否支持附图 / 跳转 URL？截图未见 ❓
- 与 iGaming Firebase FCM 多平台批量推送实战 文档里的 CF Cron + Topic 架构关系——这是单平台后台手动版，规模化需要 CF Workers 自动化。
五、三件套联动建议¶
flowchart TD
H["拉新（兑换码）→ 留存（客户端通知）→ 召回（用户回访）"]
H --> D1["Day 1 代理私发兑换码 → 玩家首充"]
D1 --> D3["Day 3 活动前推送预热（每天≤5条额度内）"]
D3 --> D14a["Day 14 不活跃 → 出现在用户回访列表"]
D14a --> D14b["Day 14 客服 Whatsapp + 个性化兑换码召回"]
D14b --> D30["Day 30 进入深度沉睡名单 → 大额定制兑换码救回"]六、待确认清单（汇总）¶
- 兑换码完整下拉项（类型/对象）
- 兑换码作废/修改/延期入口
- 用户回访的"充提差"算法窗口
- 客户端通知是否支持定时/附图/跳转 URL
- FCM 推送是否走单独 Project，需要哪些凭证（对应 PDF 资料）
七、相关文档¶
- 03-运营配置
- 07-系统直充（兑换码 vs 系统直充的差异）
- 13-推广渠道（FCM 接入与凭证 PDF）
- 15-站内消息推送（站内信 vs 客户端通知差异）
- iGaming 多平台批量推送实战
八、已知局限与运营补位¶
本节记录的是澎湃后台目前没有、或用起来不顺手的局限，不是后台现有功能。来源：MyTools《对接需求-澎湃后台 v2》。
局限：兑换码「先创建再改」两步、不能批量 / 定时 / 联动。 后台加兑换码要先创建一个，再进去自定义修改（两步操作），不能批量创建、不能定时生成、也不能与站内信联动。一天天手工弄很累。运营希望后台支持：设置生成规则（码格式 / 金额固定或随机 / 数量 / 有效期）+ 每天 0 点自动生成 + 一次预生成未来一周并按日自动生效 + 生效时自动按模板发站内信 / 推送。这些目前后台都不支持。
- 运营补位：使用协作台「兑换码工具」补位——自动生成码 + 金额、一键设置到后台。
九、互动自测¶
用本文写到的事实自测：兑换码、用户回访、客户端通知的操作与规则。做完过关卡再收工。
:::quiz{id=redeem-cash} 客服要给一个被风控误伤的玩家发一张"立即可提现"的补偿兑换码，创建时"打码要求"应该填多少？
- [ ] 填 1 倍，保证玩家先投注
- [x] 填 0 ₱
- [ ] 留空由系统默认
- [ ] 填面额的一半
解析：本文规定"打码要求 写 0 = 当现金；写 ≥ 1 倍 = 赠金套娃"，0 ₱ 即领取后立即可提。 :::
:::quiz{id=notify-limit} 客户端通知（FCM 通道）每天最多能发几条？
- [ ] 无限制，按额度控量
- [ ] 3 条
- [x] 5 条
- [ ] 10 条
解析：本文多处写明"每天最多 5 条"，创建按钮显示当天剩余额度 (0/5)，超过 5 条后台直接拦截不让点确定。 :::
:::quiz{id=recall-page multi=true} 关于"用户回访"页面，下面哪些说法符合本文？（多选）
- [x] 可以按"最近 N 天未登录"过滤流失用户
- [x] 可以按"充提差范围"筛选
- [x] 结果通过"导出 Excel"拿到名单
- [ ] 可以在本页直接群发短信召回
解析：用户回访是查询型页面，按钮只有"查询 / 导出 Excel"；短信 / WhatsApp / 推送召回是导出名单后交给客服去做，本页不下发。 :::
:::scenario{id=compensate}
{"start":"n1","nodes":{"n1":{"text":"要给一名被风控误伤的玩家补偿 100 ₱，且要能立即提现。你在创建兑换码时怎么配？","choices":[{"label":"生成数量=1、单码次数=1、金额=100 ₱、打码要求=0","next":"good","feedback":"✅ 一张一次性专属码，打码 0 立即可提，正是 1v1 私聊补偿的推荐配法。","good":true},{"label":"生成数量=1、单码次数=100 的通用码，金额=100 ₱","next":"bad","feedback":"❌ 通用码 1 个码 100 人领，会被其他人抢领，只适合公开活动，不适合补偿单个玩家。","good":false}]},"bad":{"text":"通用码流出后被别人领走，目标玩家没拿到，还超发了现金。补偿场景应回到「单码次数=1」的一次性专属码。","terminal":true},"good":{"text":"码生成后复制字符串私聊发给玩家，第二天在列表看「使用情况」是否 1/1 确认已兑换。","terminal":true}}}
:::flashcards{id=marketing-facts} - 兑换码每天频率限制 :: 无限制，按"生成数量"控量 - 客户端通知每天上限 :: 5 条 - 客户端通知走的通道 :: FCM（Firebase Cloud Messaging） - 打码要求填 0 的含义 :: 领取后立即可提，当现金用 - 生成数量=N、单码次数=1 :: N 个一次性码，适合 1v1 私聊 - 生成数量=1、单码次数=N :: 1 个码 N 人领，适合公开活动 - 创建兑换码的强制校验 :: 谷歌验证码（6 位 2FA） - 用户回访的关键筛选字段 :: 最近 N 天未登录 :::
:::gate{id=done score=0.8 title=学完营销工具} 上面全部答对且情景选到"立即可提专属码"路径，即掌握了兑换码单码/通码、用户回访筛选、客户端通知 5 条红线三件套。可以上手实操。 :::