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.

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

• Connection Modes:

	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.

Recommended Properties

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.