electron-google-analytics

Google Analytics - Measurement Protocol API

The main purpose of this was to be used with Electron built apps.

Features

• Pageview
• Event
• Screenview
• Custom function for the rest (send)

Getting started

Installation

npm i electron-google-analytics

• Init

  Analytics(trackingID, { userAgent, debug, version })

  import Analytics from 'electron-google-analytics';
  const analytics = new Analytics('UA-XXXXXXXX-X');
  

• Pageview

  Analytics#pageview(hostname, url, title, clientID)

  return analytics.pageview('http://example.com', '/home', 'Example')
    .then((response) => {
      return response;
    }).catch((err) => {
      return err;
    });
  

  If you want to keep the session you need to specify the clientID.

• Event

  Analytics#event(evCategory, evAction, { evLabel, evValue, clientID })

  return analytics.event('Video', 'play', { evLabel: 'holiday', evValue: 300})
    .then((response) => {
      return response;
    }).catch((err) => {
      return err;
    });
  

• Screenview

  Analytics#screen(appName, appVer, appID, appInstallerID, screenName, clientID)

  return analytics.screen('test', '1.0.0', 'com.app.test', 'com.app.installer', 'Test')
    .then((response) => {
      return response;
    }).catch((err) => {
      return err;
    });
  

• Send (for everything else for now)

  Analytics#send(hitType, params, clientID)

  return analytics.send('social', { sa: 'social', sn: 'facebook', st: 'home' })
    .then((response) => {
      return response;
    }).catch((err) => {
      return err;
    });
  

Tests

cross-env TRACKING_ID='UA-XXXXXXXX-X' npm test

MIT