广告与运营辅助

广告服务把业务入口、广告播放、平台回调和奖励结果连接起来；GM 与运营接口服务开发/运营人员，不是普通玩家主界面的功能。

广告业务流程

业务入口先判断开放与次数，再请求广告。广告加载失败、玩家取消、播放结束、奖励确认是不同状态；播放结束不能提前认定奖励成功。奖励绑定来源功能和行为标识，资产以服务端结果更新，不在 SDK 关窗时自行发放。

当前 AdService.PlayRewardAdAsync 先检查场景配额；DefaultSdk 渠道没有真实广告画面，直接请求业务奖励。免广告特权也走直接奖励请求；真实渠道通过 SdkService 等回调确认结果。等待层 3 秒自动隐藏只是界面等待设置，不代表超时即成功。奖励成功后执行对应展示并刷新任务数据。

当前场景 Key	业务归属
buff_roguelike	局内三选一刷新
daily_shop_refresh	每日商店刷新
single_normal_spin	普通招募单抽
single_advanced_spin	高级招募刷新
daily_base_supply	领地物资刷新
diamond_spin	符文/宝石抽奖单抽
reward_finishstage_double	关卡结算双倍
afk_benefit	挂机领取
daily_free_diamond / daily_free_coin / daily_free_stamina	钻石/金币/体力领取

这些是当前服务中的入口定义，不保证每一页都展示可操作按钮或每一渠道都接通真实广告。特别是礼包售卖没有 SellAd 类型，不能从广告服务存在推导广告礼包已上线。

界面与权益

广告按钮使用一个清晰广告图标，并展示剩余次数及加载、不可用、取消、发奖结果。飞书广告图标资料只有“图标一个、用于按钮”的资源要求，不包含独立奖励数值。

首充 24 小时体验和卡权益见月卡与免广告。免看广告仍保留业务次数和奖励确认。DefaultSdk 直接取奖成功只能证明该测试渠道业务路径，不等于看完真实 TopOn 广告或平台回调验证通过。

GM、运营与观测

旧功能库列有 GM 命令、服务器状态、白名单、版本、公告、充值回调与 Prometheus 监控。前端可见 Item、Master、Lottery 等 GM 调试入口，后端有相应运营/处理模块；命令实际权限、环境开关和操作日志需从当前部署配置判断，不因为目录存在就标为普通玩家可用。

产品约束是 GM 只用于测试或获授权环境，运营操作应具有真实账号权限并留必要记录；这不增加本次 Codex 任务的逐次人工批准门。监控可证明服务指标，不能代替 GUI 画面、真实支付或广告平台结果。

广告完成事件与奖励到账分别记录；正式事件定义和待定运营采集归埋点与数据分析。本轮只审计文档与静态来源，没有发送 GM 指令、调整服务器或执行广告操作。

依据

旧 ads-sdk-gm-ops 的广告绑定、GM 和运营范围；飞书《广告图标》DCKhsalQ9htFLEtE2q1cpH6AniP；frontend develop AdService、SDK 与特权源码。原临时 Work Package 的交付步骤及失效审批文字没有作为产品规则保留。