用途:衡量某次已保存或临时 SEO 变更的前后影响。核心要求是 before 与 after 采用相同整数天数的 Google Search Console 完整窗口,可选接入 GA4 落地页证据,避免用不等长窗口的原始总量做对比。
主要能力:输出结构化机器契约(structuredContent),包含 dataStatus、window、source、warnings、caveats 等字段;支持查询范围、页面范围等测试;对已保存测试可直接传 id。GSC 点击、展示、CTR、展示加权平均排名视为观测到的前后证据,不代表时序因果。窗口不足会返回 not-enough-data,截断时返回 partial 并给出等长缩短基线、不输出方向性结论。每个窗口至少需 7 个最终完成日才给方向性判断。查询范围测试中 retained-query-date-aggregates 视为部分数据,缺失窗口返回 null 指标而非 0 或损失。GA4 需核对属性时区与 source.analytics.status,其日界可能不同于 GSC 的太平洋日期,采样、阈值或 (other) 分组会使 GA4 证据部分化。对照组只有在代表可信未受影响对象时才使用,调整差值基于对照组比例反事实而非直接相减。
使用方式:如需发现,调用 seo_list_reports 并选 category experiments;再调用 seo_describe_report(id 为 measure-change),然后按描述参数调用 seo_run_report。示例:seo reports describe measure-change --json;seo reports run measure-change --params '{"site":"sc-domain:example.com","scope":"page","target":"https://example.com/page","title":"Updated page","changedAt":"2025-10-01","beforeDays":28,"afterDays":28}' --json。CLI 适用于 CI、保存 JSON 或无 MCP 环境。先 describe 再构建临时参数,因为 schema 把保存测试与内联测试输入合并为同一契约。
限制:不得把 not-enough-data 称为正、负或持平,不得年化或预测观测差值,不得与有效窗口长度不同的运行比较;clickPct 为 null 表示前值为零,非无限增益;GA4 部分数据不否定完整 GSC 证据,但限制分析结论;提供方、认证、属性、无效日期错误属于失败,不是零变化。
适用场景:需要以统一窗口评估页面或查询维度的 SEO 变更,并在建议推广或回滚前排查查询组合、设备、国家、可索引性、SERP 变化、季节性和其他发布。分类:writing。