Meta 广告只读离线审计

交付与范围

审计用户导出的 Meta 广告汇总的窗口一致性、漏斗指标和对账异常；不登录账户或修改投放。

不做： 不联网、不读取账户、不使用凭据、不创建测试订单、不改价/预算/库存/广告，也不保证商业结果。

凭据要求： 如需连接 Meta API，本技能需要用户自行提供 META_ACCESS_TOKEN；默认离线流程不读取该 token。

最小输入契约

window、currency、attribution_window，以及 rows[]（campaign、spend、impressions、clicks、purchases、attributed_revenue、currency、window、attribution_window）。

每份输入必须提供 source_name（非空文本）、exported_at（带 UTC 偏移的 ISO-8601 时间）、timezone（有效 IANA 时区）和 deidentification: true。缺失或格式无效输出 UNKNOWN；明确 false 输出 HOLD。不使用默认值或补造。

完整离线分析流程

固定日期范围、币种、账户导出层级和归因窗口；币种、日期窗口或归因窗口不一致时一律 RECONCILIATION_REQUIRED，并且不聚合任何混合单位行。
按 campaign 汇总花费、展示、点击、购买和平台归因收入，计算 CTR、CPA、平台 ROAS。
标记零花费有结果、窗口不一致等对账异常；异常时不提供预算/受众/创意操作建议。
输出只读审计表、口径问题和需在原导出/账户界面人工确认的问题。

可执行离线运行

在候选目录运行：

python3 scripts/capability_workflow.py meta-ads-readonly-audit fixtures/capability-repair/positive.json
python3 tests/test_capability_workflow.py

第二条命令实际运行正例、缺证据例和风险/冲突例；只验证本地 JSON 到业务输出的转换。

合成样例输出

输入 fixtures/capability-repair/positive.json 是合成数据。典型输出会提供可操作的业务对象，例如逐事件验证表、市场证据覆盖与研究问题、按维度的修复动作、实验准入与阻塞项，或按广告系列的对账指标。它不是任何真实商家的结果。

缺证据与冲突分支

缺少最小字段：返回 UNKNOWN 并列出 missing，只请求最小补充导出。
来源/窗口/成本/参数或交易重复冲突：返回 PARTIAL、HOLD 或 RECONCILIATION_REQUIRED；停止形成正面商业结论。
连续两次仍不能取得可核验材料：保留范围与缺口，要求有权人员决定是否提供只读导出；不得绕过登录墙或以猜测填充。

决策使用限制

Meta 指标和 breakdown 受归因窗口及可用性限制，平台归因不是增量或利润结论。任何生产变更需在本技能外获得明确、逐项授权，并定义预期、回滚、验证和用户可见表面。

公开资料与权利说明

官方资料（2026-09-13 访问）：https://developers.facebook.com/documentation/ads-commerce/marketing-api/insights/breakdowns。该链接仅用于核对公开平台/流程事实；本包未复制其正文、代码、截图或受限材料。
本包正文、脚本与合成夹具为本次清洁室原创表达；仅分析用户提供材料。
license: MIT 仅声明本候选自身内容的许可；不表示任何既有版本、第三方资料、平台数据或品牌资产已获所有者再次公开同意。
发布仍为 HOLD，直到逐坐标 T0/T1 来源/保留方法/IP 边界审查和精确包 hash 授权完成。

Exit Criteria

✅ 成功：正例、缺证据例、冲突例均由本地脚本执行；正例产生该 slug 的业务输出对象，且无网络/账户操作。
ℹ️ 不算交付：非空 JSON、单个数值或平台截图；它们不自动证明商业、归因、合规或生产状态。
❌ 失败：输入无效或输出与夹具契约不符；修正输入/脚本后最多重试两次。
🛑 仍失败：停止并请求用户提供去标识导出或明确授权；不采取外部写入。

1.3.1 合同修复

强制来源、导出时间、IANA 时区与去标识声明；缺失/无效不再静默接受。
数值拒绝 null、布尔值、NaN、Infinity、负值；零值只在该字段语义允许时保留。