IdentityLink Setup

IdentityLink is a process by which Kochava users associate a specific customer identifier with a device within Kochava.

IdentityLink allows Kochava customers to manage their audience in unprecedented ways. By associating an internal customer identifier with a Kochava device ID, advertisers can correlate attribution and analytics information within Kochava to the customer behavioral data within internal or 3rd-party B.I. tools.

For example, when a user installs and launches your app, Kochava tracks their behavior and ties their device’s identifiers to a Kochava device ID. If you also have a record of the user’s device identifier within your system, you can associate an internal customer ID with a given Kochava device ID.

By leveraging IdentityLink you can unite and manage your audience and optimize your spend.

Joining User Identity to Devices

Kochava provides an API to support the linkage between a user device and their identity in your application. This feature is referred to as the IdentityLink in Kochava. Use the following API to accomplish this objective.


Send the following JSON as HTTP POST to the following URL endpoint:


Available Parameters:

URL Parameter Example Value Description Req.
kochava_app_id kogamerdna114e9bb34812587 This is the unique application ID used to represent the App. Yes
device_id idfa:A6334005-9019-46BB-9659-74FD0BD33585
An object of name-value pairs for identifiers of the device. Yes
data app_userid (“identity string”)
fb_userid (“identity string”)
Name-value pair object of data that can be sent upon the “identityLink” action. Yes



Last Modified: Feb 22, 2018 at 12:35 pm