CRM 结算数据核对

要解决什么问题

渠道结算、活动归因报表里常见三类脏数据：重复归因（同笔交易被多条 Primary 记录认领）、无效交易（Event Value 里缺 transaction_id 或格式不对）、窗口外事件（结算周期与促销有效期不一致）。人工在 Excel 里筛条件容易漏规则，也难留下可审计的逐步剔除说明。

技能如何工作

本技能把核对做成顺序漏斗，每一步只保留仍满足条件的记录，逻辑与 SKILL 中表格一致：

• Step 1：Is Primary Attribution = true，去掉非主归因/重复认领行
• Step 2：Event Value 包含 transaction_id，锁定可追踪的有效交易
• Step 3：Channel 与目标合作方一致，把范围收窄到指定渠道
• Step 4：Event Time 落在促销窗口内；窗口由促销记录 Excel 解析出的起止日期决定

配套脚本 settlement_verify.py 可执行整条链路，依赖 pandas 与 openpyxl 读写表格，最终产出对账报告（含漏斗各步后的样本/统计形态，便于和财务或运营对口径）。

适用边界

• 字段名与布尔/字符串语义需与源 CRM 导出一致；渠道、主归因列若命名不同，需先映射再跑脚本。
• transaction_id 的提取规则以「Event Value 包含该标识」为准，复杂 JSON 嵌套可能要预处理。
• 促销窗口完全依赖促销记录 Excel 的日期字段质量；缺档或时区未统一会导致 Step 4 误判。
• 适合批处理核对，不是实时 API 校验；规则变更需同步改漏斗条件或脚本。