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 [email protected]

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.

Table of content

• Breaking changes
• Adding the SDK to your project
• Add or Remove Strict mode for App-kids
• Initializing the SDK
• Guides
• API

This plugin is built for

• iOS AppsFlyerSDK v6.3.0
• Android AppsFlyerSDK v6.3.0

❗ Breaking Changes

• From version 6.3.0, we use xcframework for iOS platform, then you need to use cocoapods version >= 1.10

• From version 6.2.30, logCrossPromotionAndOpenStore api will register as af_cross_promotion instead of af_app_invites in your dashboard. Click on a link that was generated using generateInviteLink api will be register as af_app_invites.

• We have renamed the following APIs:

| Old API | New API | | ------------------------------|-------------------------------| | trackEvent | logEvent | | trackLocation | logLocation | | stopTracking | stop | | trackCrossPromotionImpression | logCrossPromotionImpression | | trackAndOpenStore | logCrossPromotionAndOpenStore | | setDeviceTrackingDisabled | anonymizeUser | | AppsFlyerTracker | AppsFlyerLib |

And removed the following ones:

• trackAppLaunch -> no longer needed. See new init guide
• sendDeepLinkData -> no longer needed. See new init guide
• enableUninstallTracking -> no longer needed. See new uninstall measurement guide

If you have used 1 of the removed APIs, please check the integration guide for the updated instructions

📲 Adding the SDK to your project

Production version from npm:

$ npm install react-native-appsflyer --save

Then run the following:

iOS

$ cd ios && pod install
$ react-native run-ios

Android

$ react-native run-android

Starting from RN v0.60, and react-native-appsflyer v1.4.7 the plugin uses autolinking. If your app does not support autolinking, check out the Installation Guide here.

👨‍👩‍👧‍👦 Add or Remove Strict mode for App-kids

Starting from version 6.1.10 iOS SDK comes in two variants: Strict mode and Regular mode. Please read more here

Change to Strict mode After you installed the AppsFlyer plugin, go to the react-native-appsflyer folder inside the node_modules folder:

cd node_modules/react-native-appsflyer

Run the script changeMode.sh strict

./changeMode.sh strict

Go to the ios folder in your root project

cd ../../ios

Run pod install

Change to Regular mode Go to the react-native-appsflyer folder inside the node_modules folder:

cd node_modules/react-native-appsflyer

Run the script changeMode.sh (WITHOUT strict)

./changeMode.sh

Go to the ios folder in your root project

cd ../../ios

Run pod install

🚀 Initializing the SDK

Initialize the SDK to enable AppsFlyer to detect installations, sessions (app opens) and updates. NOTE! for iOS 14.5, we use timeToWaitForATTUserAuthorization parameter. Please read more here

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',
    onInstallConversionDataListener: true, //Optional
    onDeepLinkListener: true, //Optional
    timeToWaitForATTUserAuthorization: 10 //for iOS 14.5
  },
  (result) => {
    console.log(result);
  },
  (error) => {
    console.error(error);
  }
);

| Setting | Description | | -------- | ------------- | | devKey | Your application devKey provided by AppsFlyer (required) | | appId | Your iTunes application ID (iOS only) | | isDebug | Debug mode - set to true for testing only | |onInstallConversionDataListener| Set listener for SDK init response (Optional. default=true) | |onDeepLinkListener| Set listener for DDL response (Optional. default=false) | |timeToWaitForATTUserAuthorization| Time for the sdk to wait before launch. please read more Here |

📖 Guides

Great installation and setup guides can be viewed here.

• init SDK Guide
• Deeplinking Guide
• Uninstall Guide

📑 API

See the full API available for this plugin.