메뉴

API: 이벤트 가져오기(기술 가이드)

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

요청 주소

https://ss-api.mintegral.com/api/open/v3/event/bid_goal_supports

요청 메서드

GET

요청 예시

json Copy

-- campaign_id
GET /api/open/v3/event/bid_goal_supports
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
 {
  "campaign_id": 1234,
  "bid_goal": "Target-ROAS"
 }


-- package_name
GET /api/open/v3/event/bid_goal_supports
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
 {
  "package_name": "com.mtg.adv",
  "bid_goal": "Target-ROAS"
 }

요청 파라미터

Fields	Need	Type	Explanations	Examples
campaign_id	No	int	캠페인 ID	1234
package_name	No	string	패키지명. 여러 개는 쉼표로 구분합니다.	com.mtg.adv
bid_goal	Yes	string	최적화 타깃 유형입니다. 열거 값: target-CPE, target-ROAS	Target-CPE

참고: package_name 또는 campaign_id 중 최소 하나를 제공해야 합니다. 둘 다 비워둘 수 없습니다.

응답

Fields	Type	Explanations
code	int	200이면 성공입니다. 그 외 코드는 실패를 의미합니다.
msg	string	성공 시 "success"를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data	object	성공 시 오퍼 데이터를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data.support_events	array<json>	지원되는 이벤트 정보
data.support_events[].original_event	string	원본 이벤트명입니다. bid_goal이 Target-ROAS인 경우 이 필드는 반환되지 않습니다.
data.support_events[].mtg_event	string	MTG 표준 이벤트명
data.support_events[].target_goal_window	array<string>	최적화 목표의 시간 윈도우

응답 예시

json Copy

{
  "code": 200,
  "msg": "success",
  "data": {
    "support_events": [
      {
        "mtg_event": "Purchase",
        "target_goal_window": ["D0"]
      },
      {
        "mtg_event": "Ad Revenue",
        "target_goal_window": ["D0", "D7"]
      }
    ]
  }
}

이전의

API: 이벤트

API: Creative Set(기술 가이드

최근 수정됨: 2026-08-06

개요