Support Home > Campaign Management > Create a Web Conversion Tracking Campaign

Create a Web Conversion Tracking Campaign

Feature Summary: In order to track web conversions, the advertiser needs to leverage our ‘Acquisition’ Tracking URLs along with our Server to Server endpoint. This document defines the process for setting up a Web Conversion tracking campaign.

Create a Web Conversion Campaign

  1. Log in to Kochava.
  2. Select the desired Account and App.
  3. Select Links > Campaign Manager.


  1. Click Add a Tracker or Select Segment Tools () > Add a Tracker.
    1. Select the Campaign.
    2. Select the Segment.

    NOTE: In order to streamline the Campaign/Segment/Tracker creation process a feature has been added to allow the creation of campaigns and segments while creating a new tracker. For more information about creating a campaign or segment while adding a new tracker, refer to our Create an Install Campaign support document. support documentation.

    NOTE: Because device IDs are not available in web, it is required that the ad network replaces their device_id macro with a randomly generated session ID on the click.

  2. Enter a unique Tracker Name.

    BEST PRACTICES: It is recommended that each tracker be named after a specific network, this will enable the tracking of specific performance of each network.


  4. Select Tracker Type > Acquisition. (default setting)
  5. Select a Media Partner.
  6. NOTE: The Share With Publisher setting allows the associated publisher to view the settings for this Tracker. By unchecking this box, the associated publisher will not be able to view the settings for the Tracker.

  7. Select an Agency Partner. (optional)
  8. Enter or Update the Install Destination URL.
  9. NOTE: The Install URL will be automatically pulled from the Destination URL entered during app creation.

  10. Enter a Deep Link. (optional)
  11. Expand Custom Parameters and Click Add New Parameter
    1. Enter device_id to the Key field.
    2. Enter {device_id} to the Value field.

    NOTE: The network needs to either pass a device ID, or a randomly generated session value into the device_id field on the click. The value that is passed into the device_id field is the value that Kochava uses for attribution.

    NOTE: Adding the above code to the end of the Destination URL will allow the session variable that is generated on the click to be passed into the destination URL. The advertiser must then persist this into each subsequent page that the advertiser visits so that it is available to be passed to Kochava on conversion.

  12. Click Save (If no further Trackers need to be created).
  13. Click Save & Add Another Tracker (If additional Trackers need to be created).


Acquisition Tracker Settings
A. Campaign and Segment selection/creation section.
B. Add device_id and {device_id} to the Custom Parameter.

Passing Kochava the Conversion Event

In order to pass Kochava the conversion event, an ‘install’ action must be passed to the Server-to-Server endpoint. Within the JSON body of this call, the session variable that was generated on the click must be present as the device_id.


Sample Event Call:

	"data": {
		"usertime": 1441582077,
		"device_ua": "",
		"conversion_data": {
			"utm_campaign": "",
			"utm_medium": "",
			"utm_source": ""
		"origination_ip": "",
		"action": "install",
		"device_ids": {
			"udid": "",
			"mac": "",
			"idfa": "session_variable_here",
			"imei": "",
			"adid": "",
			"odin": "",
			"android_id": ""
	"kochava_app_id": "GUID_of_Kochava_App",
	"action": "install"


Last Modified: Oct 11, 2023 at 9:01 am