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.

IMPORTANT NOTE: App Tracking Transparency (ATT) implementation is required for Free App Analytics. ONLY devices that have opted-in and have IDFA available will be measured and available in primary reporting and analytics.

Integrating the SDK

Requirements:

Android API 16
iOS Target 12.4
Xcode 14.1
ReactNative 0.60
Native Code support enabled

Supported Platforms:

Android
iOS

Data Privacy:

SDK Data Privacy and Safety

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.

NPM Setup
Manual Setup

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:

Android Additional Steps:

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.

v2
v1 (Legacy)

import { KochavaTracker } from 'react-native-kochava-tracker';

KochavaTracker.instance.registerAndroidAppGuid("YOUR_ANDROID_APP_GUID");
KochavaTracker.instance.registerIosAppGuid("YOUR_IOS_APP_GUID");
KochavaTracker.instance.start();

import { KochavaTracker } from 'react-native-kochava-tracker';

KochavaTracker.instance.registerAndroidAppGuid("YOUR_ANDROID_APP_GUID");

KochavaTracker.instance.registerIosAppGuid("YOUR_IOS_APP_GUID");

KochavaTracker.instance.start();

import KochavaTracker from 'react-native-kochava-tracker';

var configMapObject = {}
configMapObject[KochavaTracker.PARAM_ANDROID_APP_GUID_STRING_KEY] = "YOUR_ANDROID_APP_GUID";
configMapObject[KochavaTracker.PARAM_IOS_APP_GUID_STRING_KEY] = "YOUR_IOS_APP_GUID";
KochavaTracker.configure(configMapObject);

import KochavaTracker from 'react-native-kochava-tracker';

var configMapObject = {}

configMapObject[KochavaTracker.PARAM_ANDROID_APP_GUID_STRING_KEY] = "YOUR_ANDROID_APP_GUID";

configMapObject[KochavaTracker.PARAM_IOS_APP_GUID_STRING_KEY] = "YOUR_IOS_APP_GUID";

KochavaTracker.configure(configMapObject);

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.

ReactNative – SDK Integration