Analytics Tracking Automation

analytics-tracking-automation — локальный AI-скилл для планирования, проверки и внедрения отслеживания событий GA4 + GTM.

Используйте его, когда нужно, чтобы агент помог:

• проанализировать сайт перед началом работ по трекингу
• сгруппировать страницы по бизнес-назначению
• спроектировать или проверить план событий GA4
• сравнить предложенный план с существующей живой конфигурацией GTM
• подготовить GTM-совместимые выходные данные и инструкции по верификации
• работать как с обычными сайтами, так и с магазинами на Shopify

Этот README ориентирован на пользователей и построен вокруг диалога с агентом. Если вам нужен CLI-интерфейс или рабочий процесс мейнтейнера, используйте DEVELOPING.md.

Что вы получаете

Для заданного сайта скилл помогает сформировать:

• проверяемый анализ сайта
• бизнес-ориентированные группы страниц
• компактный план трекинга, готовый к принятию решений
• GTM-совместимые выходные данные
• сводки по верификации и состоянию перед запуском
• прогресс с сохранением артефактов, который можно возобновить позже

Установка

Большинству пользователей достаточно основного скилла.

Рекомендуемый способ

Клонируйте репозиторий локально, затем установите скилл в директорию скиллов вашего агента:

git clone https://github.com/jtrackingai/analytics-tracking-automation.git
cd analytics-tracking-automation
npm run install:skills

Альтернатива без клонирования

Если вы не хотите клонировать репозиторий, установите корневой скилл напрямую:

Дополнительные параметры установки и экспортированные пакеты скиллов:

• docs/README.install.md
• docs/skills.md

Публикация в ClawHub

Если вы публикуете этот скилл в ClawHub, публикуйте экспортированный публичный пакет, а не полный репозиторий:

Затем загрузите dist/clawhub-skill-bundles/analytics-tracking-automation.

Этот публичный пакет безопасен для публикации. Он сохраняет документацию и ссылки, ориентированные на агента, но не включает исполняемые файлы рантайма (CLI-загрузчик, упакованные node-модули, транспорт телеметрии и рантайм обновлений), которые могут вызывать срабатывание строгих проверок безопасности маркетплейса.

При установке и использовании этого публичного пакета из ClawHub пользователи должны предварительно выполнить (до любой команды event-tracking):

Быстрый старт

Использование как скилл

Предполагаемый сценарий прост: скажите агенту, что вам нужно, на обычном языке.

Хорошие запросы обычно включают одно или несколько из следующего:

• URL сайта
• тип работы: новая настройка, обновление, плановое обслуживание или аудит
• корневую директорию для вывода нового запуска, например ./output или /tmp/output
• существующую директорию артефактов сайта, если она уже есть, например ./output/example_com
• GA4 Measurement ID или контекст GTM, если они уже известны
• границы области работ, например «остановиться после проверки схемы»

Для новой настройки корневая директория вывода — это не сама директория артефактов. Агент/CLI создаёт отдельную директорию артефактов для каждого сайта внутри этой корневой директории, например ./output/example_com.

Примеры запросов

Новая настройка с нуля:

Use analytics-tracking-automation to plan GA4 + GTM tracking for https://www.example.com.
Use ./output as the output root; create the site artifact directory under it.
Start from a fresh run and stop after the event schema is ready for review.

Новая настройка с контекстом реализации:

Use analytics-tracking-automation to set up tracking for https://www.example.com.
Use /tmp/output as the output root, so this site's artifacts go under /tmp/output/www_example_com.
GA4 Measurement ID is G-XXXXXXXXXX.
We care most about signup, pricing, contact, and demo intent.

Только аудит:

Use analytics-tracking-automation to run a tracking health audit for https://www.example.com.
I only want to understand the current live GTM setup and whether we should repair or rebuild.
Do not continue into deployment work.

Плановое обслуживание:

Use analytics-tracking-automation to do an upkeep review for this existing run:
./output/example_com
Tell me what is still healthy, what drifted, and what needs repair.

Обновление существующего артефакта:

Use analytics-tracking-automation to resume this artifact directory:
./output/example_com
Tell me the current checkpoint and continue only through schema review.

Только проверка групп страниц:

Use analytics-tracking-automation to review and refine the page groups in:
./output/example_com/site-analysis.json
Focus on business intent, not just URL shape.

Ветка для Shopify:

Use analytics-tracking-automation for this Shopify storefront:
https://store.example.com
I want the Shopify-specific tracking path, not the generic website flow.

Как правильно воспринимать этот скилл

Скилл раскрывается лучше всего, когда вы хотите, чтобы агент действовал как руководитель по трекингу, а не просто исполнитель команд.

Типичный сценарий диалога:

1. проверить сайт или возобновить существующий запуск
2. сгруппировать страницы в проверяемом виде
3. составить или доработать план событий
4. определить, что следует переиспользовать, исправить, добавить или удалить
5. перейти к генерации GTM и верификации только тогда, когда вы явно этого захотите

Что дальше

• Детали установки: docs/README.install.md
• Карта семейства скиллов: docs/skills.md
• Контракт рабочего процесса для агента: SKILL.md
• CLI и рабочий процесс мейнтейнера: DEVELOPING.md

Советы по отладке

Если при устранении проблем с превью обнаруживается несоответствие селекторов или проблемы с загрузкой страницы/навигацией — обратитесь к разделу отладки в DEVELOPING.md.