npmtestforbm v6.6.0
React Native AppsFlyer plugin for Android and iOS.
test ๐ 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.
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.4.3
- Android AppsFlyerSDK v6.4.3
โ Breaking Changes
From version
6.3.0
, we usexcframework
for iOS platform, then you need to use cocoapods version >= 1.10From version
6.2.30
,logCrossPromotionAndOpenStore
api will register asaf_cross_promotion
instead ofaf_app_invites
in your dashboard. Click on a link that was generated usinggenerateInviteLink
api will be register asaf_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](https://facebook.github.io/react-native/blog/2019/07/03/version-60), and react-native-appsflyer
v1.4.7
the plugin uses [autolinking](https://github.com/react-native-community/cli/blob/master/docs/autolinking.md). If your app does not support autolinking, check out the Installation Guide [here](./Docs/Installation.md).
๐จโ๐ฉโ๐งโ๐ฆ 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](https://support.appsflyer.com/hc/en-us/articles/207032066#integration-strict-mode-sdk)
Version <= 6.3.0: read this section of the README.md in branch: releases/6.x.x/6.3.x/6.3.0
Change to Strict mode
1. After you [installed](#installation) the AppsFlyer plugin, add $RNAppsFlyerStrictMode=true
in the project's Podfile:
//MyRNApp/ios/Podfile
...
use_frameworks!
$RNAppsFlyerStrictMode=true
# Pods for MyRNApp
...
- In the
ios
folder of yourroot
project Runpod install
Change to Regular mode
1. Remove $RNAppsFlyerStrictMode=true
from the project's Podfile or set it to $RNAppsFlyerStrictMode=false
- In the
ios
folder of yourroot
project Runpod 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](https://support.appsflyer.com/hc/en-us/articles/207032066-iOS-SDK-V6-X-integration-guide-for-developers#integration-33-configuring-app-tracking-transparency-att-support)
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](https://support.appsflyer.com/hc/en-us/articles/211719806-Global-app-settings-#sdk-dev-key) provided by AppsFlyer (required) |
appId | Your iTunes [application ID](https://support.appsflyer.com/hc/en-us/articles/207377436-Adding-a-new-app#available-in-the-app-store-google-play-store-windows-phone-store) (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](https://support.appsflyer.com/hc/en-us/articles/207032066-iOS-SDK-V6-X-integration-guide-for-developers#additional-apis-configuring-app-tracking-transparency-att-support) |
๐ Guides
Great installation and setup guides can be viewed [here](/Docs/Guides.md).
- [init SDK Guide](/Docs/Guides.md#init-sdk)
- [Deeplinking Guide](/Docs/Guides.md#deeplinking)
- [Uninstall Guide](/Docs/Guides.md#measure-app-uninstalls)
๐ API
See the full [API](/Docs/API.md) available for this plugin.
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago