---
name: google-ads
description: Собирает и правит поисковые кампании Google Ads — ключевые слова с типами соответствия, минус-слова, группы, адаптивные поисковые объявления (заголовки по 30 знаков, описания по 90), быстрые ссылки и уточнения — и проверяет их по лимитам Google. На выходе CSV для импорта в Google Ads Editor. Использовать, когда нужно создать кампанию в Google Ads, написать RSA-объявления, собрать ключевые слова и минус-слова, проверить длину заголовков. Триггеры — «Google Ads», «гугл реклама», «RSA», «адаптивные объявления», «Google Ads Editor», «ключевые слова для Google».
---

# Поисковая кампания для Google Ads

Скилл готовит кампанию, а не запускает рекламу: агент собирает ключевые слова, пишет
адаптивные поисковые объявления (RSA), быстрые ссылки и уточнения, раскладывает всё в
`campaign.json`, а скрипт `scripts/gads_campaign.py` проверяет лимиты Google и
выгружает CSV для Google Ads Editor. Кампания в файле — на паузе: включает её человек.

## Четыре правила, которые нельзя нарушать

1. **Ничего не загружать в аккаунт без явного «да».** Скрипт в интернет не ходит. Для
   загрузки через Google Ads API нужны developer token, OAuth и номер аккаунта клиента —
   этим скилл не занимается; не проси прислать токены в чат.
2. **Не выдумывать факты о бизнесе.** Цены, сроки, скидки, «лучший», гарантии — только из
   того, что дал пользователь или что есть на его сайте. Google отклоняет непроверяемые
   превосходные степени и рекламу, которая обещает больше, чем страница.
3. **Объём поиска не угадывать.** У агента нет доступа к Планировщику ключевых слов:
   слова он предлагает по смыслу, объём и ставки пользователь проверяет в Google Ads.
4. **Где показывается реклама.** С марта 2022 года Google не показывает рекламу
   пользователям в России и приостановил обслуживание рекламодателей из России. Скилл —
   для кампаний на другие страны из аккаунтов, которые Google обслуживает. Если
   пользователь планирует показ в России — скажи об этом до работы.

## Порядок работы

1. **Бриф.** Что продаём, сайт и посадочные страницы, страны и язык показа, чем
   отличаемся (факты), что не продаём (для минус-слов), дневной бюджет.
2. **Ключевые слова.** Группа — одно намерение, 5–20 слов. Тип соответствия — в записи:
   `кофе в зернах` — широкое, `"кофе в зернах"` — фразовое, `[кофе в зернах]` — точное.
   Широкое без умной стратегии ставок даёт много мусора — для старта бери фразовое и точное.
3. **Минус-слова.** На кампанию — нецелевое для всех групп, на группу — то, что уводит в
   соседнюю. Тип соответствия у минус-слов работает так же, но без расширения на синонимы.
4. **Объявления.** До 3 RSA в группе. В каждом — 8–15 заголовков по 30 знаков и 2–4
   описания по 90. Заголовки разные по смыслу: товар, выгода, срок, доверие, призыв;
   ключевое слово — в двух-трёх. Закрепляй (`pin`) только то, что обязано стоять первым
   (бренд, юридическая оговорка): каждое закрепление уменьшает число сочетаний.
   Восклицательный знак в заголовке Google не пропустит.
5. **Быстрые ссылки и уточнения.** Ссылки: текст до 25 знаков, две строки описания по 35,
   минимум две ссылки. Уточнения — по 25 знаков. Только существующие страницы сайта.
6. **Собери `campaign.json`** по образцу `examples/campaign.json` и проверь:
   `python3 scripts/gads_campaign.py check campaign.json` (в Windows — `python`; в Claude
   Code путь к папке скилла — `${CLAUDE_SKILL_DIR}`). Исправь все ✗.
7. **Выгрузи:** `python3 scripts/gads_campaign.py csv campaign.json kampaniya.csv` —
   UTF-16 с табуляцией, как советует справка Editor. Флаг `--utf8` — UTF-8 с запятыми,
   если файл нужно открыть в редакторе таблиц.
8. **Расскажи, как загрузить:** Google Ads Editor → Аккаунт → Импорт → Из файла →
   проверить изменения → «Опубликовать». Подробнее — `references/editor-csv.md`.

## Формат campaign.json

```json
{
  "campaign": {"name": "…", "daily_budget": 5000, "final_url": "https://…",
    "negatives": ["бесплатно", "\"своими руками\""],
    "sitelinks": [{"text": "…", "description1": "…", "description2": "…", "final_url": "https://…"}],
    "callouts": ["…"]},
  "ad_groups": [{
    "name": "…", "keywords": ["…", "\"…\"", "[…]"], "negatives": ["…"],
    "ads": [{"headlines": [{"text": "…", "pin": 1}, "…"], "descriptions": ["…"],
             "path1": "…", "path2": "…", "final_url": "https://…"}]
  }]
}
```

Бюджет — в валюте аккаунта. Регионы, языки, стратегию ставок и расписание файл не
задаёт — их выставляют в Editor или интерфейсе до публикации.

## Чего этот скилл не делает

- Не загружает кампанию в аккаунт и не публикует изменения — это делает человек в Editor.
- Не показывает объём поиска и ставки: Планировщика ключевых слов у агента нет.
- Не настраивает конверсии, стратегию ставок, аудитории, Performance Max и медийные
  кампании — только поисковые с RSA.
- Не обходит ограничения Google для России.
- Картинки для медийных объявлений — скилл reklamnye-kreativy.