react-native-appsflyer

react-native-appsflyer

This React Natie Library uses the AppsFlyer 4.6.0 library for both iOS and Android

Installation

$ npm install react-native-appsflyer --save

iOS

1. Install the appsFlyerFramework through pod . Don't use CocoaPods? please see their DOCS .

Example:

use_frameworks!
target 'demo' do
  pod 'AppsFlyerFramework'
end

1. Create bridge between your application and appsFlyerFramework: In XCode ➜ project navigator, right click Libraries ➜ Add Files to [your project's name] Go to node_modules ➜ react-native-appsflyer and add RNAppsFlyer.xcodeproj Build your project, It will generate libRNAppsFlyer.a file:

2. Run your project (Cmd+R) or through CLI run: react-native run-ios

Android

android/app/build.gradle

1. Add the project to your dependencies

dependencies {
    ...
    compile project(':react-native-appsflyer')
}

android/settings.gradle

1. Add the project

include ':react-native-appsflyer'
project(':react-native-appsflyer').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-appsflyer/android')

Build project so you should get following dependency (see an Image):

MainApplication.java

Add:

1. import com.appsflyer.reactnative.RNAppsFlyerPackage;

2. In the getPackages() method register the module: new RNAppsFlyerPackage(MainApplication.this)

So getPackages() should look like:

 @Override
    protected List<ReactPackage> getPackages() {
      return Arrays.<ReactPackage>asList(
          new MainReactPackage(),
          new RNAppsFlyerPackage(MainApplication.this),
          //.....
      );
    }

##API Methods

---

Call module by adding:

import appsFlyer from 'react-native-appsflyer';

---

appsFlyer.initSdk(options, callback): void

initialize the SDK, returns Object.

parameter	type	description
options	Object	SDK configuration

options

name	type	default	description
devKey	string		Appsflyer Dev key
appId	string		Apple Application ID (for iOS only)
isDebug	boolean	true	debug mode (optional)

Example:

 let options = {
       devKey:  'WdpTVAcYwmxsaQ4WeTspmh',
       appId: "975313579",
       isDebug: true
     };

    appsFlyer.initSdk(options, (error, result) => {
      if (error) {
        console.error(error);
      } else {
       /..
      }
    })

---

appsFlyer.trackEvent(eventName, eventValues, callback): void

• These in-app events help you track how loyal users discover your app, and attribute them to specific campaigns/media-sources. Please take the time define the event/s you want to measure to allow you to track ROI (Return on Investment) and LTV (Lifetime Value).
• The trackEvent method allows you to send in-app events to AppsFlyer analytics. This method allows you to add events dynamically by adding them directly to the application code.

parameter	type	description
eventName	String	custom event name, is presented in your dashboard. See the Event list HERE
eventValue	Object	event details

Example:

 const eventName = "af_add_to_cart";
 const eventValues = {
      "af_content_id": "id123",
      "af_currency":"USD",
      "af_revenue": "2"
  };

 appsFlyer.trackEvent(eventName, eventValues, (error, result) => {
     if (error) {
         console.error(error);
     } else {
         //...
     }
 })
    

---

appsFlyer.getAppsFlyerUID(callback): void

Get AppsFlyer’s proprietary Device ID. The AppsFlyer Device ID is the main ID used by AppsFlyer in Reports and APIs.

Example:

 appsFlyer.getAppsFlyerUID((error, appsFlyerUID) => {
      if (error) {
        console.error(error);
      } else {
        console.log("on getAppsFlyerUID: " + appsFlyerUID);
      }
    })

---

appsFlyer.trackLocation(longitude, latitude, callback(error, coords): void (iOS only)

Get AppsFlyer’s proprietary Device ID. The AppsFlyer Device ID is the main ID used by AppsFlyer in Reports and APIs.

parameter	type	description
error	String	Error callback - called on getAppsFlyerUID failure
appsFlyerUID	string	The AppsFlyer Device ID

Example:

 const  latitude = -18.406655;
 const  longitude = 46.406250;
 
 appsFlyer.trackLocation(longitude, latitude, (error, coords) => {
      if (error) {
        console.error(error);
      } else {
        this.setState( { ...this.state, trackLocation: coords });
      }
    })
})

---

##Demo

This plugin has a demo project bundled with it. To give it a try without creating a fresh project, execute the following with the plugin directory as the current working directory:

npm run setup

• Run npm run demo.ios or npm run demo.ios will run for the appropriate platform.
• Run npm run ios-pod to run Podfile under demo project