Ad Copy Generation

# Ad Copy Generation

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

## Description

The Ad Copy Generation skill produces high-performance responsive search ad (RSA) copy using AI-driven generation pipelines calibrated against millions of ad performance data points. It generates headlines (up to 15, max 30 characters each) and descriptions (up to 4, max 90 characters each), optimizing for ad strength, click-through rate, and conversion relevance while adhering to Google Ads editorial policies.

The generation engine applies proven copywriting frameworks including AIDA (Attention, Interest, Desire, Action), PAS (Problem, Agitate, Solve), and benefit-driven messaging. It incorporates dynamic keyword insertion (DKI) syntax where appropriate, manages pin strategies for controlled ad assembly, and generates systematic A/B testing variants. Each ad variant is scored against Google's ad strength criteria before submission.

Beyond generation, the skill manages the full ad copy lifecycle: competitive ad analysis to identify messaging gaps, performance-based variant pruning, statistical significance testing for A/B experiments, and automated winner scaling. It integrates with the Buddy™ platform to learn from historical performance data, continuously improving generation quality for each specific account and industry vertical.

## Use When

- User asks to "write ad copy" or "generate ads"
- User wants "new headlines" or "new descriptions" for RSAs
- User mentions "ad strength" improvement
- User asks for "A/B test variants" or "ad testing"
- User wants to "improve click-through rate" on ads
- User mentions "responsive search ads" or "RSA optimization"
- User asks about "dynamic keyword insertion" or "DKI"
- User wants "pin strategy" recommendations
- User asks to "refresh stale ad copy" or "combat ad fatigue"

## Architecture

```mermaid
flowchart TD
    A[Input: Keywords, Landing Page, USPs] --> B[Context Analysis]
    B --> C[Landing Page Scraper]
    B --> D[Keyword Intent Classifier]
    B --> E[Competitor Ad Analyzer]

    C --> F[Message Map Builder]
    D --> F
    E --> F

    F --> G[AI Generation Engine]
    G --> H[Headline Generator\nmax 30 chars x 15]
    G --> I[Description Generator\nmax 90 chars x 4]

    H --> J[Policy Compliance Check]
    I --> J

    J --> K[Ad Strength Scorer]
    K -->|Excellent| L[Final Ad Variants]
    K -->|Good| L
    K -->|Average| M[Regenerate with Feedback]
    K -->|Poor| M
    M --> G

    L --> N[Pin Strategy Optimizer]
    N --> O[A/B Test Plan]
    O --> P[Deploy to Google Ads]
```

## Implementation

Core ad copy generation with character limit enforcement and DKI support:

```javascript
const HEADLINE_MAX_LENGTH = 30;
const DESCRIPTION_MAX_LENGTH = 90;
const MAX_HEADLINES = 15;
const MAX_DESCRIPTIONS = 4;

const COPYWRITING_FRAMEWORKS = {
  AIDA: ['attention', 'interest', 'desire', 'action'],
  PAS: ['problem', 'agitate', 'solve'],
  BENEFIT: ['primary_benefit', 'secondary_benefit', 'proof', 'cta']
};

async function generateAdCopy(config) {
  const { keywords, landingPageUrl, usps, industry, targetAudience } = config;

  const landingPageContent = await scrapeLandingPage(landingPageUrl);
  const competitorAds = await analyzeCompetitorAds(keywords);
  const intentSignals = classifyKeywordIntent(keywords);

  const headlines = await generateHeadlines({
    keywords,
    usps,
    competitorAds,
    intentSignals,
    landingPageContent,
    maxLength: HEADLINE_MAX_LENGTH,
    count: MAX_HEADLINES
  });

  const descriptions = await generateDescriptions({
    keywords,
    usps,
    landingPageContent,
    maxLength: DESCRIPTION_MAX_LENGTH,
    count: MAX_DESCRIPTIONS
  }