react-native-skadnetwork

react-native-skadnetwork is a React Native module designed for use on the iOS platform. This module allows you to integrate SKAdNetwork features into your React Native projects seamlessly. It is fully compatible with third-party SDKs such as Firebase Analytics and Facebook Meta. The module is tailored for all iOS versions and currently supports a model with six events. Additionally, it supports SKAN 3 and SKAN 4 techniques for advanced tracking capabilities.

Note: SKAdNetwork only reports conversion values to SKAN services for apps downloaded from the App Store.

Features

• Seamless Integration: Easily integrate SKAdNetwork features into your React Native projects.
• Third-Party Compatibility: Fully compatible with third-party SDKs like Firebase Analytics and Facebook Meta.
• Comprehensive iOS Support: Designed specifically for all iOS versions.
• Event Model: Currently supports a model with six distinct events.
• Advanced Tracking: Supports SKAN 3 and SKAN 4 techniques for enhanced tracking and measurement.

Installation

Using Yarn

yarn add react-native-skadnetwork

Using NPM

npm install react-native-skadnetwork

Usage

iOS Integration

React Native automatically links the SKAdNetworkExtension module for you. If you encounter any issues with the module not being linked correctly, you can manually add it to your Podfile.

Manual Podfile Update (if needed)

Add the following line to your Podfile if the module is not linked automatically:

pod 'SKAdNetworkExtension', :path => '../node_modules/SKAdNetworkExtension'

cd ios
pod install

import { logEventSKAdNetwork } from 'react-native-skadnetwork';

const events = {
  SIGNUP: 0,
  LEVEL_1: 1,
  LEVEL_2: 2,
  AD_VIEW: 3,
  PURCHASE: 4,
  INSTALL: 5,
};

logEventSKAdNetwork(events.PURCHASE); // conversion value = 16 / byte value = 0, 0, 0, 0, 1, 0

// or send identification manually

logEventSKAdNetwork(0); // conversion value = 1 / byte value = 1, 0, 0, 0, 0, 0

Contributing

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

License

MIT

Project Explanation

Project Name: react-native-skadnetwork

Project Purpose: This project is developed to integrate SKAdNetwork features into React Native projects for the iOS platform. SKAdNetwork is Apple's technology for advertising tracking and measurement, and this module allows you to easily integrate these features into your React Native projects.

Technologies Used:

• React Native
• iOS (Objective-C/Swift)
• CocoaPods

Key Features:

• Seamless integration with SKAdNetwork features.
• Full compatibility with third-party SDKs such as Firebase Analytics and Facebook Meta.
• Tailored for all iOS versions.
• Currently supports six distinct events.

Key Files and Directories:

• src/: Contains the TypeScript code.
• ios/: Contains the iOS-specific code.
• example/: Example project demonstrating how to use the module.
• SKAdNetworkExtension.podspec: Podspec file containing the necessary settings for CocoaPods integration.

This documentation provides essential information about using and developing the project. If you need any additional information or assistance, please let me know!