Google Ads Audit

# Google Ads Account Audit

Part of [Agent Skills™](https://github.com/itallstartedwithaidea/agent-skills) by [googleadsagent.ai™](https://googleadsagent.ai)

## Description

The Google Ads Account Audit skill executes a comprehensive, pattern-driven analysis of any Google Ads account using a proprietary 1,000-pattern knowledge base. This is the most thorough automated audit available, covering all 20 audit categories: Campaign Structure, Bidding, Keywords, Ad Copy, Performance Max, Shopping, Audiences, Conversions, Budget, Quality Score, Search Terms, Display, Video/YouTube, Remarketing, Reporting, Account Structure, Landing Pages, Competitive Strategy, Automation, and Policy Compliance.

Each pattern in the knowledge base encodes a specific anti-pattern, threshold, or best practice violation derived from auditing thousands of Google Ads accounts across industries. The audit engine evaluates account data against these patterns, generates severity-scored findings, and produces prioritized recommendations with estimated impact. Findings are grouped by category and ranked by potential revenue impact, giving advertisers a clear roadmap for improvement.

The audit integrates directly with the Buddy™ Agent platform, enabling continuous monitoring rather than point-in-time snapshots. When deployed as a recurring audit, the skill tracks pattern resolution over time, measures improvement velocity, and alerts on regression. This transforms the traditional audit from a one-off consulting deliverable into an always-on optimization layer.

## Use When

- User asks to "audit my Google Ads account"
- User wants a "full account review" or "health check"
- User mentions "what's wrong with my campaigns"
- User asks to "find wasted spend" or "identify optimization opportunities"
- User requests "account diagnosis" or "performance analysis"
- User wants to "check campaign structure" or "review account settings"
- User asks "why is my CPC so high" or "why are my conversions dropping"
- User mentions "audit all 20 categories" or "comprehensive review"

## Architecture

```mermaid
flowchart TD
    A[Google Ads API] -->|Pull Account Data| B[Data Extraction Layer]
    B --> C[Campaign Data]
    B --> D[Ad Group Data]
    B --> E[Keyword Data]
    B --> F[Ad Copy Data]
    B --> G[Conversion Data]
    B --> H[Audience Data]

    C --> I[Pattern Matching Engine]
    D --> I
    E --> I
    F --> I
    G --> I
    H --> I

    J[gads-knowledge.js\n1,000 Patterns] --> I

    I --> K{Severity Scoring}
    K -->|Critical| L[Immediate Action Items]
    K -->|High| M[Priority Optimizations]
    K -->|Medium| N[Improvement Opportunities]
    K -->|Low| O[Best Practice Refinements]

    L --> P[Audit Report Generator]
    M --> P
    N --> P
    O --> P

    P --> Q[Prioritized Findings by Category]
    P --> R[Estimated Revenue Impact]
    P --> S[Implementation Roadmap]
```

## Implementation

The audit loads patterns from the knowledge base and evaluates each against live account data:

```javascript
import { GoogleAdsApi } from 'google-ads-api';
import { auditPatterns } from './gads-knowledge.js';

const AUDIT_CATEGORIES = [
  'campaign_structure', 'bidding', 'keywords', 'ad_copy',
  'pmax', 'shopping', 'audiences', 'conversions',
  'budget', 'quality_score', 'search_terms', 'display',
  'video_youtube', 'remarketing', 'reporting', 'account_structure',
  'landing_pages', 'competitive_strategy', 'automation', 'policy'
];

async function runFullAudit(customerId, credentials) {
  const client = new GoogleAdsApi({ ...credentials });
  const customer = client.Customer({ customer_id: customerId });

  const accountData = await extractAccountData(customer);
  const findings = [];

  for (const category of AUDIT_CATEGORIES) {
    const categoryPatterns = au