react-native-converted-in-sdk v1.1.0

react-native-converted-in-sdk

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

📹 Demo

iOS	Android

🛠️ Requirements

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

📦 Installation

Install the package using npm:

npm install react-native-converted-in-sdk

Or with yarn:

yarn add react-native-converted-in-sdk

Follow these steps to complete the installation:

iOS

• 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.

Android

• 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

🚀 Usage

Manual Module Usage

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
   };

Usage with Hook

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
   };

📚 API Reference

RNConvertInSDKProvider

useConvertedInSdk

Returns an object with the following methods:

Product Interface

🧪 Sample App

Check the example folder for a complete implementation example.

!NOTE If you encounter an error while installing pods in example/ios, please refer to this solution: https://stackoverflow.com/a/78874710/12355129

🛠️ Development

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

🧪 Testing

Run tests with:

yarn test

🚨 Error Handling

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.

🤝 Contributing

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

📚 Official Documentation

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

• Android Getting Started Guide
• iOS Getting Started Guide

📜 License

MIT