关于 ad-account-auditor
ad-account-auditor 是一项营销 Skill,依据业务约束和标准化证据审计付费媒体账户或组合。它区分平台报告的 ROAS 与实际结果依据,并报告发现,不更改预算或账户设置。
主要功能
- 01评估基准中的 20 项指标
- 02统一币种、归因窗口和转化延迟
- 03用去重后的自有数据 ID 核对结果
- 04核验声明、政策与版位否决项
- 05报告未知证据和置信度
- 06经授权生成并验证审计记录
适用场景
- 01增加预算前审计账户
- 02调查归因膨胀或预算浪费
- 03按 CAC 上限评估付费媒体效果
- 04在高风险定向调整前审查证据
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ aaron-he-zhu/ aaron-marketing-skills --skill ad-account-auditor安装后在 Claude Code 中输入/ad-account-auditor确认已加载。
附带文件references/auditor-runtime.md
详细介绍
广告账户审计
在声明的约束条件下,审计一个付费媒体账户或组合的增量贡献和运营质量。平台报告的 ROAS 只是一个输入,绝不是目标,也不能单独作为事实依据。
必须触发的情形
- 在启动、显著增加支出或更改有风险的出价/定向策略之前。
- 对追踪、归因膨胀、不安全版位、声明或浪费支出存在疑虑时。
- 用户要求根据其导出数据进行 ROAS/RQS 账户审计时。
快速开始
Audit this USD account for direct response using 7-day click, 3-day lag, and $120 CAC ceiling.
Run the incremental-profit profile against the holdout and order-ID exports.
技能约定
读取: 一组经过规范化的账户/组合证据。写入: 仅限获准写入的 v3 产物。完成条件: 所需背景信息和全部 20 个状态都已明确,否决项使用经验证的证据,并报告评分器输出,不执行支出变更。
此技能负责评判。conversion-signal-qa、attribution-reconciler、campaign-architect、ad-creative-builder 和 budget-pacing-monitor 负责构建/修复输入。未经单独明确批准,绝不启用广告系列、更改出价、上传受众或扩大预算。
对于发布前的账户审计请求,请立即在此关卡之前使用窄路径 conversion-signal-qa。不要在信号 QA 与审计之间自动插入 placement-exclusion-manager 或 conversion-value-mapper;本次运行中,缺失的版位或价值证据仍标记为 Unknown;只有在用户提出要求,或已完成的关卡指出相应问题时,才将这些同级构建技能作为单独的修复步骤。
数据来源
| 需求 | 首选证据 |
|---|---|
| 投放/支出 | 广告系列、查询、版位、受众和变更历史导出数据 |
| 结果真值 | 来自电商、分析工具或 CRM 的去重订单/潜在客户 ID |
| 经济指标 | 货币、利润/贡献、CAC/回本周期约束 |
| 归因 | 平台数据 + 自有数据时间戳/ID、标准化窗口和延迟 |
| 安全/声明 | 来自 offer-claims-registry(付费声明 SSOT)的版位报告、渲染后的广告/落地页、获批声明/披露状态 |
| 增量性 | 留出组/地域拆分/因果测试;否则明确标记为代理指标 |
说明
运行时读取项
../../../references/auditor-runbook.md../../../references/scoring-semantics.md../../../references/roas-benchmark.md../../../references/runtime-invocation.mdreferences/auditor-runtime.md
运行时与设置
读取 ../../../references/auditor-runbook.md、scoring-semantics.md、roas-benchmark.md 和 ROAS 目录条目。独立安装使用捆绑的不可变文件 references/auditor-runtime.md;绝不获取可变的 main。进行确定性调用前,遵循 runtime-invocation.md,解析 AARON_SKILLS_ROOT="${CLAUDE_PLUGIN_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || true)}",并要求评分器、验证器和类型化目录均可用。若不可用,则返回 score_state: NOT_SCORED / score_confidence: not_scored,不提供关卡判定,也不生成持久化产物。
声明配置文件(direct-response|prospecting|incremental-profit)、目标、货币、归因窗口、转化延迟、业务约束、目标和观察日期。如果缺少任何必需背景信息,则返回 NEEDS_INPUT/UNDECIDED。
证据与评分
- 比较指标前,先统一币种、时间窗口、ID、延迟和投放组合范围。
- 根据基准对全部 20 项
R1..S5标准评分,并注明来源、日期、类型和置信度。 - 自有数据真实性、版位导出数据或对账数据缺失时,使用 Unknown。没有数据不构成否决理由,也不能仅因获取不便而标记为 N/A。
- 验证否决项:
ROAS-R1:有明确证据证明,监测数据未能通过指定的自有数据真实性验证集。ROAS-R2:有明确证据证明存在重大重复计算或虚增。ROAS-O1:有明确证据证明,相对于offer-claims-registry中已批准的状态,存在重大声明/披露违规。ROAS-O2:存在适用的平台违规或受限类别违规。ROAS-A1:版位证据表明存在重大安全违规。
- 运行类型化评分器。将估算/代理增量性如实标注;不要将平台归因称为因果关系。
§2 ROAS 示例
- 完整的直接响应档案,原始分 78,无否决项/失败项:
DONE/SHIP,最终分 78。 - 完整档案,原始分 78,一项经验证的 R1 失败:
DONE_WITH_CONCERNS/FIX,最终分 59。 - 完整档案,存在经验证的 R1 和 R2 失败:
DONE/BLOCK,保留原始分,不给出最终分。 - 缺少版位报告:A1 为 Unknown,
NEEDS_INPUT/UNDECIDED,不提供总分。
§3 ROAS 防护措施
- 报告的 ROAS 较高,可能是因为投放不足、承接品牌需求或归因虚增。
- 学习阶段受到干扰属于 S2 发现项,不会自动构成否决。
- ATT/建模数据可能降低置信度;但不会自动导致 R1 失败。
- 频次、创意疲劳和受众饱和度需要单独的证据。
- 对跨平台回报进行比较前,务必先统一币种/时间窗口/延迟并去重结果。
§5 ROAS 表述
优先说明业务影响和证据。收到追溯请求时,注明 ROAS-R1/R2/O1/O2/A1;不要只展示可能与 RAMP/ECHO/TALE 冲突的 ID。
报告与结论
从 auditor-runbook 要求的精确类型化对话标头开始。不得用文字替代 status、verdict 或 score_state;在发现项之前,逐项列出所有明确缺失的限定条目,格式为 ``ID: `unknown```。
展示结论、档案/上下文、分数或覆盖率/区间、置信度、R/O/A/S 明细、对账表、已验证的关键控制项、Unknown 证据,以及按优先级排列的修复项/负责人/重新运行条件。评分器决定 status/verdict,并设定 59 分上限。
验证检查点
- 范围/币种/时间窗口/延迟/限制条件/目标均已明确。
- 自有数据的结果真实性与平台自报数据已区分。
- 所有 20 项均有有效状态和来源信息;Unknown 不进行重新归一化。
- 否决项失败均已通过正面证据验证。
- 未经单独批准,未更改投放支出/账户。
持久化
仅在获得明确授权后,才持久化至 memory/audits/ad/YYYY-MM-DD-<topic>.md。使用 validate-audit-artifact.py,针对预期的 --relative-path,组装并验证完整的 v3 草稿;仅通过一次完整内容的 Write 进行持久化,随后按 auditor runbook 的要求重新验证目标文件。禁止通过 Edit/Shell/MCP 修改保留的写入目标。不得自主写入热缓存、声明、候选项或账户状态。
参考资料
下一项推荐技能
- 追踪: conversion-signal-qa
- 声明/披露: offer-claims-registry —
ROAS-O1背后已批准的声明/披露状态 - 归因: attribution-reconciler
- 结构/受众: campaign-architect
- 投放节奏: budget-pacing-monitor