들어 오세요
메뉴

API: 오퍼 관리하기(기술 가이드)

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

프로모션 시간, 타깃 지역 등 오퍼의 기본 정보를 관리하는 방법은 다음과 같습니다.

요청 주소

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

요청 메서드

PUT

요청 예시

json Copy 
PUT /api/open/v1/offer
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{
  "offer_id": "18490",
  "offer_name": "cqf_testtttt",
  "promote_timezone": 7,
  "start_time": 1578455012,
  "target_geo": "ALL",
  "os_version_min": "8.8",
  "custom_ad_schedule": {"1":"0,1,23","2":"3,4,5","3":"3,6,5"},
  "custom_ad_schedule_timezone": 0,
  "network": "WIFI",
  "target_device": "PHONE"
}

요청 파라미터

Fields Type Explanations Default Value Examples
offer_id int 오퍼의 고유 ID — 1234
offer_name string 오퍼의 고유 이름입니다. 영문자, 밑줄, 숫자만 사용할 수 있으며 길이는 3-95자여야 합니다. "" "offer_test"
promote_timezone number 프로모션 기간의 시간대 설정입니다. 열거 값은
[ENUM-Timezone]을 참고하세요.		 "" 5.5
start_time int 프로모션 시작 시간의 타임스탬프입니다. end_time이 있는 경우 그보다 앞서야 합니다. — 1578455012
end_time Optional int 프로모션 종료 시간의 타임스탬프입니다. start_time이 있는 경우 그보다 뒤여야 합니다. 0 1578455169
target_geo string 프로모션 타깃 지역입니다. 글로벌 프로모션은 "ALL"로 설정합니다. 여러 지역은 쉼표로 구분합니다. — "CN"
os_version_min Optional string 허용되는 최소 OS 버전이며 형식은 /^[0-9](\.[0-9]){0,2}$/입니다. "x"는 자연수를 의미합니다. null로 설정하면 기본적으로 캠페인과 동일한 OS 버전 요건이 적용됩니다. — "9.0"
custom_ad_schedule Optional json 프로모션 스케줄입니다. key는 요일(1-7), value는 시간(0-23)을 의미합니다. null로 설정하면 모든 요일과 모든 시간이 선택됩니다. — {"1":"0,1,23","2":"3,4,5"}
custom_ad_schedule_timezone Deprecated number 프로모션 스케줄의 시간대 설정입니다. 열거 값은
[ENUM-Timezone]을 참고하세요. 이 필드는 더 이상 사용되지 않으며, 대신 'promote_timezone' 필드를 사용하세요.		 — -5.5
network Optional string 디바이스 네트워크 상태 타깃입니다. 열거 값은
[ENUM-Network]을 참고하세요.		 — "2G,3G,4G,5G"
target_device Optional string 타깃 디바이스 유형입니다. ENUM 값: "PHONE", "TABLET". "PHONE,TABLET" "PHONE,TABLET"

응답

Fields Type Explanations
code int 200이면 성공입니다. 그 외 코드는 실패를 의미합니다.
msg string 성공 시 "success"를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data json 성공 시 오퍼 데이터를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
offer_id int 오퍼의 고유 ID
offer_name string 설정한 오퍼명
promote_timezone number 프로모션 기간의 시간대 설정입니다. 예: -5
start_time int 프로모션 시작 시간의 타임스탬프
end_time int 프로모션 종료 시간의 타임스탬프
target_geo string 프로모션 타깃 지역입니다. 예: US,CN
os_version_min string 최소 OS 버전
custom_ad_schedule string 프로모션 스케줄
custom_ad_schedule_timezone number 프로모션 스케줄의 시간대 설정
이 필드는 더 이상 사용되지 않으며, 대신 'promote_timezone' 필드를 사용하세요.
network string 디바이스 네트워크 상태 타깃
target_device string 타깃 디바이스 유형

응답 예시

json Copy 
{
  "code": 200,
  "msg": "success",
  "data": {
    "offer_id": 18496,
    "offer_name": "cqf_testtttt",
    "promote_timezone": 7,
    "start_time": "1578455012",
    "end_time": "1578458012",
    "target_geo": "ALL",
    "os_version_min": "8.8",
    "custom_ad_schedule": "{\"1\":\"0,1,23\",\"2\":\"3,4,5\",\"3\":\"3,6,5\"}",
    "custom_ad_schedule_timezone": 0,
    "network": "WIFI",
    "target_device": "PHONE"
  }
}
이전의
API: 오퍼 생성하기(기술 가이드)
다음
API: 입찰 관리하기(기술 개요)
최근 수정됨: 2026-08-06