Integrating with Kochava

Introduction

When adding an app to TrafficGuard you will need to configure the mobile measurement platform (MMP) so TrafficGuard can send click data to the MMP and authorise the MMP to send us notifications for installs and events.


 

Prerequisites

You need to be a Kochava customer and have the Kochava SDK installed in your app.
You need to have Adding a new app have your app added on your TrafficGuard Portal.

 

TrafficGuard Portal

You will need the following values from TrafficGuard, to be added in your Kochava Portal:

If you have a dedicated Account Manager at TrafficGuard, you can jump straight to Kochava Portal section from here

  1. Property ID -  Unique identifier for every property (App/Website) that you add on TrafficGuard
  2. Organisation ID - ID of the organisation, one for every organisation.
  3. API Key - Unique Key, one for every organisation.

Property ID

  1. Open the TrafficGuard Portal
  2. If you are an Agency user, select the desired organisation.
  3. Go to Properties on the side navigation.
  4. Select your desired property > Settings
  5. Copy the Property ID 

Organisation ID & API Key

  1. Open the TrafficGuard Portal
  2. If you are an Agency user, select the desired organisation
  3. Go to Settings from the side navigation
  4. Copy the organisation ID & the Api key

Prepare your destination URL 

  1. Gather your property ID, org. ID and token, and insert it in the URL below 
https://integrate.trafficguard.ai/kochava/v1/postback?organisation_id=ORGANISATION_ID&api_key=API_KEY&property_id=PROPERTY_ID&event_name={event_name}&event_data={event_data}&event_value={event_value}&event_timestamp={event_timestamp}&device_ip={device_ip}&device_ua={device_ua}&idfa={idfa}&adid={adid}&android_id={android_id}&kochava_id={kochava_id}&network_name={network_name}&campaign_id={campaign_id}&campaign_name={campaign_name}&tracker_name={tracker_name}&tracker_id={tracker_id}&site_id={site_id}&creative_id={creative_id}&attribution_time={attribution_time}&app_limit_track={app_limit_track}&device_limit_track={device_limit_track}&matched_by={matched_by}&click_id={click_id}&city={city}&country={country}&device_ver={device_ver}&device_type={device_type}&hours_played={hours_played}&achievement_name={achievement_name}&sessions_played={sessions_played}&item_name={item_name}&item_quantity={item_quantity}&items_in_basket={items_in_basket}&item_added_from={item_added_from}&currency={currency}&duration={duration}&level_name={level_name}&level_number={level_number}&referral_from={referral_from}&cp_0={cp_0}&cp_1={cp_1}&cp_2={cp_2}&cp_3={cp_3}&click_timestamp={click_timestamp}&install_timestamp={install_timestamp}&bundle_id={bundle_id}&is_fraud={is_fraud}&invalid_traffic={invalid_traffic}&traffic_rule_traffic_value={traffic_rule}_{traffic_value}&app_version={app_version}&end=

 

Kochava portal

Create a Custom Postback for TrafficGuard in Kochava

  1. Log in to Kochava.
  2. Select the desired Account and App.
  3. Select Apps & Assets > Partner Configuration
  4. Click Add a Configuration.
  5. Under Custom Postback, Select the custom event created for this postback.
  6. Click Go
  7. Select the Custom Event (A)

     
    1. Set the event Status. (By default, this option is set to Active)
    2. Set Event Matching. (optional)
  8. Update the event Title to - TrafficGuard Install Postback

  9. Enter the Destination URL
    1. Paste the Custom Install Postback provided by TrafficGuard.
  10. Set the Supply Network Data to Analytics Partner = True (Mandatory) 
  11. Select a Delivery Delay = Real time delivery
  12. Select Retry Attempts = 3 Attempts
  13. Click Save 

Repeat the setup for every custom event per app 

 

Next steps

Once you enable an integration with Kochava, TrafficGuard will start receiving attribution data.
Next steps is to provide TrafficGuard URLs to your corresponding Partners.
Connect with your TrafficGuard Integration team at integrations@trafficguard.ai to complete the partner integration 

What data will I see in Kochava?

In terms of reporting, nothing will change in your Kochava dashboard. In your TrafficGuard dashboard, you will start seeing the data being populated.