# Kochava Quick Start Guide {% hint style="warning" %} The Kochava destination is currently in Early Access. Please contact for more information about this integration. {% endhint %} ## Destination Info * Supports [Track](https://documentation.freshpaint.io/developer/freshpaint-sdk-reference#track) calls * Supports [HIPAA mode](https://documentation.freshpaint.io/hipaa-mode) * Refer to this destination as **Kochava** in the [Integrations object](https://documentation.freshpaint.io/reference/developer/freshpaint-sdk-reference#using-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-sideServer-side
Webfalsetrue
Mobilefalsetrue
Serverfalsetrue
## 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](https://console.kochava.com/#/advertisertools/appconfigurations/appsassets). 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](https://app.freshpaint.io/destinations/catalog). 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](https://app.freshpaint.io/event-verification) 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](https://console.kochava.com/#/advertisertools/appconfigurations/appsassets). 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](https://console.kochava.com/#/advertisertools/appconfigurations/appsassets).
#### 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://documentation.freshpaint.io/integrations/destinations/mobile-measurement-partners-mmp/kochava-early-access/kochava-quick-start-guide.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.