The Kochava Xamarin SDK is a lightweight plugin which can be easily integrated into your Android or iOS 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.

Our Xamarin SDK supports all Mono frameworks including MonoGame.
Please use our Windows SDK directly if targeting a windows platform.

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

Supported Platforms:

Android
iOS

Integration:

Estimated Time to Complete

5 Minutes

(Release Notes)

Add the SDK —

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

NuGet Setup
Manual Setup

1. Install the latest version of KochavaTrackerXamarin via NuGet.
2. KochavaTrackerXamarin should now appear within your project’s references.
After downloading the DLLs for both Android and iOS from the download badge above you can import them into your project as follows where you import the iOS DLL in your iOS project and the Android DLL in your Android project.
1. Right click the References folder in your project and click Edit References.
2. Select the .Net Assembly tab and click Browse.
3. Locate and select the KochavaXamarin DLL and import it.

Android Additional Integration Steps:

Google Play Services —

The Kochava SDK requires Google Play Services ads-identifier library. To add this to your project include the GooglePlayServices.Ads.Identifier NuGet package.

//Required: ADID collection as of API 31+

Google Install Referrer —

Download the Google Install Referrer Library and add it to your project as an AndroidAarLibrary.

Email Attribution —

If enabled in the Free App Analytics dashboard for your app, the Kochava SDK can retrieve email addresses on the device, for use in attribution. If you wish to enable this capability, you need to add the GET_ACCOUNTS permission in your Android manifest.

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. This would be in Application.onCreate for Android and in UIApplicationDelegate.FinishedLaunching for iOS, although this can be done elsewhere 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.

Kochava.Tracker.Configuration config = new Kochava.Tracker.Configuration();
config.AndroidAppGuid = "_YOUR_ANDROID_APP_GUID_";
config.IosAppGuid = "_YOUR_IOS_APP_GUID_";
Kochava.Tracker.Client.Configure(config);

Kochava.Tracker.Configuration config = new Kochava.Tracker.Configuration();

config.AndroidAppGuid = "_YOUR_ANDROID_APP_GUID_";

config.IosAppGuid = "_YOUR_IOS_APP_GUID_";

Kochava.Tracker.Client.Configure(config);

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 Free App Analytics. 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.

Xamarin – SDK Integration