A React Native SDK for ConvertedIn, providing easy integration of ConvertedIn's tracking and analytics features into your React Native application.

iOS	Android

• iOS 13.0 or higher
• Android 5.0 (API level 21) or higher

Install the package using npm:

npm install react-native-converted-in-sdk

Or with yarn:

yarn add react-native-converted-in-sdk

• Add ConvertedinMobileSDK to your Podfile:

  pod 'react-native-converted-in-sdk', :path => '../node_modules/react-native-converted-in-sdk'

• Run pod install inside the ios directory.

• Add the following line to the android/settings.gradle file:

  include ':react-native-converted-in-sdk' project(':react-native-converted-in-sdk').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-converted-in-sdk/android')

• Add the following line to the android/app/build.gradle file:

  implementation project(':react-native-converted-in-sdk')

• Sync your project with Gradle files by running:

  ./gradlew sync

1. Import the module and initialize it in the root of your app:

   import { initializeSDK } from 'react-native-converted-in-sdk'; initializeSDK({ pixelId: 'your_pixel_id', storeUrl: 'your_store_url', });

2. Use the SDK methods in your components:

   import { identifyUser } from 'react-native-converted-in-sdk'; const Component = () => { React.useEffect(() => { // Example usage of SDK functions identifyUser("test@test.com", "+91", "9876543210"); }, []); // Your component logic here };

1. Wrap your app with RNConvertInSDKProvider:

   export default function App() { return ( <RNConvertInSDKProvider pixelId="your_pixel_id" storeUrl="your_store_url" > <AppContent /> </RNConvertInSDKProvider> ); }

2. Use the useConvertedInSdk hook in your components:

   import { useConvertedInSdk } from 'react-native-converted-in-sdk'; const Component = () => { const { identifyUser } = useConvertedInSdk(); React.useEffect(() => { // Example usage of SDK functions identifyUser("test@test.com", "+91", "9876543210"); }, []); // Your component logic here };

Returns an object with the following methods:

Check the example folder for a complete implementation example.

To develop the SDK locally:

1. Clone the repository.

2. Ensure you have the following environment set up:

   • Node.js version 18 or higher.
   • Yarn version 3 or higher (project version: 3.6.1).
   • Java 17 or higher.
   • For iOS development: Xcode 12.0 or higher. iOS deployment target 13.0 or higher.
   • For Android development: Android Studio 4.0 or higher.

3. Install dependencies:

   yarn install

4. Run the example app:

   • iOS:

     cd example/ios && pod install && cd ../.. yarn example ios

   • Android:

     yarn example android

Run tests with:

yarn test

If any SDK method is called before initialization, an error will be thrown with the message:

SDK must be initialized before calling this method.

Make sure to initialize the SDK using the initializeSDK method before invoking any other SDK methods.

See the contributing guide to learn how to contribute to the repository and the development workflow.

For detailed information and advanced usage, refer to the official ConvertedIn SDK documentation:

• Android Getting Started Guide
• iOS Getting Started Guide

MIT