che-audit-unisender-email
Проверяет доставку, unique-клики, UTM и post-click результат существующих UniSender-кампаний. Применяется для диагностики CTR/CTOR, resend и атрибуции; не пишет новое письмо и не отправляет рассылку.
SKILL.mdskills/che-audit-unisender-email/SKILL.md
GitHubCHE_audit-unisender-email — Аудит email-рассылок UniSender
Контракт зависимостей
- Для расчёта по готовому нормализованному JSON внешние коннекторы не нужны.
- Для live-сбора live-адаптеру требуются read-only capabilities
email.campaigns.read,email.campaign_status.read,email.campaign_stats.readиemail.delivery_stats.read. - Не предполагать наличие link-level статистики у провайдера. Live-аудит
имеет статус
partial, пока карта ссылок не передана в нормализованном входе из другого подтверждённого источника. - Для post-click анализа опциональны
web_analytics.report.read,web_analytics.sources.readиweb_analytics.goals.read. Для сверки воронки доступныcrm.leads.read,crm.pipelines.readиcrm.pipeline_statuses.read, но они не доказывают email-атрибуцию: полный attribution/revenue-аудит требует нормализованный вход с этой связью. - Способ подключения и авторизации определяет платформа; Skill его не реализует.
Маршрутизация
- Только анализ прошлых кампаний → этот skill.
- «Подготовь письмо по этим ссылкам» →
универсальный workflow подготовки письма. - Еженедельный поиск тем и материалов →
универсальный workflow подбора email-тем. - Накопительный анализ + спрос + письмо + черновик UniSender →
workflow подготовки и согласования email-кампании.
Цель
Оптимизировать не открытия сами по себе, а воронку доставлено → уникальный клик → визит → качественный визит → заявка → продажа. Работать read-only. Не изменять, не отправлять и не планировать рассылки без отдельного прямого запроса.
Обязательные материалы
Перед анализом прочитать:
- references/data-contract.md — источники, поля, UTM и контракт коннекторов;
- references/methodology.md — сопоставимость, зрелость данных, повторы и ограничения;
- references/report-template.md — структура итогового отчёта.
Если есть нормализованный JSON, запускать scripts/calculate_email_audit.py для формул и baseline. Не переносить арифметику в рассуждения без необходимости.
Рабочий процесс
Собрать кампании, link map и сопоставимые окна; разделить primary/resend; нормализовать источники; проверить unique/total клики и UTM; диагностировать post-click; сверить CRM только по доказуемой атрибуции; вернуть complete/partial и приоритеты. Нет данных — не подставлять ноль.
Для этого этапа читать процедуру; выполнять её проверки и сохранять артефакты.
Режим по расписанию
Для автоматизации через n8n или Scheduled Tasks:
- Обнаруживать новую завершённую кампанию по
campaign_id. - Создавать предварительный срез D+3 с меткой
provisional. - Обновлять итоговый срез D+7 и включать его в baseline.
- При необходимости создавать D+14 только для длинного цикла заявки.
- Хранить снапшоты идемпотентно по
campaign_id + observation_window + as_of. - Повторять временные ошибки коннекторов, но не публиковать неполный отчёт как полный.
- После изменения коннектора проверять первый фактический запуск, а не только структуру workflow.
Ограничения и безопасность
- Не помещать email, телефон или имя в UTM и URL.
- Для пользовательского связывания использовать только непрозрачный
click_idс серверным сопоставлением и подходящим согласием. - Отклонять URL с email, телефоном или именем в query-параметрах; не считать автоматическую проверку исчерпывающей PII-защитой.
- Не запрашивать и не раскрывать секреты; подключение источников обеспечивает платформа.
- Не смешивать lifetime-метрики с фиксированным D+7 baseline.
- Не скрывать расхождения между источниками и не выбирать удобное значение без обоснования.
Оценка результата
Перед выдачей применить evals/shared.csv и evals/skill-specific.csv по
evals/judge_prompt.md. Неприменимые критерии помечать not_applicable; общий
балл не вычислять.
Навигация по ресурсам
- references/data-contract.md — читать при соответствующем этапе workflow.
- references/methodology.md — читать при соответствующем этапе workflow.
- references/report-template.md — читать при соответствующем этапе workflow.
Точные имена зависят от подключения: provider-adapter.md.
Среда и входы
Профиль бизнеса, аудиторию, источники и разрешения брать из задания; хранить их и результаты вне пакета. Методолог навыка не становится автором материала автоматически. Использовать только объявленные инструменты. Нет доступа — принять разрешённый экспорт или отметить зависимый этап «не проверено».
Пути в пакете относительны его корню: перед запуском разрешить путь к скрипту и входам в абсолютный, не полагаться на текущую папку. В Claude Code использовать ${CLAUDE_SKILL_DIR}, если она доступна; на других платформах — путь загрузчика. Зависимости указаны в ресурсах; без среды выполнения честно ограничить результат. Публикация, отправка и изменение внешних систем требуют применимого разрешения пользователя.
Авторство
Методолог навыка — Любовь Черемисина. Лицензия оригинальной методологии и кода этого пакета — MIT.
Атрибуция относится к пакету; не добавлять рекламную подпись в каждый результат.
Ресурсы по необходимости
- evals/judge_prompt.md — читать при проверке результата.