Support Home > Analytics, Reports & API > Premium Publisher API Campaign Management

Premium Publisher API Campaign Management

The Kochava platform provides extensive tools to track everything from impressions through post-install events for connected devices. The Campaign Management API Integration provides the programmatic tools to create and maintain campaigns, segments and trackers.

Get Campaigns List

This API provides the ability to retrieve the entire list of campaigns from the numerical App ID provided in the URL.

 

Parameters Description Format
app_id App_id that the campaign is associated with.

Example: 123

 String
stats Whether to include number_of_trackers and number_of_tiers.

Example: true

 Boolean

 

Sample Request:

GET: https://campaign.api.kochava.com/campaign/{app_id}?stats={stats}
Authentication Key: {MyUserAPIKey}

 

Sample Response:

[
  {
    "id": "11133239913",
    "app_id": "11193",
    "type": "type_url_forward",
    "source": "v1up",
    "name": "censoring test",
    "destination_url": "http://google.com",
    "date_created": 1476912340,
    "date_start": 0,
    "date_end": 0,
    "date_track_outside_range": false,
    "budget_daily": 0,
    "budget_weekly": 0,
    "budget_max": 0,
    "target_clicks": 0,
    "target_installs": 0,
    "meta": "",
    "legacy_io_guid": "",
    "smart_link_id": "",
    "what_if_parent_campaign_id": ""
  },
  {
    "id": "11133165431",
    "app_id": "11193",
    "type": "type_url_forward",
    "source": "web",
    "name": "Facebook 02.16.2016",
    "destination_url": "",
    "date_created": 1455565374,
    "date_start": 0,
    "date_end": 0,
    "date_track_outside_range": true,
    "budget_daily": 0,
    "budget_weekly": 0,
    "budget_max": 0,
    "target_clicks": 0,
    "target_installs": 0,
    "meta": "",
    "legacy_io_guid": "",
    "smart_link_id": "72",
    "what_if_parent_campaign_id": ""
  },
  {
    "id": "11133223385",
    "app_id": "11193",
    "type": "type_url_forward",
    "source": "web",
    "name": "new sl",
    "destination_url": "",
    "date_created": 1469462822,
    "date_start": 0,
    "date_end": 0,
    "date_track_outside_range": true,
    "budget_daily": 0,
    "budget_weekly": 0,
    "budget_max": 0,
    "target_clicks": 0,
    "target_installs": 0,
    "meta": "",
    "legacy_io_guid": "",
    "smart_link_id": "1119",
    "what_if_parent_campaign_id": ""
  },
  {
    "id": "11133187461",
    "app_id": "11193",
    "type": "type_url_forward",
    "source": "v1up",
    "name": "Re-Direct Test \"",
    "destination_url": "http://",
    "date_created": 1456273410,
    "date_start": 0,
    "date_end": 0,
    "date_track_outside_range": false,
    "budget_daily": 0,
    "budget_weekly": 0,
    "budget_max": 0,
    "target_clicks": 0,
    "target_installs": 0,
    "meta": "",
    "legacy_io_guid": "",
    "smart_link_id": "",
    "what_if_parent_campaign_id": ""
  }
]

Create a Campaign

This API is used to create a new campaign by providing a JSON definition of the campaign.

 

Parameters Description Format
app_id App_id that the campaign is associated with.

Example: 123

 String

 

Sample Request:

Post: https://campaign.api.kochava.com/campaign/{app_id}
Authentication-Key: {MyUserAPIKey}
Body:{
  "name": "this campaign",
  "date_end": 1490727343,
  "date_start": 1490727343,
  "destination_url": "http://",
  "source": "api"
}

 

Sample Response:

{
  "id": "2",
  "app_id": "14393",
  "type": "type_url_forward",
  "source": "api",
  "name": "this campaign",
  "destination_url": "http://",
  "date_created": 1493327428,
  "date_start": 1490727343,
  "date_end": 1490727343,
  "date_track_outside_range": false,
  "budget_daily": 0,
  "budget_weekly": 0,
  "budget_max": 0,
  "target_clicks": 0,
  "target_installs": 0,
  "meta": "",
  "legacy_io_guid": "",
  "smart_link_id": null,
  "what_if_parent_campaign_id": null
}

Update a Campaign

This API is used to update an existing campaign by providing a JSON definition of the campaign with the modifications. If the campaign is successfully updated an HTTP 200 code and response, as shown below, is returned.

 

Parameters Description Format
app_id App_id that the campaign is associated with.

Example: 123

 String

 

Sample Request:

Post: https://campaign.api.kochava.com/campaign/{app_id}
Authentication-Key: {MyUserAPIKey}
Body:{
  "id": "2",
  "name": "new campaign name"
}

 

Sample Response:

{
  "id": "2",
  "app_id": "14393",
  "type": "type_url_forward",
  "source": "api",
  "name": "new campaign name",
  "destination_url": "http://",
  "date_created": 1493327428,
  "date_start": 1490727343,
  "date_end": 1490727343,
  "date_track_outside_range": false,
  "budget_daily": 0,
  "budget_weekly": 0,
  "budget_max": 0,
  "target_clicks": 0,
  "target_installs": 0,
  "meta": "",
  "legacy_io_guid": "",
  "smart_link_id": null,
  "what_if_parent_campaign_id": null
}

Get Campaign by ID

This API provides the ability to retrieve a single campaign for the numerical Campaign ID provided in the URL.

 

Parameters Description Format
app_id App_id that the campaign is associated with.

Example: 123

 String
campaign_id The campaign associated with this campaign_id are returned.

Example: 123

 Boolean

 

Sample Request:

Get: https://campaign.api.kochava.com/campaign/{app_id}/{campaign_id}
Authentication-Key: {MyUserAPIKey}

 

Sample Response:

{
  "id": "2",
  "app_id": "14393",
  "type": "type_url_forward",
  "source": "api",
  "name": "new campaign name",
  "destination_url": "http://",
  "date_created": 1493327428,
  "date_start": 1490727343,
  "date_end": 1490727343,
  "date_track_outside_range": false,
  "budget_daily": 0,
  "budget_weekly": 0,
  "budget_max": 0,
  "target_clicks": 0,
  "target_installs": 0,
  "meta": "",
  "legacy_io_guid": "",
  "smart_link_id": null,
  "what_if_parent_campaign_id": null
}

Get Segments

This API provides the ability to retrieve the segments for the numerical Campaign ID provided in the URL.

 

Parameters Description Format
campaign_id Segments associated with this campaign_id are returned.

Example: 123

 String

 

Sample Request:

Get: https://campaign.api.kochava.com/tier/{campaign_id}
Authentication-Key: {MyUserAPIKey}

 

Sample Response:

[
  {
    "id": "13033251866",
    "app_id": "14393",
    "campaign_id": "13033239913",
    "source": "web",
    "name": "Default Segment",
    "target_geo": "",
    "date_created": 1476912355,
    "what_if_parent_tier_id": ""
  }
]

Create a Segment

This API is used to create a new segment by providing a JSON definition of the segment.

 

Parameters Description Format
campaign_id Segment will be created within the designated campaign_id.

Example: 123

 String

 

Sample Request:

Post: https://campaign.api.kochava.com/tier/{campaign_id}
Authentication-Key: {MyUserAPIKey}
Body:{
  "name": "new tier",
  "source": "web"
}

 

Sample Response:

{
  "id": "2",
  "app_id": "14393",
  "campaign_id": "1",
  "source": "web",
  "name": "new tier",
  "target_geo": "",
  "date_created": 1493328053,
  "what_if_parent_tier_id": null
}

Update a Segment

This API is used to update an existing segment by providing a JSON definition of the segment with the modifications. If the segment is successfully updated an HTTP 200 code and response, as shown below, is returned.

 

Parameters Description Format
campaign_id Segment will be updated within the designated campaign_id.

Example: 123

 String

 

Sample Request:

Post: https://campaign.api.kochava.com/tier/{campaign_id}
Authentication-Key: {MyUserAPIKey}
Body:{
    "id": "2"
    "name":"new name"
}

 

Sample Response:

{
  "id": "2",
  "app_id": "14393",
  "campaign_id": "1",
  "source": "web",
  "name": "new name",
  "target_geo": "",
  "date_created": 1493328053,
  "what_if_parent_tier_id": null
}

Get Segment by ID

This API provides the ability to retrieve a single segment for the numerical Segment ID provided in the URL.

 

Parameters Description Format
campaign_id Designated campaign which contains the desired segment.

Example: 123

 String
tier_id Segment will be returned with the designated tier_id.

Example: 123

 String

 

Sample Request:

Get: https://campaign.api.kochava.com/tier/{campaign_id}/{tier_id}
Authentication-Key: {MyUserAPIKey}

 

Sample Response:

{
  "id": "2",
  "app_id": "14393",
  "campaign_id": "1",
  "source": "web",
  "name": "new name",
  "target_geo": "",
  "date_created": 1493328053,
  "what_if_parent_tier_id": null
}

Get Trackers

This API provides the ability to retrieve the entire list of trackers for the numerical App ID provided in the URL.

 

Parameters Description Format
app_id App_id that the trackers are associated with.

Example: 123

 String
tracker_ids Comma separated list of trackers to return.

Example: 123,456

 String
editable whether to just include non-SAN, non-Smartlink trackers.

Example: true

 Boolean
network_name Include only results from this network.

Example: Applovin - iOS

 String
campaign_name Include only results from this campaign.

Example: Demo Campaign

 String
tier_name Include only results from this tier.

Example: Default Tier

 String
network_pricing Include only results with this price type.

Example: cpi

 String
type Include only results of this type.

Example: type_url_forward

 String
network_name_not Exclude results from this.

Example: Applovin - iOS

 String
campaign_name_not Exclude results from this campaign.

Example: Demo Campaign

 String
tier_name_not Exclude results from this tier.

Example: Default Tier

 String
network_pricing_not Exclude results with this price type.

Example: cpc

 String
type_not Exclude results with this type.

Example: type_url_forward

 String
traffic_verification Include or exclude trackers with traffic verification rules.

Example: true

 String
tracker_overrides Include or exclude trackers with override rules.

Example: true

 String
campaign_ids Include these campaign ids in the results.

Example: 1,2

 String
tier_ids Include these tier ids in the results.

Example: 1,2

 

Sample Request:

Get: https://campaign.api.kochava.com/tracker/{app_id}?ids={tracker_ids}&editable={editable}&network_name={network_name}&network_name_not={network_name_not}&campaign_name={campaign_name}&campaign_name_not={campaign_name_not}&tier_name={tier_name}&tier_name_not={tier_name_not}&network_pricing={network_pricing}&network_pricing_not={network_pricing_not}&type={type}&type_not={type_not}&traffic_verification={traffic_verification}&tracker_overrides={tracker_overrides}
Authentication-Key: {MyUserAPIKey}
Accept-Encoding: application/json (application/gzip)

 

Sample Response:

[
  {
    "id": "13033249379",
    "tier_id": "13033170351",
    "campaign_id": "13033165431",
    "app_id": "14393",
    "date_created": "2016-07-25T09:08:01-07:00",
    "source": "web",
    "guid": "kojoseph-android56a2a4e6b9e6f6fef310549fc3",
    "name": "GooglePlay",
    "type": "type_url_forward",
    "click_tracking_url": "https://control.kochava.com/v1/cpi/click?campaign_id=kojoseph-android56a2a4e6b9e6f6fef310549fc3&network_id=3881&site_id=none&device_id=device_id",
    "imp_tracking_url": "https://imp.control.kochava.com/track/impression?campaign_id=kojoseph-android56a2a4e6b9e6f6fef310549fc3&network_id=3881&site_id=none&device_id=device_id",
    "destination_url": "https://play.google.com/store/apps/details?id=uk.co.hellogames.jdtouch",
    "destination_url_reengagement": "",
    "network_id": "3881",
    "network_pricing": "cpc",
    "network_price": "0.00",
    "budget_daily": "0.00",
    "budget_weekly": "0.00",
    "budget_max": "0.00",
    "rtb_id": "",
    "rtb_definitions": "{}",
    "meta": "",
    "legacy_campaign_id": "6fef310549fc3",
    "legacy_post_id": "30",
    "perm_publisher_allow_view": "1",
    "is_active": "1",
    "creative_ids": [],
    "click_url_custom_params": [],
    "destination_data": {},
    "rtb_update_status": "",
    "rtb_update_response": null,
    "rtb_update_pid": null,
    "s2s_destination": null,
    "postback_url": null,
    "verification_rules": null,
    "smart_link_id": null,
    "what_if_parent_tracker_id": null,
    "network_name": "SmartLinks",
    "network_is_self_attributing": false,
    "campaign_name": "Facebook 02.16.2016",
    "tier_name": "Segment Smartlink 14393",
    "app_guid": "kotestapp12345",
    "agency_tracker_id": null,
    "twitter_event_guid": "FCAF8281-387F-4092-8156-88E3DBA60842",
    "google_android_postback_url": "https://control.kochava.com/v1/cpi/network_specific/90_startup?campaign_id=kojoseph-android56a2a4e6b9e6f&device_id={adid}&device_id_type=adid&lat={lat}&click_url={click_url}&click_timestamp={click_ts}&trv_campaign={campaign_id}&video_id={video_id}",
    "google_ios_postback_url": "https://control.kochava.com/v1/cpi/network_specific/351_startup?campaign_id=kojoseph-android56a2a4e6b9e6f&device_id={md5_advertising_id}&device_id_type=idfa&device_hash_method=md5&device_id_is_hashed=true&lat={lat}&click_url={click_url}&click_timestamp={click_ts}&trv_campaign={campaign_id}&video_id={video_id}"
  },
  {
    "id": "13033271906",
    "tier_id": "13033192401",
    "campaign_id": "13033187461",
    "app_id": "14393",
    "date_created": "2016-02-23T16:24:15-08:00",
    "source": "web",
    "guid": "kojoseph-android56a2a4e6b9e6f144bda33e7bc5",
    "name": "SL Re_direct Test2",
    "type": "type_url_forward",
    "click_tracking_url": "https://control.kochava.com/v1/cpi/click?campaign_id=kojoseph-android56a2a4e6b9e6f6fef310549fc3&network_id=3881&site_id=none&device_id=device_id",
    "imp_tracking_url": "https://imp.control.kochava.com/track/impression?campaign_id=kojoseph-android56a2a4e6b9e6f6fef310549fc3&network_id=3881&site_id=none&device_id=device_id",
    "destination_url": "http://smart.link/56c22a3d7a56f?site_id=99&custom_1=99",
    "destination_url_reengagement": "",
    "network_id": "1",
    "network_pricing": "cpc",
    "network_price": "0.00",
    "budget_daily": "0.00",
    "budget_weekly": "0.00",
    "budget_max": "0.00",
    "rtb_id": null,
    "rtb_definitions": null,
    "meta": "{}",
    "legacy_campaign_id": "144bda33e7bc5",
    "legacy_post_id": "6",
    "perm_publisher_allow_view": "1",
    "is_active": "0",
    "creative_ids": [],
    "click_url_custom_params": [
      {
        "key": "tom",
        "value": "leland"
      },
      {
        "key": "bllop",
        "value": "bleep"
      }
    ],
    "destination_data": {
      "type": "custom",
      "typeObj": "{\"name\":\"Custom\",\"active\":true}"
    },
    "rtb_update_status": "",
    "rtb_update_response": null,
    "rtb_update_pid": null,
    "s2s_destination": "",
    "postback_url": "",
    "verification_rules": null,
    "smart_link_id": null,
    "what_if_parent_tracker_id": null,
    "network_name": "Mobile Posse",
    "network_is_self_attributing": false,
    "campaign_name": "Re-Direct Test",
    "tier_name": "Default Segment",
    "app_guid": "kotestapp12345",
    "agency_tracker_id": null,
    "twttter_event_guid": "5C0356B4-814C-49FA-92E0-6EEEBFA7D632",
    "google_android_postback_url": "https://control.kochava.com/v1/cpi/network_specific/90_startup?campaign_id=kojoseph-android56a2a4e6b9e6f&device_id={adid}&device_id_type=adid&lat={lat}&click_url={click_url}&click_timestamp={click_ts}&trv_campaign={campaign_id}&video_id={video_id}",
    "google_ios_postback_url": "https://control.kochava.com/v1/cpi/network_specific/351_startup?campaign_id=kojoseph-android56a2a4e6b9e6f&device_id={md5_advertising_id}&device_id_type=idfa&device_hash_method=md5&device_id_is_hashed=true&lat={lat}&click_url={click_url}&click_timestamp={click_ts}&trv_campaign={campaign_id}&video_id={video_id}"
  }
]

Update Trackers

This API is used to update an existing tracker by providing a JSON definition of the tracker with modifications. If the tracker is successfully updated an HTTP 200 code and response, as shown below, is returned.

 

Parameters Description Format
app_id App_id that the trackers are associated with.

Example: 123

 String

 

Sample Request:

Post: https://campaign.api.kochava.com/tracker/{app_id}
Content-Type: application/json; charset=utf-8
Authentication-Key: {MyUserAPIKey}
Body: {
  "id": "13033249379",
  "name": "New tracker name"
}

 

Sample Response:

{
  "id": "1",
  "tier_id": "1",
  "campaign_id": "1",
  "app_id": "14393",
  "date_created": "2017-04-27T18:57:17.578263758Z",
  "source": "web",
  "guid": "kojoseph-android56a2a4e6b9e6fe8b7504849dbf",
  "name": "Web app tracker - 1",
  "type": "type_url_forward",
  "click_tracking_url": "",
  "imp_tracking_url": "",
  "destination_url": "http://",
  "destination_url_reengagement": "",
  "network_id": "1",
  "network_pricing": "cpi",
  "network_price": 0,
  "budget_daily": 0,
  "budget_weekly": 0,
  "budget_max": 0,
  "rtb_id": null,
  "rtb_definition": null,
  "meta": "",
  "legacy_campaign_id": "e8b7504849dbf",
  "legacy_post_id": "1",
  "perm_publisher_allow_view": false,
  "is_active": true,
  "creative_ids": null,
  "click_url_custom_params": [],
  "destination_data": {
    "type": "",
    "typeObj": "{}"
  },
  "rtb_update_status": "",
  "rtb_update_response": null,
  "rtb_update_pid": null,
  "s2s_destination": null,
  "postback_url": null,
  "verification_rules": null,
  "smart_link_id": null,
  "what_if_parent_tracker_id": null,
  "network_name": "",
  "network_is_self_attributing": false,
  "network_supports_impressions": false,
  "campaign_name": "",
  "tier_name": "",
  "events": null,
  "app_guid": "kotestapp12345",
  "agency_tracker_id": null,
  "twttter_event_guid": "B0828B49-14A7-4FEF-A9C4-C7749358392F",
  "google_android_postback_url": "https://control.kochava.com/v1/cpi/network_specific/90_startup?campaign_id=kojoseph-android56a2a4e6b9e6f&device_id={adid}&device_id_type=adid&lat={lat}&click_url={click_url}&click_timestamp={click_ts}&trv_campaign={campaign_id}&video_id={video_id}",
  "google_ios_postback_url": "https://control.kochava.com/v1/cpi/network_specific/351_startup?campaign_id=kojoseph-android56a2a4e6b9e6f&device_id={md5_advertising_id}&device_id_type=idfa&device_hash_method=md5&device_id_is_hashed=true&lat={lat}&click_url={click_url}&click_timestamp={click_ts}&trv_campaign={campaign_id}&video_id={video_id}"
}

Delete a Tracker

This API is used to delete an existing tracker by providing the numerical Tracker ID. If the tracker is deleted an HTTP 200 response will be returned, otherwise another HTTP code and message detailing the error will be returned.

 

Parameters Description Format
app_id App_id that the trackers are associated with.

Example: 123

 String
tracker_id Comma seperated list of trackers to return.

Example: 123

 String

 

Sample Request:

Delete: https://campaign.api.kochava.com/tracker/{app_id}/delete/{tracker_id}
Content-Type: application/json; charset=utf-8
Authentication-Key: {MyUserAPIKey}

 

Sample Response:

{
  "success": "Tracker deleted"
}

Create a Tracker

This API is used to create a new tracker by providing a JSON definition of the tracker.

 

Parameters Description Format
app_id App_id that the tracker will be associated with.

Example: 123

 String

 

Sample Request:

Post: https://campaign.api.kochava.com/tracker/{app_id}/create
Content-Type: application/json; charset=utf-8
Authentication-Key: {MyUserAPIKey}
Body: {
  "name": "Web app tracker - 1",
  "type": "type_url_forward",
  "network_id": "1",
  "destination_url": "http://a-great-dest.com",
  "destination_url_reengagement": "",
  "network_pricing": "cpi",
  "network_price": 0,
  "perm_publisher_allow_view": false,
  "click_url_custom_params": [],
  "tier_id": "1",
  "campaign_id": "1",
  "agency_network_id": "0",
  "destination_data": {
    "type": "",
    "typeObj": "{}"
  },
  "events": [
    "cool",
    "events"
  ]
}

 

Sample Response:

{
  "id": "1",
  "tier_id": "1",
  "campaign_id": "1",
  "app_id": "14393",
  "date_created": "2017-04-27T18:57:17.578263758Z",
  "source": "web",
  "guid": "kojoseph-android56a2a4e6b9e6fe8b7504849dbf",
  "name": "Web app tracker - 1",
  "type": "type_url_forward",
  "click_tracking_url": "",
  "imp_tracking_url": "",
  "destination_url": "http://",
  "destination_url_reengagement": "",
  "network_id": "1",
  "network_pricing": "cpi",
  "network_price": 0,
  "budget_daily": 0,
  "budget_weekly": 0,
  "budget_max": 0,
  "rtb_id": null,
  "rtb_definition": null,
  "meta": "",
  "legacy_campaign_id": "e8b7504849dbf",
  "legacy_post_id": "1",
  "perm_publisher_allow_view": false,
  "is_active": true,
  "creative_ids": null,
  "click_url_custom_params": [],
  "destination_data": {
    "type": "",
    "typeObj": "{}"
  },
  "rtb_update_status": "",
  "rtb_update_response": null,
  "rtb_update_pid": null,
  "s2s_destination": null,
  "postback_url": null,
  "verification_rules": null,
  "smart_link_id": null,
  "what_if_parent_tracker_id": null,
  "network_name": "",
  "network_is_self_attributing": false,
  "network_supports_impressions": false,
  "campaign_name": "",
  "tier_name": "",
  "events": null,
  "app_guid": "kotestapp12345",
  "agency_tracker_id": null,
  "twttter_event_guid": "B0828B49-14A7-4FEF-A9C4-C7749358392F",
  "google_android_postback_url": "https://control.kochava.com/v1/cpi/network_specific/90_startup?campaign_id=kojoseph-android56a2a4e6b9e6f&device_id={adid}&device_id_type=adid&lat={lat}&click_url={click_url}&click_timestamp={click_ts}&trv_campaign={campaign_id}&video_id={video_id}",
  "google_ios_postback_url": "https://control.kochava.com/v1/cpi/network_specific/351_startup?campaign_id=kojoseph-android56a2a4e6b9e6f&device_id={md5_advertising_id}&device_id_type=idfa&device_hash_method=md5&device_id_is_hashed=true&lat={lat}&click_url={click_url}&click_timestamp={click_ts}&trv_campaign={campaign_id}&video_id={video_id}"
}

Get Tracker Overrides

This API provides the ability to retrieve the tracker overrides for the numerical Override ID provided in the URL.

 

Parameters Description Format
tracker_id Designated tracker which the tracker overrides will be returned.

Example: 123

 String

 

Sample Request:

Get: https://campaign.api.kochava.com/tracker/override?id={tracker_id}
Authentication-Key: {MyUserAPIKey}

 

Sample Response:

{
  "success": true,
  "request_id": "05250401062NRTLCA0QM120319571",
  "tracker_overrides": {
    "device_id_lookback_window": {
      "name": "Device",
      "key": "device_id_lookback_window",
      "group": "click",
      "type": "select",
      "value": 1,
      "admin": 0
    },
    "enable_verification": {
      "name": "Enable Verification",
      "key": "enable_verification",
      "group": "general",
      "type": "toggle",
      "value": 1,
      "admin": 0
    },
    "fingerprint_lookback_window": {
      "name": "Fingerprint",
      "key": "fingerprint_lookback_window",
      "group": "click",
      "type": "select",
      "value": 1,
      "admin": 0
    },
    "impression_lookback_device": {
      "name": "Device",
      "key": "impression_lookback_device",
      "group": "impression",
      "type": "select",
      "value": 1,
      "admin": 0
    },
    "impression_lookback_fingerprint": {
      "name": "Fingerprint",
      "key": "impression_lookback_fingerprint",
      "group": "impression",
      "type": "select",
      "value": 1,
      "admin": 0
    },
    "impression_lookback_ip": {
      "name": "IP",
      "key": "impression_lookback_ip",
      "group": "impression",
      "type": "select",
      "value": 1,
      "admin": 0
    },
    "impression_lookback_partial_ip": {
      "name": "Partial IP",
      "key": "impression_lookback_partial_ip",
      "group": "impression",
      "type": "select",
      "value": 1,
      "admin": 0
    },
    "impressions_disable_attribution": {
      "name": "Disable Impression Attribution",
      "key": "impressions_disable_attribution",
      "group": "impression",
      "type": "toggle",
      "value": 1,
      "admin": 0
    },
    "ip_lookback_window": {
      "name": "IP",
      "key": "ip_lookback_window",
      "group": "click",
      "type": "select",
      "value": 1,
      "admin": 0
    }
  }
}

Post Tracker Overrides

This API provides the ability to create tracker overrides for the numerical Tracker ID provided in the URL.

 

Parameters Description Format
tracker_id Designated tracker which the tracker overrides will be created for.

Example: 123

 String

 

Values Available for Input:

  • device_id_lookback_window
  • event_association_lookback
  • fingerprint_equalizer_lookback
  • fingerprint_lookback_window
  • impression_lookback_device
  • impression_lookback_fingerprint
  • impression_lookback_ip
  • impression_lookback_partial_ip
  • ip_lookback_window
  • enable_verification
  • impressions_disable_attribution

 

Sample Request:

Post: https://campaign.api.kochava.com/tracker/override?id={tracker_id}
Content-Type: text/plain; charset=utf-8
Authentication-Key: {MyUserAPIKey}
Body: {
  "tracker_overrides": {
    "device_id_lookback_window": {
      "name": "Device",
      "key": "device_id_lookback_window",
      "group": "click",
      "type": "select",
      "value": 1,
      "admin": 0
    },
    "enable_verification": {
      "name": "Enable Verification",
      "key": "enable_verification",
      "group": "general",
      "type": "toggle",
      "value": 1,
      "admin": 0
    },
    "fingerprint_lookback_window": {
      "name": "Fingerprint",
      "key": "fingerprint_lookback_window",
      "group": "click",
      "type": "select",
      "value": 1,
      "admin": 0
    },
    "impression_lookback_device": {
      "name": "Device",
      "key": "impression_lookback_device",
      "group": "impression",
      "type": "select",
      "value": 1,
      "admin": 0
    },
    "impression_lookback_fingerprint": {
      "name": "Fingerprint",
      "key": "impression_lookback_fingerprint",
      "group": "impression",
      "type": "select",
      "value": 1,
      "admin": 0
    },
    "impression_lookback_ip": {
      "name": "IP",
      "key": "impression_lookback_ip",
      "group": "impression",
      "type": "select",
      "value": 1,
      "admin": 0
    },
    "impression_lookback_partial_ip": {
      "name": "Partial IP",
      "key": "impression_lookback_partial_ip",
      "group": "impression",
      "type": "select",
      "value": 1,
      "admin": 0
    },
    "impressions_disable_attribution": {
      "name": "Disable Impression Attribution",
      "key": "impressions_disable_attribution",
      "group": "impression",
      "type": "toggle",
      "value": 1,
      "admin": 0
    },
    "ip_lookback_window": {
      "name": "IP",
      "key": "ip_lookback_window",
      "group": "click",
      "type": "select",
      "value": 1,
      "admin": 0
    }
  }
}

 

Sample Response:

{
  "success": true,
  "request_id": "0519233001FPLLNGZIEY162611664"
}

 
 

Last Modified: Feb 20, 2024 at 4:00 pm