sdk-analytics-installer
Zainstaluj i skonfiguruj śledzenie analityki w Next.js i React — umiejętność Claude dla SDK dotCMS
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Umiejętność Claude, która prowadzi Cię przez instalację i konfigurację SDK analityki dotCMS (@dotcms/analytics) w projektach Next.js i React. Automatycznie śledzi wyświetlenia stron, konwersje (zakupy, pobrania, rejestracje) i zdarzenia niestandardowe. Obsługuje zarządzanie sesjami, śledzenie użytkowników anonimowych, parametry kampanii UTM oraz batching zdarzeń dla wydajności. Idealna dla deweloperów, którzy chcą szybko wdrożyć analitykę świadomą treści w swoich aplikacjach.
Jak używać
Wyzwij umiejętność, gdy chcesz zainstalować, skonfigurować lub ustawić @dotcms/analytics, sdk-analytics, SDK analityki, dodać śledzenie analityki lub wspomnieć o instalacji analityki w projektach Next.js lub React. Umiejętność automatycznie rozpozna Twoje zapytanie i przygotuje instrukcje.
Przygotuj zmienne środowiskowe wymagane przez SDK: NEXT_PUBLIC_DOTCMS_ANALYTICS_SITE_KEY (klucz witryny), NEXT_PUBLIC_DOTCMS_ANALYTICS_HOST (host serwera) i opcjonalnie NEXT_PUBLIC_DOTCMS_ANALYTICS_DEBUG (dla trybu debugowania). Umiejętność pomoże Ci je skonfigurować.
Utwórz scentralizowany plik konfiguracji analityki (np. /src/config/analytics.config.js), który eksportuje obiekt analyticsConfig z ustawieniami siteAuth, server, autoPageView i debug. Umiejętność pokaże Ci dokładną strukturę.
Dodaj komponent DotContentAnalytics do głównego layoutu aplikacji — jego jedynym celem jest automatyczne śledzenie wyświetleń stron przy zmianach tras. Pamiętaj, że to NIE jest React Context Provider.
W komponentach, gdzie chcesz śledzić zdarzenia niestandardowe (konwersje, kliknięcia), użyj hooka useContentAnalytics(config), importując konfigurację z pliku centralnego. Hook zawsze wymaga parametru config — nigdy nie używa Context.
Umiejętność zweryfikuje Twoją konfigurację i pomoże w debugowaniu, jeśli włączysz tryb debug. SDK będzie automatycznie batching'ować zdarzenia dla optymalnej wydajności.