sdk-analytics-installer

Use this skill when the user asks to install, configure, or set up @dotcms/analytics, sdk-analytics, analytics SDK, add analytics tracking, or mentions installing analytics in Next.js or React projects

1. 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.

2. 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ć.

3. 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ę.

4. 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.

5. 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.

6. 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.