API: Obtain Events (Technical Guide)

Label：API ,API key ,developer guide ,technical guide ,obtain events

You need to use your Mintegral token to manage your offers. For more details, please check Token.

Request address

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

Request method

GET

Request example

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"
 }

Request Parameter

Fields	Need	Type	Explanations	Examples
campaign_id	No	int	Campaign id	1234
package_name	No	string	Package name, multiple separated by commas	com.mtg.adv
bid_goal	Yes	string	Optimize Target type, enumerate values: target-CPE, target-ROAS	Target-CPE

Note：At least one of package_name or campaign_id must be provided (cannot both be empty)

Response

Fields	Type	Explanations
code	int	200 code, is success. Others, are fail.
msg	string	If success, return to "success". If fail, return to detailed wrong info.
data	object	If success, return to offer data. If fail, return to detailed wrong info.
data.support_events	array<json>	Supported event information
data.support_events[].original_event	string	Original event name, if bid_goal is Target-ROAS, this field is not returned
data.support_events[].mtg_event	string	MTG standard event name
data.support_events[].target_goal_window	array<string>	The time window of the optimization goal

Response Example

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: Event

API: Creative Set (Technical Guide

Last modified: 2025-08-28

Outline