Introduction
If you're using Redux or ngrx/store to manage your app's state, you can use Redux Beacon to tap into your dispatched actions and map them to events that are consumable by an analytics service (e.g. Google Analytics). With Redux Beacon your entire global state life-cycle becomes trackable.
Redux Beacon Diagram
- Redux Beacon is lightweight. The core Redux Beacon module is tiny (~ 1KB), and each target, extension, and util, is either around the same size or smaller.
- You can use Redux Beacon with any framework. Redux Beacon doesn't depend on any framework, you can use Redux Beacon with React, Angular, React Native, Vue or just plain JavaScript.
- You can send analytics anywhere. We have prebuilt targets for the most popular analytics services, you can also build your own custom targets if you need to.
- You can track analytics offline. Redux Beacon provides extensions for tracking analytics during intermittent outages in connectivity. These extensions save events in a persistent store when offline (e.g indexedDB). When back online, the extensions purge the store and pass the events off to a target. Read more about offline event collection in the docs.
Supported Targets
​
Version
Package
Third-Party Targets
​
Version
Package
Other Targets
If you don't see your analytics target listed it might be worth a shot doing a quick search on npmjs.org. If all else fails you can always build and provide your own custom Targets!
Usage
- Step 1. Pick out a target (see above)
- Step 2. Pick out some events you want to track from your target's Event Definitions section
- Step 3. Match the events to action types (see below)
Examples
Track a page view on each
ROUTE_CHANGED action1
const eventsMap = {
2
'ROUTE_CHANGED': trackPageView(action => ({
3
page: action.payload.routerState.url,
4
})),
5
}
Copied!
Track an event on each
VIDEO_SELECTED action, use the state before the action and the state after the action to hydrate the analytics event1
const eventsMap = {
2
'VIDEO_SELECTED': trackEvent((action, prevState, nextState) => ({
3
category: 'Videos',
4
action: action.type,
5
label: prevState.videos.currentCampaign,
6
value: nextState.videos.numVideosSelected,
7
}))
8
}
Copied!
Track an event on _every action using the special '*' key_
1
const eventsMap = {
2
'*': trackEvent(action => ({
3
category: 'redux',
4
action: action.type,
5
})),
6
}
Copied!
Track multiple events on each
VIDEO_PLAYED action using the combineEvents util1
const eventsMap = {
2
'VIDEO_PLAYED': combineEvents(
3
trackTiming(action => ({
4
category: 'Videos',
5
action: 'load',
6
value: action.payload.loadTime,
7
}))
8
trackEvent(() => ({
9
category: 'Videos',
10
action: 'play'
11
})),
12
),
13
}
Copied!
Track an event on each 'VIDEO_SEARCHED' action, but throttle it with the debounceEvent util so it doesn't fire as often
1
const eventsMap = {
2
'VIDEO_SEARCHED': debounceEvent(300,
3
trackEvent(action => ({
4
category: 'Videos',
5
action: 'search',
6
label: action.payload.searchTerm,
7
}))
8
),
9
}
Copied!
The
trackPageView, trackEvent, and trackTiming functions used above are called eventDefinitions and are what you use to create events that are consumable by an analytics service (a.k.a "target"). Each target will have its own set of eventDefinitions that you can use and customize.Don't like the idea of using an object to map actions?
You can use a function...
1
const pageView = trackPageView(action => ({
2
page: action.payload.routerState.url,
3
}));
4
​
5
const videoLoadTime = trackTiming(action => ({
6
category: 'Videos',
7
action: 'load',
8
value: action.payload.loadTime,
9
}));
10
​
11
const videoPlayed = trackEvent(() => ({
12
category: 'Videos',
13
action: 'play'
14
}));
15
​
16
const eventsMapper = (action) => {
17
switch(action.type) {
18
case 'ROUTE_CHANGED':
19
return pageView;
20
case 'VIDEO_PLAYED':
21
return [videoLoadTime, videoPlayed]
22
default:
23
return [];
24
}
25
}
Copied!
More Examples & Recipes
Extensions & Plugins
​
Version
Package
Last modified 2yr ago