游戏中心埋点 CSV
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_d786d32b/tracking-skill。
技能介绍
解决的问题
QQ 游戏中心改版埋点文档常因来源分散而字段不稳:oper_id、game_id、activity_id 等业务参数缺少依据,page_name 与 element_level 命名不一致,曝光/点击事件漏配,CSV 打开后中文乱码。这个 skill 面向这类埋点文档生成、补全与审校场景,目标不是发明业务事实,而是把 Figma、PRD、截图和既有 CSV 中的可用信息整理成可交付表格。
工作方式
- 先读取
references/tracking_spec.md、references/example_patterns.md与assets/tracking_template.csv,确认列顺序、必填字段和扩展字段语义。 - 从输入材料抽取页面、模块、元素、交互与事件,建立页面曝光、模块曝光、元素曝光/点击、播放、滑动、下载等事件矩阵。
- 按规范写入
page_name、module_name、element_name、element_level、game_id、activity_id、adtag和ext1-ext25。 - 对无来源字段保留空值或标注「待确认」,避免编造
oper_id或业务参数。 - 使用
scripts/tracking_csv_tool.py生成模板、写入output.csv并执行validate,再根据错误与警告二次修订。
适用边界
该技能依赖明确的新规范与参考样例,适合已有 Figma、PRD、截图或旧 CSV 的团队。若输入中缺少真实 oper_id、来源入口、动态参数或跳转目标,输出中相应字段只能待确认。复杂业务逻辑、权限态、失败态和跨页面状态机仍需人工回看来源。
使用场景
- 从 Figma 页面稿和 PRD 抽取游戏中心改版事件,生成符合新规范的埋点 CSV。
- 对已有埋点 CSV 补齐缺失事件,统一 page_name、element_level 和扩展字段语义。
- 交付前校验 CSV 列顺序、必填字段、曝光点击配对和待确认字段来源。
- 根据截图和流程图识别按钮、列表、浮层,整理可交付给测试的埋点表格。
适合人员
- 负责游戏中心改版埋点整理的产品,需要把 PRD 和页面稿落成可评审 CSV。
- 需要核对埋点字段与事件层级的测试,要求输出前发现漏曝光和命名不一致。
- 维护数据口径的前端/客户端工程师,需要避免运营自造 oper_id 和业务参数。
- 接收盘点文档的数据分析同学,需要按固定列序拿到可导入的 CSV。