Skip to content

React Native Mobile Application Implementation Guide


As of version 1.1.4, GPS geo-location data is not captured by default and will only be derived from the IP address. You can set the geo-location enable by the trackerConfig.setGeoLocationEnabled(true). To capture GPS geo-location data (requires permission grant by user).


Do not reshare this document with anyone unless they need to implement WOGAA tracking on their mobile applications.

Latest Version

The latest version of WOGAA Mobile Trackers is 2.1.2.


  1. Install via npm.
  2. Implement codes for React Native tracking.
  3. Check React Native implementation
  4. Verification of React Native implementation


React Native Tracker uses native iOS and Android Tracker underneath.

Step 1. Install via npm

Install via NPM

NPM is an open source package manager for the JavaScript development.


npm will install React Native Tracker under node_modules/react-native-tracker

The steps to install are as follows:

  1. npm install
  2. react-native link (React Native < 0.60)
  3. Update Podfile and App level Gradle build. See examples below.

Podfile Example

Podfile Example

source ''

target 'MasterDetailExampleApp' do
  pod 'RNTracker', :path => '../node_modules/react-native-tracker' # React Native < 0.60
  use_frameworks! # or use_modular_headers! # React Native < 0.60

Gradle Example

Gradle Example

  repositories { 
    maven { 
      url "" 

Step 2. Implement codes for React Native Tracking

In your App.js class,

  1. Add import Tracker from 'react-native-tracker';.
  2. Add the following codes when your application starts for the appropriate environment.

For Staging


For Production


Add track screenview for each view.

Track ScreenView

  componentDidMount() { 


Please update your Tracker.trackScreenView to pass only the screen name as the example above. The function below had been removed because the tracker will auto generate the screen id as uuid. react-native Tracker.trackScreenView('ScreenId', 'ScreenName');

Step 3. Check React Native Implementation

Method 1: Manually check the logs

Run your application using Xcode or Android Studio and verify the platform logs below

Example (iOS Tracker)

[WOGAA Tracker] Started (2.1.2)


[WOGAA Tracker] Started (2.1.2) shows tracker has started and the version number of the tracker

Example (Android Tracker)

I/WOGAATracker: Started (2.1.2)


I/WOGAATracker: Started (2.1.2) shows tracker has started and the version number of the tracker

Method 2: Use tool to check if data is being received in your environment(s).


- Staging received events will take about 10 seconds to process. (Last 24 hours)

- Production received events will take about 1 day to process.

Step 4. Verification of React Native Implementation

A verification email will be sent once we have successfully received data from your mobile application in production server.

It may take up to 7 working days for the verification. Please let us know if there is any issues with regards to this via

Reference Implementation