mcpField
A
ad-account-auditor

ad-account-auditor

github.com/aaron-he-zhu营销与增长3.0k1.0k 次安装今天更新
代码仓库

关于 ad-account-auditor

ad-account-auditor 是一项营销 Skill,依据业务约束和标准化证据审计付费媒体账户或组合。它区分平台报告的 ROAS 与实际结果依据,并报告发现,不更改预算或账户设置。

主要功能

  1. 01评估基准中的 20 项指标
  2. 02统一币种、归因窗口和转化延迟
  3. 03用去重后的自有数据 ID 核对结果
  4. 04核验声明、政策与版位否决项
  5. 05报告未知证据和置信度
  6. 06经授权生成并验证审计记录

适用场景

  1. 01增加预算前审计账户
  2. 02调查归因膨胀或预算浪费
  3. 03按 CAC 上限评估付费媒体效果
  4. 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.md
  • references/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。

证据与评分
  1. 比较指标前,先统一币种、时间窗口、ID、延迟和投放组合范围。
  2. 根据基准对全部 20 项 R1..S5 标准评分,并注明来源、日期、类型和置信度。
  3. 自有数据真实性、版位导出数据或对账数据缺失时,使用 Unknown。没有数据不构成否决理由,也不能仅因获取不便而标记为 N/A。
  4. 验证否决项:
    • ROAS-R1:有明确证据证明,监测数据未能通过指定的自有数据真实性验证集。
    • ROAS-R2:有明确证据证明存在重大重复计算或虚增。
    • ROAS-O1:有明确证据证明,相对于 offer-claims-registry 中已批准的状态,存在重大声明/披露违规。
    • ROAS-O2:存在适用的平台违规或受限类别违规。
    • ROAS-A1:版位证据表明存在重大安全违规。
  5. 运行类型化评分器。将估算/代理增量性如实标注;不要将平台归因称为因果关系。

§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 修改保留的写入目标。不得自主写入热缓存、声明、候选项或账户状态。

参考资料

下一项推荐技能

评论

支持 Markdown