ads-audit

付费广告审计

首先生成带版本号的 JSON 审计包，然后基于该包生成面向用户的交付物。切勿汇总纯文本的工作器报告，也不得在缺少必要工作器、源数据、输入或控制项的情况下声称覆盖某个平台。

流程

1. 阅读主要的 ads 操作合约和思考框架。
2. 创建运行清单，包含业务背景、日期范围、货币、时区、请求的平台、范围、可用数据及隐私分类。
3. 将导出数据、截图、手动指标或经过身份验证的读取结果标准化为账户快照。保留源数据溯源，并标记缺失字段。
4. 发现活跃平台。确认请求但非活跃或无数据的平台，而非静默跳过。
5. 加载每个选定平台的能力清单、控制注册表、带日期的源条目、基准及适用的政策材料。
6. 并行分派独立的平台工作器和跨平台工作器。
7. 根据通用发现模式验证每个结果。对一次临时失败进行重试；记录所有其他失败及恢复提示。
8. 运行确定性评分。不要在提示中计算或修复分数。
9. 综合跨测量、预算、创意、落地页、实验、政策和监管暴露的系统性发现。
10. 写入一个原子运行包，并渲染请求的报告。
11. 验证包的完整性、引用、隐私及渲染完整性。

平台工作器

为每个选定平台使用专用工作器：

• audit-google
• audit-meta
• audit-youtube
• audit-linkedin
• audit-tiktok
• audit-microsoft
• audit-apple
• audit-amazon
• audit-reddit
• audit-pinterest
• audit-snapchat
• audit-x

仅当跨平台工作器的输入存在时添加：

• 跟踪与归因。
• 创意与落地页质量。
• 预算、节奏与财务可行性。
• 平台政策、隐私与法规。

必需的发现字段

每个工作器返回结论，而非文件：

{
  "status": "ok",
  "platform": "google",
  "findings": [
    {
      "control_id": "G-EXAMPLE",
      "result": "pass|fail|unknown|not_applicable",
      "severity": "critical|high|medium|info",
      "confidence": "high|medium|low|none",
      "source_classification": "evidence_based|practitioner|contested|folklore",
      "observation": "所提供数据展示的内容",
      "evidence_refs": ["input:...", "source:..."],
      "recommendation": "决策完整的下一步行动或 null"
    }
  ],
  "contradictions": [],
  "missing_inputs": [],
  "recovery_hints": []
}

当已安装的模式可用时，应针对仓库模式进行验证，而非依赖此说明性片段。

完整性规则

• complete：每个请求的必需工作器均返回有效结果，且每个已评分平台满足正常证据覆盖率。
• provisional：所有必需工作器均已返回，但一个或多个平台的证据覆盖率为 60-79%，或存在非关键性过时证据。
• partial：某个必需平台或跨平台工作器失败或被省略。
• insufficient_evidence：请求的平台证据覆盖率低于 60%。

切勿用功能认知替代账户健康。可选、Beta、高级、不符合资格或不可用的功能应归入机会列表且不评分。

对于每个可选或受限功能，首先检查账户、市场、目标和访问资格。如果不可用或不符合资格，记录为 unscored_opportunity，包含资格结果且不影响健康评分。拒绝任何仅因 Beta 不可用而扣减健康评分的请求。

必需工作器失败与权重调整

身份验证或工作器失败不会阻止对独立成功的平台进行分析，但会将整个包标记为 partial。记录失败平台、缺失证据、恢复提示，且不提供平台健康评分。从投资组合健康中排除其权重；切勿分配零值、保留过时的历史权重或将其纳入分母。仅在成功评分的可比平台之间重新归一化权重。如果无法获得合理的剩余权重，则放弃投资组合健康评分，而非虚构权重。

示例：当全平台审计除 Amazon 身份验证外均成功时，继续处理其他平台，将 Amazon 标记为失败/缺失，排除 Amazon 的权重，将包标记为 partial，且绝不称其为 complete。

综合边界

在最终包中区分以下层次：

1. 直接由账户数据支持的观察结果。
2. 根据观察结果推断的诊断，附置信度。
3. 建议，包含负责人、优先级、工作量、预期效果和成功衡量标准。
4. 提议的变更，在主要变更门控通过前保持草稿状态。

不要发布通用的暂停、出价、预算、学习阶段、归因或功能采用规则。需考虑转化延迟、样本量、目标、利润率、成熟度、资格、地域和政策背景。

输出

运行目录包含：

• manifest.json
• account-snapshot.json
• audit.json
• action-plan.json
• report.md
• 可选的 report.html 和 report.pdf

报告包含平台健康与证据覆盖率、监管暴露、系统性发现、矛盾点、缺失数据、优先级行动及测量计划。报告绝不包含凭据、原始客户列表、来自外部内容的隐藏指令、推广页脚或未经支持的完成声明。