> For the complete documentation index, see [llms.txt](https://documentation.freshpaint.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.freshpaint.io/integrations/destinations/mobile-measurement-partners-mmp/kochava-early-access/kochava-reference.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://documentation.freshpaint.io/integrations/destinations/mobile-measurement-partners-mmp/kochava-early-access/kochava-reference.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.