Links API


Links API is an API for listing, creating, and modifying SmartLink™ resources.


App Group

This endpoint can be used to create an App Group.

 

Endpoint:

POST: https://links.api.kochava.com/v1/groups
Header: Authentication Key: {MyUserAPIKey}

NOTE: An App cannot be added to more than one App Group and an App Group may only contain one instance of each platform. Please ensure the Apps that you are grouping are not already included in another App Group and each have a distinct App platform (iOS, Android, Fire OS, Web, etc).

 

Request Body:

 

Response Body:

This endpoint can be used to retrieve a specific App Group.

 

Endpoint:

GET: https://links.api.kochava.com/v1/groups/id
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The ID of an App Group to look up. Example: 123 Number

 

Response Body:

This endpoint can be used to change the name of an App Group and/or add new Apps to the App Group.

NOTE: There are restrictions on what Apps can be added to an App Group. An App cannot be added to more than one App Group and an App Group may only contain one instance of each platform. Please ensure the Apps that you are adding are not already included in another App Group and each App included has a distinct platform (iOS, Android, Fire OS, Web, etc).

NOTE: Apps cannot be removed from an App Group. If an App needs to be removed, the App Group as a whole can be archived, as long as there are no active SmartLinks™ remaining for the App Group. You can then recreate the App Group with the desired list of Apps.

NOTE: If the intent is to only change the App Group name, the list of Apps currently in the group must be passed in the Update request as well, similar to how it is passed on the Create request.

 

Endpoint:

PUT:https://links.api.kochava.com/v1/groups/id
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The ID of the app group to edit. Example: 123 Number

 

Request Body:

 

Response Body:

This endpoint is used to archive an App Group.

NOTE: This action cannot be reversed.

 

Endpoint:

PUT: https://links.api.kochava.com/v1/groups/id/archive
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The ID of the app group to archive. Example: 123 Number

 

Response Body:

This endpoint can be used to retrieve a list of Subdomains.

 

Endpoint:

GET: https://links.api.kochava.com/v1/groups/id/subdomains

 

Parameters:

Parameter Description Format
id The app group id to update. Example: 123. Number

 

Response Body:

This endpoint can be used to retrieve a list of App Groups.

 

Endpoint:

GET: https://links.api.kochava.com/v1/groups?is_active=true&search=prod&page=2&page_size=10&sort=name&platform=android%2Cios&account=5&has_write_access=1
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
account An account to filter the results to. Helpful for requests made by Agency users who may work with more than one advertiser. Example: 10246. Number
has_written_access Indicates that the API key has the ability to create SmartLinks™ Resources for the App Group. This is useful in the case of Agency users who may have read-only access to some App Groups. Example: 1. String
is_active Filter on active/inactive. If is_active = false, that means the App Group was archived. Example: true. Boolean
page_size The number of items to return per page. Example: 10 Default: 25. Number
page The page number of the result set to retrieve. Example: 2 Default: 1. Number
platform Comma separated list of platforms to filter app groups by. Options include android, androidtv, chromecast, daydream, htcvive, ios, kindle, linux, macosx, nintendoswitch, nintendowiiu, oculusgo, oculusrift, playstation, roku, samsunggearvr, tizenos, tvos, viziosmartcastos, web, webgl, webos, windows, windowsxbox. String
search Filter App Groups by the given search value. Search values can be full/partial App Group Name or App Name. String
sort The value and direction to sort by. Options include name_asc, name_desc, smartlink_count_asc, smartlink_count_desc, app_count_asc, app_count_desc, created_asc, created_desc. Default: created_asc. String
sort The value and direction to sort by. Options include name_asc, name_desc, smartlink_count_asc, smartlink_count_desc, app_count_asc, app_count_desc, created_asc, created_desc. Default: created_asc. String

 

Response Body:


App Group Campaigns

This endpoint can be used to retrieve a list of App Group Campaigns for a given App Group.

App Group Campaigns are Campaigns that are shared across all Apps in an App Group. Multiple SmartLinks™ can be assigned to an App Group Campaign.

NOTE: App Group Campaigns are separate and distinct from the Campaigns created via the Campaign API. You cannot add trackers created in the Campaign API to App Group Campaigns and you cannot add SmartLinks™ to Campaigns created via the Campaign API.

 

Endpoint:

GET: https://links.api.kochava.com/v1/groups/id/campaigns?is_deleted
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The app group id to get the campaigns for. Example: 123. Number
is_deleted Filter on whether or not the campaign is deleted. Default is to omit deleted campaigns. Example: false. Bool

 

Response Body:

This endpoint can be used to check an App Group Campaign.

App Group Campaigns are Campaigns that are shared across all Apps in an App Group. Multiple SmartLinks™ can be assigned to an App Group Campaign.

NOTE: App Group Campaigns are separate and distinct from the Campaigns created via the Campaign API. You cannot add trackers created in the Campaign API to App Group Campaigns and you cannot add SmartLinks™ to Campaigns created via the Campaign API.

 

Endpoint:

POST: https://links.api.kochava.com/v1/groups/id/campaigns/check
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The app group id to check the campaigns for. Example: 123. Number

 

Response Body:

This endpoint can be used to create an App Group Campaign.

App Group Campaigns are Campaigns that are shared across all Apps in an App Group. Multiple SmartLinks™ can be assigned to an App Group Campaign.

NOTE: App Group Campaigns are separate and distinct from the Campaigns created via the Campaign API. You cannot add trackers created in the Campaign API to App Group Campaigns and you cannot add SmartLinks™ to Campaigns created via the Campaign API.

 

Endpoint:

POST: https://links.api.kochava.com/v1/groups/id/campaigns?
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The app group id to create the campaign for. Example: 123. Number

 

Request Body:

 

Response Body:

This endpoint can be used to update a App Group Campaign.

App Group Campaigns are Campaigns that are shared across all Apps in an App Group. Multiple SmartLinks™ can be assigned to an App Group Campaign.

NOTE: App Group Campaigns are separate and distinct from the Campaigns created via the Campaign API. You cannot add trackers created in the Campaign API to App Group Campaigns and you cannot add SmartLinks™ to Campaigns created via the Campaign API.

 

Endpoint:

POST: https://links.api.kochava.com/v1/groups/id/campaigns/campaign_id
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The app group id to update the campaigns for. Example: 123. Number
campaign_id The campaign id to update. Example: 123. Number

 

Response Body:


Advertisers

This endpoint can be used to get a list of Advertisers where the API key has either read or write access to at least one of the Advertiser’s App Groups. Useful for Agency users who may work with more than one Advertiser.

 

Endpoint:

GET: https://links.api.kochava.com/v1/advertisers?has_write_access=true
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
has_write_access Filter on whether the API key has write access to at least one of the Advertiser’s App Groups. This is useful for Agency users who may have read-only or write access to an App Group. Boolean

 

Response Body:


Agencies

This endpoint can be used to retrieve a list of Agencies a SmartLink™ can be associated to.

 

Endpoint:

GET: hhttps://links.api.kochava.com/v1/agency_networks
Header: Authentication Key: {MyUserAPIKey}

 

Response Body:


Media Partners

This endpoint can be used to retrieve a list of integrated SmartLink™ Media Partners and Private Networks the SmartLink™ can be associated to.

 

Endpoint:

GET: https://links.api.kochava.com/v1/networks?vppn_app_id=30000%C30001
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
vppn_app_id OPTIONAL FILTER: Specify list of apps and receive a list of private networks associated to those apps. Excluding this filter will return all networks (universal and private). Example: 30000,30001. String

 

Response Body:


SmartLinks™ without iOS Universal Link or Android App Link Support

This endpoint can be used to check a SmartLink™ name.

 

Endpoint:

POST: https://links.api.kochava.com/v1/links/check/name
Header: Authentication Key: {MyUserAPIKey}

 

Request Body:

 

Response:

This endpoint can be used to create a SmartLink™.

NOTE: App platforms eligible to be included in SmartLink™ routes are the following: “Android”, “iOS”, “Web” (Desktop), “Kindle” (Fire OS), “Macosx” (macOS), “Windows”. App Groups may contain additional platforms, however those will be omitted from SmartLink™ routes.

 

Endpoint:

POST: https://links.api.kochava.com/v1/links
Header: Authentication Key: {MyUserAPIKey}

 

Request Body:

Name Parameter Description
App Group ID app_group_id ID of the App Group.
Network ID network_id ID of the Media Partner. For none, use 3881.
Agency ID agency_network_id ID of the Agency. For none, use null.
App Group Campaign ID app_group_campaign_id Only one of app_group_campaign_id or app_group_campaign_name is required.

In order to assign a SmartLink™ to an existing App Group Campaign, populate app_group_campaign_id with an existing App Group ID and populate app_group_campaign_name with null or omit the parameter.

In order to create a new App Group Campaign, populate app_group_campaign_name with a new App Group Campaign Name and populate app_group_campaign_id with null or omit the parameter.

App Group Campaign Name app_group_campaign_name Only one of app_group_campaign_id or app_group_campaign_name is required.

In order to assign a SmartLink™ to an existing App Group Campaign, populate app_group_campaign_id with an App Group ID and populate app_group_campaign_name with null or omit the parameter.

In order to create a new App Group Campaign, populate app_group_campaign_name with a new App Group Campaign Name and populate app_group_campaign_id with null or omit the parameter.

Ad Pricing Model network_price Options: CPC (Cost per Click), CPI (Cost per Install), CPM (Cost per Impression), CPA (Cost per Action)
Ad Price network_pricing This amount will be assigned to the traffic depending on the Ad Pricing Model. For example if CPI $1 and the SmartLink™ click or impression is attributed to an install, that install will have a install price of $1.
Custom Parameter Key custom_params > key These key/value pairs will be added to the SmartLink™ URL.
Custom Parameter Value custom_params > value These key/value pairs will be added to the SmartLink™ URL.
SmartLink Name name The name of the SmartLink™.
Catch-All App default > app_id Traffic that does not match any of the platforms included within the defined routes will be stored under this App, under a Kochava-generated Tracker name: “Catch-all tracker for [SmartLink Name]”.
Catch-All Destination default > destination_url Users clicking on devices that do not match any of the platforms included within the defined routes will be redirected to this destination. Typically your website.
Routes by App routes_by_app Define destinations and conversion events by App/platform.
Conversion App routes_by_app > app_id Apps included must belong to the App Group.
Conversion Events routes_by_app > events List of Events you would like this SmartLink’s™ traffic to attribute to. Can be _Install and/or Post-install Events. These conversion Events should match the Event names sent to Kochava from the Conversion App.
Routes routes_by_app > routes Define the Tracker name, “if app is installed” and “if app is not installed” destinations, and the platform of the App.
Tracker Name routes_by_app > routes > name The name of the Tracker for this route (app/platform-specific).
“If App is Not Installed” Destination routes_by_app > routes > destination_url Destination to take the user to if the app is not installed on the device. Typically the app store.
“If App is Installed” Destination routes_by_app > routes > reenagement_url Destination to take the user to if the app is already installed on the device. Typically a deep link that will open the app and/or take the user to a specific destination within the app.
Platform of the Route routes_by_app > routes > rules > platform_in The platform designated should match that of the conversion app, as well as the destinations specified for the given route. Upon a user clicking on a SmartLink™, Kochava will detect the platform and route the user to the appropriate destinations. Options: “Android”, “iOS”, “Web” (Desktop), “Kindle” (Fire OS), “Macosx” (macOS), “Windows”.

 

Response Body:

This endpoint can be used to retrieve a specific SmartLink™.

 

Endpoint:

GET: https://links.api.kochava.com/v1/links/id
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The ID of the SmartLink™ to look up. Example: 123. Number

 

Response Body:

This endpoint can be used to retrieve a specific QR Code.

 

Endpoint:

GET: https://links.api.kochava.com/v1/links/id/qr?format=svg&size=256
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The ID of the SmartLink™ ID. Example: 123. Number
format Image format for the QR code. png, jpg, svg Example: svg Default: png. String
size desired size of the outputed qr code image. 0: as small as possible. < 0: scaling multiplier. > 0: number of pixels wide/high. Note: svg currently only uses scaling multiplier. Example: 256 Default: 0. Integer

 

Response:

 

Response Body:

This endpoint can be used to update an existing SmartLink™.

NOTE: For simplicity, the entire response from a GET can be sent as an update. Some fields will be ignored, but any changes will be considered and applied if permissible.

 

CAUTION: Please ensure the “id” fields, found within “data”, “default”, and “routes” have the original values from the GET response. Leaving the id fields blank or changing the value will cause the SmartLink™ to become disassociated from the underlying App-specific Trackers, which may cause routing and attribution issues.

 

Endpoint:

PUT: https://links.api.kochava.com/v1/links/id
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The ID of the SmartLink™ to update. Example: 123. Number

 

Request Body:

NOTE: Parameters that can be updated include the following:

Name Parameter Description
Agency ID agency_network_id ID of the Agency. For none, use null.
App Group Campaign ID app_group_campaign_id Only one of app_group_campaign_id or app_group_campaign_name is required.

In order to assign a SmartLink™ to an existing App Group Campaign, populate app_group_campaign_id with an App Group ID and populate app_group_campaign_name with null or omit the parameter.

In order to create a new App Group Campaign, populate app_group_campaign_name with a new App Group Campaign Name and populate app_group_campaign_id with null or omit the parameter.

Ad Pricing Model network_pricing Options: CPC (Cost per Click), CPI (Cost per Install), CPM (Cost per Impression), CPA (Cost per Action)
Ad Price network_price This amount will be assigned to the traffic depending on the Ad Pricing Model. For example if CPI $1 and the SmartLink™ click or impression is attributed to an install, that install will have a install price of $1.
Custom Parameter Key custom_params > key These key/value pairs will be added to the SmartLink™ URL.
Custom Parameter Value custom_params > value These key/value pairs will be added to the SmartLink™ URL.
SmartLink Name name The name of the SmartLink™.
Catch-All App default > app_id Traffic that does not match any of the platforms included within the defined routes will be stored under this App, under a Kochava-generated Tracker name: “Catch-all tracker for [SmartLink Name]”.
Catch-All Destination default > destination_url Users clicking on devices that do not match any of the platforms included within the defined routes will be redirected to this destination. Typically your website.
Conversion Events routes_by_app > events List of Events you would like this SmartLink’s™ traffic to attribute to. Can be _Install and/or Post-install Events. These conversion Events should match the Event names sent to Kochava from the Conversion App.
Tracker Name routes_by_app > routes > name The name of the Tracker for this route (app/platform-specific).
“If App is Not Installed” Destination routes_by_app > routes > destination_url Destination to take the user to if the app is not installed on the device. Typically the app store.
“If App is Installed” Destination routes_by_app > routes > reenagement_url Destination to take the user to if the app is already installed on the device. Typically a deep link that will open the app and/or take the user to a specific destination within the app.

 

Response Body:

This endpoint can be used to archive a SmartLink™.

 

Endpoint:

PUT: https://links.api.kochava.com/v1/links/id/archive
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The ID of the SmartLink™ to archive. Example: 123. Number

 

Response Body:

This endpoint can be used to retrieve a list of SmartLinks™.

 

Endpoint:

GET: https://links.api.kochava.com/v1/links?app_group_id=123%2C321&advertiser_account_id=23&is_active=true&search=inmobi&page=2&page_size=10&sort=name
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
app_group_id App Group(s) to filter on – can be a single id or a comma delimited list of ids. Example: 123,321. String
advertiser_account_id Advertiser Account ID to filter on. Example: 123. Number
is_active Filter on active/inactive. If is_active = false, that means the SmartLink™ was archived. Example: true. Boolean
search Filter SmartLinks™ by the given search value. Search values can be full/partial SmartLink Name, SmartLink URL, Partner Name, Agency Name. Example: inmobi. String
page_size The number of items to return per page. Example: 10 Default: 25. Number
page The page number of the result set to retrieve. Example: 2 Default: 1. Number
sort The value: (name, created, updated) and direction to sort by: (asc, desc) Example: name Default: created_asc. String

 

Response Body:


SmartLinks™ with iOS Universal Link and Android App Link Support

This endpoint can be used to check a SmartLink™ name.

 

Endpoint:

POST: https://links.api.kochava.com/v1/links/check/name
Header: Authentication Key: {MyUserAPIKey}

 

Request Body:

 

Response:

This endpoint can be used to create a SmartLink™ that contains an iOS App with Kochava-hosted Universal Link support, as well as an Android App with Kochava-hosted App Link support. A prerequisite to this is completing the integration requirements for Kochava-hosted Universal Links and App Links. More information can be found here.

NOTE: App platforms eligible to be included in SmartLink™ routes are the following: “Android”, “iOS”, “Web” (Desktop), “Kindle” (Fire OS), “Macosx” (macOS), “Windows”. App Groups may contain additional platforms, however those will be omitted from SmartLink™ routes.

 

Endpoint:

POST: https://links.api.kochava.com/v1/links
Header: Authentication Key: {MyUserAPIKey}

 

Request Body:

Name Parameter Description
App Group ID app_group_id ID of the App Group.
“If App is Installed” Destination path Destination to take the user to if the app is already installed on the device. Typically a deep link that will open the app and/or take the user to a specific destination within the app. The “path” value will be applied to any routes that contain “native_link”: “ios” or “native_link”: “android”.
Network ID network_id ID of the Media Partner. For none, use 3881.
Agency ID agency_network_id ID of the Agency. For none, use null.
App Group Campaign ID app_group_campaign_id Only one of app_group_campaign_id or app_group_campaign_name is required.

In order to assign a SmartLink™ to an existing App Group Campaign, populate app_group_campaign_id with an existing App Group ID and populate app_group_campaign_name with null or omit the parameter.

In order to create a new App Group Campaign, populate app_group_campaign_name with a new App Group Campaign Name and populate app_group_campaign_id with null or omit the parameter.

App Group Campaign Name app_group_campaign_name Only one of app_group_campaign_id or app_group_campaign_name is required.

In order to assign a SmartLink™ to an existing App Group Campaign, populate app_group_campaign_id with an App Group ID and populate app_group_campaign_name with null or omit the parameter.

In order to create a new App Group Campaign, populate app_group_campaign_name with a new App Group Campaign Name and populate app_group_campaign_id with null or omit the parameter.

Ad Pricing Model network_price Options: CPC (Cost per Click), CPI (Cost per Install), CPM (Cost per Impression), CPA (Cost per Action)
Ad Price network_pricing This amount will be assigned to the traffic depending on the Ad Pricing Model. For example if CPI $1 and the SmartLink™ click or impression is attributed to an install, that install will have a install price of $1.
Custom Parameter Key custom_params > key These key/value pairs will be added to the SmartLink™ URL.
Custom Parameter Value custom_params > value These key/value pairs will be added to the SmartLink™ URL.
SmartLink Name name The name of the SmartLink™.
Catch-All App default > app_id Traffic that does not match any of the platforms included within the defined routes will be stored under this App, under a Kochava-generated Tracker name: “Catch-all tracker for [SmartLink Name]”.
Catch-All Destination default > destination_url Users clicking on devices that do not match any of the platforms included within the defined routes will be redirected to this destination. Typically your website.
Routes by App routes_by_app Define destinations and conversion events by App/platform.
Conversion App routes_by_app > app_id Apps included must belong to the App Group.
Conversion Events routes_by_app > events List of Events you would like this SmartLink’s™ traffic to attribute to. Can be _Install and/or Post-install Events. These conversion Events should match the Event names sent to Kochava from the Conversion App.
Routes routes_by_app > routes Define the Tracker name, “if app is installed” and “if app is not installed” destinations, and the platform of the App.
Tracker Name routes_by_app > routes > name The name of the Tracker for this route (app/platform-specific).
“If App is Not Installed” Destination routes_by_app > routes > destination_url Destination to take the user to if the app is not installed on the device. Typically the app store.
Universal Link/App Link Flag routes_by_app > routes > native_link Insert “ios” as the value for a iOS Universal Link-enabled route. Insert “android” as the value for an Android App Link-enabled route.

 

Response Body:

This endpoint can be used to retrieve a specific SmartLink™.

 

Endpoint:

GET: https://links.api.kochava.com/v1/links/id
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The ID of the SmartLink™ to look up. Example: 123. Number

 

Response Body:

This endpoint can be used to retrieve a specific QR Code;.

 

Endpoint:

GET: https://links.api.kochava.com/v1/links/id/qr?format=svg&size=256
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The ID of the SmartLink™ ID. Example: 123. Number
format Image format for the QR code. png, jpg, svg Example: svg Default: png. String
size desired size of the outputed qr code image. 0: as small as possible. < 0: scaling multiplier. > 0: number of pixels wide/high. Note: svg currently only uses scaling multiplier. Example: 256 Default: 0. Integer

 

Response:

 

Response Body:

This endpoint can be used to update an existing SmartLink™ that contains an iOS App with Kochava-hosted Universal Link support, as well as an Android App with Kochava-hosted App Link support.

NOTE: For simplicity, the entire response from a GET can be sent as an update. Some fields will be ignored, but any changes will be considered and applied if permissible.

 

CAUTION: Please ensure the “id” fields, found within “data”, “default”, and “routes” have the original values from the GET response. Leaving the id fields blank or changing the value will cause the SmartLink™ to become disassociated from the underlying App-specific Trackers, which may cause routing and attribution issues.

 

Endpoint:

PUT: https://links.api.kochava.com/v1/links/id
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The Smart Link id. Example: 123. Number

 

Request Body:

NOTE: Parameters that can be updated include the following:

Name Parameter Description
“If App is Installed” Destination path Destination to take the user to if the app is already installed on the device. Typically a deep link that will open the app and/or take the user to a specific destination within the app. The “path” value will be applied to any routes that contain “native_link”: “ios” or “native_link”: “android”.
Agency ID agency_network_id ID of the Agency. For none, use null.
App Group Campaign Name app_group_campaign_name Only one of app_group_campaign_id or app_group_campaign_name is required.

In order to assign a SmartLink™ to an existing App Group Campaign, populate app_group_campaign_id with an App Group ID and populate app_group_campaign_name with null or omit the parameter.

In order to create a new App Group Campaign, populate app_group_campaign_name with a new App Group Campaign Name and populate app_group_campaign_id with null or omit the parameter.

Ad Pricing Model network_pricing Options: CPC (Cost per Click), CPI (Cost per Install), CPM (Cost per Impression), CPA (Cost per Action)
Ad Price network_price This amount will be assigned to the traffic depending on the Ad Pricing Model. For example if CPI $1 and the SmartLink™ click or impression is attributed to an install, that install will have a install price of $1.
Custom Parameter Key custom_params > key These key/value pairs will be added to the SmartLink™ URL.
Custom Parameter Value custom_params > value These key/value pairs will be added to the SmartLink™ URL.
SmartLink Name name The name of the SmartLink™.
Catch-All App default > app_id Traffic that does not match any of the platforms included within the defined routes will be stored under this App, under a Kochava-generated Tracker name: “Catch-all tracker for [SmartLink Name]”.
Catch-All Destination default > destination_url Users clicking on devices that do not match any of the platforms included within the defined routes will be redirected to this destination. Typically your website.
Conversion Events routes_by_app > events List of Events you would like this SmartLink’s traffic to attribute to. Can be _Install and/or Post-install Events. These conversion Events should match the Event names sent to Kochava from the Conversion App.
Tracker Name routes_by_app > routes > name The name of the Tracker for this route (app/platform-specific).
“If App is Not Installed” Destination routes_by_app > routes > destination_url Destination to take the user to if the app is not installed on the device. Typically the app store.

 

Response Body:

This endpoint can be used to archive a SmartLink™.

 

Endpoint:

PUT: https://links.api.kochava.com/v1/links/id/archive
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
id The ID of the SmartLink™ to archive. Example: 123. Number

 

Response Body:

This endpoint can be used to retrieve a list of SmartLinks™.

 

Endpoint:

GET: https://links.api.kochava.com/v1/links?app_group_id=123%2C321&advertiser_account_id=23&is_active=true&search=inmobi&page=2&page_size=10&sort=name
Header: Authentication Key: {MyUserAPIKey}

 

Parameters:

Parameter Description Format
app_group_id App Group(s) to filter on – can be a single id or a comma delimited list of ids. Example: 123,321. String
advertiser_account_id Advertiser Account ID to filter on. Example: 123. Number
is_active Filter on active/inactive. If is_active = false, that means the SmartLink™ was archived. Example: true. Boolean
search Filter SmartLinks™ by the given search value. Search values can be full/partial SmartLink Name, SmartLink URL, Partner Name, Agency Name. Example: inmobi. String
page_size The number of items to return per page. Example: 10 Default: 25. Number
page The page number of the result set to retrieve. Example: 2 Default: 1. Number
sort The value: (name, created, updated) and direction to sort by: (asc, desc) Example: name Default: created_asc. String

 

Response Body: