ad-account-auditor

広告アカウント監査

宣言された制約のもとで、広告アカウントまたはポートフォリオの増分貢献と運用品質を監査します。プラットフォームが報告する 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 のままにします。これらの関連ビルダーによる修正は、ユーザーが依頼した場合、または完了したゲートで該当する指摘事項が特定された場合に限り、別途行います。

データソース

必要な情報	推奨エビデンス
配信／支出	キャンペーン、検索クエリ、プレースメント、オーディエンス、変更履歴のエクスポート
成果の真実性	E コマース、アナリティクス、または 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. ベンチマークの R1..S5 の全 20 項目を、ソース／日付／タイプ／信頼度とともにスコアリングします。
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。
• プロファイルが完全で、R1 の失敗が 1 件検証済み：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 は公開しないでください。

レポートと判定

監査ランブックの正確な型付き会話ヘッダーから始めます。status、verdict、score_state を文章に置き換えず、それぞれを明示して列挙します。明示的に欠けている対象の項目は、所見の前に ``ID: `unknown``` の形式で個別に記載します。

判定、プロファイル／コンテキスト、スコアまたはカバレッジ／区間、信頼度、R/O/A/S の詳細、照合表、検証済みの重要なコントロール、Unknown のエビデンス、優先順位を付けた修正／担当者／再実行条件を示します。status/verdict と 59 の上限はスコアラーが決定します。

検証チェックポイント

• 範囲／通貨／期間／遅延／制約／目標が明示されています。
• 自社データによる成果の真実と、プラットフォームの自己申告が区別されています。
• 全 20 項目に有効な状態と出所情報があり、Unknown は再正規化されていません。
• 拒否条件となる失敗が肯定的に検証されています。
• 個別の承認なしに、出稿額／アカウントの変更は行われていません。

永続化

明示的な承認を得た場合に限り、memory/audits/ad/YYYY-MM-DD-<topic>.md に永続化します。意図した --relative-path を指定して validate-audit-artifact.py で完全な v3 ドラフトを作成・検証し、内容全体を一度に Write する方法のみで永続化した後、監査ランブックの要件に従って対象を再検証します。予約済みシンクへの編集／シェル／MCP による変更はサポートされていません。ホットキャッシュ、主張、候補、アカウント状態を自律的に書き込まないでください。

参考資料

• ROAS ベンチマーク
• 計測プロトコル
• 監査ランブック
• スコアリングの意味

次に推奨するスキル

• トラッキング： conversion-signal-qa
• 主張／開示： offer-claims-registry — ROAS-O1 の根拠となる承認済みの主張／開示状態
• アトリビューション： attribution-reconciler
• 構成／オーディエンス： campaign-architect
• ペーシング： budget-pacing-monitor