1. Home
  2. Marketers
  3. Campaign Management
  4. Create a Custom Postback
  1. Home
  2. Marketers
  3. Create a Custom Postback
Searching...

Create a Custom Postback

Contents

This feature is available only with paid Kochava accounts. Contact us to learn more.

Custom postbacks allow marketers to send a real-time feed of data captured by Kochava to a specific endpoint. This is particularly useful if your team has internal tools/endpoints that are built to analyze/store data for your apps.

NOTE: Within Kochava, it is possible to create Kochava-Certified Postbacks. For more information, refer to our Kochava-Certified Postbacks support document.

Use Cases for Custom Postbacks:

A Custom Postback enables Kochava users to perform tasks such as:

  • Post a real-time feed of install and post-install events to an endpoint (e.g., data warehouse)
  • Customize which parameters are sent on postback
  • Create postbacks on demand

Create a Postback

  1. Log in to Kochava.
  2. Select the desired Account and App.
  3. Select Apps & Assets > Partner Configuration.

Feature Note: To add this menu item to your Favorites Menu, select the “+” sign that appears when you hover over the menu. The Features Menu provides quick access to your most frequently visited areas of the Kochava UI.

  1. Click + Add a Configuration.

NOTE: In the next step, a custom event will be selected. If a custom event has not already been created, refer to our Post-Install Event Creation support documentation before preceding.

  1. Under Custom Postback, Select the custom event created for this postback.
  2. Click Save.
  1. Set the event Status. (By default, this option is set to Active)
  2. Set Event Matching. (optional)

NOTE: The Event Matching field allows the event to be modified to another custom event. This field only needs to be modified if the event that was initially selected is no longer the event that is needed.

  1. Update the event Title. (optional)
  2. Enter the Destination URL.

A. Select the Custom Event

A. Select the Custom Event

  1. Set the Supply Network Data to Analytics Partner. (optional)

NOTE: Selecting “True” will send attribution-level data to the associated partner, while choosing “False” will not send the attribution-level data.

  1. Select a Delivery Delay.

NOTE: The Delivery Delay determines whether the postback is delivered in real time or if there is an intentional delay before delivery. The Delivery Delay can be set from real-time delivery up to 10 minutes.

  1. Select Retry Attempts.

NOTE: The Retry Attempts determines the number of times Kochava will attempt to redeliver an event postback upon posting failure. Retry Attempts can be set from Do Not Retry to up to 10 attempts.

  1. Select Macro(s). (optional)

NOTE: Any selected macros will be passed within the Destination URL.
(see iOS 14+ restrictions)

Macro Function
Install
Event
{event_name} Name set for registered event, will be “_install” for installs. ✔ ✔
{event_data} Numerical data provided with event (if present). ✔
{event_value} Numerical data provided with event (if present). ✔
{event_timestamp} Datetime of event. ✔ ✔
{device_ip} IP address of device on which event was performed. ✔ ✔
{device_ua} User Agent of the device on which the event was performed. ✔ ✔
{idfa} IDFA of the device on which the event was performed. ✔ ✔
{adid} ADID of the device on which the event was performed. ✔ ✔
{android_id} Android ID of the device on which the event was performed. ✔ ✔
{kochava_id} Kochava Device ID of the device on which the event was performed. ✔ ✔
{network_name} Name of the network responsible for the event conversion. ✔ ✔
{campaign_id} ID of the campaign responsible for the event conversion. ✔ ✔
{campaign_name} Name of the campaign responsible for the event conversion. ✔ ✔
{tracker_name} Name of the Kochava tracker responsible for the event conversion. ✔ ✔
{tracker_id} ID of the Kochava tracker responsible for the event conversion. ✔ ✔
{site_id} Value received in site_id field, as received on the click. ✔ ✔
{creative_id} Value received in creative_id field, as received on the click. ✔ ✔
{attribution_time} Time that the attribution occurred. ✔ ✔
{app_limit_track} The limit_tracking flag, as set by the developer within the app. ✔ ✔
{device_limit_track} The limit_tracking flag as set by the user within the OS of their device. ✔ ✔
{matched_by} Type of device identifier by which the event was attributed. ✔ ✔
{click_id} ID of the click within Kochava. ✔ ✔
{city} The city in which the event occurred. ✔ ✔
{country} The ISO 3166-1 country code from which the event occurred. ✔ ✔
{device_ver} The version number of the device. ✔ ✔
{device_type} The type of device that triggered the event. ✔ ✔
{hours_played} Optional event attribute key. ✔
{achievement_name} Optional event attribute key. ✔
{sessions_played} Optional event attribute key. ✔
{item_name} Optional event attribute key. ✔
{item_quantity} Optional event attribute key. ✔
{items_in_basket} Optional event attribute key. ✔
{item_added_from} Optional event attribute key. ✔
{currency} Optional event attribute key. ✔
{duration} Optional event attribute key. ✔
{level_name} Optional event attribute key. ✔
{level_number} Optional event attribute key. ✔
{referral_from} Optional event attribute key. ✔
{cp_0} Optional attribute key. ✔ ✔
{cp_1} Optional attribute key. ✔ ✔
{cp_2} Optional attribute key. ✔ ✔
{cp_3} Optional attribute key. ✔ ✔
{cp_4} Optional attribute key. ✔ ✔
{cp_5} Optional attribute key. ✔ ✔
{cp_6} Optional attribute key. ✔ ✔
{cp_7} Optional attribute key. ✔ ✔
{cp_8} Optional attribute key. ✔ ✔
{cp_9} Optional attribute key. ✔ ✔
  1. Click Save.
Updated on January 21, 2025

Was this article helpful?

Yes No