들어 오세요
메뉴

API: 트래킹 URL 업데이트하기(기술 가이드)

오퍼를 관리하려면 Mintegral 토큰을 사용해야 합니다. 자세한 내용은 Token을 확인하세요.

Mintegral API를 사용해 오퍼의 클릭 URL과 노출 URL을 업데이트하는 방법은 다음과 같습니다.

요청 주소

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

요청 메서드

PUT

요청 예시

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"
}

요청 파라미터

Fields Type Explanations Default Value Examples
offer_id int 오퍼 ID — 123
tracking_method string 트래킹 방식입니다. 예: "Appsflyer", "Adjust". 열거 값은
[ENUM-Tracking Method]을 참고하세요.		 — "APPSFLYER"
click_url string 클릭 어트리뷰션 트래킹 URL — "https://app.appsflyer.com/"
impression_url Optional string 뷰스루 어트리뷰션 트래킹 URL — "https://impression.appsflyer.com/
support_server_click Optional string 이 오퍼가 Mintegral 서버에서 클릭 데이터를 받을 수 있는지 여부를 나타냅니다. — YES,NO

응답

Fields Type Explanations
code int 200이면 성공입니다. 그 외 코드는 실패를 의미합니다.
msg string 성공 시 "success"를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data json 성공 시 오퍼의 트래킹 데이터를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
offer_id int 오퍼 ID
tracking_method string 트래킹 방식
impression_url string 뷰스루 어트리뷰션 트래킹 URL
click_url string 클릭 어트리뷰션 트래킹 URL
click_url_status string 클릭 URL 상태입니다. 열거 값:
PENDDING => Click URL이 테스트 대기 중이거나 테스트를 통과하지 못해 계속 테스트 중입니다.
PASS => Click URL을 사용할 수 있습니다.
NOT_EXIST => Click URL이 null입니다.

응답 예시

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: 광고주로서 퍼블리셔 관리하기(기술 가이드)
다음
API: 크리에이티브 업데이트하기(기술 가이드)
최근 수정됨: 2026-08-06