Support Home > Campaign Management > Create a Kochava-Certified Postback

Create a Kochava-Certified Postback

Kochava-Certified Postbacks allow Free App Analytics users to send a real-time feed of installs and in-app events to a Kochava-Certified partner. The endpoints and parameters included in these postbacks are defined within the integration, and managed by Kochava in conjunction with each specific partner. The Kochava-Certified Postback is the easiest way to establish a postback and should be used as the default method.

NOTE: Within Free App Analytics, it is possible to create custom postbacks. For more information on creating a custom postback, refer to our Create a Custom Postback support document.

NOTE: Free App Analytics accounts will only have access to run campaigns with Self-Attributing Networks (for example, Google, Facebook, Twitter, Amazon, etc.). The full list of SANs you can run campaigns with will be included in the dropdown in your Kochava dashboard. You will need an upgraded account in order to run campaigns with non-SAN partners.

Create a New Postback Configuration

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


  1. Click Add a Configuration.
  2. Select Media Partner.
  3. Click Go.

    New Configuration

    A. Select a Network Partner

Edit Postback

  1. For an Install Event Postback, Click Install > Postback Tools () > Edit.
  2. For Post-Install Active Events, locate the desired event and Click Edit Postback.

    Edit Postback

    A. Click to edit Install Postback
    B. Locate the desired Event and Click Edit Postback.

    NOTE: The custom Postback settings are dependent on the network selected. For more information about the custom settings for specific networks, contact your Client Success Managers.

  4. Enter the Package Name (Android) or Bundle ID (iOS).

    ID Settings


    NOTE: The Package name is easily located in the URL of the app on the Google Play store. (id=com.packagename)

    NOTE: The Bundle ID must be obtained from the app developer, the app manager or the Apple Store. For more information, refer to our Locating the Apple Bundle ID support document.

  6. Select a Delivery Delay.
  7. NOTE: The Delivery Delay determines whether the postback is delivered in realtime or if there is an intentional delay before delivery.  Delivery Delay can be set from 30 seconds to up to 10 minutes.


    BEST PRACTICE: Selecting All will send all installs to the network, but will only include attribution information for installs attributed to that network. A common use case for delivering All is to enable the network to optimize targeting away from users who have already installed the app, even if that network did not drive the install.


    Delivery Delay

    A. Realtime to 10 Minute Delay

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


    Retry Attempts

    A. Do Not Retry to 10 Attempts

  10. Select the Delivery Method.
  11. NOTE: The Delivery Method determines whether the partner will receive all events/installs or only those for which they have won attribution.


    Delivery Method

    A. All or Network Only

  12. Click Save.

NOTE: Updates to Kochava-Certified Postback will automatically take affect for the currently-configured postbacks.

Network Specific Fields

Network Specific fields contain data that is required for postbacks to be properly sent to network partners based on the desired delivery settings. It is very important that the network specific fields be properly set up. For example, Facebook requires a Facebook App ID, specific event names, and a Kochava click tracker ID for proper attribution.

For more information about Network Specific Fields, contact a Free App Analytics Client Success Managers.


Network Specific Postback Settings

A. Facebook Use Terms must be reviewed and accepted.

Creating a Postback on a Standard SessionBegin SDK Event

The following details are associated with creating a SessionBegin Postback within Kochava:

  • Attribution will occur on a single session per device per calendar day (UTC).
  • If the SessionBegin Postback is configured and set to Network Only, a single Postback will be sent per device per calendar day UTC if the install was attributed to that network or if the device converted on a Reengagement tracker for that network.
  • If the SessionBegin Postback is configured and set to All, a single Postback will be sent per device per calendar day UTC regardless of attribution source, and will include Unattributed data.
  • For all Postback session data to be sent to an internal database or to an analytics platform, a custom App Open event must be used.


Last Modified: Aug 14, 2023 at 12:53 pm