# Kochava Reference

This is a reference document for the Kochava destination. For information on how to set up this integration, see the [Kochava Quick Start Guide.](/integrations/destinations/mobile-measurement-partners-mmp/kochava-early-access/kochava-quick-start-guide.md)

{% hint style="warning" %}
The Kochava destination is currently in Early Access. Please contact <support@freshpaint.io> for more information about this integration.
{% endhint %}

## Destination Info

* Supports [Track](/reference/developer/freshpaint-sdk-reference.md#track) calls
* Supports [HIPAA mode](/readme/hipaa-mode.md)
* Connection Modes:

<table><thead><tr><th width="200.33333333333331" align="right"> </th><th data-type="checkbox">Client-side</th><th data-type="checkbox">Server-side</th></tr></thead><tbody><tr><td align="right">Web</td><td>false</td><td>true</td></tr><tr><td align="right">Mobile</td><td>false</td><td>true</td></tr><tr><td align="right">Server</td><td>false</td><td>true</td></tr></tbody></table>

This is a reference document for the Kochava destination. For information on how to set up this integration, see the [Kochava Quick Start Guide](/integrations/destinations/mobile-measurement-partners-mmp/kochava-early-access/kochava-quick-start-guide.md).

### Events

#### Required Properties

| Freshpaint Property     | Kochava Parameter   | Type   | Requirement | Description                                                                                      |
| ----------------------- | ------------------- | ------ | ----------- | ------------------------------------------------------------------------------------------------ |
| `$ip`                   | `originating_ip`    | string | Required    | IP address of the user who performed the action. Events are dropped if this property is missing. |
| `$user_agent`           | `device_ua`         | string | Required    | User agent of the device which performed the action.                                             |
| `$persistent_device_id` | `kochava_device_id` | string | Required    | A stable mobile device identifier.                                                               |

#### Required iOS Properties

<table><thead><tr><th>Freshpaint Property</th><th>Kochava Parameter</th><th>Type</th><th>Requirement</th><th width="155.2265625">Description</th></tr></thead><tbody><tr><td><code>$idfa</code></td><td><code>device_ids.idfa</code></td><td>string</td><td>Required when tracking iOS devices</td><td>Apple's Identifier for Advertisers. This will only be present when users have granted consent to the App Tracking Transparency (ATT) framework.</td></tr><tr><td><code>$idfv</code></td><td><code>device_ids.idfv</code></td><td>string</td><td>Required when tracking iOS devices</td><td>Apple's Identifier for Vendors.</td></tr><tr><td><code>$att_status</code></td><td><code>att.status</code></td><td>string</td><td>Required when tracking iOS devices</td><td>The App Tracking Transparency status for iOS 14+ events.</td></tr></tbody></table>

#### Required Android Properties

<table><thead><tr><th>Freshpaint Property</th><th>Kochava Parameter</th><th>Type</th><th width="145.21875">Requirement</th><th width="161.44921875">Description</th></tr></thead><tbody><tr><td><code>$gaid</code></td><td><code>device_ids.ad_id</code></td><td>string</td><td>Required when tracking Android devices</td><td>The Google Advertising ID.</td></tr><tr><td><code>$android_id</code></td><td><code>device_ids.android_id</code></td><td>string</td><td>Required when tracking Android devices</td><td>The android_id is a more permanent device identifier for Android devices.</td></tr></tbody></table>

#### Recommended Properties

<table><thead><tr><th>Freshpaint Property</th><th>Kochava Parameter</th><th>Type</th><th width="145.21875">Requirement</th><th width="161.44921875">Description</th></tr></thead><tbody><tr><td><code>kochava_event_name</code></td><td><code>event_name</code></td><td>string</td><td>Recommended</td><td>Determines whether the event will be sent as an install or conversion event. If sent as a conversion event, this </td></tr><tr><td><code>$app_version</code></td><td><code>app_version</code></td><td>string</td><td>Recommended</td><td>The app version associated with the mobile event.</td></tr><tr><td><code>$os</code></td><td><code>device_ver</code></td><td>string</td><td>Recommended</td><td>The OS name of the device (e.g. "iOS" or "Android"). Combined with <code>$device_model</code> and <code>$device_version</code> to build the Kochava <code>device_ver</code> string when the device user agent is unavailable.</td></tr><tr><td><code>$device_model</code></td><td><code>device_ver</code></td><td>string</td><td>Recommended</td><td>The device model (e.g. "iPhone" or "SM-J727A"). Combined with <code>$os</code> and <code>$device_version</code> to build the Kochava <code>device_ver</code> string when the device user agent is unavailable.</td></tr><tr><td><code>$device_version</code></td><td><code>device_ver</code></td><td>string</td><td>Recommended</td><td>The OS version of the device (e.g. "13.6.0"). Combined with <code>$device_model</code> and <code>$os</code> to build the Kochava <code>device_ver</code> string when the device user agent is unavailable.</td></tr></tbody></table>


---

# 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-reference.md?ask=<question>
```

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.