SuperAPI AI 工具集

analyze-performance-intake

数据与分析

查看项目

更新于 10-27 11:26

技能介绍

用途

本技能是 analyze-performance 剧本中的一个步骤(原子),专注于性能数据的采集(intake)、数据卫生(hygiene)与覆盖度(coverage)标注。它负责把一周内来自各种工具、导出文件和粘贴内容的数据汇总、清洗,并生成覆盖度行,或在条件不足时切换到仅声称模式。

主要能力

  • 从测量契约(measurement contract)出发,获取公司类型、裁判指标(referee)和渠道清单。
  • 读取工具数据:meta_read performance、social_analytics_get、ads_creative_read、video_read、campaign_read。
  • 处理营销人员通过单条输入消息提供的连接器、导出文件、截图或粘贴内容。
  • 从最小有用读取(契约 §4)开始,对照渠道清单逐项勾选其余部分。
  • 当存在代码工具时,在代码中对大型粘贴导出进行汇总;若没有代码工具,绝不凭肉眼汇总,而是要求提供摘要报告,并在报告到达前将裁判指标标记为未测量(契约 §4),且绝不回显。
  • 记录已到达和未到达的数据(“本周未检查”——运行中不提问)。
  • 数据卫生:从新收入中剔除测试、批发、员工订单和订阅续费;净额处理退款;对齐时区与货币;记录折扣深度。
  • 成熟度处理:将本周首次报告的数据与上周首次报告的数据进行比较;单独展示上周重述后的数据。导出文件是本周的数据来源;meta_read 用于识别 Goose 广告并进行交叉核对,按广告 ID 去重。
  • 将输入摘要保存到 reports/performance/inputs/<YYYY-MM-DD>.md,供 run-paid-campaigns 复用。
  • 生成覆盖度行:按渠道标注真实 / 声称 / 未测量 / 未使用;展示在明细中可见的 Meta 花费占比。
  • 当该类型的裁判指标缺失(或没有总花费)时,切换到仅声称模式(仅标签,无 MER,调用限制在首次查看,首行通知)。

使用方式

加载 ../analyze-performance/references/measurement-contract.md。输入包括:测量契约(公司类型、裁判指标、渠道清单);工具读取结果;营销人员从单条输入消息提供的连接器、导出文件、截图或粘贴内容。按照上述步骤执行,最终输出按渠道整理的干净数据集(带标签)、覆盖度行以及下周的数据需求清单。

适用场景

适用于需要按周汇总和清洗营销性能数据、核对渠道覆盖度、并为后续付费活动运行准备输入摘要的场景。

限制

  • 没有代码工具时,不得凭肉眼汇总大型导出,必须要求摘要报告。
  • 运行中不提问,未检查的数据标记为“本周未检查”。
  • 裁判指标缺失或没有总花费时,只能进入仅声称模式。
  • 其他具体限制暂未提供。