Segment

Setup

  1. 1.
    Sign up for Segment.io and create a Segment.io project for your web application.
  2. 2.
    Add the JavaScript Tracking Snippet to your site.
    During development and testing it is often helpful to use the debug version of analytics.js. Follow the instructions here to enable it.
  3. 3.
    Install the target:
    npm install --save @redux-beacon/segment

Usage

import Segment from '@redux-beacon/segment';
// Create or import an events map.
// See "getting started" pages for instructions.
const segment = Segment();
const segmentMiddleware = createMiddleware(eventsMap, segment);
const segmentMetaReducer = createMetaReducer(eventsMap, segment);

Event Definitions

Don't see your event listed? Please submit a pull request to the Redux Beacon repository with the missing event. Use the source of the existing event-helpers to guide your work. If you need any support feel free to make the pull request with all you're able to do. We can fill in the gaps from there.

pageView

Docs:

import { trackPageView } from '@redux-beacon/segment';
const pageView = trackPageView((action, prevState, nextState) => {
return {
category: /* (optional) */
name: /* (optional) */
properties: /* (optional) */
options: /* (optional) */
};
});
The last line of the tracking snippet analytics.page(); hits Segment.io with a page view that matches the first loaded route. If you're tracking page views using Redux Beacon, be sure to remove this line so the initial page load isn't recorded twice.

event

Docs:

import { trackEvent } from '@redux-beacon/segment';
const event = trackEvent((action, prevState, nextState) => {
return {
name: /* fill me in */,
properties: /* (optional) */,
options: /* (optional) */,
};
});

alias

Docs:

import { setAlias } from '@redux-beacon/segment';
const alias = setAlias((action, prevState, nextState) => {
return {
userId: /* fill me in */,
previousId: /* (optional) */,
options: /* (optional) */,
};
});

group

Docs:

import { setGroup } from '@redux-beacon/segment';
const group = setGroup((action, prevState, nextState) => {
return {
groupId: /* fill me in */,
traits: /* (optional) */,
options: /* (optional) */,
};
});

identify

Docs:

import { identifyUser } from '@redux-beacon/segment';
const user = identifyUser((action, prevState, nextState) => {
return {
userId: /* (optional) */,
traits: /* (optional) */,
options: /* (optional) */,
};
});

reset

Docs:

import { reset } from '@redux-beacon/segment';
const resetRequest = reset();