superpan/react-amplitude

React Amplitude Analytics

react-amplitude

React Amplitude Analytics

This is a JavaScript module that can be used to include Amplitude Analytics tracking code in a website or app that uses React for its front-end codebase.

Feel free to file issues, ideas and pull requests against this repo.

Installation

With yarn:

yarn add react-amplitude

With npm:

npm install react-amplitude --save

Usage

Initializing:

import React from 'react';
import ReactDOM from 'react-dom';

...
import Amplitude from 'react-amplitude';
Amplitude.initialize('YOUR_UNIQUE_TRACKING_CODE');
...

document.addEventListener('DOMContentLoaded', function() {
  ReactDOM.render(<App />, document.getElementById('app'));
});

API

Amplitude.initialize(amplitudeTrackingCode)

Must be initialized using this function before any of the other tracking functions will record any data.

Example

Amplitude.initialize('YOUR_UNIQUE_TRACKING_CODE');

Value	Notes
gaTrackingID	String. Required.

Amplitude.event(eventName)

Log an event to Amplitude.

Example

Amplitude.event('EVENT_NAME_TO_BE_LOGGED', eventProperties);

Value	Notes
eventName	String. Required.
eventProperties	Object. Optional.

Amplitude.resetUserId()

Remove user tracking (e.g. on logging out).

Example

Amplitude.resetUserId();

Amplitude.setUserId(userId)

Track users through a unique user id.

Example

Amplitude.setUserId(userId);

Value	Notes
userId	String. Required.

Development

git clone https://github.com/rorygarand/react-amplitude.git
yarn install
npm run build

Acknowledgements

• react-ga.