The Kochava Flutter SDK is a lightweight plugin which can be easily integrated into your Flutter 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 10.3
Xcode 13.3.1

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 pub.dev (recommended) or by downloading the SDK files manually and adding them.

pub.dev Setup
Manual Setup

Add the Kochava Tracker plugin to your pubspec.yaml file. Replace “x.y.z” with the latest version obtained from the Download Badge above.

kochava_tracker: ^x.y.z

1

kochava_tracker: ^x.y.z
1. Download the kochava_tracker.zip from the Download Badge above.
2. Extract the zip file into the root directory of your project.
3. Add the Kochava Tracker plugin to your pubspec.yaml file.

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

v2
v1 (Legacy)

import 'package:kochava_tracker/kochava_tracker.dart';
KochavaTracker.instance.registerAndroidAppGuid("YOUR_ANDROID_APP_GUID");
KochavaTracker.instance.registerIosAppGuid("YOUR_IOS_APP_GUID");
KochavaTracker.instance.start();

import 'package:kochava_tracker/kochava_tracker.dart';

KochavaTracker.instance.registerAndroidAppGuid("YOUR_ANDROID_APP_GUID");

KochavaTracker.instance.registerIosAppGuid("YOUR_IOS_APP_GUID");

KochavaTracker.instance.start();

import 'package:kochava_tracker/kochava_tracker.dart';

var config = {
  KochavaTracker.PARAM_ANDROID_APP_GUID_STRING_KEY: 'YOUR_ANDROID_APP_GUID',
  KochavaTracker.PARAM_IOS_APP_GUID_STRING_KEY: 'YOUR_IOS_APP_GUID',
};
KochavaTracker.instance.configure(config);

import 'package:kochava_tracker/kochava_tracker.dart';

var config = {

KochavaTracker.PARAM_ANDROID_APP_GUID_STRING_KEY: 'YOUR_ANDROID_APP_GUID',

KochavaTracker.PARAM_IOS_APP_GUID_STRING_KEY: 'YOUR_IOS_APP_GUID',

};

KochavaTracker.instance.configure(config);

Confirm the Integration:

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.

Flutter – SDK Integration