All skills

Работа с рекламой в Яндекс Директе через официальный API: анализ статистики, конверсий и поисковых запросов, аудит, создание и изменение кампаний, объявлений, фраз, ставок, условий ретаргетинга и настроек, выгрузки и предпросмотр. Используй для задач о рекламе Директа, ЕПК, расходах, эффективности, позициях в поиске, модерации, минус-фразах и управлении рекламным кабинетом.

Use this Skill: https://skilld.dev/gh/artwist-polyakov/polyakov-claude-skills/yandex-direct

This session only. Nothing lands on disk.

referencesMANUAL_SETUP.md

≈6.3k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Как довести задачу до результата через интерфейс

Если нужное действие отсутствует в командах скилла или API, подготовьте всё необходимое для его выполнения человеком. Это относится к созданию кампаний, настройке целей, работе с материалами и любым другим ручным шагам. Ниже приведён общий порядок и пример для Мастера кампаний.

Передача ручного шага

Сначала объясните, какой результат нужен и почему выбрана эта настройка. Проверьте, можно ли выполнить её имеющимися командами. Отсутствие готовой команды и отсутствие возможности в API — разные ограничения: называйте фактическую причину.

Дайте человеку инструкцию, которую можно выполнить без самостоятельной разработки рекламной кампании:

  1. Что открыть. Сервис, кабинет, конкретная кампания или счётчик, путь к разделу. Названия кнопок сверяйте с действующей справкой или доступным интерфейсом. Если путь изменился, уточните текущее расположение, не придумывайте его.
  2. Что ввести. Подготовленные тексты, ссылки, файлы, список целей с ID, значения параметров. Недостающие данные обозначайте явно: «Недельный бюджет не задан — нужно выбрать сумму». Не заполняйте их случайными числами.
  3. Зачем это нужно. Одно короткое объяснение для существенной настройки: какой результат она улучшает или какое ограничение задаёт.
  4. Что произойдёт после нажатия. Сохранение черновика, отправка на модерацию, изменение работающей рекламы или начало расходования средств.
  5. Как проверить результат. Ожидаемое значение после сохранения, событие в Метрике, статус кампании или строка отчёта. Укажите, кто выполняет проверку и какие сведения нужно вернуть агенту.

Подготовьте материалы и таблицу итоговых настроек до передачи ручного шага. Уже согласованные в разговоре цели и значения используйте повторно. Если запуск входит в поручение и параметры определены, не добавляйте ещё одно согласование без причины. Если поручена только подготовка, оставьте результат готовым к запуску и ясно обозначьте завершающее действие.

После ручного выполнения проверьте доступную статистику или сохранённые настройки. Не называйте действие выполненным, если подготовлена только инструкция.

Пример: Мастер кампаний для продвижения сайта

Этот пример подходит, когда нужна автоматическая кампания для получения выбранных пользователем целевых действий на сайте. Текущие команды скилла не создают такие кампании; статистику после создания можно получать через Reports. Возможности самого инструмента описаны в справке Мастера кампаний.

1. Подготовить данные и материалы

Перед настройкой соберите или подготовьте:

Что понадобится Что должно быть определено
Кабинет и сайт Логин, полная ссылка на продвигаемую страницу, название будущей кампании
Предложение Что продаём, кому, по какой действующей цене, в какие сроки и на какой территории
Результат рекламы Одна или несколько ценных целей, выбранных пользователем
Обработка обращений Куда поступает заявка, кто отвечает и когда; для продаж — где подтверждается оплата
Деньги Допустимый расход за неделю, период запуска, приемлемая цена каждой выбранной цели
Объявления Готовые заголовки, тексты, изображения или видео, быстрые ссылки и контакты

Не останавливайтесь на просьбе «добавьте хорошие объявления». Подготовьте варианты под фактическое предложение. Проверьте названия месяцев, цены, сроки акции и условия на сайте. Для изображений дайте готовые файлы либо точное задание на недостающий материал.

У каждого текста должны быть понятное предложение и следующий шаг для клиента. Ссылки должны вести к соответствующим товарам, услугам или условиям. Перепроверьте сочетания заголовков, текста и изображений: каждое должно сохранять смысл и действующую цену. Рекомендации Яндекса по заголовкам и текстам.

2. Подготовить счётчик и доступ

Откройте нужный счётчик в Метрике и проверьте домен. Если счётчика ещё нет, нажмите Добавить счётчик, заполните сведения о сайте и установите полученный код на его страницы. В разделе Настройка → Счётчик → Скопировать доступен код для установки; владельцу сайта или разработчику передайте конкретный домен и номер счётчика. Создание и установка счётчика.

Если Метрика и Директ используют разные логины, владелец счётчика открывает Настройки → Доступ → Индивидуальный доступ → Добавить пользователя, вводит нужный логин, выбирает соответствующие задаче права и сохраняет изменения. Для просмотра достаточно просмотра; для изменения существующей цели нужны права редактирования. Пароль или токен передавать человеку либо агенту для этого не требуется. Доступ к счётчику.

Результат шага: известны номер счётчика, сайт и логин, который видит его в Директе.

3. Создать или проверить ценные цели

Покажите пользователю имеющиеся цели с названиями и ID. Выясните, какой факт означает результат бизнеса. Существующую работающую цель используйте повторно.

Результат Когда считать цель достигнутой Что недостаточно само по себе
Принятая заявка Сервер принял форму и создал обращение в системе обработки заявок Клик по кнопке, незаполненная форма, сообщение об ошибке
Подтверждённая оплата Заказ получил подтверждённый статус оплаты Добавление в корзину, переход к оплате, возврат из платёжной системы без проверки статуса
Качественный звонок Система учёта звонков подтвердила согласованные признаки целевого звонка Нажатие на номер телефона

Если нужна новая цель, в Метрике откройте Цели → Добавить цель → Целевое событие. Задайте понятное название и идентификатор события, например lead_accepted для принятой заявки. Выберите точное совпадение идентификатора и сохраните цель. Сайт передаёт событие через reachGoal; для событий вне сайта используется передача офлайн-данных. Настройка целевого события.

Передайте разработчику сайта конкретное задание:

Для счётчика с указанным номером отправлять reachGoal с идентификатором lead_accepted после успешного создания заявки. Не отправлять при ошибке проверки полей, отказе сервера или простом клике. Повторная отрисовка сообщения об успехе не должна создавать повторную цель для той же заявки. Для оплаты завести отдельное событие после подтверждения оплаты, если пользователь выбрал именно этот результат.

Названия событий в этом примере — предлагаемые имена для новых целей. У существующей цели сохраняйте её реальное имя события. Числовой ID цели для Директа и текстовый идентификатор события для сайта — разные значения; запишите оба.

Если подтверждённая оплата известна только системе учёта заказов, настройте передачу оттуда. В Метрике данные из CRM могут создавать отдельные цели, включая оплаченный заказ. Выберите именно нужный статус. Загрузка данных из CRM. Для магазина с электронной коммерцией проверьте, как именно сайт отправляет событие purchase: его название само по себе не доказывает, что деньги получены. Передача электронной коммерции.

4. Проверить цель на настоящем сценарии

  1. Откройте сайт с параметром _ym_debug=2: например, https://example.com/?_ym_debug=2. Если в адресе уже есть параметры, добавьте &_ym_debug=2.
  2. Выполните целевое действие и проверьте в отладчике Метрики нужный счётчик и событие. При включённом исключении собственных визитов используйте приватное окно. Официальная проверка цели.
  3. Сопоставьте отправленное событие с реальной заявкой или подтверждённой оплатой. Затем проверьте ошибочный сценарий: неотправленная форма или отменённая оплата не должны давать ту же цель. Это практическая проверка того, что измеряется результат, который выбрал пользователь.
  4. Найдите цель по имени или ID в разделе Конверсии Метрики, задайте период проверки и проверьте достижения и целевые визиты. Данные появляются после обработки. Отчёт «Конверсии».

Сохраните название, ID, счётчик, время проверки и её результат. Прямой тестовый визит проверяет работу цели; он не обязан появиться как рекламная конверсия Директа.

5. Собрать кампанию

В Директе откройте Добавить → Кампанию → Мастер кампаний → Конверсии и трафик и укажите подготовленную ссылку. Заполните объявления, Быстрые ссылки, регион и время показов. В Аудитория выберите подходящий режим: Подобрать оптимальную или Настроить вручную. Создание кампании.

Проверьте всё, что Директ предложил автоматически, по подготовленным материалам. Регион должен соответствовать территории обслуживания, а расписание — возможности принимать обращения. Автоматическое расширение и рекомендации оценивайте по задаче бизнеса.

Мастер выбирает места показов автоматически. Если нужны выбор размещений или исключение площадок, подберите другой инструмент до запуска. Возможности размещения.

6. Выбрать цели, стратегию и бюджет

В Цель продвижения выберите Максимум целевых действий. Добавьте счётчик, выбранные Целевые действия и их цены. Проверьте автоматически добавленные цели Карт, если подключена организация. Цели кампании.

Цена цели означает, сколько готовы платить за результат. Доход от заказа — другая величина. Не подставляйте его в поле цены привлечения. Если допустимая цена ещё не определена, подготовьте расчёт из фактической цены результата в истории и экономики продажи, затем получите недостающее значение у пользователя. Укажите исходные данные и допущения; средний чек сам по себе не определяет допустимый рекламный расход.

Вариант цены в Мастере Как оплачивается реклама
Средняя цена за неделю Оплата за клики; алгоритм стремится к заданной средней цене результата
Фиксированная цена Оплата за конверсии; при нескольких достигнутых выбранных целях оплачивается каждая

Сопоставьте режим оплаты с выбранными событиями. Если заявка и оплата могут произойти в одном визите, заранее объясните последствия выбора обеих целей. Режимы оплаты Мастера.

Задайте согласованный Недельный бюджет. Для ограниченного периода отдельно определите дату проверки и остановки: недельная сумма не задаёт общий расход за всё время. Зафиксируйте валюту, учёт НДС и сумму пополнения по интерфейсу кабинета. Минимум и ограничения выбранного режима берите из текущей формы, а не из произвольного примера.

Если рассматривается Адаптация бюджета, отдельно укажите допустимое увеличение и верхнюю границу расходов. Эта настройка может увеличить бюджет следующей недели, поэтому её нельзя включать молча при фиксированном бюджете пользователя. Адаптация бюджета.

Слишком низкая целевая цена способна ограничить число результатов. Для первого вывода о работе автоматической стратегии Яндекс рекомендует 7–14 дней; отслеживание технических ошибок начинают сразу. Как работает «Максимум конверсий».

7. Показать итоговые настройки и отправить кампанию

Перед завершающим действием заполните таблицу фактическими данными. Она должна быть понятна человеку без чтения кода.

Настройка Было Будет
Кабинет, кампания Реальные данные или «новая кампания» Название, тип, кабинет
Страница перехода Текущий адрес или «не задан» Полный проверенный адрес
Объявления Текущие варианты или «не созданы» Готовые тексты и файлы; отдельно изменённые месяцы, цены и сроки
Аудитория Текущие настройки или «не заданы» Территория, расписание, режим подбора аудитории
Счётчик и цели Текущий выбор или «не заданы» Номер счётчика; название и ID каждой выбранной цели
Цена и оплата Текущие значения или «не заданы» Цена каждой цели, валюта, выбранный режим оплаты
Бюджет Текущий бюджет или «не задан» Сумма за неделю; адаптация; согласованный предел расходов
Период Текущие даты или «не заданы» Начало, дата проверки, условие остановки
Проверка Что уже проверено Кто сверяет запуск, цели и первые результаты

Создать кампанию отправляет её на модерацию; Сохранить как черновик сохраняет подготовку. Показы могут начаться после одобрения при наличии денег. Модерация и запуск. Если требуется пополнение, пользователь выбирает подходящий ему способ и проверяет сумму в кабинете. Способы оплаты.

После отправки зафиксируйте ID и фактический статус кампании. При отклонении прочитайте причину конкретного элемента, подготовьте исправление и покажите его до/после. После сохранения сверьте настройки с таблицей.

8. Проверить рекламу после запуска

Откройте Статистика под названием кампании либо Статистика → Мастер отчётов. Задайте фактические даты работы и те же ценные цели. Мастер отчётов Директа.

Проверьте расход, показы, клики и конверсии отдельно по каждой выбранной цели. Через скилл можно получить отчёт по ID кампании:

uv run scripts/report.py --account client-login --campaign 123456 \
  --preset campaigns --period LAST_7_DAYS --goals 20002,20003 \
  --attribution AUTO --no-cache

В примере логин, кампания и цели условные; замените их фактическими значениями. Атрибуцию и НДС приведите к тем же настройкам, что используете в интерфейсе. Формулы и особенности сравнения приведены в REPORTS.md.

Сверьте конверсии с принятыми заявками или оплаченными заказами за сопоставимый период. Учитывайте задержку обработки и время от рекламного перехода до результата. При отсутствии конверсий сначала проверьте, работает ли событие, выбран ли нужный ID и успели ли накопиться данные; только затем обсуждайте изменения рекламы.

Передайте пользователю конкретный результат: кампания создана или подготовлена; её ID и статус; выбранные цели; фактические бюджет и режим оплаты; что проверено; какое действие ещё требуется и по каким данным будет оцениваться результат.

Source: SKILL.md on GitHub

No alerts3d3 checks · Risk SAFE
  • Gen Agent Trust Hub3d

    The yandex-direct skill is a professional and security-conscious implementation for managing Yandex Direct advertisements. It features a robust secret-redaction system that automatically masks OAuth tokens in all logs and outputs. Additionally, it provides specific protections against path traversal, symlink attacks, and accidental credential leakage via HTTP redirects.

  • Socket3d

    No alerts

  • Snyk3d

    Risk: LOW · No issues

Signed by skilld at 75f331e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 2 weeks ago

README badge

README badge for artwist-polyakov/polyakov-claude-skills/yandex-direct