Mintegral Developer Interface Documentation

Document description

Document Description

This document is an introduction for SDK developers to use API to create APP and unit information in Mintegral developer platform;
This version does not provide test environment. Developers can use the formal interface URL for testing.

Module Descriptions

Media module: media addition and media editing features
Ad placement module: ad placement addition and ad placement editing features New!
Ad unit module: ad unit addition and ad unit editing features

Interface Details

API Request 

Request Protocol

Any interface that is present or related to this document must follow the HTTPs protocol, all requests’ ContentType is application/x-www-form-urlencoded and all responses’ ContentType is application/json.

Request Method

The request method for all interface should be POST or GET.

Request General Parameters

Below are general parameters that are applicable for all interfaces:

Name	Type	Description
skey	string	Developer’s skey on Mintegral platform.
time	string	The unix timestamp for when the request is initiated, valid time is ±300 seconds.
sign	string	Signature. Signature generation guidelines can be found in appendix 1.

API Response

Response JSON data includes information as shown in table below

Name	Type	Description
code	int	Returned value.0 indicates success. More values can be found in appendix 7.
msg	string	Returned message. Detailed error message will be displayed in this field.
data	json array or json object	Returned data.

Media Module

Create media

Request URL: https://dev.mintegral.com/app/open_api_create
Request method: POST

Request parameters:

Name	Type	Required	Description
app_name	string	Required	Media name intended to be unique among all media names in the same publisher account.
os	string	Required	Operating system. Enumeration values refer to appendix 3.
package	string	Required	Media’s respective package name intended to be unique among all package names in the same account. iOS sample: id1364356863 Android sample: com.talkingtom
is_live_in_store	int	Required	Whether live in app store(s). Enumeration values are as below: 1-yes; 0-no; if value equals 1, store url must be presented in the store_url field.
store_url	string	Required for applications live in app store(s)	App store link.
coppa	int	Required	Whether abides to COPPA. Enumeration values are as below: 1-yes; 0-no;
campaign_black_rule	int	Optional;default value equals 1;	Ad blacklist rule. Enumeration values are as below: 0—not setting up blacklist 1-inherit publisher level blacklist 2—set up individually If campaign_black_rule equals 2, at least one of the following fields must be filled in: black_category, black_mtg_category, black_packagename, black_adv_domain, or black_website_domain.
black_category	string	Optional	Blacklist based on market category. Enumeration values can be found in the appendix.  This field is used when black_enable_category_type equals 1. Separate category IDs with commas; e.g.: black_category=11,12,13 If campaign_black_rule equals 2, at least one of the following fields must be filled in: black_category, black_mtg_category, black_packagename, black_adv_domain, or black_website_domain.
black_enable_category_type	int	Optional;default value equals 1;	Category blacklist type. Enumeration values are as below: 1-market category, use black_category; 2-Mintegral category, use black_mtg_category.
black_mtg_category	string	Optional	Blacklist based on Mintegral level 3 category. Enumeration values can be found in appendix 2.1.  Separate level 3 category codes with commas; e.g.: black_mtg_category=6010201,6010202 If black_enable_category_type equals 2, use this field.
black_packagename	string	Optional	Blacklists based on package name. Separate package names by commas; iOS sample: id1364356863,id1364356865,id1364356867 Android sample: com.talkingtom,com.talkinglily,com.talkinglucy If campaign_black_rule equals 2, at least one of the following fields must be filled in: black_category, black_mtg_category, black_packagename, black_adv_domain, or black_website_domain.
black_adv_domain	string	Optional	Blacklists based on advertiser's domain name, separate by commas; Mintegral will block all products related to the identified domain name, for example, fill in advertiser.com. If campaign_black_rule equals 2, at least one of the following fields must be filled in: black_category, black_mtg_category, black_packagename, black_adv_domain, or black_website_domain.
black_website_domain	string	Optional	Enter the website domains to block, separated by commas. Mintegral will not return ads from these domains; If campaign_black_rule equals 2, at least one of the following fields must be filled in: black_category, black_mtg_category, black_packagename, black_adv_domain, or black_website_domain.
auto_storekit	int	Optional	Whether automatic display of storekit is permitted. Enumeration values are as below: 1-yes(Default); 0-no;
mediation_platform	int	Optional	Mediation Platform. Enumeration values can be found in the appendix 5. Default: 0 (Others)
video_orientation	string	Optional	Orientation of returned video. Enumeration values include "portrait", "landscape", "both". Default: "both"
store	string	Optional	App Store Name. Enumeration values can be found in the appendix 8. Default iOS App Store: app_store Default Android App Store: google_play

Response parameters:

Name	Type	Description
code	int	Returned value. 200 indicates success.
msg	string	Returned message. Detailed error message will be displayed in this field.
data	json array or json object	Returned data.
publisher_id	int	Developer ID.
app_name	int	Media name.
app_id	int	App ID for respective media created on Mintegral platform.
warning	string	This field will be present if blacklist setup fails.

Response sample：

 
{
    "code": 200,
    "data": {
        "app_id": 209,
        "publisher_id": 123,
        "app_name": "App Name"
    }
}

Edit Media

Request URL: https://dev.mintegral.com/app/open_api_edit
Request method: POST

Request parameters:

Name	Type	Required	Description
app_id	int	Required	Media ID on Mintegral platform
app_name	string	Optional	Media name will only be updated when this field is presented.
package	string	Optional	Media’s respective package name intended to be unique among all package names in the same account. iOS sample: id1364356863 Android sample: com.talkingtom
is_live_in_store	int	Optional	Information on whether live in app store(s) will only be updated when this field is presented. If value equals 1, store_url must be provided 1-yes; 0-no;
store_url	string	Required for applications live in app store(s)	Appstore link
coppa	int	Required	Information on whether abides to COPPA will only be updated if this filled is presented. 1-yes; 0-no;
campaign_black_rule	int	Optional	Ad blacklist rule will only be updated if this field is presented. Enumeration values are as below: 0—not setting up blacklist 1-inherit publisher level blacklist 2—set up individually If campaign_black_rule equals 2, at least one of the following fields must be filled in: black_category, black_mtg_category, black_packagename, black_adv_domain, or black_website_domain.
black_category	string	Optional	Blacklist based on market category. Enumeration values can be found in the appendix 2.  This field is used when black_enable_category_type equals 1. Separate category IDs with commas; e.g.: black_category=11,12,13 If campaign_black_rule equals 2, at least one of the following fields must be filled in: black_category, black_mtg_category, black_packagename, black_adv_domain, or black_website_domain.
black_enable_category_type	int	Optional	Category blacklist type will only be updated if this field is presented. 1-market category, use black_category; 2-Mintegral category, use black_mtg_category.
black_mtg_category	string	Optional	Blacklist based on Mintegral level 3 category will only be updated if this field is presented. Enumeration values can be found in appendix 2.1.  Separate level 3 category codes with commas; e.g.: black_mtg_category=6010201,6010202
black_packagename	string	Optional	Blacklists based on package name. Separate package names by commas; iOS sample: id1364356863,id1364356865,id1364356867 Android sample: com.talkingtom,com.talkinglily,com.talkinglucy If campaign_black_rule equals 2, at least one of the following fields must be filled in: black_category, black_mtg_category, black_packagename, black_adv_domain, or black_website_domain.
black_adv_domain	string	Optional	Blacklists based on advertiser's domain name, separate by commas; Mintegral will block all products related to the identified domain name, for example, fill in advertiser.com. If campaign_black_rule equals 2, at least one of the following fields must be filled in: black_category, black_mtg_category, black_packagename, black_adv_domain, or black_website_domain.
black_website_domain	string	Optional	Enter the website domains to block, separated by commas. Mintegral will not return ads from these domains; If campaign_black_rule equals 2, at least one of the following fields must be filled in: black_category, black_mtg_category, black_packagename, black_adv_domain, or black_website_domain.
auto_storekit	int	Optional	Whether automatic display of storekit is permitted. Enumeration values are as below: 1-yes(Default); 0-no;
mediation_platform	int	Optional	Mediation Platform. Enumeration values can be found in the appendix 5.
video_orientation	string	Optional	Orientation of returned video. Enumeration values include "portrait", "landscape", "both". Default: "both"
store	string	Optional	App Store Name. Enumeration values can be found in the appendix 8.

Response parameters:

Name	Type	Description
code	int	Returned value. 200 indicates success.
msg	string	Returned message. Detailed error message will be displayed in this field.
data	json array or json object	Returned data.
publisher_id	int	Developer ID.
app_id	int	Media name.
app_name	int	App ID for respective media created on Mintegral platform.
is_live_in_store	int	Whether live in app store(s) . 1-yes; 0-no;
store_url	string	Appstore link.
coppa	int	Whether abides to COPPA. 1-yes; 0-no;
campaign_black_rule	int	Ad blacklist rules.
black_category	string	Blacklist based on market category.
black_packagename	string	Blacklist based on package name.
warning	string	This field will be present if blacklist setup fails.

Response sample：

    
{
    "code": 200,
    "data": {
        "app_id": 209,
        "app_name": "App Name",
        "is_live_in_store": 0,
        "store_url": "https://play.google.com/store/apps/details?id=com.live.live4d",
        "coppa": 0,
        "campaign_black_rule": 0,
        "black_category": "",
        "black_packagename": "",
        "publisher_id": 5059
    }
}

Media List

Request URL: https://dev.mintegral.com/v2/app/open_api_list
Request method: GET

Request parameters:

Name	Type	Required	Description
package	string	Optional	Media Package name.
os	string	Optional	Operating system. Enumeration values refer to appendix 3.

Response parameters:

Name	Type	Description
code	int	Returned value. 200 indicates success.
msg	string	Returned message. Detailed error message will be displayed in this field.
data	json array or json object	Returned data.
total	int	Total Number of Apps.
lists	json array or json object	Media List.
app_id	int	App ID for respective media created on Mintegral platform.
app_name	string	App Name for respective media created on Mintegral platform.
package	string	Media Package name.
os	string	Operating system. Enumeration values refer to appendix 3.

Response sample：

    
{
    "code": 200,
    "data": {
        "total": 1,
        "page": 1,
        "per_page": 5000,
        "lists": [
            {
                "app_id": 18111,
                "app_name": "app_namexxxx",
                "package": "com.xxx.gp",
                "os": "ANDROID"
            }
        ]
    }
}

Placement

Create Ad Placement

Request URL：https://dev.mintegral.com/v2/placement/open_api_create
Request method: POST

Request Parameters:

Name	Type	Required	Description
app_id	int	Required	Media ID.
placement_name	string	Required	Ad Placement name.
ad_type	string	Required	Ad unit ad format. Enumeration values include "rewarded_video", "new_interstitial", "native", "static_interstitial", "banner", "automatic_rendering_native", "splash_ad".
integrate_type	string	Required	Integration type. Value only supports "sdk", which means integrate via SDK;
content_type	string	If ad_type = "native" or "automatic_rendering_native" or "new_interstitial", it is optional.	Content type. Enumeration values include "image", "video", "both". Default: "both"
video_orientation	string	If ad_type = "native", it is optional.	Orientation of returned video. Enumeration values include "portrait", "landscape", "both". Default: "landscape"
show_close_button	int	If ad_type = "banner", it is optional.	Whether show the close button: 1-yes; 0-no;(Default)
auto_fresh	int	If ad_type = "banner", it is optional.	When Auto Refresh is turned on, new ads are automatically requested and displayed to users at intervals. 1-turn on; 0-turn off;(Default)
ad_space_type	int	If ad_type = "new_interstitial", it is optional.	Ad Size. 1-Full Screen Interstitial;(Default) 2-Half Screen Interstitial;
unit_names	string	One of "unit_names" and "hb_unit_name" is Required.	“unit_names" are used for traditional units (non-bidding units) Separate unit_names with commas; e.g.: unit_names=unit_name1,unit_name2 This does not provide ad unit names with commas
hb_unit_name	string	One of "unit_names" and "hb_unit_name" is Required.	"hb_unit_name" is the unit which is used for header bidding.
skip_time	int	Optional	This setting only displays when there is a "video resource" in the ad. (New Interstitial with the setting of fullscreen video, etc.) -1 - Non Skippable; 0~30 - Close button will appear after `skip_time` seconds.

Response parameters:

Name	Type	Description
code	int	Returned value. 200 indicates success.
msg	string	Returned message. Detailed error message will be displayed in this field.
data	json array or json object	Returned data.
publisher_id	int	Developer ID.
app_id	int	Media ID.
placement_id	int	Ad Placement Id.
placement_name	string	Ad placement name.
unit_ids	array	Ad Unit ID.

Response sample：

    
{
    "code": 200,
    "data": {
        "placement_id": 4888,
        "unit_ids": [
            1238888,
            1238889
        ],
        "publisher_id": 1999,
        "app_id": 8888,
        "placement_name": "native_plm"
    }
}

Edit Ad Placement

Request URL：https://dev.mintegral.com/v2/placement/open_api_edit
Request method: POST

Request Parameters:

Name	Type	Required	Description
app_id	int	Required	Media ID.
placement_id	int	Required	Ad Placement ID.
placement_name	string	Optional	Ad Placement name.
content_type	string	If ad_type = "native" or "new_interstitial", it is optional.	Content type. Enumeration values include "image", "video", "both".
video_orientation	string	If ad_type = "native", it is optional.	Orientation of returned video. Enumeration values include "portrait", "landscape", "both".
show_close_button	int	If ad_type = "banner", it is optional.	Whether show the close button: 1-yes; 0-no;
auto_fresh	int	If ad_type = "banner", it is optional.	When Auto Refresh is turned on, new ads are automatically requested and displayed to users at intervals. 1-turn on; 0-turn off;
ad_space_type	int	If ad_type = "new_interstitial", it is optional.	Ad Size. 1-Full Screen Interstitial; 2-Half Screen Interstitial;
skip_time	int	Optional	This setting only displays when there is a "video resource" in the ad. (New Interstitial with the setting of fullscreen video, etc.) -1 - Non Skippable; 0~30 - Close button will appear after `skip_time` seconds.

Response parameters:

Name	Type	Description
code	int	Returned value. 200 indicates success.
msg	string	Returned message. Detailed error message will be displayed in this field.
data	json array or json object	Returned data.
publisher_id	int	Developer ID.
app_id	int	Media ID.
placement_id	int	Ad Placement ID.
placement_name	string	Ad placement name.

Response sample：

    
{
    "code": 200,
    "data": {
        "placement_id": 128888,
        "publisher_id": 5888,
        "app_id": 288,
        "placement_name": "Placement Name"
    }
}

Delete Ad Placement 

Request URL: https://dev.mintegral.com/v2/placement/open_api_delete
Request method: POST

Request parameters:

Name	Type	Required	Description
placement_ids	string	Required	Ad placement IDs. Separate Ad Placement IDs with commas; e.g.: placement_ids=1,2,3

Name

Type

Required

Description

placement_ids

string

Required

Ad placement IDs.

Separate Ad Placement IDs with commas; e.g.: placement_ids=1,2,3

Response parameters:

Name	Type	Description
code	int	Returned value.0 indicates success. More values can be found in appendix 7.
msg	string	Returned message. In case of error, this field displays the detailed error message
data	json array or json object	Returned data. Returns the ID of corresponding action
publisher_id	int	Developer ID.

Response sample：

 
{
    "code": 200,
    "data": {
        "publisher_id": 123
    }
}

Ad Placement List

Request URL: https://dev.mintegral.com/v2/placement/open_api_list
Request method: GET

Request parameters:

Name	Type	Required	Description
app_id	int	Optional	Media ID

Response parameters:

Name	Type	Description
code	int	Returned value. 200 indicates success.
msg	string	Returned message. Detailed error message will be displayed in this field.
data	json array or json object	Returned data.
total	int	Total Number of Ad Placements.
lists	json array or json object	Ad Placement List.
placement_id	int	Ad Placement ID created on Mintegral platform.
placement_name	string	Ad Placement Name created on Mintegral platform.
app_id	int	App ID created on Mintegral platform.
ad_type	string	Ad unit ad format. 

Response sample：

    
{
    "code": 200,
    "data": {
        "total": 2,
        "page": 1,
        "per_page": 5000,
        "lists": [
            {
                "placement_id": 574096,
                "placement_name": "原生max",
                "app_id": 176359,
                "ad_type": "native"
            },
            {
                "placement_id": 559486,
                "placement_name": "原生分层",
                "app_id": 176359,
                "ad_type": "automatic_rendering_native"
            }
        ]
    }
}

Ad Unit Module

Create Ad Unit

* Recommended to use the v2 interface to create unit -> Create Placement Unit Interface

Create Placement Unit

Request URL：https://dev.mintegral.com/v2/unit/open_api_create
Request method: POST

Request Parameters:

Name	Type	Required	Description
app_id	int	Required	Media ID.
placement_id	int	Required	Placement ID.
bidding_type	int	Optional	Biddinig Type, access needs to be applied for separately. 1-Header Bidding; 0-Traditional(Default);
unit_name	string	Required	Ad unit name.
target_ecpm	array	Optional	Target Ecpm, access needs to be applied for separately. Format: the keys are country codes, Uppercase only, Enumeration keys include "ALL" and country codes, such as "US","CN". For all country codes, please refer to Country, and values should be numerical. For Example: target_ecpm[AL] = 1 target_ecpm[AX] = 1 target_ecpm[ALL] = 2

Response parameters:

Name	Type	Description
code	int	Returned value. 200 indicates success.
msg	string	Returned message. Detailed error message will be displayed in this field.
data	json array or json object	Returned data.
publisher_id	int	Developer ID.
app_id	int	Media ID.
placement_id	int	Placement ID.
unit_id	int	Unit ID for respective ad placements created on Mintegral platform.
unit_name	string	Ad unit name.

Response sample：

    
{
    "code": 200,
    "data": {
        "placement_id": 5000,
        "unit_id": 1314361,
        "publisher_id": 1234,
        "app_id": 9001039,
        "unit_name": "fullscreen_test"
    }
}

Edit Ad Unit

* Recommended to use the v2 interface to edit unit -> Edit Placement Unit Interface

Edit Placement Unit

Request URL：https://dev.mintegral.com/v2/unit/open_api_edit
Request method: POST

Request Parameters:

Name	Type	Required	Description
app_id	int	Required	Media ID.
placement_id	int	Required	Placement ID.
unit_id	int	Required	Ad Unit ID.
unit_name	string	Optional	Ad Unit name. At least one of unit_name,target_ecpm,clear_target_ecpm is required.
target_ecpm	array	Optional	Target Ecpm, access needs to be applied for separately. Format: the keys are country codes, Uppercase only, Enumeration keys include "ALL" and country codes, such as "US","CN". For all country codes, please refer to Country, and values should be numerical. For Example: target_ecpm[AL] = 1 target_ecpm[AX] = 1 target_ecpm[ALL] = 2 At least one of unit_name,target_ecpm,clear_target_ecpm is required.
clear_target_ecpm	int	Optional	If clear all target ecpm setting or not 1 - clear 0 or other values - not do anyting At least one of unit_name,target_ecpm,clear_target_ecpm is required.

Response parameters:

Name	Type	Description
code	int	Returned value. 200 indicates success.
msg	string	Returned message. Detailed error message will be displayed in this field.
data	json array or json object	Returned data.
publisher_id	int	Developer ID.
app_id	int	Media ID.
placement_id	int	Placement ID.
unit_id	int	Unit ID for respective ad placements created on Mintegral platform.
unit_name	string	Ad unit name.

Response sample：

    
{
    "code": 200,
    "data": {
        "placement_id": 5000,
        "unit_id": 134148,
        "publisher_id": 1234,
        "app_id": 9001039,
        "unit_name": "fullscreen_test"
    }
}

Delete Ad Unit 

Request URL: https://dev.mintegral.com/unit/open_api_delete
Request method: POST

Request parameters:

Name	Type	Required	Description
unit_ids	string	Required	Ad unit IDs. Separate Ad Unit IDs with commas; e.g.: unit_ids=1,2,3

Name

Type

Required

Description

unit_ids

string

Required

Ad unit IDs.

Separate Ad Unit IDs with commas; e.g.: unit_ids=1,2,3

Response parameters:

Name	Type	Description
code	int	Returned value.0 indicates success. More values can be found in appendix 7.
msg	string	Returned message. In case of error, this field displays the detailed error message
data	json array or json object	Returned data. Returns the ID of corresponding action
publisher_id	int	Developer ID.

Response sample：

 
{
    "code": 200,
    "data": {
        "publisher_id": 123
    }
}

Ad Unit List

Request URL: https://dev.mintegral.com/v2/unit/open_api_list
Request method: GET

Request parameters:

Name	Type	Required	Description
placement_id	int	Optional	Ad Placement ID.

Response parameters:

Name	Type	Description
code	int	Returned value. 200 indicates success.
msg	string	Returned message. Detailed error message will be displayed in this field.
data	json array or json object	Returned data.
total	int	Total Number of Ad Units.
lists	json array or json object	Ad Unit List.
unit_id	int	Ad Unit ID created on Mintegral platform.
unit_name	string	Ad Unit Name created on Mintegral platform.
placement_id	int	Ad placement ID created on Mintegral platform.
app_id	int	App ID created on Mintegral platform.
target_ecpm	json array or json object	Target cpm list, For example: target_ecpm[AL] = 1 target_ecpm[AX] = 1 target_ecpm[ALL] = 2
bidding_type	int	Biddinig Type. 1-Header Bidding; 0-Traditional;

Response sample：

    
{
    "code": 200,
    "data": {
        "total": 2,
        "page": 1,
        "per_page": 5000,
        "lists": [
            {
                "unit_id": 11111,
                "unit_name": "native",
                "placement_id": 22222,
                "app_id": 33333,
                "bidding_type": 1,
                "target_ecpm": []
            },
            {
                "unit_id": 11112,
                "unit_name": "test",
                "placement_id": 22222,
                "app_id": 33333,
                "bidding_type": 0,
                "target_ecpm": {
                    "CN": 0.01,
                    "HK": 0.01,
                    "MO": 0.01,
                    "TW": 0.01
                }
            }
        ]
    }
}

Appendix

Appendix1：Sign Generation

The signature string is an important identifier for integration. Developers are required to verify the use of tokens. The generation rule is: md5(SECRETmd5(time))

skey: The agreed private key, which can be found by going to your account page -> API Tools -> Create APP&Unit API
SECRET: The agreed private key, which can be found by going to your account page -> API Tools -> Create APP&Unit API -> Secret
time: The Unix timestamp of when the request was initiated, valid for ±300 seconds

Example

1. Request parameters:

$parameters = [
    'skey'=> 'm79hZT3XYukEI05rWtcU',
    'app_name'=> 'set_app_test_a18DF',
    'coppa'=> '1',
    'package'=> 'test123',
    'store_url'=> '',
    'publisher_id'=> 12792,
    'is_live_in_store'=> 0,
    'time'=> '1563181040',
    'os'=> 'ANDROID'
];
$secret = '99b50cfa3e2ae9ebb276f4e16e26f04b';

2. Sign generation:

md5(SECRETmd5(time)), the generated sign:

f9dc2e2e928be342892e4e823c021777

The SECRET of the above example is: 99b50cfa3e2ae9ebb276f4e16e26f04b

Appendix2: Blacklist Category List

1. Android Apps Blacklist Category List

ID	Blacklist Category List
44 45 5 56 38 6 7 8 46 9 10 40 47 41 11 12 13 14 48 15 16 49 17 18 19 20 37 21 22 23 24 50 25 1 26 27 28 29 39 42 51 30 52 31 43 32 53 33 34 54 35 36 55	Action Adventure Allgames AndroidWear Arcade Art & Design Auto & Vehicles Beauty Board Books & Reference Business Cards Casino Casual Comics Communication Dating Education Educational Entertainment Events Family Finance Food & Drink Health & Fitness House & Home Libraries & Demo Lifestyle Maps & Navigation Medical Music & Audio MusicGames News & Magazines Others Parenting Personalization Photography Productivity Puzzle Racing RolePlaying Shopping Simulation Social SportGames Sports Strategy Tools Travel & Local Trivia VideoPlayers & Editors Weather WordGames

Blacklist Category List

44
45
5
56
38
6
7
8
46
9
10
40
47
41
11
12
13
14
48
15
16
49
17
18
19
20
37
21
22
23
24
50
25
1
26
27
28
29
39
42
51
30
52
31
43
32
53
33
34
54
35
36
55

Action
Adventure
Allgames
AndroidWear
Arcade
Art & Design
Auto & Vehicles
Beauty
Board
Books & Reference
Business
Cards
Casino
Casual
Comics
Communication
Dating
Education
Educational
Entertainment
Events
Family
Finance
Food & Drink
Health & Fitness
House & Home
Libraries & Demo
Lifestyle
Maps & Navigation
Medical
Music & Audio
MusicGames
News & Magazines
Others
Parenting
Personalization
Photography
Productivity
Puzzle
Racing
RolePlaying
Shopping
Simulation
Social
SportGames
Sports
Strategy
Tools
Travel & Local
Trivia
VideoPlayers & Editors
Weather
WordGames

2. iOS Apps Blacklist category list 

ID	Blacklist name
94 77 96 93 92 91 97 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 90 89 95 88 87 86 99 106 105 107 108 109 110 111 112 113 114 101 115 116 102 117 118 119 100 103 120 121 122 123 124 104 125 126 127 2 85 84 83 98 82 81 80 79 78	Book Business Catalogs Education Entertainment Finance Food & Drink Games Games -> Action Games -> Adventure Games -> Arcade Games -> Board Games -> Card Games -> Casino Games -> Dice Games -> Educational Games -> Family Games -> Music Games -> Puzzle Games -> Racing Games -> RolePlaying Games -> Simulation Games -> Sports Games -> Strategy Games -> Trivia Games -> Word Health & Fitness Lifestyle Medical Music Navigation News Newsstand Newsstand -> Arts & Photography Newsstand -> Automotive Newsstand -> Brides & Weddings Newsstand -> Business & Investing Newsstand -> Children's Magazines Newsstand -> Computers & Internet Newsstand -> Cooking,Food & Drink Newsstand -> Crafts & Hobbies Newsstand -> Electronics & Audio Newsstand -> Entertainment Newsstand -> Fashion & Style Newsstand -> Health,Mind & Body Newsstand -> History Newsstand -> Home & Garden Newsstand -> LiteraryMagazines & Journals Newsstand -> Men's Interest Newsstand -> Movies & Music Newsstand -> News & Politics Newsstand -> Outdoors & Nature Newsstand -> Parenting & Family Newsstand -> Pets Newsstand -> Professional & Trade Newsstand -> RegionalNews Newsstand -> Science Newsstand -> Sports & Leisure Newsstand -> Teens Newsstand -> Travel & Regional Newsstand -> Women's Interest Others Photo & Video Productivity Reference Shopping SocialNetworking Sports Travel Utilities Weather

Blacklist name

94
77
96
93
92
91
97
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
90
89
95
88
87
86
99
106
105
107
108
109
110
111
112
113
114
101
115
116
102
117
118
119
100
103
120
121
122
123
124
104
125
126
127
2
85
84
83
98
82
81
80
79
78

Book
Business
Catalogs
Education
Entertainment
Finance
Food & Drink
Games
Games -> Action
Games -> Adventure
Games -> Arcade
Games -> Board
Games -> Card
Games -> Casino
Games -> Dice
Games -> Educational
Games -> Family
Games -> Music
Games -> Puzzle
Games -> Racing
Games -> RolePlaying
Games -> Simulation
Games -> Sports
Games -> Strategy
Games -> Trivia
Games -> Word
Health & Fitness
Lifestyle
Medical
Music
Navigation
News
Newsstand
Newsstand -> Arts & Photography
Newsstand -> Automotive
Newsstand -> Brides & Weddings
Newsstand -> Business & Investing
Newsstand -> Children's Magazines
Newsstand -> Computers & Internet
Newsstand -> Cooking,Food & Drink
Newsstand -> Crafts & Hobbies
Newsstand -> Electronics & Audio
Newsstand -> Entertainment
Newsstand -> Fashion & Style
Newsstand -> Health,Mind & Body
Newsstand -> History
Newsstand -> Home & Garden
Newsstand -> LiteraryMagazines & Journals
Newsstand -> Men's Interest
Newsstand -> Movies & Music
Newsstand -> News & Politics
Newsstand -> Outdoors & Nature
Newsstand -> Parenting & Family
Newsstand -> Pets
Newsstand -> Professional & Trade
Newsstand -> RegionalNews
Newsstand -> Science
Newsstand -> Sports & Leisure
Newsstand -> Teens
Newsstand -> Travel & Regional
Newsstand -> Women's Interest
Others
Photo & Video
Productivity
Reference
Shopping
SocialNetworking
Sports
Travel
Utilities
Weather

Appendix2.1: Mintegral Category List

Values must be separated by commas when multiple category codes are submitted.

ID	Category
6010201	Tools -> Tools-to-earn -> Offer Wall
6010202	Tools -> Tools-to-earn -> Utilities-to-earn-elderly
6010203	Tools -> Tools-to-earn -> News-to-earn
6010204	Tools -> Tools-to-earn -> Utilities-to-earn
6010205	Tools -> Tools-to-earn -> Lead Forms
6011001	Tools -> System Tools -> Accelerator
6011002	Tools -> System Tools -> Cleaner
6011003	Tools -> System Tools -> Utilities
6011004	Tools -> System Tools -> System Customization
6011005	Tools -> System Tools -> Application Store
6011006	Tools -> System Tools -> AI Bot
6020101	Game -> Role Playing -> RPG-agender
6020102	Game -> Role Playing -> RPG-male
6020103	Game -> Role Playing -> RPG-female
6020104	Game -> Role Playing -> Interactive Story
6020201	Game -> Strategy -> 4X
6020202	Game -> Strategy -> Midcore Strategy
6020301	Game -> Hyper Casual -> ASMR
6020302	Game -> Hyper Casual -> Other Hyper Casual
6020303	Game -> Hyper Casual -> Costume
6020401	Game -> Adult -> Adult
6020501	Game -> Action -> Casual Action
6020502	Game -> Action -> Hardcore Action
6020601	Game -> Casino -> Real Money Skill-based Game
6020602	Game -> Casino -> Real-money Casino
6020603	Game -> Casino -> Social-casino
6020701	Game -> Children -> Children
6020801	Game -> Idle -> Roguelike
6020802	Game -> Idle -> Clicker
6020803	Game -> Idle -> Idle Simulation
6020901	Game -> Merge -> Merge Battle
6020902	Game -> Merge -> Merge
6021001	Game -> Management Simulation -> Management
6021002	Game -> Management Simulation -> Casual Management
6021101	Game -> Multiplayer Battle -> Multiplayer Escape Room
6021102	Game -> Multiplayer Battle -> MOBA
6021202	Game -> Racing -> Hardcore Racing
6021203	Game -> Racing -> Casual Racing
6021301	Game -> Party -> Board
6021302	Game -> Party -> Casual Party
6021401	Game -> Card -> Card
6021501	Game -> Parkour -> Hardcore Parkour
6021601	Game -> Game Rewards -> Game Rewards
6021701	Game -> Solitaire -> Solitaire
6021702	Game -> Solitaire -> Chess
6021801	Game -> Shooting -> Arcade Shooter
6021802	Game -> Shooting -> Hardcore Shooting
6021803	Game -> Shooting -> Casual Shooting
6021901	Game -> Tower Defense -> Casual Tower Defense
6021902	Game -> Tower Defense -> Midcore Tower Defense
6021903	Game -> Tower Defense -> Hardcore Tower Defense
6022001	Game -> Sports -> Sports
6022002	Game -> Sports -> Casual Sports
6022101	Game -> Coloring -> Coloring
6022201	Game -> Word -> Word
6022301	Game -> Match -> Match+Strategy
6022302	Game -> Match -> Classical Match
6022303	Game -> Match -> Match+Management
6022401	Game -> Puzzle -> Hardcore Puzzle
6022402	Game -> Puzzle -> Casual Puzzle
6022501	Game -> Music & Rhythm -> Casual Music
6022502	Game -> Music & Rhythm -> Harcore Music
6022601	Game -> Game Box -> Game Box
6022701	Game -> Play-to-earn -> Play-to-earn Casino
6022702	Game -> Play-to-earn -> Play-to-earn Puzzle
6022703	Game -> Play-to-earn -> Play-to-earn Casual
6022704	Game -> Play-to-earn -> Play-to-earn Management
6022801	Game -> Life Simulation -> Life Simulator
6022802	Game -> Life Simulation -> Casual Simulator
6022803	Game -> Life Simulation -> Midcore Simulator
6022901	Game -> Sandbox -> Casual Sandbox
6022902	Game -> Sandbox -> Multiplayer Sandbox
6030101	E-commerce -> E-commerce Platform -> Cross-border E-commerce
6030102	E-commerce -> E-commerce Platform -> E-commerce Platform
6030103	E-commerce -> E-commerce Platform -> Brand E-commerce
6030104	E-commerce -> E-commerce Platform -> Second-hand E-commerce
6030201	E-commerce -> Vertical E-commerce -> Food & Beverages
6030202	E-commerce -> Vertical E-commerce -> Medical Health
6030203	E-commerce -> Vertical E-commerce -> Adult Products
6030204	E-commerce -> Vertical E-commerce -> Publication
6030205	E-commerce -> Vertical E-commerce -> Household Supplies
6030206	E-commerce -> Vertical E-commerce -> Luxury
6030207	E-commerce -> Vertical E-commerce -> Fashion
6030208	E-commerce -> Vertical E-commerce -> Musical Instruments
6030209	E-commerce -> Vertical E-commerce -> Pregnancy & Baby ＆ Toys
6030210	E-commerce -> Vertical E-commerce -> Electronics
6030211	E-commerce -> Vertical E-commerce -> Beauty & Personal Care
6030212	E-commerce -> Vertical E-commerce -> Accessories
6030213	E-commerce -> Vertical E-commerce -> Sports & Outdoors
6030214	E-commerce -> Vertical E-commerce -> Gardening
6030215	E-commerce -> Vertical E-commerce -> Home ＆ Living
6030216	E-commerce -> Vertical E-commerce -> Office Supplies
6030217	E-commerce -> Vertical E-commerce -> Pet Supplies
6030218	E-commerce -> Vertical E-commerce -> Other Vertical E-commerce
6030301	E-commerce -> Other E-commerce -> Discounts
6040101	Entertainment -> Social ＆ Live Streaming -> Lesbian Social
6040102	Entertainment -> Social ＆ Live Streaming -> Gay Social
6040103	Entertainment -> Social ＆ Live Streaming -> Social-male
6040104	Entertainment -> Social ＆ Live Streaming -> Social & Dating
6040105	Entertainment -> Social ＆ Live Streaming -> Social Networking
6040106	Entertainment -> Social ＆ Live Streaming -> Communities
6040107	Entertainment -> Social ＆ Live Streaming -> Short-video
6040108	Entertainment -> Social ＆ Live Streaming -> Live
6040109	Entertainment -> Social ＆ Live Streaming -> AI Social-male
6040110	Entertainment -> Social ＆ Live Streaming -> AI Social Networking
6040201	Entertainment -> Online Reading -> Romance Novel
6040202	Entertainment -> Online Reading -> Interactive Novel
6040203	Entertainment -> Online Reading -> Novel
6040204	Entertainment -> Online Reading -> Comics
6040205	Entertainment -> Online Reading -> Audiobooks
6040301	Entertainment -> Audiovisual -> Video-female
6040302	Entertainment -> Audiovisual -> Streaming
6040303	Entertainment -> Audiovisual -> Video-male
6040304	Entertainment -> Audiovisual -> Short Drama Series
6040305	Entertainment -> Audiovisual -> Screen Mirroring
6040306	Entertainment -> Audiovisual -> FM ＆ Radio
6040401	Entertainment -> News -> Fashion Gossip
6040402	Entertainment -> News -> News
6040403	Entertainment -> News -> News-male
6040501	Entertainment -> Music -> Music Composer
6040502	Entertainment -> Music -> Karaoke
6040503	Entertainment -> Music -> Music Player
6040601	Entertainment -> Entertainment -> Quizzes
6040602	Entertainment -> Entertainment -> Game Plugins
6040603	Entertainment -> Entertainment -> Other Entertainment
6040701	Entertainment -> Graphics & Design -> Photography
6040702	Entertainment -> Graphics & Design -> Design
6040703	Entertainment -> Graphics & Design -> AI Photography
6040704	Entertainment -> Graphics & Design -> AI Design
6050101	Life Services -> Pregnancy & Baby Care -> Pregnancy & Baby Service
6050102	Life Services -> Pregnancy & Baby Care -> Pregnancy & Baby Forums
6050201	Life Services -> Travel -> Hotels & Accommodations
6050202	Life Services -> Travel -> Tourism Guides
6050203	Life Services -> Travel -> Ride Services
6050204	Life Services -> Travel -> Parking & Charging Stations
6050205	Life Services -> Travel -> Maps
6050206	Life Services -> Travel -> Other Travel
6050301	Life Services -> Life Convenience -> Housekeeping
6050302	Life Services -> Life Convenience -> Wedding Service
6050303	Life Services -> Life Convenience -> Show Ticketing
6050304	Life Services -> Life Convenience -> Life Payment
6050305	Life Services -> Life Convenience -> Communication & Telecom Services
6050306	Life Services -> Life Convenience -> Transportation
6050307	Life Services -> Life Convenience -> Convenient Tools
6050308	Life Services -> Life Convenience -> Local Life
6050309	Life Services -> Life Convenience -> Pet Services
6050310	Life Services -> Life Convenience -> Grocery
6050311	Life Services -> Life Convenience -> Food & Drink
6050312	Life Services -> Life Convenience -> Restaurant Reservation
6050313	Life Services -> Life Convenience -> Government Service
6050314	Life Services -> Life Convenience -> Car Service
6050315	Life Services -> Life Convenience -> Elderly Service
6050401	Life Services -> Real Estate -> House Selling & Renting
6050402	Life Services -> Real Estate -> Property Management
6050403	Life Services -> Real Estate -> Home Design & Decorating
6060102	Education -> Formal Education -> K-12 Education
6060103	Education -> Formal Education -> Higher Education
6060104	Education -> Formal Education -> Formal Education
6060201	Education -> Study Abroad -> Study Abroad Service
6060202	Education -> Study Abroad -> Study Abroad Preparation
6060301	Education -> Vocational Skills -> Industry Training
6060302	Education -> Vocational Skills -> Skill Learning
6060401	Education -> Language Education -> English Learning
6060402	Education -> Language Education -> Dictionary & Translation
6060403	Education -> Language Education -> Non-English-languages
6060501	Education -> Interest-based Education -> Children's Interest Education
6060502	Education -> Interest-based Education -> Adult Interest Education
6060601	Education -> Special Needs Education -> Special Needs Education
6060701	Education -> Religion & Belief -> Buddhism
6060702	Education -> Religion & Belief -> Islam
6060703	Education -> Religion & Belief -> Christianity
6060704	Education -> Religion & Belief -> Other Religions
6060801	Education -> Preschool Education -> Preschool Education
6070101	Finance -> Investment -> Banking
6070102	Finance -> Investment -> Loan
6070103	Finance -> Investment -> Stocks & Securities
6070104	Finance -> Investment -> Digital Assets
6070105	Finance -> Investment -> Insurance
6070106	Finance -> Investment -> Trusts
6070201	Finance -> Asset Allocation -> Asset Management
6070301	Finance -> Gambling -> Lottery
6070302	Finance -> Gambling -> Sports Betting
6080101	Business -> Business & Office -> Office Software
6080102	Business -> Business & Office -> Job Search & Recruitment
6080103	Business -> Business & Office -> Workplace Social Media
6080201	Business -> Business Investment -> Business Service
6080202	Business -> Business Investment -> Investment & Franchise
6090101	Health & Fitness -> Health & Fitness -> Women Wellness
6090102	Health & Fitness -> Health & Fitness -> Fitness
6090201	Health & Fitness -> Medical Health -> Medical Care
6090202	Health & Fitness -> Medical Health -> Medical Platform
6090203	Health & Fitness -> Medical Health -> Other Medical Health
6090301	Health & Fitness -> Healthcare News -> Healthcare News

Appendix3: Operating System

Value	Description
ANDROID	Google Android
IOS	Apple iOS

Appendix4: Country

For country codes, please refer to Wikipedia:https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements

Appendix5: Mediation Platform

Value	Description
1	MAX
4	DT FairBid
6	TopOn
7	TradPlus
8	GroMore
9	Helium
11	Unity
12	IronSource
13	Yandex
14	Google AdMob/AdManager
15	ToBid
0	Others

Appendix6: AD Format

AD Format(For query)	AD Format Name(For display)	Traffic type
app_wall	App Wall	Native SDK
native	Native	Native SDK & Online api
rewarded_video	Rewarded Video	Native SDK
offerwall	Offer Wall	Native SDK
static_interstitial	Static Interstitial	Native SDK
new_interstitial	New Interstitial	Native SDK
interactive_ads	Interactive Ads	Native SDK
banner	Banner	Native SDK
splash_ad	Splash AD	Native SDK
automatic_rendering_native	Native(Auto Rendering)	Native SDK
online_api_interstitial	Interstitial(Online API)	Online api
online_api_banner	Banner(Online API)	Online api
online_api_video	Online Video	Online api

Appendix7: Returned Value

Returned Value	Message	Notes
200	Success	Success
-2004	No Access	Verification unsuccessful
-2006	Permission denied	No permission to proceed
-2007	Invalid Params	Invalid parameters
-10016	Invalid APP Name	Invalid APP name
-10017	Invalid APP Platform	Invalid operating system
-11004	Invalid Unit Name	Invalid Unit name
-11010	Invalid Unit Name	Invalid ad unit name
-11011	Invalid Unit AdType	Invalid Unit Ad Type
-11017	Failed to add new ad unit. The number of ad units per APP + Ad Format could not exceed 10.	Failed to add new ad unit. The number of ad units per APP + Ad Format could not exceed 10.
-15001	Invalid Placement name	Invalid Placement name
-15002	Invalid Placement id	Invalid Placement id
-15006	Failed to add new placement. The number of placements per APP + Ad Format could not exceed 10.	Failed to add new placement. The number of placements per APP + Ad Format could not exceed 10.

Appendix8: Store

Value	Description
google_play	Google Play
app_store	Apple App Store
amazon	Amazon Appstore
other	Others