# gaql-reference

Скилл помогает составлять запросы GAQL для отчётов Google Ads и разбираться в ресурсах, полях и фильтрах. Пригодится, когда нужно подготовить запрос или проверить его структуру.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 111
- Автор: Cogny AI
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cognyai/claude-code-marketing-skills/tree/HEAD/skills/gaql-reference/SKILL.md
- Обновлён: 2026-10-12
- HTML: https://affpapa.org/nevibecode/skills/gaql-reference

## Что делает

Скилл объясняет устройство запросов GAQL: выбор полей и ресурса, условия фильтрации, сортировку, лимит строк и параметры. В справке разобраны ресурсы кампаний, групп объявлений, поисковых запросов, географии и истории изменений. По теме можно запросить готовый шаблон, например для анализа показателя качества или поисковых запросов.

При подключённых инструментах Cogny MCP скилл может передать запрос Google Ads на выполнение и обратиться к документации API. Без подключения справочная часть всё равно работает, но запросы не запускаются. Для Microsoft Ads предусмотрен отдельный инструмент отчётов: GAQL там не используется, поэтому запросы Google Ads к нему неприменимы.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/gaql-reference/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/gaql-reference/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/gaql-reference/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/gaql-reference/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cognyai/claude-code-marketing-skills gaql-reference
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/gaql-reference/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/cognyai/claude-code-marketing-skills --path skills/gaql-reference
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/gaql-reference/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/cognyai/claude-code-marketing-skills/tree/HEAD/skills/gaql-reference/SKILL.md

## Когда брать
- составить GAQL-запрос для отчёта по поисковым запросам
- выбрать ресурс для анализа географических показателей
- отфильтровать кампании по статусу и периоду
- проверить структуру запроса перед запуском
- найти запрос для аудита истории изменений

## Примеры запросов агенту
- Составь GAQL-запрос для отчёта по поисковым запросам за последние 30 дней.
- Покажи запрос для анализа показателя качества в Google Ads.
- Объясни, какой ресурс выбрать для отчёта по географическим показателям.

## Похожие
- [seo-audit](https://affpapa.org/nevibecode/skills/coreyhaines31-seo-audit.md) — скилл · 238500 установок
- [programmatic-seo](https://affpapa.org/nevibecode/skills/coreyhaines31-programmatic-seo.md) — скилл · 150800 установок
- [copy-editing](https://affpapa.org/nevibecode/skills/coreyhaines31-copy-editing.md) — скилл · 149800 установок
- [marketing-ideas](https://affpapa.org/nevibecode/skills/coreyhaines31-marketing-ideas.md) — скилл · 147400 установок
- [sales-enablement](https://affpapa.org/nevibecode/skills/sales-enablement.md) — скилл · 119400 установок
- [revops](https://affpapa.org/nevibecode/skills/revops.md) — скилл · 114000 установок

Из того же набора: [cognyai/claude-code-marketing-skills](https://affpapa.org/nevibecode/by/cognyai/claude-code-marketing-skills.md) — 38 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md