sdk-analytics-installer

Name: sdk-analytics-installer
Author: dotCMS

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

TL;DR

Install and configure @dotcms/analytics with centralized config and proper hook usage.

What Is It

SDK for content-aware analytics in Next.js/React
Tracks pageviews, events, and conversions automatically
Provides session and UTM campaign tracking
Uses centralized config with environment variables

Key Features

Auto page view tracking on route changes
Conversion tracking for purchases, downloads, etc.
Custom event tracking via useContentAnalytics hook
30-minute session timeout for anonymous users
UTM campaign parameter tracking
Event batching for performance
Centralized configuration management
Environment variable-based setup

How to Use

1.Install package: npm install @dotcms/analytics
2.Create centralized config file with siteAuth, server, autoPageView, debug
3.Add <DotContentAnalytics config={config} /> to layout.js root
4.Import analyticsConfig in every component using useContentAnalytics
5.Always pass config to useContentAnalytics hook

Guardrails & Gotchas

CRITICAL: useContentAnalytics() ALWAYS requires config as parameter
NOT a React Context provider - config must be passed manually
Do NOT omit config when using useContentAnalytics
Centralize config to avoid duplication and improve maintainability

GitHub Stats

Author

@dotCMS

Repository

dotCMS/core

Stars

949

Explore More Skills

revenuecat

@rawveg

Comprehensive assistance with RevenueCat in-app subscriptions and purchases

687

7mo ago

sdk-analytics-installer

Explore More Skills

revenuecat

api-design-principles

solana-security