들어 오세요
메뉴

API: 캠페인 업데이트하기(기술 가이드)

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

캠페인 정보를 업데이트합니다.

요청 주소

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

요청 메서드

PUT

요청 예시

json Copy 
PUT /api/open/v1/campaign
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{
  "campaign_id": 1234,
  "is_coppa": "YES",
  "campaign_name": "Test",
  "promotion_type": "APP",
  "product_name": "Test",
  "package_name": "id333206289",
  "description": "Test",
  "icon": "f7c970d0d24c71d84d15a78f29042323",
  "category": "BUSINESS",
  "app_size": 12.13,
  "min_version": "1.0.0"
 }

요청 파라미터

Fields Type Explanations Default Value Examples
campaign_id int 캠페인의 고유 ID — 1234
campaign_name Optional string 캠페인에 대한 짧은 설명입니다. 캠페인명은 고유해야 하며 최대 길이는 100자입니다. — "Test_campaign_name"
promotion_type Optional string 홍보하려는 광고 목표 유형입니다. "APP" 또는 "WEBSITE" 중 하나일 수 있습니다. — "APP"
is_coppa Optional string 캠페인이 아동을 대상으로 하는 경우, 해당 캠페인이 COPPA 요건을 충족하는지 지정해야 합니다. 포함 값: "YES", "NO". "" "YES"
icon Optional string 로고 또는 아이콘의 MD5입니다. 크리에이티브 업로드 API를 통해 이미지를 성공적으로 업로드한 후 MD5를 받을 수 있습니다.
참고: jpg, png, jpeg, bmp 파일만 허용되며, 크기는 512x512이고 5MB 이하여야 합니다.		 "" "f7c970d0d24c71d84d15a78f29042323"
product_name Optional string 앱 이름 또는 웹사이트 이름입니다. 이 필드의 최대 길이는 100자입니다. — —
package_name Optional string 앱의 번들 ID 또는 iOS App Store ID입니다.
참고: platform="IOS"이고 alive_in_store="YES"인 경우 package name은 App Store ID여야 합니다.
platform="ANDROID"인 경우 package name은 번들 ID여야 합니다.		 — android: "com.tencent.mm"
ios: "id414478124"
app_size Optional number 앱 크기이며 단위는 MB입니다. 광고 목표가 웹사이트인 경우 이 필드는 비워두세요. — 12.34
category Optional string 광고 목표의 카테고리입니다. 카테고리는 플랫폼별로 다릅니다. 다음을 확인하세요.
[ENUM-Category for iOS]
[ENUM-Category for Android].		 — "GAMES"
min_version Optional string 허용되는 최소 OS 버전이며 형식은 /^[0-9](\.[0-9]){0,2}$/입니다.
참고: 광고 목표가 웹사이트인 경우 이 필드는 비워두세요.		 — "1.0.0"
description Optional string 광고 목표에 대한 설명입니다. 이 필드의 최대 길이는 4000자입니다. — "Test"

응답

Fields Type Explanations
code int 200이면 성공입니다. 그 외 코드는 실패를 의미합니다.
msg string 성공 시 "success"를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data json 성공 시 캠페인 데이터를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
campaign_id int 캠페인의 고유 ID
campaign_name string 추가한 캠페인명
is_coppa string COPPA 설정 값
promotion_type string 설정한 프로모션 유형
alive_in_store string 설정한 “alive in store” 값
preview_url string 캠페인에 추가한 미리보기 링크
product_name string 광고 목표 이름
package_name string 홍보하려는 애플리케이션의 iOS App Store ID 또는 번들 ID
description string 광고 목표 설명
icon string 아이콘 또는 로고의 MD5
platform string 캠페인 플랫폼
category string 캠페인 카테고리
app_size string 애플리케이션 크기
min_version string 최소 OS 버전

응답 예시

json Copy 
{
  "msg": "success",
  "code": 200,
  "data": {
    "campaign_id": 1234,
    "is_coppa": "YES",
    "campaign_name": "Test",
    "promotion_type": "APP",
    "alive_in_store": "YES",
    "preview_url": "https://play.google.com/store/apps/details?id=xxxxxxx",
    "product_name": "Test",
    "package_name": "com.tencent.mm",
    "description": "Test",
    "icon": "f7c970d0d24c71d84d15a78f29042323",
    "platform": "ANDROID",
    "category": "GAMES",
    "app_size": "12.13",
    "min_version": "1.0.0"
  }
}
이전의
API: 캠페인 생성하기(기술 가이드)
다음
API: 오퍼 시작하기(기술 가이드)
최근 수정됨: 2026-08-06