Support Home > Server-to-Server Integration > Install Notification Setup

Install Notification Setup

The document describes the recommended approach to integrate with the Kochava system to track installations resulting from media efforts with publishers. The Kochava platform provides extensive tools to track downloads/installs of mobile apps and optimize the ad sources that are driving the quality installs at the right price using a publisher agnostic approach.

Working with publishers, Kochava has developed a turn-key approach to tracking campaign performance and segmenting the reporting by targets. This approach allows customers to view the conversion performance by segments defined in the campaign targeting rules.

We have made this offering available to you, the application developer, to minimize the level of effort to integrate API’s and SDK’s with your application when you want to optimize adoption and engagement with your apps, and to support ad-buy optimization.


Kochava SDK is Not Required

Because the Kochava system does not require an SDK, you can begin sending your data to Kochava without any client side udpates. Please contact your Kochava account manager for information on how to get your app provisioned for tracking.


About the Kochava System

Kochava provides an open integration layer to connect with major publishers and networks so you can maximize visibility into your promotional efforts. In addition, the Kochava system provides post-back support to 3rd party networks (where applicable) so you don’t have to add additional SDK’s into your app.


Install Tracking

To track the conversions of your media efforts, Kochava must receive a single API “ping” from your servers which correspond to a unique install or startup of your application. It’s important that the API call is made at a point where the user is launching the app for the first time to maximize visibility into conversions for your campaigns. If you are interested in tracking specific post-install actions, please use the post-install event notification system to track those events post-installation.

 

NOTE: Because Kochava works across various publishers; we support all possible identifiers for devices for the purpose of reconciliation. Please note the identifier for the devices in the server-to-server API calls using the device_id_type parameter. The default for Android will be android_id and the default for iOS will be IDFA.

 

NOTE: With the introduction of iOS6, Apple has provided two new identifiers for advertisers and advertising publishers. To maximize reconciliation approaches, please send both IDFA and IDFV in the server to server call.

 

  • Identifier for Advertiser: This is a common ID across all advertisers for a given app.
  • Identifier for Vendor: This is a common ID across all apps for a given vendor.

Install Event API

To send a usage event from your application, call the below Server to Server endpoint with a POST payload containing the following JSON elements.

http://control.kochava.com/track/json

 

JSON Property Description Req.
kochava_app_id This is the unique application ID used to represent the App. Yes
app_version A string representation of the application version number. No
device_ids This can be the IDFA, IMEI, Android ID, MAC address or a custom variant. You must submit at least one identifier within the device_id object, and may submit more than one. Yes
action Action associated to the API event. Yes
origination_ip The IP address of the device on install. Yes
device_ver A string representation of the device make, model and OS. The syntax is as follows: <device>-<os_name>-<os_version> where each value is separated by a hyphen. Examples include: “iPhone-iOS-3.3”, iPhone-iOS-5.0”, or “HTC_Increadible-Android-2.6” . OS’s include: “iPad”, “iPhone”,”Android”. Yes
device_ua A string representation of the device user agent as provided by the client. This string is useful in when campaigns require fingerprint attribution Yes
data Each event is a JSON object – see examples. Yes

 

Sample Install Event Calls:


Apple Search Install Event API

Sending information to the Kochava system is also possible when utilizing Apple Search Ads by adding additional information to the main payload. If not using Apple Search Ads, the below information may be disregarded.

http://control.kochava.com/track/json

Sample Event Calls:


Device Specific Instructions

The information below details how to send data from specific devices to Kochava through the server-to-server integration.
 

Device Sending a Usage Event Details
Roku Send GetDeviceUniqueId() as String within the UDID parameter of the S2S feed.

 
 

Last Modified: Apr 24, 2017 at 12:42 pm