Support Home > SDK Integration > Cordova – SDK Integration

Cordova – SDK Integration


The Kochava Cordova SDK is a lightweight plugin which can be easily integrated into your Cordova 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 API 31+ (Android 12), 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 API 31 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 12.4

 

Supported Platforms:

  • Android
  • iOS

 

Data Privacy:


Migration:

If you are migrating from a Kochava SDK prior to version 3.0.0 to version 3.x first remove the old version by running the following command from the root of your project.

Once removed the new version can be integrated by following the integration steps below. SDK usage can then 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 you must first add it to your project.

  1. Download and unzip the Kochava Cordova SDK to a known location.
  2. Using a terminal navigate to the root directory of your Cordova Project.
  3. Run the following command where sdk_path is the location of the unzipped Kochava Cordova SDK from step 1.

Google Play Store:

If you wish for the SDK to collect the Google Play Ads Identifier (ADID), App Set ID (ASID) and/or make use of the Install Referrer, you must integrate Google Play Services by adding the appropriate dependencies. Collection is handled by the Kochava SDK with only the dependency itself needing to be included. The Kochava SDK does not require specific versions of its dependencies however we recommend keeping them up to date whenever possible.

 

Ads Identifier

NOTE: If using a version prior to version 17.1.0 you must also add the following permission.

 

Install Referrer

 

App Set ID


Huawei App Gallery:

If you wish for the SDK to collect the Huawei Advertising ID (OAID) and/or make use of the Install Referrer, you must integrate the Huawei Ads SDK by adding the appropriate dependencies. Collection is handled by the Kochava SDK with only the dependency itself needing to be included. The Kochava SDK does not require specific versions of its dependencies however we recommend keeping them up to date whenever possible.

 

Ads Identifier

 

Install Referrer


Network Data Gathering:

The following permissions are optional and used by the Network Datapoint module of the Kochava SDK. They are automatically included if using that module but can be removed if desired.


Minification (ProGuard / R8):

The following minification rules are required when code minification is enabled. They are automatically included when adding the Kochava SDK and typically do not require manual inclusion. If you are experiencing issues after enabling minification you can manually include the rules in your configuration file.


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 ensure it’s started before use, provide more accurate session reporting, and quicker deeplink results.

 


Confirm the Integration

After integrating the SDK and adding the code to start the tracker, launch and run the app for at least 10 seconds or more. During this time the tracker will start and send an install payload to Kochava. To confirm integration was successful, visit the app’s Install Feed Validation page Apps & Assets > Install Feed Validation. On this page you should see one of two integration messages, indicating integration success or failure.

 

Integration Successful:

 Integration Success!

 

Along with this message you will also see a variety of data points associated with the device used for testing. At this point your integration is successful and you can proceed to the next step(s).

NOTE: It may take a few minutes for the first install to appear within the Install Feed Validation page. If you do not see this message immediately, you may simply need to wait a few minutes and check again.


Integration Not Complete:

 Integration Not Complete!

 

If you encounter this message, please review the integration steps, uninstall and reinstall the app, and check again.

 
 

 

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.