Amplitude

• Setup

• Usage

• Event Definitions

Setup

1. Sign up for Amplitude at http://amplitude.com and make a note of your API key.

2. Install amplitude-js: npm install --save amplitude-js.

3. Install the target:

    npm install --save @redux-beacon/amplitude

Usage

import amplitude from 'amplitude-js';
import Amplitude from '@redux-beacon/amplitude';

// Create or import an events map.
// See "getting started" pages for instructions.

// initialise amplitude
const amplitudeInstance = amplitude.getInstance();
amplitudeInstance.init('YOUR_API_KEY')

const target = Amplitude({ instance: amplitudeInstance });

const amplitudeMiddleware = createMiddleware(eventsMap, target);
const amplitudeMetaReducer = createMetaReducer(eventsMap, target);

Event Definitions

• event
• userId
• logout
• userProperties

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.

event

Docs:

• https://amplitude.zendesk.com/hc/en-us/articles/115001361248#tracking-events
• https://amplitude.zendesk.com/hc/en-us/articles/115001361248#setting-event-properties

import { logEvent } from '@redux-beacon/amplitude';

const event = logEvent((action, prevState, nextState) => {
  return {
    type: /* fill me in */,
    properties: /* (optional) */,
  };
});

userId

Docs:

https://amplitude.zendesk.com/hc/en-us/articles/115001361248#setting-custom-user-ids

import { setUserId } from '@redux-beacon/amplitude';

const event = setUserId((action, prevState, nextState) => {
  return /* (user Id) fill me in */
});

logout

Docs:

https://amplitude.zendesk.com/hc/en-us/articles/115001361248#logging-out-and-anonymous-users

import { logout } from '@redux-beacon/amplitude';

const event = logout();

userProperties

Docs:

https://amplitude.zendesk.com/hc/en-us/articles/115001361248#setting-multiple-user-properties

import { setUserProperties } from '@redux-beacon/amplitude';

const event = setUserProperties((action, prevState, nextState) => {
  return {
   [/* property key */]: /* property value */,
  };
});