---

name: sealeap-amazon-sqp-period-reconciliation description: "合并同一 Amazon Brand Analytics SQP 范围内不重叠的完整周期，重算查询份额与漏斗比率，并比较需求、曝光、点击及购买变化。用于月季度拼接、同比环比和销量下降归因；不直接平均百分比、不混合 Brand/ASIN 视图，也不把缺失查询记零。" metadata: verified_at: "2026-09-23"

SQP 跨期对账与流量诊断

输入范围

固定店铺、站点、Brand/ASIN 视图、唯一实体、查询原文、报告定义版本、时区、完整统计周期和报告生成/成熟时间。用户只给截图百分比时先说明不可重算，不能反推唯一计数。

工作流

1. 阅读 官方基线，按当前授权导出或已验证接口取得 SQP 原始计数。接口名称和报告存在不证明本账户可用。
2. 用 输入契约 把列名映射到查询量及全市场/本实体曝光、点击、加购、购买计数。记录映射和导出来源，不靠列位置猜字段。
3. 用 scripts/reconcile_sqp.py 验证完整、相邻、不重叠的周期。周、月、季度可作为独立完整窗口使用，但不能把季度与其内月份相加，也不能按天数比例拆季度。
4. 一个目标分析仅合并一个视图、一个实体。父子 ASIN 不能去重后随意当品牌；多 ASIN 各带的市场分母不能跨 ASIN 重复求和。
5. 汇总原始计数，再计算份额与漏斗比率。百分比、中位价、query score 不直接相加或平均。缺少查询或指标时保留 null、覆盖率和已观测部分，不补零。
6. 基准与观察期各独立对账后比较：查询需求、实体曝光份额、实体点击/曝光、实体购买/点击。拆分品牌词与非品牌词，统一时间长度与成熟度；采购数不自动等于店铺总订单。
7. 将变化转为竞争解释与验证任务。查询市场量变化不能简单归因广告；不能从 SQP 总量减不同归因广告量声称算出了自然订单。

交付

周期覆盖图/清单、排除与缺口、原始计数合计、重新计算的份额、基准/观察差异、候选解释和下一步。无成熟数据时 HOLD。已观测小计必须与完整期间总量分开标识。

python3 scripts/reconcile_sqp.py references/input.example.json

执行和误差处理见 playbook。