Support Home > Campaign Management > Create a Custom Postback

Create a Custom Postback

Feature Summary: 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.
  4.  

 

  1. Click Add a Configuration.
  2. 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.

  3. Under Custom Postback, Select the custom event created for this postback.
  4. Click Go.
  5.  

    Select Custom Event
    A. Select the Custom Event

     

  6. Set the event Status. (By default, this option is set to Active)
  7. Set Event Matching. (optional)
  8. 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.

  9. Update the event Title. (optional)
  10. Enter the Destination URL.
  11.  

    General Settings
    A. Match to another Custom Event (optional)

     

  12. Set the Supply Network Data to Analytics Partner. (optional)
  13. NOTE: Selecting “True” will send attribution-level data to the associated partner, while choosing “False” will not send the attribution-level data.

  14. Select a Delivery Delay.
  15. 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.

  16. Select Retry Attempts.
  17. 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.

     

    Advanced Settings

     

  18. Select Macro(s). (optional)
  19. NOTE: Any selected macros will be passed within the Destination URL.

    (see iOS 14+ restrictions)

     

    MacroFunction
    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.

     

  20. Click Save.

 
 

Last Modified: Jul 19, 2023 at 10:48 am