Install Simple Analytics with Gatsby

Download PDF

Run the following command:

npm install gatsby-plugin-simple-analytics --save-dev

What does it do

It tracks page views with support for pushState navigation. It sends the data to Simple Analytics and it will be available in your dashboard. You need to have a paid subscription for it to work.

How to use

Add our plugin to gatsby-config.js

plugins: [
  {
    resolve: "gatsby-plugin-simple-analytics",
    options: {
      trackPageViews: true,
    },
  },
];

If you want to set a custom domain, use this config:

plugins: [
  {
    resolve: "gatsby-plugin-simple-analytics",
    options: {
      domain: "custom.example.com",
      eventsGlobal: "sa",
      events: true,
      trackPageViews: true,
      ignorePages: ["pathname"],
    },
  },
];

Read our docs on the custom domain feature.

Use with Confirmic

Confirmic provides a privacy-by-design API to ethically manage your users’ data. It’s pretty cool.

If you want to use it with Confirmic’s data-micropolicy use this config:

plugins: [
  {
    resolve: "gatsby-plugin-simple-analytics",
    options: {
      metomic: "POLICY-SLUG",
    },
  },
];

It will result in something like this:

<script src="https://scripts.simpleanalyticscdn.com/latest.js" async="" defer="" type="text/x-metomic" data-micropolicy="POLICY-SLUG">