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.

Destination Info

Client-side
Server-side

Web

Mobile

Server

This is a reference document for the Kochava destination. For information on how to set up this integration, see the Kochava Quick Start Guide.

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

Freshpaint Property
Kochava Parameter
Type
Requirement
Description

$idfa

device_ids.idfa

string

Required when tracking iOS devices

Apple's Identifier for Advertisers. This will only be present when users have granted consent to the App Tracking Transparency (ATT) framework.

$idfv

device_ids.idfv

string

Required when tracking iOS devices

Apple's Identifier for Vendors.

$att_status

att.status

string

Required when tracking iOS devices

The App Tracking Transparency status for iOS 14+ events.

Required Android Properties

Freshpaint Property
Kochava Parameter
Type
Requirement
Description

$gaid

device_ids.ad_id

string

Required when tracking Android devices

The Google Advertising ID.

$android_id

device_ids.android_id

string

Required when tracking Android devices

The android_id is a more permanent device identifier for Android devices.

Freshpaint Property
Kochava Parameter
Type
Requirement
Description

kochava_event_name

event_name

string

Recommended

Determines whether the event will be sent as an install or conversion event. If sent as a conversion event, this

$app_version

app_version

string

Recommended

The app version associated with the mobile event.

$os

device_ver

string

Recommended

The OS name of the device (e.g. "iOS" or "Android"). Combined with $device_model and $device_version to build the Kochava device_ver string when the device user agent is unavailable.

$device_model

device_ver

string

Recommended

The device model (e.g. "iPhone" or "SM-J727A"). Combined with $os and $device_version to build the Kochava device_ver string when the device user agent is unavailable.

$device_version

device_ver

string

Recommended

The OS version of the device (e.g. "13.6.0"). Combined with $device_model and $os to build the Kochava device_ver string when the device user agent is unavailable.

Last updated

Was this helpful?