react-native-segment-sdk
v0.1.5
Published
The Analytics API you've always wanted. Now for React Native. Powered by Segment.
Downloads
5
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.