메뉴

API: 입찰 관리하기(기술 개요)

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

요청 주소

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

요청 메서드

PUT

요청 예시

json Copy

PUT /api/open/v1/offer/bid_rate
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
// 일반 입찰(지역 및 mtgid와 무관)
{
  "offer_id": 123, 
  "bid_rate":3.2
}
// 지역별 입찰:
{
  "offer_id": 123, 
  "bid_rate":3.2, 
  "bid_rate_by_location": [
    {"country_code":"CN,AE","bid_rate":0.5},
    {"country_code":"CN","bid_rate":0.6}
  ]
}
// mtgid별 입찰:
{
  "offer_id": 123, 
  "bid_rate":3.2, 
  "bid_rate_by_mtgid": [
    {"country_code":"CN,AE","bid_rate":0.5,"mtgid":"mtg123456"},
    {"country_code":"CN","bid_rate":0.6,"mtgid":"mtg654321"}
  ]
}

요청 파라미터

Fields	Type	Explanations	Default Value	Examples
offer_id	int	오퍼의 고유 ID	—	`123`
bid_rate `Optional`	float	모든 오퍼 타깃 지역에 적용되는 기본 입찰가입니다. 특정 지역 또는 앱 입찰가가 설정되지 않은 경우에만 적용됩니다. 0보다 큰 소수점 셋째 자리까지의 float 값을 사용할 수 있습니다. CPE/CPI/CPM 입찰 유형은 0.01보다 커야 하며, CPC 입찰 유형은 0.001보다 커야 합니다.	—	`5.22`
bid_rate_by_location `Optional`	array<json>	특정 지역의 입찰가입니다. 참고: 입찰가가 필요한 모든 지역을 제출하세요. 요청에 포함되지 않은 지역은 기본 입찰가로 설정됩니다.	—	특정 지역 입찰가를 취소하려면 이 필드를 비워 두세요. 예: bid_rate_by_location = []
country_code	string	입찰 설정 대상 지역입니다. 타깃 지역은 오퍼의 지역에 포함되어야 합니다.	—	`"CN,US"`
bid_rate	float	특정 지역의 입찰가입니다.	—	`3.21`
bid_rate_by_mtgid `Optional`	array<json>	특정 퍼블리셔의 입찰가입니다. 참고: 1. 고급 기능이므로 “permission denied”가 반환되면 AM에게 접근 권한을 요청하세요. 2. 특정 퍼블리셔의 입찰가를 취소하려면 이 필드를 비워 두세요. 3. 입찰가가 필요한 모든 mtgid를 제출하세요. 요청에 포함되지 않은 mtgid는 기본 입찰가로 설정됩니다.	—	특정 퍼블리셔 입찰가를 취소하려면 이 필드를 비워 두세요. 예: bid_rate_by_mtgid = []
country_code	float	타깃 지역	—	`"CN"`
bid_rate	float	특정 지역 내 특정 퍼블리셔의 입찰가	—	`3.21`
mtgid	float	퍼블리셔의 고유 ID	—	`"mtg123456"`

참고:

1 bid_rate의 정밀도는 0.001입니다.

2 Bid rate의 최솟값은 bid_type과 관련이 있습니다.
> A) 오퍼의 bid type이 "CPI", "CPE", "CPM"인 경우 최소 bid rate는 0.01입니다.
> B) 오퍼의 bid type이 "CPC"인 경우 최소 bid rate는 0.001입니다.

3 bid_rate와 bid_rate_by_location을 동시에 null로 둘 수 없습니다.

4 bid_rate 값을 변경하여 오퍼의 기본 가격을 업데이트할 수 있습니다.

5 bid_rate_by_location 값을 변경하여 특정 지역의 가격을 업데이트할 수 있습니다.

6 특정 지역 가격을 삭제해야 하는 경우 "bid_rate_by_location"을 null로 두세요. 예: bid_rate_by_location = [].

7 이 API는 전체 업데이트 방식을 사용합니다. 지역 또는 mtgid별 입찰가를 제출할 때는 전체 설정을 제출하세요.

응답

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

응답 예시

json Copy

{
  "msg": "success",
  "code": 200,
  "data": {
    "id": 123
  }
}

이전의

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

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

최근 수정됨: 2026-08-06

개요