API: Updating Tracking URL (Technical Guide)

Label：API key ,API ,technical guide ,developer guide ,updating tracking url ,click url ,impression url

You need to use your Mintegral token to manage your offers. For more details, please check Token.

Here's how you update your click URLs and impression URLs in your offers using Mintegral's API.

Request address

https://ss-api.mintegral.com/api/open/v1/tracking

Request method

PUT

Request example

json Copy

PUT /api/open/v1/tracking
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{
  "offer_id": 18490,
  "tracking_method": "REYUN",
  "impression_url": "https://uri6.com/tkio/aIBFJ3a?campuuid={uuid}&clickid={click_id}&ip={ip}&ua={ua}&subchannel={affiliate_id}&idfa={device_id}&imei={imei}&androidid={@info.args.androidid@}&muid={@info.args.imei_md5@}&impression=true",
  "click_url": "https://uri6.com/tkio/aIBFJ3a?campuuid={uuid}&clickid={click_id}&ip={ip}&ua={ua}&subchannel={affiliate_id}&idfa={device_id}&imei={imei}&androidid={@info.args.androidid@}&muid={@info.args.imei_md5@}",
  "support_server_click": "YES"
}

Request Parameter

Fields	Type	Explanations	Default Value	Examples
offer_id	int	Offer ID	—	`123`
tracking_method	string	Tracking method. eg. `"Appsflyer"`, `"Adjust"`. Enum value in [ENUM-Tracking Method]	—	`"APPSFLYER"`
click_url	string	Click attribution tracking URL	—	`"https://app.appsflyer.com/"`
impression_url `Optional`	string	View-through attribution tracking URL	—	`"https://impression.appsflyer.com/`
support_server_click `Optional`	string	This indicates whether this offer is allowed to receive click data from Mintegral server.	—	`YES`,`NO`

Response

Fields	Type	Explanations
code	int	200 code, is success. Others, are fail.
msg	string	If success, return to "success". If fail, return to detailed wrong info.
data	json	If success, return tracking data of offer. If fail, return to detailed wrong info.
offer_id	int	Offer ID
tracking_method	string	Tracking method
impression_url	string	View-through attribution tracking URL
click_url	string	Click attribution tracking URL
click_url_status	string	Status of click url, Enum value: PENDDING => Click URL is waiting a test or click url has not passed and continue testing PASS => Click URL is available NOT_EXIST => Click URL is null

Response Example

json Copy

{
  "msg": "success",
  "code": 200,
  "data": {
    "offer_id": 18490,
    "tracking_method": "REYUN",
    "impression_url": "https://uri6.com/tkio/aIBFJ3a?campuuid={uuid}&clickid={click_id}&ip={ip}&ua={ua}&subchannel={affiliate_id}&idfa={device_id}&imei={imei}&androidid={@info.args.androidid@}&muid={@info.args.imei_md5@}&impression=true",
    "click_url": "https://uri6.com/tkio/aIBFJ3a?campuuid={uuid}&clickid={click_id}&ip={ip}&ua={ua}&subchannel={affiliate_id}&idfa={device_id}&imei={imei}&androidid={@info.args.androidid@}&muid={@info.args.imei_md5@}",
    "click_url_status": "PENDDING"
  }
}

API: Managing Publishers as Advertiser (Technical Guide)

API: Updating Creatives (Technical Guide)

Last modified: 2025-08-28

Outline