메뉴

API: 크리에이티브 업데이트하기(기술 가이드)

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

Mintegral API를 사용해 오퍼의 크리에이티브를 업데이트하는 방법은 다음과 같습니다. 크리에이티브의 사이즈, 형식, 종횡비 요건에 대한 자세한 내용은 부록을 참고하세요.
Appendix - Creative Dimension.

요청 주소

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

이 인터페이스는 곧 사용 중단될 예정입니다. API—Create Creative Set을 사용하세요.

요청 메서드

PUT

요청 예시

json Copy

PUT /api/open/v1/offer/apply_creative
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{
  "offer_id": 123,
  "ad_type": "REWARDED_VIDEO",
  "creative": [
    {
      "creative_md5":"0a6335cd9151ac5dc79ad996f4e12674",
      "creative_name":"creative_test.png" ,
      "apply_in_area": "CN,EN",
      "option": "ENABLE"
    }
  ]
}

요청 파라미터

Fields	Type	Explanations	Default Value	Examples
offer_id	int	오퍼 ID	—	`123`
ad_type	string	타깃 광고 유형입니다. 여러 광고 유형은 쉼표로 구분합니다. 열거 값은 다음을 참고하세요. [ENUM-ad type(static)] [ENUM-ad type(video)]	—	`"REWARDED_VIDEO"`
creative	array<json>
creative_md5	string	업로드 후 생성된 Creative MD5입니다. 기본적으로 파일명으로 사용됩니다. creative name은 영문자, 숫자 또는 밑줄이어야 합니다.	—	`"0a6335cd9151ac5dc79ad996f4e12674"`
creative_name	string	업로드 후 생성된 Creative name입니다.	—	`"creative_test"`
apply_in_area	string	특정 크리에이티브의 타깃 지역입니다. 타깃 지역은 오퍼의 target_geo에 포함되어야 합니다. PS: 1. 오퍼의 모든 지역을 타기팅하려면 "ALL"로 설정합니다. 2. 여러 타깃 지역은 쉼표로 구분합니다.	—	`"CN,EN"`
creative_set_name `Optional`	string	크리에이티브 세트 이름	—	`"default"`
option	string	오퍼 내 크리에이티브 상태입니다. 열거 값: `"ENABLE"`, `"DISABLE"`. `ENABLE`: 오퍼에서 크리에이티브 실행을 허용합니다. `DISABLE`: 특정 오퍼에서 크리에이티브를 일시 중지하고 제거합니다. 참고: 새 오퍼를 설정할 때는 "ENABLE"로 설정하세요.	—	`"DISABLE"`

응답

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

응답 예시

json Copy

{
  "msg": "success",
  "code": 200,
  "data": ["success"]
}

이전의

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

API: 오디언스 타겟 업데이트하기(기술 가이드)

최근 수정됨: 2026-08-06

개요