A Universal Google Analytics module for node and the browser. You can either include this referenced via a script tag globally, or use a bundling process such as webpack or browserify. Once universal-ga has been initialized, you can any of the tracking methods to send your analytics data to Google.

Currently supported features:

• Plugins
• Pageviews
• Screenviews
• Events
• User timings
• Exceptions
• Custom Dimensions/Metrics

$ npm install --save universal-ga

To initialize universal-ga, you will need to first pass in your analytics tracking id.

var analytics = require('universal-ga');
...
analytics.initialize('UA-XXXXX-YYY');

<script src="analytics.js"></script>
...
<script>analytics.initialize('UA-XXXXX-YYY');</script>

Initialization is dependant upon window being available at the time you call it, so be sure you call this once you can attach to window and before you call any of the other tracking methods.

Before anything else will work, you must first initialize analytics by passing an initial tracking id.

analytics.initialize('UA-12345-12');

Additional options can also be sent to analytics.create by including them as additional properties on the options object.

analytics.initialize('UA-12345-12', { storage: 'none' });

Allows you to create multiple tracking ids. If you just need to add an additional tracking id, options can just be the name of your additional tracker. This can be used in combination with the .name() method.

analytics.initialize('UA-12345-1');
analytics.create('UA-12345-2', 'anotherTracker');
...
analytics.pageview('/home');
analytics.name('anotherTracker').pageview('/home');

However, if you need to combine additional options with a name, you will need to name your tracker as part of the options object.

analytics.initialize('UA-12345-1');
analytics.create('UA-12345-2', {
  name: 'anotherTracker',
  clientId: generateUUID()
});

This will namespace any additional values, allowing you to specify which values to send to which tracker. The above example would send the following data to analytics:

['send', 'pageview', '/home'],
['anotherTracker.send', 'pageview', 'home']

Namespaces the next set of values sent to analytics.

analytics
  .name('anotherTracker')
  .pageView('/home')
  .timing('load', 'page', 123);

The above would send the following data to analytics:

['anotherTracker.send', 'pageview', '/home'],
['anotherTracker.send', 'timing', 'load', 'page', 123]

Set key/value pairs for analytics.

analytics.set('page', '/about');

Allows you to add plugins to analytics. Additional options for plugins can be seen in the plugins documentation.

analytics.plugin('foo');

Allows you to send a pageview to analytics. Additional options for the pageview can be seen in the pages documentation.

analytics.pageview('/about');

Send a screenview to analytics. Additional options for the screenview can be seen in the app screens documentation.

analytics.screenview('/about');

Send event data and event metrics to analytics. Additional options for events can be seen in the event tracking documentation.

analytics.event('category', 'action', { eventLabel: 'label' });

Send timing data to analytics. Additional options for timing can be seen in the user timing documentation.

analytics.timing('load', 'DOMContentLoaded', 123);

Send exception data to analytics. You can specify whether or not the event was fatal with the optional boolean flag.

Send custom dimension/metrics to analytics. You need to first configure caustom dimensions/metrics through the analytics management interface. This allows you to specify a metric/dimension index to track custom values. See custom dimensions/metrics documentation for more details.

Dimensions and metrics keys will be a key of dimension[0-9] or metric[0-9].

analytics
  .custom('dimension01', 1234)
  .custom('metric04', 'my custom dimension');

You can additional combine custom metrics/dimensions with other analytics properties (such as events or pageviews) as additional data.

analytics
  .event('category', 'action', { metric05: 'custom metric data' })
  .pageview('/index', { dimension02: 'custom dimension data' });