Support Home > Analytics, Reports & API > Agency API Campaign Management

Agency API Campaign Management

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

Depending on the level of agency integration, the agency will have access to different features of Agency API Campaign Management. For more information on Kochava for Agencies, refer to our Kochava for Agencies support documentation.

 

Controlled Agency Profile

Access to:

  • Assigned Campaigns (view)

Limited Agency Profile

Full Access to:

  • Campaign/Segment Creation
  • Tracker Creation
  • Partner Configuration

Full Agency
Profile

Full Access to:

  • App Tools
  • Campaign Management
  • Tracker/Segment Creation and Management
  • Partner Configuration

 

NOTE: The agency API specific key must be used to access the Agency API Campaign Management tool.


Get Campaigns List

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

 

ParametersDescriptionFormat
app_idApp_id that the campaign is associated with. Example: 123.String
statsWhether to include number_of_trackers and number_of_tiers. Example: true.Boolean

 

Sample Request:

GET: https://campaign.api.kochava.com/agency/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.

 

ParametersDescriptionFormat
app_idApp_id that the campaign is associated with. Example: 123.String

 

Sample Request:

Post: https://campaign.api.kochava.com/agency/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.

 

ParametersDescriptionFormat
app_idApp_id that the campaign is associated with. Example: 123.String

 

Sample Request:

Post: https://campaign.api.kochava.com/agency/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.

 

ParametersDescriptionFormat
app_idApp_id that the campaign is associated with. Example: 123.String
campaign_idThe campaign associated with this campaign_id are returned. Example: 123 .Boolean

 

Sample Request:

Get: https://campaign.api.kochava.com/agency/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.

 

ParametersDescriptionFormat
campaign_idSegments associated with this campaign_id are returned. Example: 123.String

 

Sample Request:

Get: https://campaign.api.kochava.com/agency/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.

 

ParametersDescriptionFormat
campaign_idSegment will be created within the designated campaign_id. Example: 123.String

 

Sample Request:

Post: https://campaign.api.kochava.com/agency/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.

 

ParametersDescriptionFormat
campaign_idSegment will be updated within the designated campaign_id. Example: 123.String

 

Sample Request:

Post: https://campaign.api.kochava.com/agency/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.

 

ParametersDescriptionFormat
campaign_idDesignated campaign which contains the desired segment. Example: 123.String
tier_idSegment will be returned with the designated tier_id. Example: 123.String

 

Sample Request:

Get: https://campaign.api.kochava.com/agency/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.

 

ParametersDescriptionFormat
app_idApp_id that the trackers are associated with. Example: 123.String
tracker_idsComma seperated list of trackers to return. Example: 123,456.String
editablewhether to just include non-SAN, non-Smartlink trackers. Example: true.Boolean
network_nameInclude only results from this network. Example: Applovin - iOS.String
campaign_nameInclude only results from this campaign. Example: Demo Campaign.String
tier_nameInclude only results from this tier. Example: Default Tier.String
network_pricingInclude only results with this price type. Example: cpi.String
typeInclude only results of this type. Example: type_url_forward.String
network_name_notExclude results from this. Example: Applovin - iOS.String
campaign_name_notExclude results from this campaign. Example: Demo Campaign.String
tier_name_notExclude results from this tier. Example: Default Tier.String
network_pricing_notExclude results with this price type. Example: cpc.String
type_notExclude results with this type. Example: type_url_forward.String
traffic_verificationInclude or exclude trackers with traffic verification rules. Example: true.String
tracker_overridesInclude or exclude trackers with override rules. Example: true.String
campaign_idsInclude these campaign ids in the results. Example: 1,2.String
tier_idsInclude these tier ids in the results. Example: 1,2.

 

Sample Request:

Get: https://campaign.api.kochava.com/agency/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/agency/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/agency/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/agency/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/agency/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/agency/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/agency/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/agency/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/agency/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.

 

ParametersDescriptionFormat
app_idApp_id that the trackers are associated with. Example: 123.String

 

Sample Request:

Post: https://campaign.api.kochava.com/agency/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/agency/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/agency/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.

 

ParametersDescriptionFormat
app_idApp_id that the trackers are associated with. Example: 123.String
tracker_idComma seperated list of trackers to return. Example: 123.String

 

Sample Request:

Delete: https://campaign.api.kochava.com/agency/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.

 

ParametersDescriptionFormat
app_idApp_id that the tracker will be associated with. Example: 123.String

 

Sample Request:

Post: https://campaign.api.kochava.com/agency/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",
  "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/agency/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/agency/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.

 

ParametersDescriptionFormat
tracker_idDesignated tracker which the tracker overrides will be returned. Example: 123.String

 

Sample Request:

Get: https://campaign.api.kochava.com/agency/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.

 

ParametersDescriptionFormat
tracker_idDesignated tracker which the tracker overrides will be created for. Example: 123.String

 

Sample Request:

Post: https://campaign.api.kochava.com/agency/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: Oct 10, 2023 at 1:59 pm