메뉴

API: Creative Set 생성하기(기술 가이드)

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

Mintegral API를 사용해 새 크리에이티브 세트를 생성하는 방법은 다음과 같습니다.

요청 주소

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

요청 메서드

POST

요청 예시

json Copy

POST /api/open/v1/creative_set HTTP/1.1
Host: ss-api.mintegral.com
Content-Type: application/json

{
    "creative_set_name": "test_create_group_1",
    "offer_id": 100,
    "geos": [
        "ALL"
    ],
    "ad_outputs": [
        211,
        212,
        213
    ],
    "creatives": [
        {
            "creative_name": "test_creative_1",
            "creative_md5": "abcd"
        },
        {
            "creative_name": "test_creative_2",
            "creative_md5": "cdfg"
        }
    ]
}

요청 파라미터

field	dataType	isRequired	desc	defaultValue
creative_set_name	string	Y	크리에이티브 세트 이름	-
combination_method	int	N	creative_set의 조합 방식: 1: 프로그래매틱 크리에이티브 세트 2: 맞춤형 크리에이티브 세트	`1`
offer_id	int	N	크리에이티브 세트 생성 후 바인딩하려는 오퍼	—
geos	array<string>	N	크리에이티브 세트가 사용되는 국가/지역	`["ALL"]`
ad_outputs	array<int>	Y	크리에이티브 세트가 조합할 것으로 예상되는 광고 출력 유형은 아래를 참고하세요. [ENUM Ad Output]	-
creatives	array<object>	Y	크리에이티브 세트에 바인딩된 크리에이티브 목록	-
creative_name	string	Y	크리에이티브 세트 내 크리에이티브 이름	-
creative_md5	string	Y	크리에이티브 콘텐츠 MD5	-

응답

field	dataType	desc
code	int	200이면 성공입니다. 그 외 코드는 실패를 의미합니다.
msg	string	성공 시 "success"를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data	json	성공 시 "success"를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
creative_set_name	string	creative_set_name
creative_set_id	int	creative_set_id
offer_id	int	offer_id

응답 예시

json Copy

{
  "msg": "success",
  "code": 200,
  "data": {
    "creative_set_name": "test_create_group_1",
    "creative_set_id": 2001,
    "offer_id": 100
  }
}

이전의

API: Creative Set 데이터 조회하기(기술 가이드)

API: Creative Set 삭제하기(기술 가이드)

최근 수정됨: 2026-08-06

개요