들어 오세요
메뉴

API: 캠페인 생성하기(기술 가이드)

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

홍보하려는 광고 목표를 생성합니다. 광고 목표는 앱 또는 웹사이트일 수 있습니다.

요청 주소

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

요청 메서드

POST

요청 예시

json Copy 
POST /api/open/v1/campaign
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{
  "campaign_name": "Test",
  "is_coppa": "YES",
  "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": "BUSINESS",
  "app_size": 12.13,
  "min_version": "1.0.0"
}

요청 파라미터

참고: 기본값이 비어 있는 경우 아래 표에는 "—"로 표시됩니다.

Fields Type Explanations Default Value Examples
campaign_name string 캠페인에 대한 짧은 설명입니다. 캠페인명은 고유해야 하며 최대 길이는 100자입니다. — "Test_campaign_name"
promotion_type string 홍보하려는 광고 목표 유형입니다. "APP" 또는 "WEBSITE" 중 하나일 수 있습니다. — "APP"
preview_url string 광고 대상의 미리보기 링크입니다.
참고:
1. promotion_type="APP"이고 alive_in_store="YES"인 경우, 미리보기 링크를 사용해 애플리케이션 정보를 자동으로 가져옵니다. 여기에는 product_name, package_name, description, icon, platform, category, app_size, min_version이 포함됩니다.
2. 프로모션에는 사용자가 추가한 값보다 시스템이 수집한 애플리케이션 정보를 우선 사용합니다. 미리보기 링크에서 정보를 가져오지 못하면 사용자가 설정한 값을 사용합니다.		 android: "https://play.google.com/store/apps/details?id=com.tencent.mm&hl=zh"
ios: "https://apps.apple.com/cn/app/%E6%94%AF%E4%BB%98%E5%AE%9D-%E8%AE%A9%E7%94%9F%E6%B4%BB%E6%9B%B4%E7%AE%80%E5%8D%95/id333206289"
is_coppa string 캠페인이 아동을 대상으로 하는 경우, 해당 캠페인이 COPPA 요건을 충족하는지 지정해야 합니다. 선택 값: "YES", "NO". — "YES"
alive_in_store string 홍보하려는 앱이 이미 Google Play 또는 iOS App Store에 출시되어 있는지 지정합니다. 선택 값: "YES", "NO". — "YES"
icon string 로고 또는 아이콘의 MD5입니다. 크리에이티브 업로드 API를 통해 이미지를 성공적으로 업로드한 후 MD5를 받을 수 있습니다.
참고: jpg, png, jpeg, bmp 파일만 허용되며, 크기는 512x512이고 5MB 이하여야 합니다.		 — "f7c970d0d24c71d84d15a78f29042323"
product_name string 앱 이름 또는 웹사이트 이름입니다. 이 필드의 최대 길이는 100자입니다. — "product_name_test"
package_name 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 number 앱 크기이며 단위는 MB입니다. 광고 목표가 웹사이트인 경우 이 필드는 비워두세요. — 12.34
platform string 광고를 홍보할 플랫폼입니다. 선택 값은 "IOS"와 "ANDROID"이며, 둘 중 하나만 선택할 수 있습니다. — "IOS"
category string 광고 목표의 카테고리입니다. 카테고리는 플랫폼별로 다릅니다. 다음을 확인하세요.
[ENUM-Category for iOS]
[ENUM-Category for Android].		 — "GAMES"
min_version string 허용되는 최소 OS 버전이며 형식은 /^[0-9](\.[0-9]){0,2}$/입니다. 참고: 광고 목표가 웹사이트인 경우 이 필드는 비워두세요. — "1.0.0"
description 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": "BUSINESS",
    "app_size": "12.13",
    "min_version": "1.0.0"
  }
}
이전의
API: 캠페인 목록 조회하기(기술 가이드)
다음
API: 캠페인 업데이트하기(기술 가이드)
최근 수정됨: 2026-08-06