Яндекс.Директ: единый рабочий навык
Этот навык задаёт порядок работы. Узкие навыки yandex-wordstat, roistat-reports-api и amocrm-api-control уточняют свои программные интерфейсы, но не заменяют этот порядок.
Перед началом
- Пройти общий поиск навыков по теме задачи.
- Всегда прочитать основной порядок, правила решений и правила работы. В правилах работы — таблица конкретных документов по операции: их прочитать до действия.
- Для семантики — сбор ключевых фраз, протокол исчерпания синонимов и задание смысловой проверки.
- Для исследования спроса, конкурентов, медиаплана или прогноза — приёмка исследования и прогноза.
- Для нового клиента, сборки по нескольким сайтам, комбинаторных объявлений и записи новых черновиков — приёмка новой сборки.
- Для действующего кабинета, авторизации или любой записи — надзорная проверка и указатель скриптов; при сбое доступа — восстановление доступа.
- Для изменения самого навыка — карта источников правил.
В первом статусе назвать прочитанные файлы.
Все ссылки относительны каталога навыка: установка не зависит от имени пользователя и расположения домашнего каталога.
Неподвижные правила
Roistat, amoCRM и XMLRiver необязательны. Отсутствие такого источника блокирует только выводы, которым он нужен (окупаемость, продажи, платный сбор выдачи), а не всю задачу. Подключение проверяйте по факту доступа, не предполагайте.
Сначала определить клиента, кабинет и разрешённый объём; затем читать данные.
Доступ подтверждается свежим запросом к нужной службе, а не наличием файла с токеном.
В поставке есть общие приложения авторизации для Директа и Метрики. Пользователю не требуется создавать собственное приложение.
Авторизация Директа и Метрики раздельна. Токен, код подтверждения и секрет приложения не передаются в аргументах процесса и не печатаются.
Чтение и запись разделены. Любая запись, запуск, модерация, бюджет или остановка трафика требуют отдельного явного разрешения.
Имена кампаний и групп показываются пользователю раньше служебных номеров.
Сырые данные Wordstat и поисковых фраз не являются готовой семантикой.
Автоматические сценарии не принимают смысловые решения за человека или проверяющего агента.
Секреты и клиентские выгрузки хранятся только вне каталога навыка.
Сначала API Директа; интерфейс — только при доказанном отсутствии метода. Метрика — только через API.
В общем аккаунте читаются только кампании клиента. «0 кампаний» при заявленном кабинете — блокер доступа, а не факт о бизнесе.
«Не знаю» — это ответ: повторно его не спрашивать, но и фактом не считать.
Доказательства раскладываются по элементам (текст, посадочная, площадка, аудитория); одна продажа не засчитывается нескольким объявлениям.
РСЯ — отдельный пакет текстов, у каждого объявления своё изображение без искажений. DisplayUrlPath — русский, до 20 символов, из ключа группы. Якоря в быстрых ссылках запрещены.
Полный поисковый запрос — доказательство, а не минус-фраза: в минус-слова идёт одно слово или неразрывная пара.
Бюджет и денежные параметры стратегии берутся только из решения заказчика; иначе unknown.
Изменяемые поля перечитываются из API непосредственно перед записью; после записи ранее работавшие кампании сверяются со снимком «до».
Результат
Каждый запуск оставляет проверяемые входы, исходные ответы, решения, план изменения и чтение после изменения. Если обязательного доказательства нет, статус — BLOCKED с конкретной причиной, а не предположение о готовности.
1---2name: yandex-direct-unified3description: "Единая точка входа для безопасной работы с Яндекс.Директом: авторизация, чтение кабинета, Метрика, Wordstat, семантика, подготовка изменений и контролируемая запись."4metadata:5 source: https://skillmd.com/skills/hashgraph-online/yandex-direct-unified6---78# Яндекс.Директ: единый рабочий навык910Этот навык задаёт порядок работы. Узкие навыки yandex-wordstat, roistat-reports-api и amocrm-api-control уточняют свои программные интерфейсы, но не заменяют этот порядок.1112## Перед началом13141. Пройти общий поиск навыков по теме задачи.152. Всегда прочитать [основной порядок](references/main-workflow.md), [правила решений](references/decision-rules.md) и [правила работы](references/operating-rules.md). В правилах работы — таблица конкретных документов по операции: их прочитать до действия.163. Для семантики — [сбор ключевых фраз](references/keyword-collection-runbook.md), [протокол исчерпания синонимов](references/synonym-exhaustion-protocol.md) и [задание смысловой проверки](references/semantic-review-agent-brief.md).174. Для исследования спроса, конкурентов, медиаплана или прогноза — [приёмка исследования и прогноза](references/research-forecast-acceptance.md).185. Для нового клиента, сборки по нескольким сайтам, комбинаторных объявлений и записи новых черновиков — [приёмка новой сборки](references/new-client-full-build-acceptance.md).196. Для действующего кабинета, авторизации или любой записи — [надзорная проверка](references/workflow-supervisor.md) и [указатель скриптов](references/script-index.md); при сбое доступа — [восстановление доступа](references/access-recovery-runbook.md).207. Для изменения самого навыка — [карта источников правил](references/source-map.md).2122В первом статусе назвать прочитанные файлы.2324Все ссылки относительны каталога навыка: установка не зависит от имени пользователя и расположения домашнего каталога.2526## Неподвижные правила2728- Roistat, amoCRM и XMLRiver необязательны. Отсутствие такого источника блокирует только выводы, которым он нужен (окупаемость, продажи, платный сбор выдачи), а не всю задачу. Подключение проверяйте по факту доступа, не предполагайте.2930- Сначала определить клиента, кабинет и разрешённый объём; затем читать данные.31- Доступ подтверждается свежим запросом к нужной службе, а не наличием файла с токеном.32- В поставке есть общие приложения авторизации для Директа и Метрики. Пользователю не требуется создавать собственное приложение.33- Авторизация Директа и Метрики раздельна. Токен, код подтверждения и секрет приложения не передаются в аргументах процесса и не печатаются.34- Чтение и запись разделены. Любая запись, запуск, модерация, бюджет или остановка трафика требуют отдельного явного разрешения.35- Имена кампаний и групп показываются пользователю раньше служебных номеров.36- Сырые данные Wordstat и поисковых фраз не являются готовой семантикой.37- Автоматические сценарии не принимают смысловые решения за человека или проверяющего агента.38- Секреты и клиентские выгрузки хранятся только вне каталога навыка.39- Сначала API Директа; интерфейс — только при доказанном отсутствии метода. Метрика — только через API.40- В общем аккаунте читаются только кампании клиента. «0 кампаний» при заявленном кабинете — блокер доступа, а не факт о бизнесе.41- «Не знаю» — это ответ: повторно его не спрашивать, но и фактом не считать.42- Доказательства раскладываются по элементам (текст, посадочная, площадка, аудитория); одна продажа не засчитывается нескольким объявлениям.43- РСЯ — отдельный пакет текстов, у каждого объявления своё изображение без искажений. `DisplayUrlPath` — русский, до 20 символов, из ключа группы. Якоря в быстрых ссылках запрещены.44- Полный поисковый запрос — доказательство, а не минус-фраза: в минус-слова идёт одно слово или неразрывная пара.45- Бюджет и денежные параметры стратегии берутся только из решения заказчика; иначе `unknown`.46- Изменяемые поля перечитываются из API непосредственно перед записью; после записи ранее работавшие кампании сверяются со снимком «до».4748## Результат4950Каждый запуск оставляет проверяемые входы, исходные ответы, решения, план изменения и чтение после изменения. Если обязательного доказательства нет, статус — BLOCKED с конкретной причиной, а не предположение о готовности.