All skills

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

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

This session only. Nothing lands on disk.

referenceshypotheses.md

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

Проверяемые идеи роста

Здесь сохранены приёмы из интервью с владельцем проекта от 26.08.2026. Это варианты для проверки, а не обязательные настройки или доказанные способы увеличить продажи. Отсутствие такого эксперимента не является ошибкой кампании. Практики настройки описаны в PLAYBOOK.md, команды и расчёты — в REPORTS.md, порядок записи — в CHANGES.md.

Как предложить и оценить эксперимент

Повод должен быть понятен из данных или запроса пользователя. Назовите, что именно предлагается изменить и почему это может помочь. Пользователь вправе проверить вариант, который вы не рекомендуете, или отказаться от предложенного. Объясните последствия и следуйте его задаче; сама рекомендация не разрешает запись.

До запуска определите:

  • объект и конкретное изменение;
  • ожидаемый результат и условия, при которых приём имеет смысл;
  • допустимый расход, срок и достаточный для решения объём наблюдений;
  • выбранные пользователем ценные цели, атрибуцию и исходные показатели;
  • отчёт и наблюдаемый критерий успеха, остановки или возврата прежних настроек;
  • способ выполнения: готовая команда, поддержанный метод API или интерфейс.

Цена попытки бывает разной:

Вид Чем платим Что учитывать
Проверка без нового расхода Работой и вниманием Например, анализируем уже накопленные данные без изменения показов
Дополнительные показы или конверсии Рекламным бюджетом Нужны предел расхода и срок; успешный запуск тоже стоит денег
Повторное обучение Расходом и временем всей кампании Оценивать последствия только по одной настройке недостаточно

Обе действующие идеи ниже открывают рекламный расход. Не называйте попытку бесплатной потому, что один из возможных неудачных исходов ничего не стоит. Лимит кампании тоже не делает новую площадку бесплатной: если бюджет раньше выбирался не полностью, расход может вырасти; если полностью — новое размещение получит часть денег остальных размещений.

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

Показывайте и результат самого эксперимента, и итог кампании или кабинета. Сравнение «до и после» показывает изменение, но само по себе не устанавливает причину: одновременно меняются спрос, аукцион и соседние кампании. Ровный итог может означать как перераспределение заявок, так и новый результат, компенсировавший общее снижение спроса. Для более надёжного вывода нужен одновременный контроль — сопоставимая часть спроса без изменения; организовать его удаётся не всегда. Остановка кампании с последующим сравнением периодов такого контроля не создаёт.

Если заранее согласован критерий остановки и пользователь поручил его выполнить, следуйте этому условию. Иначе представьте фактические показатели и варианты продолжения или возврата. Неудачная попытка в одном кабинете означает «здесь не сработало», а не опровержение приёма для всех тематик.

Товарная галерея без фида

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

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

Когда предложить. Товар один или их немного, фида нет и его подготовка дорога, зато есть готовое объявление и достоверная цена. Обязательное условие — кампания показывает рекламу на поиске: галерея находится на странице выдачи. Кампания только с сетями не проверяет эту гипотезу. Если каталог и фид уже есть, сначала рассмотрите обычный товарный вариант из PLAYBOOK.md.

Цена может работать как преимущество — «дешевле других», — либо как фильтр, который сознательно сокращает нецелевые клики. Определите нужную роль с пользователем до добавления цены; это часть предложения, а не незаметный побочный эффект эксперимента.

Как выполнить. API описывает PriceExtension в Ads.add / Ads.update: Price, OldPrice, PriceQualifier, PriceCurrency. У готовой команды ads_write.py ad update параметра отдельной цены нет. Не подменяйте его --text или созданием другого формата объявления. Применимость метода и полей проверяйте по API_OBJECTS.md; если выполняете поддержанный метод отдельно, сохраняйте тот же порядок: чтение, конкретный план, запись, повторное чтение. В интерфейсе это элемент «Цена» на уровне объявления; остальные значения сохраняются.

Чем измерить. Нужен отчёт по объявлениям с AdId, AdNetworkType, Slot и показами, кликами, расходом и показателями выбранных целей. Строка Slot=PRODUCT_GALLERY с ненулевыми показами у объявления без фида подтверждает, что технически этот путь сработал в данном кабинете. Такой разрез можно собрать собственным отчётом через report.py; отчёт по поисковым запросам для него не подходит, поскольку Slot в нём недоступен.

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

Как прочитать исход.

  • Нет показов в PRODUCT_GALLERY: сначала проверьте объём именно поисковых показов (AdNetworkType=SEARCH). Сетевые показы не увеличивают число наблюдений для этой проверки. На малом объёме результат неопределён; достаточный объём и срок договоритесь выбрать заранее, универсального числа в интервью нет. При достаточном объёме итог — «в этом кабинете размещение не появилось». Отчёт не показывает, участвовало ли объявление в подходящих аукционах галереи, поэтому отсутствие строки не доказывает, что способ вообще невозможен.
  • Показы в галерее есть, а конверсии кампании не выросли или стали дороже: технический путь сработал, экономическое улучшение пока не подтверждено. Покажите оба результата и возможные внешние причины. Одного сравнения периодов недостаточно, чтобы объявить галерею причиной ухудшения.
  • Расход или цена результата достигли согласованного предела: примените заранее выбранное условие остановки либо предложите возврат исходного состояния.

Мастер кампаний рядом с ЕПК

Что проверить. Запустить Мастер кампаний с оплатой за конверсии рядом с работающими едиными перфоманс-кампаниями (ЕПК). Основные кампании сохраняются, если пользователь не поручил иначе. Это способ проверить дополнительный спрос и автоматический подбор размещений; он не требует считать ЕПК неудачной.

Почему такой вариант. В практике владельца Мастер либо приносил недорогие заявки, либо не набирал конверсии. Оплата за конверсии ограничивает стоимость второго исхода. Но возможен и третий: заявки появляются, а их цена оказывается неприемлемой. Они оплачены, поэтому «неудача бесплатна» — неверное обещание. Недельный предел расхода, целевая цена результата и срок нужны до запуска.

Когда предложить. Основные кампании уже собраны и работают, пользователь готов выделить отдельный бюджет и выполнить действия в интерфейсе. Владелец обычно рассматривает этот вариант рядом с ЕПК даже без явного провала основной рекламы. Это повод предложить эксперимент, а не правило создавать Мастер во всех кабинетах; его отсутствие не является находкой аудита.

Как выполнить. Создание, настройка, остановка и изменение Мастера кампаний выполняются через интерфейс; полноценного управления им в API нет. Выберите Мастер кампаний, подходящее предложение и оплату за конверсии, задайте согласованные цели и бюджет. После ручного действия проверьте фактические настройки. Пошаговое руководство с подготовкой целей и материалов — MANUAL_SETUP.md; ориентиры интерфейса — UI_MAP.md.

Чем измерить. Reports отдаёт сводку по кампании, хотя Campaigns.get Мастер не возвращает и детальная разбивка по группам, объявлениям и условиям показа недоступна. Отсутствие Мастера в списке кампаний API не означает, что его нет в кабинете; не назначайте ему неподтверждённый CampaignType.

Получите конверсии каждой выбранной цели и их цену по Мастеру и ЕПК за один период, явно передав --goals и --attribution AUTO. Той же моделью снимите сопоставимые итоги кабинета. Отчёт по модели LC нельзя напрямую сравнивать с результатами Мастера, посчитанными по AUTO.

Приписанная Мастеру заявка не обязательно дополнительная: без него её могла привести другая кампания. Рост или снижение общего итога тоже не доказывает перераспределение трафика. Назовите это ограничение; если нужно оценить именно прирост, обсудите возможность одновременного контроля.

Как прочитать исход.

  • За согласованный срок ценных конверсий нет: нужного результата не получили. Проверьте расход и состояние кампании; ноль конверсий сам по себе не объясняет, почему стратегия не дала результат. При оплате за конверсии отсутствие оплачиваемых достижений обычно означает отсутствие соответствующих списаний, но фактический расход берите из отчёта.
  • Конверсии есть, но их цена выше допустимой: экономическая цель попытки не достигнута. Предложите остановить её или изменить условия в пределах задачи.
  • Конверсии Мастера недороги, но итог кабинета не вырос: это повод разобрать общий результат, а не доказательство бесполезности Мастера. Решение о продолжении опирается на цену его ценных конверсий, итог кабинета и ограничения сравнения.

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

Расширенный географический таргетинг — снятая идея

Раньше предлагалось проверить расширенный геотаргетинг для дополнительного охвата. Отдельный переключатель перестал работать и в API, и в интерфейсе: идея снята из-за изменения платформы, а не из-за неудачи в отдельном кабинете. Не предлагайте передавать устаревшее поле или искать исчезнувшую настройку. Для анализа географии используйте доступные отчёты и настройку регионов. Источник: обновление геотаргетинга в Директе.

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

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