Об этом проекте

Пакет @vskstudio/takt-angular предлагает нативную интеграцию Angular для платформы аналитики Takt, ориентированной на сбор данных с приоритетом конфиденциальности. Он разработан для Angular 17 и более поздних версий и может быть добавлен в проект одной командой менеджера пакетов. Установка Выполните: pnpm add @vskstudio/takt-angular @vskstudio/takt-core Интеграция Bootstrap В корневом вызове bootstrap зарегистрируйте провайдера с помощью provideTakt. Провайдер инициализирует основную библиотеку аналитики только в браузере, отправляет начальный просмотр страницы, активирует необязательные функции автоматического захвата (клики по исходящим ссылкам, загрузки файлов, SPA-навигация и т. д.) и выполняет очистку при уничтожении приложения Angular. На стороне сервера провайдер инертен, что делает библиотеку безопасной для серверного рендеринга (SSR). Инъекционный сервис TaktService может быть внедрен в любом месте приложения. Он предоставляет такие методы, как track(eventName, options), pageview(), optOut() и optIn(). Все методы являются пустыми операциями (no-ops) до инициализации библиотеки или при запуске на сервере, что гарантирует отсутствие ошибок. Декларативное отслеживание кликов Директива TaktEventDirective позволяет разработчикам привязывать отслеживание к любому кликабельному элементу через атрибут taktEvent с необязательными входными данными taktProps и taktRevenue. Директива разрешает активный экземпляр аналитики в момент клика, сохраняя разметку чистой. UI-виджеты Предоставляются два автономных компонента: - TaktBadgeComponent отрисовывает сгенерированный сервером SVG-бейдж для заданного домена. - TaktEmbedComponent отрисовывает изолированный iframe, который отображает публичные панели аналитики. Оба компонента можно использовать в любом шаблоне Angular; они поддерживают входные параметры для домена, темы, размера, языка и визуального варианта. Публичный API статистики Хелпер createStats создает клиент для публичного API Takt. Он предлагает асинхронные методы summary, timeseries, realtime и breakdown, позволяя разработчикам программно получать агрегированные данные аналитики. Независимый от фреймворка кастомный элемент Для страниц, не использующих Angular, экспортируется автономный кастомный элемент с именем takt-analytics. После вызова defineTaktElement (или импорта модуля, который автоматически запускает регистрацию), элемент можно разместить в обычном HTML, и он будет автоматически соблюдать настройки конфиденциальности, такие как отслеживание исходящих ссылок и загрузок файлов. Также доступен CDN-бандл для быстрого подключения без этапа сборки. Параметры конфигурации TaktConfig поддерживает широкий набор опций, включая домен, endpoint, отслеживание исходящих ссылок, отслеживание загрузок файлов, SPA-навигацию, соблюдение Do Not Track, исключение localhost, частоту выборки (sample rate), обработку строк запроса, исключения путей, очистку URL и отслеживание тегированных элементов. Значения по умолчанию подходят для большинства сайтов, а конфигурация может быть передана в provideTakt при bootstrap. Лицензия Библиотека выпущена под лицензией MIT.