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

Этот репозиторий представляет собой шаблон для построения платформы веб-аналитики на базе Events API и Endpoints от Tinybird. Основной акцент сделан на конфиденциальности и скорости; согласно README, пользователи могут получить метрики в реальном времени в готовом дашборде за считанные минуты, даже не имея предварительных знаний о Tinybird. После настройки можно добавлять пользовательские события для таких сценариев, как eCommerce или маркетинг, сохраняя производительность в реальном времени. Настройка: клонируйте репозиторий, перейдите в директорию tinybird, установите зависимости с помощью pnpm, войдите в Tinybird и выполните развертывание. Отслеживание включается путем размещения предоставленного фрагмента скрипта в секции head сайта с токеном трекера. README предполагает получение событий page_hit при просмотре и взаимодействии посетителей с сайтом. Пользовательские события можно отправлять через Tinybird.trackEvent. Пользовательские атрибуты используют префикс data-tb_ и хранятся в колонке payload источника данных analytics_events, прилагаясь к каждому событию. Поддержка мультитенентности и нескольких доменов реализована через параметры data-domain и data-tenant-id. Все эндпоинты проекта могут быть отфильтрованы по tenant_id и domain, либо JWT-токены могут содержать fixed_params. Трекер также поддерживает web vitals через библиотеку web-vitals. События с действием web_vital включают такие метрики, как LCP, TTFB, FCP, INP и CLS. Готовый дашборд доступен по адресу analytics.tinybird.live, где пользователи вставляют токен администратора рабочего пространства. Токен дашборда также получается из Tinybird. Расширенные разделы ссылаются на отдельные README для tinybird и dashboard для локальной разработки; pnpm dev синхронизирует изменения с веткой Tinybird, а pnpm deploy используется для продакшена. Создается файл .env.local со значениями TINYBIRD_TOKEN и TINYBIRD_HOST. Пользователи могут настроить и разместить собственный дашборд на Vercel. В README отмечается, что Tinybird как платформа соответствует GDPR, в то время как пользователи остаются ответственными за соблюдение правил GDPR при сборе данных и получении согласия.