Tracking SPAs (Single Page Applications)

ag@dreamdata.io Updated by ag@dreamdata.io

Tracking events with Dreamdata in a Single Page Application (SPA) depends on the specific SPA framework being used. This article cannot cover every possible framework, but it will provide examples from popular libraries/frameworks, such as React and Angular.

Since there isn't a modern SDK available for seamless installation and import (using any JavaScript module systems), you'll need to manually incorporate our Analytics script into your main index.html file or a template. The location for injecting the script may vary depending on the specific library or framework used. However, most modern UI tools generally have a primary index.html page where the app is rendered, making it a suitable place for script insertion.

ℹ️ It's important to note that, unlike most other methods for configuring Dreamdata analytics and form tracking, this approach necessitates the involvement of a developer with access to the codebase. It cannot be implemented through Google Tag Manager (GTM) or our Auto Identify script.

Setting up the Analytics script:

  1. In your Dreamdata application, navigate to Data Platform > Sources > Javascript (Web Tracking) Source.
  2. Click on the "Copy Script" button.
  3. Paste the copied script into your main app's HTML page, e.g., the index.html file in the root directory for a React CRA. Place the script right before the closing </head> tag.

At this point, window.analytics should be globally accessible in your app. You now have access to various tracking methods, such as analytics.track, analytics.identify, and analytics.page, which we will discuss further in the following sections.

Tracking view (route) changes

React.js

In SPAs, different views are rendered instead of loading new HTML pages for each URL change. This process is typically managed by a third-party library, like react-router-dom or similar.

Here's an example of tracking view changes in modern React Application:

// React example that uses useLocation hook from react-router-dom
const location = useLocation();
useEffect(() => { 
    analytics.page();
}, [location.pathname]);

This effect has the location as a dependency, and it calls analytics.page() whenever the URL pathname changes.

Angular.js

The Angular example is similar to the previous React.js example:

// Implement the OnInit interface for your AppComponent:
@Component({ // ... }) 
export class AppComponent implements OnInit { // ... }

// Subscribe to the router's events and filter for NavigationEnd events, then call analytics.page() with the current route:

constructor(private router: Router) {} 
    ngOnInit() { 
    this.router.events.subscribe((event) => { 
        if (event instanceof NavigationEnd) { 
            analytics.page(); 
        } 
    }); 
}

As mentioned at the beginning of this guide, we cannot cover implementations for every modern UI framework or library. However, the concept should be clear enough, regardless of the framework you use. Simply "hook" into the appropriate router for that specific tool and listen for route changes.

Tracking forms

Although there is a brief section on tracking forms with our Analytics script, it's helpful to provide a straightforward example to guarantee a mutual understanding.

In a contemporary application, it's common to encounter a form accompanied by an onSubmit handler.

export default function FormExample() { 
    const [email, setEmail] = useState(""); 

    const handleSubmit = (e) => { 
        e.preventDefault(); 

        // this will be based on whatever your form does // e.g. book-a-demo 
        analytics.track("some-form-submit"); 

        // How you get an email from your form can vary 
        // and can be done in tens of different ways 
        // regardless, you'll somehow get a value of an email from a form 
        // and pass it to our identify 

        analytics.identify(null, { email }); 
}; 

    return (
        <div className="App"> 
            <form onSubmit={handleSubmit}> 
                <input name="email" placeholder="email" type="email" onChange={(e) => setEmail(e.target.value)} /> 
                <button type="submit">Submit</button> 
            </form>
    </div> );
}

This is just a React.js example and illustrates how you would do this in a modern UI library. No matter what you use, you will have a handler for your form. In this scenario, whatever you form does, you will include analytics.track and analytics.identify as part of it.

This concludes our guide on using Dreamdata tracking with Single Page Applications (SPAs). If you have further questions or need clarification on any aspect of this guide, please feel free to contact us.

How did we do?

Tracking iframes with auto-identify script

Across domain & device tracking

Contact