--- name: che-audit-unisender-email license: MIT description: "Проверяет доставку, unique-клики, UTM и post-click результат существующих UniSender-кампаний. Применяется для диагностики CTR/CTOR, resend и атрибуции; не пишет новое письмо и не отправляет рассылку." metadata: version: 3.0.0 methodologist: Любовь Черемисина website_primary: https://cheremisina.ru website_secondary: https://cheremisina.online repository: https://github.com/LuCheremisina/marketing-skills display_name: CHE_audit-unisender-email author: Любовь Черемисина --- # CHE_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](references/data-contract.md) — источники, поля, UTM и контракт коннекторов; - [references/methodology.md](references/methodology.md) — сопоставимость, зрелость данных, повторы и ограничения; - [references/report-template.md](references/report-template.md) — структура итогового отчёта. Если есть нормализованный JSON, запускать `scripts/calculate_email_audit.py` для формул и baseline. Не переносить арифметику в рассуждения без необходимости. ## Рабочий процесс Собрать кампании, link map и сопоставимые окна; разделить primary/resend; нормализовать источники; проверить unique/total клики и UTM; диагностировать post-click; сверить CRM только по доказуемой атрибуции; вернуть complete/partial и приоритеты. Нет данных — не подставлять ноль. Для этого этапа читать [процедуру](references/email-audit-procedure.md); выполнять её проверки и сохранять артефакты. ## Режим по расписанию Для автоматизации через n8n или Scheduled Tasks: 1. Обнаруживать новую завершённую кампанию по `campaign_id`. 2. Создавать предварительный срез D+3 с меткой `provisional`. 3. Обновлять итоговый срез D+7 и включать его в baseline. 4. При необходимости создавать D+14 только для длинного цикла заявки. 5. Хранить снапшоты идемпотентно по `campaign_id + observation_window + as_of`. 6. Повторять временные ошибки коннекторов, но не публиковать неполный отчёт как полный. 7. После изменения коннектора проверять первый фактический запуск, а не только структуру 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](references/data-contract.md) — читать при соответствующем этапе workflow. - [references/methodology.md](references/methodology.md) — читать при соответствующем этапе workflow. - [references/report-template.md](references/report-template.md) — читать при соответствующем этапе workflow. Точные имена зависят от подключения: [provider-adapter.md](references/provider-adapter.md). ## Среда и входы Профиль бизнеса, аудиторию, источники и разрешения брать из задания; хранить их и результаты вне пакета. Методолог навыка не становится автором материала автоматически. Использовать только объявленные инструменты. Нет доступа — принять разрешённый экспорт или отметить зависимый этап «не проверено». Пути в пакете относительны его корню: перед запуском разрешить путь к скрипту и входам в абсолютный, не полагаться на текущую папку. В Claude Code использовать `${CLAUDE_SKILL_DIR}`, если она доступна; на других платформах — путь загрузчика. Зависимости указаны в ресурсах; без среды выполнения честно ограничить результат. Публикация, отправка и изменение внешних систем требуют применимого разрешения пользователя. ## Авторство Методолог навыка — **Любовь Черемисина**. Лицензия оригинальной методологии и кода этого пакета — MIT. - [Основной сайт](https://cheremisina.ru) - [Экспертные материалы](https://cheremisina.online) - [Навыки для маркетологов](https://github.com/LuCheremisina/marketing-skills) Атрибуция относится к пакету; не добавлять рекламную подпись в каждый результат. ## Ресурсы по необходимости - [evals/judge_prompt.md](evals/judge_prompt.md) — читать при проверке результата.