Go to file
2018-11-01 12:42:18 +02:00
android check sdk version at the project level, bump minimum sdk version 2018-11-01 12:42:18 +02:00
example Update pkg in examaple project 2017-09-30 17:54:19 +03:00
ios/RCTAppMetrica add user profile reporting 2018-09-12 16:56:09 +02:00
.eslintignore Add ESLint 2017-09-18 10:07:46 +03:00
.eslintrc.json Add flow annotation 2017-09-30 15:41:58 +03:00
.flowconfig Add flow annotation 2017-09-30 15:41:58 +03:00
.gitignore gitignore 2017-09-18 10:03:45 +03:00
.npmignore Add example project to npmignore 2017-09-30 14:29:12 +03:00
.travis.yml Enable travis 2017-09-18 10:10:51 +03:00
index.js add user profile reporting 2018-09-12 16:56:09 +02:00
LICENSE Initial commit 2017-09-18 09:46:10 +03:00
package-lock.json 1.1.0 2018-09-10 16:08:49 +03:00
package.json 1.1.0 2018-09-10 16:08:49 +03:00
README.md add user profile reporting 2018-09-12 16:56:09 +02:00

Build Status NPM version

react-native-appmetrica

React Native bridge to the AppMetrica on both iOS and Android.

Installation

  1. Only for iOS: setup AppMetrica. YandexMobileMetrica.framework should be placed at <project_dir>/ios/ or <project_dir>/ios/Frameworks/. Otherwise you'll get build error.
  2. npm install --save react-native-appmetrica
  3. react-native link react-native-appmetrica

iOS notice: If you build failed after installing SDK and react-native-appmetrica make sure YandexMobileMetrica.framework and libRCTAppMetrica.a are included at Build Phase -> Link Binary With Libraries

Example

import AppMetrica from 'react-native-appmetrica';

AppMetrica.activateWithApiKey('2dee16d2-1143-4cd3-a904-39ce10ac2755');

AppMetrica.reportEvent('Hello world');

Usage

import AppMetrica from 'react-native-appmetrica';

// Start the statistics collection process.
AppMetrica.activateWithApiKey('...KEY...');
// OR
AppMetrica.activateWithConfig({
  apiKey: '...KEY...',
  sessionTimeout: 120,
  firstActivationAsUpdate: true,
});

// Send a custom event message and additional parameters (optional).
AppMetrica.reportEvent('My event');
AppMetrica.reportEvent('My event', { foo: 'bar' });

// Send a custom error event.
AppMetrica.reportError('My error');

// Send user profile with predefined attributes.
AppMetrica.reportUserProfile({ name: 'User 1', age: 87 });

// Send user profile with custom attributes.
AppMetrica.reportUserProfile({
  likesMusic: true,
  addedToFavorites: '+1',
  score: 150,
});

Reporting user profile

All predefined attributes are supported. Use null to reset them.

type UserProfileAttributes = {
    name?: ?string,
    gender?: 'female' | 'male' | string | void,
    age?: ?number,
    birthDate?: Date | [number] | [number, number] | [number, number, number] | void,
    notificationsEnabled?: boolean,
    /** custom attributes */
    [string]: string | number | boolean,
};

Custom attributes are supported. They can't be reset for now.

Use values like '+1', '-10' for counters. Current limitation is any custom attribute which value started with '+' or '-' will be considered as a counter.