JSPM

  • Created
  • Published
  • Downloads 139561
  • Score
    100M100P100Q224108F
  • License

React Native Appsflyer plugin

Package Exports

  • react-native-appsflyer

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (react-native-appsflyer) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

React Native AppsFlyer plugin for Android and iOS.

๐Ÿ›  In order for us to provide optimal support, we would kindly ask you to submit any issues to support@appsflyer.com

When submitting an issue please specify your AppsFlyer sign-up (account) email , your app ID , production steps, logs, code snippets and any additional relevant information.

npm version

Table of content

This plugin is built for

๐Ÿ“ฒInstallation

$ npm install react-native-appsflyer --save

Then run:

$ react-native link react-native-appsflyer

iOS

With Cocoapods

Add the appsFlyerFramework to podfile and run pod install.

pod 'react-native-appsflyer',
:path => '../node_modules/react-native-appsflyer'

Note that You must also have the React dependencies defined in the Podfile as described here.

Check out the sample pod file for a working example.

Without Cocoapods

  1. Download the Static Lib of the AppsFlyer iOS SDK from here.
  2. Unzip and copy the contents of the Zip file into your project directory.
  3. Copy RNAppsFlyer.h and RNAppsFlyer.m from node_modules โžœ react-native-appsflyer to your project directory.

For more info check out the Installation guide here.

Android

Running react-native link react-native-appsflyer will complete the Android integration.

For the manual integration steps, check out the Installation guide here.

๐Ÿš€ Setup

Set your App_ID (iOS only), Dev_Key and enable AppsFlyer to detect installations, sessions (app opens) and updates.

This is the minimum requirement to start tracking your app installs and is already implemented in this plugin. You MUST modify this call and provide:
devKey - Your application devKey provided by AppsFlyer.
appId - For iOS only. Your iTunes Application ID.

Add the following lines to your code to be able to initialize tracking with your own AppsFlyer dev key:

import React, {Component} from 'react';
import {Platform, StyleSheet, Text, View} from 'react-native';
import appsFlyer from 'react-native-appsflyer';

appsFlyer.initSdk({
  devKey: 'K2**********99',
  isDebug: false,
  appId: '41*****44'
},
  (result) => {
    console.log(result);
  },
  (error) => {
    console.error(error);
  }
)

Important - For iOS another step is required for tracking. AppState logic is required to track Background-to-foreground transitions. Check out the relevant guide to see how this manidtory step is impelemented.

๐Ÿ“– Guides

Great installation and setup guides can be viewed here.

๐Ÿ“‘ API

See the full API available for this plugin.

๐Ÿ“ฑ Demo

Check out the demo for this project here.