Support Home > SDK Integration > ReactNative – SDK Integration

ReactNative – SDK Integration

The Kochava ReactNative SDK is a lightweight plugin which can be easily integrated into your ReactNative project. The entire integration process takes less than five minutes and simply requires adding the SDK within your project and then starting the Kochava Tracker in code. If you have already integrated the SDK and started the tracker, please visit Using the SDK and choose a topic.

 

Integration Note: If targeting Android 13, collection of the ADID requires the normal permission:
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/> Please ensure this permission is added to your AndroidManifest.xml in order for ADID collection to continue to take place as of Android 13 and beyond.
Some Google Play policies, such as the Families Policy, require that apps not use the ADID. In those cases this permission should not be included as the ADID should not be collected.


Integrating the SDK

Requirements:

  • Android API 16
  • iOS Target 10.3
  • Xcode 13.3.1
  • ReactNative 0.60
  • Native Code support enabled

 

Supported Platforms:

  • Android
  • iOS

 

Data Privacy:


 

Migration:

If you are migrating from a Kochava SDK prior to version 2.0.0 to version 2.x usage can be updated by reviewing the code samples for any given topic, as the overall usage of the SDK remains the same.


Integration:

Estimated Time to Complete
5 Minutes

(Release Notes)

In order to use the Kochava SDK, first add it within your project. This can be accomplished using npm (recommended) or by downloading the SDK files manually and adding them.

    1. Using a terminal navigate to the root directory of your ReactNative Project.
    2. Run the following commands:
  • Download the latest version from the Download Badge above to the root directory of your ReactNative Project.

    1. Using a terminal navigate to the root directory of your ReactNative Project.
    2. Run the following commands:

Starting the Tracker

Estimated Time to Complete
1 Minute

Once you have added the Kochava SDK to your project, the next step is to configure and start the Kochava Tracker in code. Only your App GUID is required to start the tracker with the default settings, which is the case for typical integrations.

We recommend starting the tracker as soon as the application starts, although this can be done later if needed. Starting the tracker as early as possible will provide more accurate session reporting and help to ensure the tracker has been started before using it. Keep in mind the tracker can only be configured and started once per launch.


Confirm the Integration

 

SDK WAYPOINT: At this point basic integration is complete and the Kochava SDK will begin reporting session activity and attributing installs.

 

Where to Go From Here:

Now that you have completed integration you are ready to utilize the many features offered by the Kochava SDK. Continue on to Using the SDK and choose a topic.

 
 
Last Modified: Jul 26, 2022 at 1:33 pm