The Return data
Field |
Type |
Example |
Desc |
status |
boolean |
true |
true : sucess for this request,false : It's fail for this request |
info |
string |
success |
If successful, 'sucess' will be return ,Otherwise fail message will be return |
data |
array |
|
the result |
Data Fields
Field |
Type |
Enum |
Example |
Desc |
campid |
int |
|
123 |
campagin ID |
offer_name |
String |
|
campaign_01 |
offer name |
status |
String |
running,stop |
running |
the status,It's include running and stop |
platform |
String |
|
ios,android,ios,pc,others,all_device,xxx |
allow to target platform,multi-select,Multiple platforms are separated by commas |
min_version |
String |
|
4.1 |
min platform version |
max_version |
String |
|
8.1 |
max platform version |
target_device |
String |
|
phone,tablet |
target device |
tracking_link |
String |
|
|
tracking link |
traffic_source |
String |
|
non-incent,no adult |
target traffic source |
traffic_network |
String |
2G,3G,4G,wifi |
wifi |
target traffic network,Multiple values are separated by commas |
geo |
Array |
|
["SA","US"] |
|
exclude_traffic |
String |
email, icon drop, facebook, non official creativities, non-incent, brand bidding, in app, social network except facebook, search traffic except brand bidding, silent installation |
email, icon drop |
exclude traffic source |
preview_link |
String |
|
|
|
price |
Float |
|
0.12 |
offer's price |
price_model |
String |
cpc, cpi, cpa, cpe, cpm |
cpm |
offer's price model |
note |
String |
|
|
offer kpi |
app_category |
String |
|
Tools |
offer category in the application martket |
start_time |
Int |
|
1426694400 |
offer's lanuch time , the Unix time stamp format |
start_date |
String |
|
2015-03-19T00:00:00+0800 |
offer's lanuch time,the date format |
end_time |
Int |
|
1426694400 |
closing time, The Unix time stamp format |
end_date |
String |
|
2015-03-19T00:00:00+0800 |
closing time.The date time format |
update_time |
Int |
|
1426694400 |
the last time when the offer is update ,The Unix time stamp format |
update_date |
String |
|
2015-03-19T00:00:00+0800 |
the last time when the offer is update.The date format |
effective_time |
Int |
|
1426694400 |
time of enabling offermodification ,Unix time stamp |
effective_date |
String |
|
2015-03-19T00:00:00+0800 |
time of enabling offermodification , the date format |
carriers |
String |
|
Digi,Maxis,Celcom |
Target carriers |
daily_cap |
Int |
|
1000 |
the cap for daily .the value is '999999999' that mean is over cap for this offer |
conversion_flow |
String |
1-click, 2-click, 3-click, MO, PIN, SOI, DOI, CC submit, Pay per call, Other |
1-click, 2-click |
the conversion flow for cpa offer. |
icon_link |
String |
|
http://file.3s.mobvista.com/upload-files/view?path=71b95651298059f3f953ebb09a0c864c |
the icon link for the offer, It could be null |
package_name |
String |
|
com.g2us.armedwarriorstw |
the package name in the application market,It could be null. |
app_name |
String |
|
Poker Texas |
the app name |
app_desc |
String |
|
Poker Texas |
the app desc |
app_size |
Float |
|
3.1 |
the app size, It could null |
app_rate |
Float |
|
4.0 |
the app rate,It could null |
link_type |
String |
gp, app, apk, subscription, ipa, website |
gp |
the link type ,It could be null |
video_creatives |
Array |
|
["file.3s.mobvista.com/upload-files/view?path=71b95651298059f3f953ebb09a0c864c", "file.3s.mobvista.com/upload-files/view?path=71b95651298059f3f953ebb09a0c864c"] |
the list of video creatives,if null will be '[]' |
creatives |
Array |
|
["file.3s.mobvista.com/upload-files/view?path=71b95651298059f3f953ebb09a0c864c"] |
the list of picture creatives , if null will be '[]' |
gid_idfa_needs |
String |
yes,no |
yes |
do you absolutely need idfa or gaid for conversion? |
legal_doc |
Array |
|
["file.3s.mobvista.com/upload-files/view?path=71b95651298059f3f953ebb09a0c864c"] |
the legal document,If null it will be '[ ]; |
settlement_by_install |
String |
yes,no |
yes |
is cpi price model |
blacklist_subid |
Array |
|
[{"subid": "app","updated_at": 1490962682},{"subid": "app2","updated_at": 1490962682}] |
Sub channel Blacklist |
whitelist_subid |
Array |
|
[{"subid": "app3","updated_at": 1490962682},{"subid": "app4","updated_at": 1490962682}] |
Sub channel Whitelist |
skadnetwork_campaign |
int |
0,1 |
1 |
Whether the offer supports SKADNetwork Campaign, 1 represents yes |
skan_signature_api |
string |
|
https://tracking.lenzmx.com/sign_click?mb_nt=cb15197&mb_campid=zijie_test |
SKAdnetwork basic signature API |
impression_link |
string |
|
https://tracking.lenzmx.com/impression?mb_nt=cb15197&mb_campid=zijie_test |
impression link |
blacklist_subid
Field |
Type |
Enum |
Example |
Desc |
subid |
string |
|
app |
Sub channel |
updated_at |
init |
|
1490962682 |
Add time |
whitelist_subid
Field |
Type |
Enum |
Example |
Desc |
subid |
string |
|
app |
Sub channel |
updated_at |
init |
|
1490962682 |
Add time |
example for json
{
"status": true,
"info": "success",
"data": [
{
"campid": 1234,
"offer_name": "campaign_001",
"status": "running",
"platform": "android",
"min_version": "4.1",
"max_version": "8.1",
"target_device": "phone,tablet",
"tracking_link": "http://tracking.whatsappbgr.com/click?mb_pl=android&mb_nt=cb1341&mb_campid=nx_adm_history_us_and_non_33915",
"traffic_source": "non-incent,no adult",
"traffic_network": "2G,3G,4G,wifi",
"geo": [
"AD",
"AE"
],
"exclude_traffic": "incent",
"preview_link": "https://play.google.com/store/apps/details?id=com.aetn.history.watch&hl=en",
"price": 1.82,
"price_model": "cpi",
"note": "<p>Cost per view view<$0.3</p>",
"app_category": "Entertainment",
"start_time": 1502890278,
"start_date": "2017-08-16T21:31:18+0800",
"end_time": 0,
"end_date": "",
"update_time": 1523957722,
"update_date": "2018-04-17T17:35:22+0800",
"effective_time": 0,
"effective_date": "",
"carriers": "",
"daily_cap": 12,
"conversion_flow": "",
"icon_link": "https://lh3.googleusercontent.com/ssEaer1AVoUpnIuVbsYaifHRag03GgTn2yEU-rqDzKqeQh1FZdLKXhgtG7tRE6akfQ=w300",
"package_name": "com.aetn.history.watch",
"app_name": "HISTORY: Watch TV Show Full Episodes & Specials",
"app_desc": "Watch Alone, Forged in Fire, The Curse of Oak Island, Ancient Aliens & more. All of your favorite HISTORY shows are available wherever and whenever you want, right on your Android device.\n\nThe HISTORY app is a great way to access full episodes and clips from all your favorite HISTORY shows. New content is added all the time. The HISTORY app allows you to:\n\n•Watch full episodes and clips of your favorite HISTORY shows including:\n-Alone\n-American Pickers\n-American Ripper\n-Ancient Aliens\n-Ax Men\n-Counting Cars\n-Forged in Fire\n-Hunting Hitler\n-Ice Road Truckers\n-Mountain Men\n-Six\n-Swamp People\n-The Curse of Oak Island\n-Vikings\n\n\n•Create a customized Watchlist of your favorite shows.\n•See exclusive clips from HISTORY shows, never before shown on television.\n\nThe HISTORY app is free to use. If your TV provider is supported you can sign in and get access to even more content. More TV providers coming very soon!\n\nHISTORY CONTENT IS ONLY AVAILABLE TO STREAM IN THE UNITED STATES.\n\nPlease note: This app features Nielsen’s proprietary measurement software which will allow you to contribute to market research, like Nielsen’s TV Ratings.\n\nTo learn more about the digital measurement products and your choices in regard to them, please visit http://www.nielsen.com/digitalprivacy for more information.",
"app_size": 18.3,
"app_rate": 4.04,
"link_type": "gp",
"video_creatives": [
"http://cdn-3s.mobvista.com/upload/default/5ad439ea3c84a.wmv?p1=513153.uc&p2=f94a5c57aae023e0805dc2a4b91cf02cee0fd61e19501f90f076db6cb8749b07",
"http://cdn-3s.mobvista.com/upload/default/5ad439778b9d6.avi?p1=513153.uc&p2=140ace130ebc4612738b8da395d90489f6f6a1df085d6662f44a746a6c6cf7a8"
],
"creatives": [
"http://cdn-3s.mobvista.com/upload/default/5a72e314b7058.jpg?p1=513153.uc&p2=93884637e7d07bd42a50537abb3e7b0b2b296e7a893287188ff8169b50871c8c",
],
"gid_idfa_needs": "no",
"legal_doc": [],
"settlement_by_install": "",
"blacklist_subid": [
{
"subid": "app",
"updated_at": 1490962682
},
{
"subid": "app2",
"updated_at": 1490962682
},
{
"subid": "app21",
"updated_at": 1490962682
}
],
"whitelist_subid": [
{
"subid": "app3",
"updated_at": 1490962682
},
{
"subid": "app4",
"updated_at": 1490962682
}
],
"impression_link": "http://tracking.whatsappbgr.com/impression?mb_pl=android&mb_nt=cb1341&mb_campid=nx_adm_history_us_and_non_33915"
}
]
}
Appendix
GEO demo
GEO |
Country |
AD |
Andorra |
AE |
United Arab Emirates |
AF |
Afghanistan |
AG |
Antigua and Barbuda |
AI |
Anguilla |
AL |
Albania |
AM |
Armenia |
AO |
Angola |
AQ |
Antarctica |
AR |
Argentina |
AS |
American Samoa |
AT |
Austria |
AU |
Australia |
AW |
Aruba |
AX |
Åland Islands |
AZ |
Azerbaijan |
BA |
Bosnia and Herzegovina |
BB |
Barbados |
BD |
Bangladesh |
BE |
Belgium |
BF |
Burkina Faso |
BG |
Bulgaria |
BH |
Bahrain |
BI |
Burundi |
BJ |
Benin |
BL |
Saint Barthélemy |
BM |
Bermuda |
BN |
Brunei Darussalam |
BO |
Bolivia, Plurinational State of |
BQ |
Bonaire, Sint Eustatius and Saba |
BR |
Brazil |
BS |
Bahamas |
BT |
Bhutan |
BV |
Bouvet Island |
BW |
Botswana |
BY |
Belarus |
BZ |
Belize |
CA |
Canada |
CC |
Cocos (Keeling) Islands |
CD |
Congo, the Democratic Republic of the |
CF |
Central African Republic |
CG |
Congo |
CH |
Switzerland |
CI |
Côte d'Ivoire |
CK |
Cook Islands |
CL |
Chile |
CM |
Cameroon |
CN |
China |
CO |
Colombia |
CR |
Costa Rica |
CU |
Cuba |
CV |
Cabo Verde |
CW |
Curaçao |
CX |
Christmas Island |
CY |
Cyprus |
CZ |
Czech Republic |
DE |
Germany |
DJ |
Djibouti |
DK |
Denmark |
DM |
Dominica |
DO |
Dominican Republic |
DZ |
Algeria |
EC |
Ecuador |
EE |
Estonia |
EG |
Egypt |
EH |
Western Sahara |
ER |
Eritrea |
ES |
Spain |
ET |
Ethiopia |
FI |
Finland |
FJ |
Fiji |
FK |
Falkland Islands (Malvinas) |
FM |
Micronesia, Federated States of |
FO |
Faroe Islands |
FR |
France |
GA |
Gabon |
GD |
Grenada |
GE |
Georgia |
GF |
French Guiana |
GG |
Guernsey |
GH |
Ghana |
GI |
Gibraltar |
GL |
Greenland |
GM |
Gambia |
GN |
Guinea |
GP |
Guadeloupe |
GQ |
Equatorial Guinea |
GR |
Greece |
GS |
South Georgia and the South Sandwich Islands |
GT |
Guatemala |
GU |
Guam |
GW |
Guinea-Bissau |
GY |
Guyana |
HK |
Hong Kong |
HM |
Heard Island and McDonald Islands |
HN |
Honduras |
HR |
Croatia |
HT |
Haiti |
HU |
Hungary |
ID |
Indonesia |
IE |
Ireland |
IL |
Israel |
IM |
Isle of Man |
IN |
India |
IO |
British Indian Ocean Territory |
IQ |
Iraq |
IR |
Iran, Islamic Republic of |
IS |
Iceland |
IT |
Italy |
JE |
Jersey |
JM |
Jamaica |
JO |
Jordan |
JP |
Japan |
KE |
Kenya |
KG |
Kyrgyzstan |
KH |
Cambodia |
KI |
Kiribati |
KM |
Comoros |
KN |
Saint Kitts and Nevis |
KP |
Korea, Democratic People's Republic of |
KR |
Korea, Republic of |
KW |
Kuwait |
KY |
Cayman Islands |
KZ |
Kazakhstan |
LA |
Lao People's Democratic Republic |
LB |
Lebanon |
LC |
Saint Lucia |
LI |
Liechtenstein |
LK |
Sri Lanka |
LR |
Liberia |
LS |
Lesotho |
LT |
Lithuania |
LU |
Luxembourg |
LV |
Latvia |
LY |
Libya |
MA |
Morocco |
MC |
Monaco |
MD |
Moldova, Republic of |
ME |
Montenegro |
MF |
Saint Martin (French part) |
MG |
Madagascar |
MH |
Marshall Islands |
MK |
Macedonia, the former Yugoslav Republic of |
ML |
Mali |
MM |
Myanmar |
MN |
Mongolia |
MO |
Macao |
MP |
Northern Mariana Islands |
MQ |
Martinique |
MR |
Mauritania |
MS |
Montserrat |
MT |
Malta |
MU |
Mauritius |
MV |
Maldives |
MW |
Malawi |
MX |
Mexico |
MY |
Malaysia |
MZ |
Mozambique |
NA |
Namibia |
NC |
New Caledonia |
NE |
Niger |
NF |
Norfolk Island |
NG |
Nigeria |
NI |
Nicaragua |
NL |
Netherlands |
NO |
Norway |
NP |
Nepal |
NR |
Nauru |
NU |
Niue |
NZ |
New Zealand |
OM |
Oman |
PA |
Panama |
PE |
Peru |
PF |
French Polynesia |
PG |
Papua New Guinea |
PH |
Philippines |
PK |
Pakistan |
PL |
Poland |
PM |
Saint Pierre and Miquelon |
PN |
Pitcairn |
PR |
Puerto Rico |
PS |
Palestine, State of |
PT |
Portugal |
PW |
Palau |
PY |
Paraguay |
QA |
Qatar |
RE |
Réunion |
RO |
Romania |
RS |
Serbia |
RU |
Russian Federation |
RW |
Rwanda |
SA |
Saudi Arabia |
SB |
Solomon Islands |
SC |
Seychelles |
SD |
Sudan |
SE |
Sweden |
SG |
Singapore |
SH |
Saint Helena, Ascension and Tristan da Cunha |
SI |
Slovenia |
SJ |
Svalbard and Jan Mayen |
SK |
Slovakia |
SL |
Sierra Leone |
SM |
San Marino |
SN |
Senegal |
SO |
Somalia |
SR |
Suriname |
SS |
South Sudan |
ST |
Sao Tome and Principe |
SV |
El Salvador |
SX |
Sint Maarten (Dutch part) |
SY |
Syrian Arab Republic |
SZ |
Swaziland |
TC |
Turks and Caicos Islands |
TD |
Chad |
TF |
French Southern Territories |
TG |
Togo |
TH |
Thailand |
TJ |
Tajikistan |
TK |
Tokelau |
TL |
Timor-Leste |
TM |
Turkmenistan |
TN |
Tunisia |
TO |
Tonga |
TR |
Turkey |
TT |
Trinidad and Tobago |
TV |
Tuvalu |
TW |
Taiwan, Province of China |
TZ |
Tanzania, United Republic of |
UA |
Ukraine |
UG |
Uganda |
UK |
United Kingdom of Great Britain and Northern Ireland |
UM |
United States Minor Outlying Islands |
US |
United States of America |
UY |
Uruguay |
UZ |
Uzbekistan |
VA |
Holy See |
VC |
Saint Vincent and the Grenadines |
VE |
Venezuela, Bolivarian Republic of |
VG |
Virgin Islands, British |
VI |
Virgin Islands, U.S. |
VN |
Viet Nam |
VU |
Vanuatu |
WF |
Wallis and Futuna |
WS |
Samoa |
YE |
Yemen |
YT |
Mayotte |
ZA |
South Africa |
ZM |
Zambia |
ZW |
Zimbabwe |
App Category
We use the same categories as Google Play. The possible value is as follows.
Business, Game, Subscription, Books and Reference, Comics, Communications,
Education, Entertainment, Finance, Health and Fitness, Libraries and Demo, Lifestyle,
Live Wallpapers, Media and Video, Medical, Music and Audio, News and Magazines,
Personalization, Photography, Productivity, Shopping, Social, Sports, Tools,
Transportation, Travel and Local, Weather, Widgets, Action, Adventure, Arcade,
Board, Card, Casino, Casual, Educational, Family, Music, Puzzle, Racing, Role
Playing, Simulation, Strategy, Trivia, Word
Exclude Traffic
Possible value for excluded traffic |
null |
incent |
email |
icon drop |
facebook |
non official creativities |
adult traffic |
brand bidding |
in app |
social network except facebook |
search traffic except brand bidding |