Install Simple Analytics with the Analytics library

Download PDF

You can install Simple Analytics using the open-source Analytics library (website, npm). It’s a pluggable library designed as an abstraction layer to customize your app’s analytics requirements easily.

Install via npm

npm install analytics @analytics/simple-analytics

Using the Analytics library

The Analytics library works with any frontend framework, including react, vue, angular or static html.

To use it:

Import the analytics library and @analytics/simple-analytics
Initialize the analytics library
Page views get tracked automatically
Include the non-javascript fallback in your html

Example code:

/* src/analytics.js */
import Analytics from "analytics";
import simpleAnalyticsPlugin from "@analytics/simple-analytics";

const analytics = Analytics({
  app: "awesome-app",
  plugins: [
    // Load simple analytics! 🎉
    simpleAnalyticsPlugin(),
  ],
});

/* All page views are now tracked by simple analytics */

Make sure to include this file in the entry point of your application. This will ensure the Analytics library and Simple Analytics scripts load correctly.

When the Analytics library is initialized it will automatically load the simple analytics script onto the page.

For additional instructions on how to use with other frontend frameworks, check out the Analytics library docs

Include non-JS enabled browser fallback

Remember to include the noscript image tag in your HTML for JS-disabled browsers.

Include this line at the end of your <body>

<noscript><img src="https://queue.simpleanalyticscdn.com/noscript.gif" alt="" referrerpolicy="no-referrer-when-downgrade" /></noscript>

View the source

You can view the source code of this plugin on GitHub

If you encounter issues, don’t hesitate to contact us via our support channels.