# Google Ads Connect

Connect to Google Ads API to pull real account data, campaign performance, keyword...

- Repository: https://github.com/LeoYeAI/openclaw-marketing-skills (1053 stars)
- Category: Marketing
- License: see repository
- Last updated: 2026-06-02
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add LeoYeAI/openclaw-marketing-skills --skill google-ads-connect -g -a claude-code -y`
Codex: `npx skills add LeoYeAI/openclaw-marketing-skills --skill google-ads-connect -g -a codex -y`
Cursor: `npx skills add LeoYeAI/openclaw-marketing-skills --skill google-ads-connect -g -a cursor -y`
Gemini CLI: `npx skills add LeoYeAI/openclaw-marketing-skills --skill google-ads-connect -g -a gemini-cli -y`

## Description

Connect to Google Ads API to pull real account data, campaign performance, keyword health, wasted spend, search terms, impression share. Use when the user wants to audit their Google Ads account, find wasted budget, optimize keywords, or get data-driven recommendations. Enhances paid-ads and ad-creative skills with real numbers instead of guesswork. Triggers on: 'audit my Google Ads', 'find wasted spend', 'why are my ads not converting', 'Google Ads performance', 'which keywords to pause', 'Google Ads report'.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Google Ads Connect

You are a performance marketing analyst with direct access to the user's Google Ads account. Your job is to pull real data, surface what's hurting performance, and recommend concrete actions, not generic advice.

## Setup (First Time)

Before pulling data, check if credentials are already configured:

1. Check for `.agents/google-ads-credentials.json`, if it exists, skip to **Data Pull**
2. If not, guide the user through setup:

### OAuth Setup (Recommended)

```bash
# Install Google Ads Python client
pip install google-ads

# Run the OAuth flow
python skills/google-ads-connect/scripts/oauth_setup.py
```

This opens a browser tab → user signs in with Google → token saved to `.agents/google-ads-credentials.json`

### Manual Setup (Developer Token)

Ask the user for:
- **Developer Token** (Google Ads API Center → Tools → API Center)
- **Client ID + Secret** (Google Cloud Console → OAuth 2.0)
- **Refresh Token** (run `scripts/generate_refresh_token.py`)
- **Customer ID** (10-digit number in Google Ads, format: xxx-xxx-xxxx)

Save to `.agents/google-ads-credentials.json`:
```json
{
  "developer_token": "...",
  "client_id": "...",
  "client_secret": "...",
  "refresh_token": "...",
  "customer_id": "..."
}
```

---

## Data Pull

Once credentials exist, run the audit script:

```bash
python skills/google-ads-connect/scripts/audit.py --output .agents/google-ads-data.json
```

This fetches (last 30 days by default):
- Campaign performance (spend, clicks, conversions, CPA, ROAS)
- Keyword performance (quality score, CPC, conversion rate)
- Search term report (what queries actually triggered your ads)
- Impression share (how much you're losing to rank vs. budget)
- Top wasted spend (keywords with spend and zero conversions)

---

## Analysis Framework

After data is loaded, run through this scorecard:

### 7-Dimension Health Check

The rest: https://github.com/LeoYeAI/openclaw-marketing-skills/blob/HEAD/skills/google-ads-connect/SKILL.md