Integrating Gooddata with React (Create React App / Vite)

Adding Gooddata to your React (Create React App / Vite) project is a simple, straightforward process. Follow the step-by-step instructions below to start tracking your visitors without compromising their privacy.

Step 1: Copy Your Project ID

Before you begin, you need your unique Gooddata Project ID.

1. Log in to your Gooddata Dashboard.
2. Select your project from the sidebar.
3. Click on the Settings gear icon in the bottom left.
4. Copy the Project ID or the provided tracking snippet block.

Step 2: Add the Script to Your App

For single-page React applications, you can inject the script directly into the document head when your main App component mounts.

1. Open your main App.jsx or App.tsx file.
2. Import the useEffect hook from React.
3. Paste the following code inside your App component to dynamically create and append the script.
4. Replace <YOUR_PROJECT_ID> with your actual ID.

import { useEffect } from 'react';

function App() {
  useEffect(() => {
    const script = document.createElement('script');
    script.src = "https://gooddata-fyp.onrender.com/sdk/tracker.js";
    script.defer = true;
    script.setAttribute('data-project-id', '<YOUR_PROJECT_ID>');
    document.head.appendChild(script);
  }, []);

  return <div>Your App Components</div>;
}

Step 3: Verify the Installation

Once you have added the script and published your changes, it's time to test if Gooddata is receiving data.

1. Open your live website in a new incognito/private browsing window.
2. Navigate to a few different pages.
3. Return to your Gooddata Dashboard and go to the Realtime tab.
4. You should see "1 Active Visitor" and your recent page views populating instantly.

Troubleshooting: If you don't see any data, make sure you don't have an adblocker enabled that might be blocking the script, and ensure you replaced <YOUR_PROJECT_ID> with your actual ID.