AGENT SKILL

direct-report-wizard-library

Собрать клиенту набор из ~20 сохранённых отчётов в Мастере отчётов Яндекс Директа («Мои отчёты») с лидами, квал-лидами, продажами и выручкой по отдельным целям — заголовки, тексты, картинки, видео, посадочные, воронка кампаний, динамика, площадки, аудитории, устройства, города, запросы, форматы, стратегии. Использовать, когда просят «сделай отчёты в Директе», «срезы в Мастере отчётов», «чтобы смотреть статистику прямо в Директе», «статистика по заголовкам/ассетам ЕПК». Только отчёты: кампании, ставки и объявления не трогать.

License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
direct-report-wizard-library
description
Собрать клиенту набор из ~20 сохранённых отчётов в Мастере отчётов Яндекс Директа («Мои отчёты») с лидами, квал-лидами, продажами и выручкой по отдельным целям — заголовки, тексты, картинки, видео, посадочные, воронка кампаний, динамика, площадки, аудитории, устройства, города, запросы, форматы, стратегии. Использовать, когда просят «сделай отчёты в Директе», «срезы в Мастере отчётов», «чтобы смотреть статистику прямо в Директе», «статистика по заголовкам/ассетам ЕПК». Только отчёты: кампании, ставки и объявления не трогать.

02 资源文件 2

03 SKILL.md 正文

Набор отчётов в Мастере отчётов Директа

Результат — в кабинете клиента в «Статистика → Мои отчёты» лежат отчёты 1. … – 20. …. В каждом есть поиск и РСЯ, расход, показы, клики, CTR, конверсии отдельно по каждой бизнес-цели, CR, CPA, ценность конверсий и ДРР. Каталог отчётов с группировками и периодами — в references/report-catalog.md.

Жёсткие правила

  1. Менять можно только отчёты. Кампании, группы, объявления, ставки и цели не трогать.
  2. Для создания нового отчёта не нажимать «Сохранить настройки»: эта кнопка обновляет открытый отчёт; новый создаётся только через «Сохранить в "Мои отчёты"». Намеренно обновлять существующий отчёт через «Сохранить настройки» можно при явном поручении изменить его настройки либо при исправлении подтверждённого дефекта отчёта, созданного в текущем пакете. Перед записью открыть канонический адрес без state/inheritFrom, подтвердить кабинет, название и точный набор меняемых полей; после сохранения заново открыть с сервера и сверить изменённые поля, цели, период и группировки. Не переносить это разрешение на посторонние существующие отчёты.
  3. Сначала проверь логин. Открой https://direct.yandex.ru/dna/grid/campaigns/ без ulogin и прочитай логин в левой колонке или в ulogin= итогового URL. Если Директ показывает «Доступ ограничен», значит активен чужой аккаунт Яндекса. Переключи его через аватар → список аккаунтов, если пользователь это разрешил, и после работы верни прежний аккаунт; иначе попроси пользователя переключить аккаунт и подожди. Учти: переключение меняет кабинет во всех вкладках браузера.
  4. Цели определяй по данным, не угадывай. Через API: campaigns.get → PriorityGoals (Unified/TextCampaign) и цели Метрики management/v1/counter/{id}/goals. Разложи цели на лид (обращение, форма, Roistat-лид — по каждому сайту и счётчику), квал-лид и продажу (CRM «Заказ оплачен»). Сомнительное соответствие согласуй с пользователем.
  5. Ценность ≠ деньги. Если цель стоит ключевой с ручной ценностью (PriorityGoals.Items[].IsMetrikaSourceOfValue=NO), столбец «Ценность конверсий» по ней равен конверсиям × заданной ценности. Реальная выручка бывает только у цели продажи с ценностью из Метрики или CRM. Предупреди пользователя об этом в отчёте-сводке.
  6. Не сдавать без проверки. В конце выведи список «Мои отчёты» и сверь его с каталогом. Каждый отчёт открой и убедись, что на кнопке целей написано Цели · <первая цель>, +N.
  7. Расход с НДС или без — как решил пользователь. По умолчанию включать «с НДС»: так расход совпадает со счетами. Выбранный вариант включить в каждом отчёте, сохранить и подтвердить значение после нового открытия с сервера. Временное включение без сохранения не считается готовой настройкой.

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

  1. База с целями (отчёт №1). Статистика → Библиотека отчётов → «Элементы объявлений» (/dna/reports/library/assets). Дальше:

    • Группировки и метрики: добавь «№ объявления»; в метриках добавь «Ценность конверсий» (поиск по «конверс») и «ДРР (по ценности)» (поиск по «ДРР»).
    • Цели: в окне целей ищи каждую цель по номеру и ставь галочку в найденной строке.
    • Настройки отображения (там же, слева): «Конверсии» и «Ценность конверсий» переключи на «Отдельно по каждой цели».
    • Период: 30 дней, «Включая сегодня».
    • Сохрани через «Сохранить в "Мои отчёты"» с названием 1. Сочетания: заголовок + текст + картинка + видео.
  2. Остальные отчёты делай из сохранённого, тогда цели и метрики переносятся сами. Открой последний сохранённый отчёт, затем:

    • в «Группировки и метрики» нажми «Удалить всё» у группировок;
    • через поиск отметь нужные группировки из каталога, не забудь «Тип площадки»;
    • нажми «Применить»;
    • выставь период и детализацию над таблицей;
    • при необходимости отсортируй по «Расход»;
    • сохрани через иконку дискеты → «Сохранить в "Мои отчёты"» → название → «Сохранить».

    После сохранения откроется новый отчёт (/dna/reports/my/rep/N/). Следующий собирай уже от него.

  3. Названия: N. Срез (период). Имя клиента в название не добавляй, отчёты и так внутри его кабинета. Переименовать можно через «⋮» в шапке отчёта → «Переименовать отчёт».

  4. Проверка: на /dna/reports/my/ получи список ссылок a[href*="/reports/my/rep/"] и сверь его с каталогом.

Особенности интерфейса

  • Быстрый выбор периода может выключить «Включая сегодня» (например, у «30 дней»). После выбора или изменения периода заново проверь эту опцию перед сохранением; при повторном открытии сверь фактические начало и конец периода. Само название «30 дней» не доказывает включение сегодняшней даты.
  • Окно «Группировки и метрики» открывается с задержкой ~2–3 с. Клики в первую секунду попадают в таблицу под ним и, например, включают «Месяц» или «Неделю» в детализации. После открытия жди и проверяй правую колонку «Группировки» до «Применить».
  • Первый клик по иконкам шапки после загрузки страницы часто теряется (дискета, «⋮»): первый клик показывает подсказку, повторный открывает меню. Каждый раз проверяй меню снимком области; если меню не открылось, кликни ещё раз. Два клика подряд вслепую могут открыть и сразу закрыть меню.
  • Результаты поиска в окне группировок: у одноуровневых групп пункт стоит на второй строке, у вложенных (Регионы → Местонахождение → Город) — на третьей. Перед кликом проверяй, какой пункт отмечен.
  • В окне целей поиск по номеру показывает строку счётчика и строку цели; ставить галочку нужно на строке цели. Подсказку «Откройте через боковое меню…» можно не закрывать.
  • «Место клика» (быстрые ссылки, заголовок, телефон) в этом отчёте серое: Директ не совмещает его с конверсиями по целям. Клики по быстрым ссылкам берутся из API (ClickType = SITELINK1..8).
  • Часа суток и дня недели как группировок нет. Детализация бывает только по дням, неделям, месяцам, кварталам и годам. При детализации «По дням» в дате виден день недели («08.09, вт»). Часы брать из Метрики (ym:s:hour, ym:s:dayOfWeek с фильтром по источнику Директ).
  • В отчёте «Элементы объявлений» у заголовков и текстов убраны кавычки и часть пунктуации. Изображение указано адресом …/images/direct/<group>/<hash> (последний сегмент — AdImageHash из API), «Идентификатор видео» совпадает с CreativeId. В CSV прочерк - означает «нет данных».

Точная статистика по вариантам ЕПК (если нужна в своей платформе)

В API Директа нет статистики по отдельному заголовку или картинке. Есть она только в отчёте «Элементы объявлений». Выгрузи отчёт №1 через «Скачать → CSV». Строка CSV — это реально показанное сочетание: тип площадки, кампания, объявление, заголовок, текст, изображение, видео, конверсии по каждой цели и доход. Статистика элемента = сумма строк, где он участвовал. Сравнивать вариант честнее с другими вариантами внутри тех же объявлений, учитывая только строки, где этот тип элемента вообще показывался.

Сдача пользователю

Таблица № / отчёт / какое решение помогает принять. Обязательно укажи:

  • период каждого отчёта;
  • что реальные деньги показывает только «Ценность» цели продажи;
  • чего в Директе нет и откуда это взять (часы, место клика).

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k