react-native-segment-sdk
v0.1.5
Published
The Analytics API you've always wanted. Now for React Native. Powered by Segment.
Downloads
14
Maintainers
Readme
React Native Segment SDK
Updates the existing React Native Analytics project with support for Alias API.
Originally written by Tal Kain [email protected], Tony Xiao [email protected] and other contributors.
Based on Segment (https://segment.com) Analytics project. See iOS SDK and Android SDK.
iOS Installation
- Download and install the npm package by running
npm install --save react-native-segment-sdk
. - In your Podfile, add
pod "Analytics"
to your project. - Inside Xcode (make sure you've opened your
.xcworkspace
file), go to the project navigator and right clickLibraries
->Add Files to [your project's name]
. - Go to
node_modules/react-native-segment-sdk/ios
-> and addRNSegmentIOAnalytics.h
andRNSegmentIOAnalytics.m
to your project. - Make sure your project links to libAnalytics.a (The libraries should be listed under "Build Phases -> Link Binary With Libraries". Should happen automatically if you use cocoapods).
Android Installation
- Download and install the npm package by running
npm install --save react-native-segment-sdk
. - If using rnpm, run
rnpm link
. Otherwise add toandroid/app/src/main/java/com/<your-app-name>/MainActivity.java
:
import com.facebook.react.ReactPackage;
import com.smore.RNSegmentIOAnalytics.RNSegmentIOAnalyticsPackage; // <-- add this
...
return Arrays.<ReactPackage>asList(
new MainReactPackage(),
new RNSegmentIOAnalyticsPackage(), // <-- add this
...
);
Usage sample
import Analytics from 'react-native-segment-sdk'
const segmentIOWriteKey = "SEGMENT_IO_WRITE_KEY"
const flushEverySecondsCount = 1
Analytics.setup(segmentIOWriteKey, flushEverySecondsCount)
Analytics.identify("abc123", {"email":"[email protected]"})
Analytics.alias("abc123")
Analytics.track("Item Purchased", {"item":"Sword of Heracles", "revenue":2.95})
Analytics.screen("Photo Feed", {"Feed Type":"private"})
Analytics.flush()
Analytics.reset()
Documentation
https://segment.com/docs/libraries/ios/#getting-started https://segment.com/docs/libraries/android/#getting-started
Handling possible issues
Google SDK BitCode issue
ld: '......./Pods/GoogleIDFASupport/Libraries/libAdIdAccessLibrary.a(TAGActualAdIdAccess.o)' does not contain bitcode. You must rebuild it with bitcode enabled (Xcode setting ENABLE_BITCODE), obtain an updated library from the vendor, or disable bitcode for this target. for architecture arm64
There are instructions for fixing it here: https://stackoverflow.com/questions/31395260/google-analytics-libadidaccess-a-does-not-contain-bitcode
License
This project is released under the MIT License.