Kochava Quick Start Guide

Send in-app events to Kochava via Freshpaint.

The Kochava destination is currently in Early Access. Please contact [email protected] for more information about this integration.

Destination Info

• Supports Track calls

• Supports HIPAA mode

• Refer to this destination as Kochava in the Integrations object

  • If you've configured multiple apps, you can choose a specific one by suffixing the Kochava App GUID, such as: Kochava::koapp-name-0000000. You can retrieve this value from the App Settings page for the Kochava app of interest.

• Connection Modes:

	Client-side	Server-side
Web
Mobile
Server

Getting Started

What You'll Need

1. Your Kochava App GUID

   1. To send events to multiple Kochava apps, you'll need to have multiple Freshpaint destinations. Each Freshpaint destination maps to one Kochava app.

2. Check with your Kochava account manager to see if the app has the authenticated events feature enabled. If it does, you'll need an API Key and an App Secret. Reach out to your Kochava account manager for these values.

3. Events in Freshpaint mapped to the appropriate destination (Kochava app)

Get your Kochava App GUID

1. In the Kochava console, navigate to App Configurations → Apps & Assets.

2. Click on the app you'd like to send events for.

3. In the settings you'll find the App GUID.

Configure the Kochava destination in Freshpaint

1. Navigate to the Freshpaint Destinations page.

2. Search for the Kochava destination.

3. Select Configure to paste your Kochava App GUID from the above steps.

4. Customers that use HIPAA mode should then configure the required and recommended properties. You can find all properties that the Freshpaint Kochava integration supports here.

5. If your Kochava destination is tied to an iOS Kochava app, you must enable the required iOS properties.

6. If your Kochava destination is tied to an Android Kochava app, you must enable the required Android properties.

7. Enable the Kochava integration.

Once you've followed the steps above you can start sending events to Kochava.

Setting up Events

Now that you've configured Freshpaint to connect to your Kochava app, you can send events to Kochava to track.

Install Events

Installs are a special type of conversion event and are tracked separately in Kochava. In order to track a conversion event, one of the two cases must be true:

1. The kochava_event_name recommended property is sent with the value of Application Installed. If the kochava_event_name property is passed and doesn't match Application Installed, the event will not be tracked as an install event. If the kochava_event_name property is not passed/allowed, then we move to option 2.

2. The event name must be Application Installed.

By default, the newest versions of the mobile SDKs capture the app installs and will track the install events with the name of Application Installed.

Conversion Events

All non-install events are sent to Kochava as conversion events.

Confirm and Validate Events

Confirm and Validate Events in Freshpaint

1. Navigate to your app and trigger an event that should be sent to Kochava.

2. Navigate to the Event Verification tool in Freshpaint.

3. Select Kochava and verify your event went through.

4. Verify the event is marked as OK or resolve any missing property issues.

Confirm and Validate Conversions in Kochava

To check whether Kochava is receiving your events:

1. Log in to your Kochava account.

2. Navigate to App Configurations → Apps & Assets.

3. Click on the Events tab. You should see the events listed that have been passed. It can take a couple minutes for the events to show in this list.

Or

1. Log in to your Kochava account.

2. Navigate to Analytics → Dashboards.

Troubleshooting Events

By default, Kochava's API responds with 200. If your Kochava app uses authenticated events, but the API Key or Secret are incorrect, you will get 200 response codes. Kochava will silently drop these events. When using authenticated events, ensure that your events are being created in Kochava. If they are, your API Key and Secret are working as expected.