들어 오세요
메뉴

API: 예산 업데이트하기(기술 가이드)

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

Mintegral API를 사용해 오퍼의 예산을 관리하고 변경할 수 있습니다.

  1. 오퍼가 프로모션 중인 모든 지역에 예산을 추가하거나, 지역별로 서로 다른 예산을 추가할 수 있습니다.
  2. 오퍼의 모든 타깃 지역에 예산을 추가하려면 country_code를 "ALL"로 두세요.
  3. 오퍼 내 서로 다른 지역에 예산을 추가해야 하는 경우 "country_code" 필드에 해당 지역의 국가 코드를 추가하세요. 또한 같은 "country_code"에 두 개 이상의 지역 코드를 추가하면 해당 지역 그룹이 예산을 공유한다는 의미입니다.

    참고:

    A) 오퍼에서 타기팅 중인 지역에만 예산을 추가할 수 있습니다.

    B) 지역별로 예산을 관리하기로 선택한 경우, 해당 오퍼가 타기팅하는 모든 지역에 예산이 설정되어 있는지 확인하세요. 같은 오퍼 내 동일 지역에 서로 다른 예산을 추가할 수 없습니다.

요청 주소

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

요청 메서드

PUT

요청 예시

json Copy 
PUT /api/open/v1/offer/budget
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{
  "offer_id": 123,
  "budget": [
    {
      "country_code": "US",
      "daily_cap_type": "BUDGET",
      "daily_cap": 0,
      "total_budget": "OPEN"
    },
    {
      "country_code": "CN",
      "daily_cap_type": "BUDGET",
      "daily_cap": 0,
      "total_budget": "OPEN"
    }
  ]
}

요청 파라미터

Fields Type Explanations Default Value Examples
offer_id int 오퍼의 고유 ID — 123
budget array 오퍼 예산 — —
country_code string 별도로 예산을 추가한 지역 — "CN,EN"
daily_cap_type string 일일 예산 유형입니다. 오퍼 지출 기준으로 예산을 관리하려면 "BUDGET"을 선택하고, 전환 수 기준으로 예산을 관리하려면 "CONVERSION"을 선택할 수 있습니다. — "BUDGET"
daily_cap int 최솟값은 50입니다. — —
total_budget string / int 일정 기간 동안의 오퍼 예산을 추가합니다. "OPEN"은 예산 제한이 없음을 의미합니다. — "OPEN"
total_budget_effective_time Deprecated string 총예산 적용 시간입니다.
예: YYYY-MM-DD		 — "2019-05-09"
total_budget_effective_timezone Deprecated number 총예산 적용 시간의 시간대입니다.
다음을 확인하세요:
[ENUM-Timezone]		 — 5.5

응답

Fields Type Explanations
code int 200이면 성공입니다. 그 외 코드는 실패를 의미합니다.
msg string 성공 시 "success"를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data json 성공 시 일반 객체를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.

응답 예시

json Copy 
{
  "msg": "success",
  "code": 200,
  "data": {}
}

오류 코드

예:

json Copy 
{
  "code": 10000,
  "msg": "error",
  "data": {
    "budget": "The budget field is required."
  }
}

오류 코드 상세 내용은 아래를 확인하세요.

code msg data Explanations
10000 error 
{
    "budget": "The budget field is required."
}
 Budget 필드는 null일 수 없습니다.
10000 error 
{
    "budget": "budget is not json string!"
}
 Budget 필드는 JSON이어야 합니다.
11423 budget is error! 
{
    "country_code": "you can only set ALL budget
    or special budget!"
}
 1 오퍼의 모든 타깃 지역에 예산을 추가하려면 country_code를 "ALL"로 두세요.
2 오퍼 내 서로 다른 지역에 예산을 추가해야 하는 경우 “country_code” 필드에 해당 지역의 국가 코드를 추가하세요. 또한 같은 “country_code”에 두 개 이상의 지역 코드를 추가하면 해당 지역 그룹이 예산을 공유한다는 의미입니다.
3 같은 오퍼에서 country_code를 “All”과 특정 지역으로 동시에 설정할 수 없습니다.
11423 budget is error! 
{
    "country_code": "KB cannot set budget, you can only 
    set budget on ALL or special country(AD,AE,AF,CN)!"
}
 오퍼에서 타기팅 중인 지역에만 예산을 추가할 수 있습니다.
11423 budget is error! 
{
    "budget": "these (AD,AE,AF,CN) not set budget!"
}
 지역별로 예산을 관리하기로 선택한 경우, 해당 오퍼가 타기팅하는 모든 지역에 예산이 설정되어 있어야 하며, 같은 오퍼 내 동일 지역에 서로 다른 예산을 추가할 수 없습니다.
11423 budget is error! 
{
    "daily_cap_type": "daily_cap_type must be
    BUDGET or CONVERSION!"
}
 daily_cap_type 필드는 "BUDGET" 또는 "CONVERSION"으로 설정해야 합니다.
11423 budget is error! 
{
    "daily_cap": "daily_cap is empty!"
}
 daily_cap 필드는 null일 수 없습니다.
11423 budget is error! 
{
    "total_budget": "total_budget is empty!"
}
 total_budget 필드는 null일 수 없습니다.
11423 budget is error! 
{
    "daily_cap": "daily_cap cannot less than 50!"
}
 daily_cap의 최솟값은 50입니다.
이전의
API: 입찰 관리하기(기술 개요)
다음
API: 오퍼 프로모션 상태 업데이트하기
최근 수정됨: 2026-08-06