@adobe/react-native-acpanalytics
is a wrapper around the iOS and Android AEP Analytics SDK to allow for integration with React Native applications. Functionality to enable Adobe Analytics is provided entirely through JavaScript documented below.
You need to install the SDK with npm and configure the native Android/iOS project in your react native project. Before installing the Analytics extension it is recommended to begin by installing the Core extension.
Note: If you are new to React Native we suggest you follow the React Native Getting Started page before continuing.
First create a React Native project:
react-native init MyReactApp
Install and link the @adobe/react-native-acpanalytics
package:
cd MyReactApp
npm install @adobe/react-native-acpanalytics
- React Native 0.60+
CLI autolink feature links the module while building the app.
- React Native <= 0.59
react-native link @adobe/react-native-acpanalytics
Note For iOS
using cocoapods
, run:
cd ios/ && pod install
This project contains jest unit tests which are contained in the __tests__
directory, to run the tests locally:
make run-tests-locally
import {ACPAnalytics} from '@adobe/react-native-acpanalytics';
ACPAnalytics.extensionVersion().then(version => console.log("AdobeExperienceSDK: ACPAnalytics version: " + version));
Note: It is recommended to initialize the SDK via native code inside your AppDelegate and MainApplication in iOS and Android respectively. However, you can still initialize the SDK in Javascript. For more information see how to initialize Core.
#import <RCTACPAnalytics/ACPAnalytics.h>
[ACPAnalytics registerExtension];
import com.adobe.marketing.mobile.Analytics;
Analytics.registerExtension();
import {ACPAnalytics} from '@adobe/react-native-acpanalytics';
ACPAnalytics.registerExtension();
ACPAnalytics.getTrackingIdentifier().then(identifier => console.log("AdobeExperienceSDK: Tracking identifier: " + identifier));
ACPAnalytics.sendQueuedHits();
ACPAnalytics.getQueueSize().then(size => console.log("AdobeExperienceSDK: Queue size: " + size));
ACPAnalytics.clearQueue();
ACPAnalytics.setVisitorIdentifier("yourVisitorId");
ACPAnalytics.getVisitorIdentifier().then(vid => console.log("AdobeExperienceSDK: Visitor identifier: " + vid));
ACPCore.trackAction("action", {"mytest": "action"});
ACPCore.trackState("state", {"mytest": "state"});
See CONTRIBUTING
See LICENSE