markdalgleish / stateless-dtm

Purely stateless interface for Dynamic Tag Manager

stateless-dtm

Purely stateless interface for Dynamic Tag Manager.

Why?

DTM encourages the use of a stateful global object to maintain tracking data, referred to as a "data layer". Unfortunately, this approach doesn't quite feel at home in the era of purely functional interfaces (e.g. React) and front-end event sourcing (e.g. Redux).

To combat this, stateless-dtm conceals this global mutation behind a purely functional interface. When tracking an event, the "data layer" object must be provided in its entirety, ensuring that all events are completely atomic and don't depend on prior mutations.

Usage

import track from 'stateless-dtm';

track('event-name', {
  some: 'data',
  more: 'stuff'
});

By default, the data layer is exposed via a window.analytics object, and events are tracked by calling window._satellite.track(eventName). These can be customised, but this feature is currently undocumented.

License

MIT License