@hadx/analytics

Hadex Analytics

This is Hadex's analytics library to track and report React Native app's usage using Firebase's firestore.

What for?

Why not use Firebase Analytics?

You can have access to all the data programmatically since it's hosted on your firebase firestore. Hadex Analytics provides functions to read, filter and analyse those data. No need to export to BigQuery which is not free.

Getting started

1. Create a new project on firebase console (ex: AppsAnalytics)

2. Add a Web App to the project

1. Copy the firebaseConfig part to ./credentials/firebaseConfig.json

In ./credentials/firebaseConfig.json

{
    "apiKey": "...",
    "authDomain": "...",
    "databaseURL": "...",
    "projectId": "...",
    "storageBucket": "...",
    "messagingSenderId": "...",
    "appId": "..."
}

1. Create Firestore database with Rules

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if request.auth != null;
    }
  }
}

1. Enable Anonymous Authentication

2. Install this package

yarn add @hadx/analytics

1. Link react-native-device-info

Basic Usage

On your React Native app initialization:

import Analytics from '@hadx/analytics';


export default class App extends React.Component {
    componentDidMount() {
        Analytics.initialize({appID: 'myappID'}, () => {
            Analytics.logEvent('openApp')
        });
    }
}

Dependencies

• react-native-device-info: used to get device's informations
• firebase: used mainly for firestore api

Automatic events

These events below are logged automatically for you

Event ID	When	Data
newUser	a new user installs your app	deviceID