---
name: google-ads-copilot
description: Claude Code skill bundle cho Google Ads — 15 audit skills (search terms, structure, budget, RSAs, PMax, ...). Pull data via Google Ads MCP server (GAQL) hoặc CSV export.
---

# Skill: Google Ads Copilot — 15 audit kỹ năng

## Skill này làm gì

Bundle 15 skill chạy trong Claude Code, giúp bạn audit + tối ưu Google Ads theo lối "intent-first" (đọc ý định người tìm kiếm thay vì chỉ nhìn CTR/CPA). 3 lớp: **Read** (kéo data), **Draft** (sinh đề xuất review được), **Apply** (chỉ thực thi khi bạn duyệt — có dry-run + manifest + cooldown 7 ngày). Hỗ trợ MCP live (GAQL) lẫn CSV export.

## Khi nào dùng

- Audit toàn diện tài khoản Google Ads (search/PMax/Display)
- Tìm search term lãng phí + sinh negative keyword list
- Quality Score diagnostics + RSA copy hợp ý định buyer
- Performance Max deep dive (chống "intent contamination")
- Daily standup / weekly report ngân sách + bleeding campaigns
- Plan lại cấu trúc account từ zero hoặc rebuild

## Cách cài (Claude Code skill, 10 phút)

```bash
git clone https://github.com/TheMattBerman/google-ads-copilot.git
cd google-ads-copilot
./install.sh auto

cp data/google-ads-adc-authorized-user.template.json \
   data/google-ads-adc-authorized-user.json
cp data/google-ads-mcp.test.env.example.sh \
   data/google-ads-mcp.test.env.sh

source data/google-ads-mcp.test.env.sh
./scripts/test-mcp.sh
```

Nếu chưa có API → **Export mode**: paste CSV export từ Google Ads UI thẳng vào chat.

## Câu lệnh chủ đạo (Vietnamese)

```
/google-ads audit

Bạn audit giùm tôi tài khoản Google Ads <customer_id>.
Tập trung 3 thứ:
1. Search term nào đang đốt tiền không ra chuyển đổi (>500K không có conversion)
2. Campaign nào intent contamination
3. Đề xuất negative keyword list + budget reallocation

Output bằng tiếng Việt. Số tiền hiển thị VND. 
Draft trước, đừng apply gì cả — tôi review xong mới chạy /google-ads apply.
```

15 slash command:
- `/google-ads connect` — health check + chọn account
- `/google-ads daily` — bleeding campaigns + waste pattern khẩn
- `/google-ads audit` — review chiến lược toàn diện
- `/google-ads draft-summary` — show queue draft chờ duyệt
- `/google-ads search-terms` — phát hiện waste/signal
- `/google-ads intent-map` — build model ý định search
- `/google-ads negatives` — sinh negative keyword
- `/google-ads tracking` — kiểm tra conversion tracking
- `/google-ads structure` — đề xuất restructure campaign
- `/google-ads rsas` — sinh RSA copy theo buyer language
- `/google-ads budget` — guide scaling + ngân sách
- `/google-ads plan` — plan/rebuild kiến trúc account
- `/google-ads pmax` — analyze Performance Max
- `/google-ads landing-review` — chẩn đoán landing page
- `/google-ads apply [draft-name]` — execute draft đã duyệt

## Quyền hạn cần thiết

- **Google Ads Developer Token** (apply tại `ads.google.com/aw/apicenter`)
- **OAuth credentials** (GCP project + Desktop OAuth client)
- **Environment variables**:
  - `GOOGLE_APPLICATION_CREDENTIALS` — path ADC JSON
  - `GOOGLE_CLOUD_PROJECT` — GCP project ID
  - `GOOGLE_ADS_DEVELOPER_TOKEN`
  - `GOOGLE_ADS_LOGIN_CUSTOMER_ID` — bắt buộc nếu chạy qua MCC
- **Apply scope giới hạn**: negative keyword + pause keyword/ad group + set daily budget. KHÔNG cho: tạo campaign mới, sửa RSA, enable paused entity, delete, đổi bid strategy
- **Safety guardrail**: budget change cap 30%/lần, cooldown 7 ngày, block nếu tracking chưa pass

## Lưu ý cho doanh nghiệp Việt Nam

- Setup Google Ads API + OAuth + Developer Token ~30-60 phút lần đầu
- Đường cài API + OAuth + Developer Token này đã chạy thật và verify được (lần đầu mất khoảng 30–60 phút). Số tài khoản quảng cáo là của riêng bạn, không dùng chung với ai.
- Output English-default → wrapper "Output bằng tiếng Việt"
- Tiền tệ: API trả ra micro-units (÷1.000.000 → VND) — Claude auto-convert
- Account ngân sách nhỏ (<500K/ngày): dùng `/google-ads daily` thay `/google-ads audit`

## Mẹo dùng hiệu quả

1. **Chạy `/google-ads tracking` TRƯỚC mọi audit khác** — nếu tracking không trust thì mọi recommendation đều rác
2. **Luôn review draft trước khi `apply`** — `/google-ads draft-summary` xem queue + risk note
3. **Export mode tốt cho SME chưa có API** — paste CSV search term report thẳng vào chat

---

**Tác giả:** Eroca Thanh · 2026-05-28
