Dotinapp Affilaite API Document

1.Examine and verify

The publisher provides application information, and postback（such as " param=“）to the AM, and AM submits the relevant information required for review.

2.Get ad export interface

AM will inform the following information after review:

Field name / Meaning / Sample
sid / Traffic unique identifier / 4309
token / Get the token of the ad interface / BaK8xPA

Advertisement Export Interface Parameter Description:

Field name / Meaning / if necessary / Sample
sid / Traffic unique identifier / yes / 4309
token / Get the token of the ad interface / yes / BaK8xPA
os / Request the corresponding os ad export [0: ios, 1: android] / no(default = 1) / 1
adn / Limit the number of entries returned / no(default = 10000) / 10000
cat / Sorted by different strategies (first edition is not supported, to be upgraded) / no(default = 0) / 0
gaid / 0: no need for gaid
1: need gaid
default : all offers / no / 0

Publisher splice the request parameter to get the offer.

sample :

3. The ad export return

Http returns the sample

{

"ads": [

{

"ad_id": 1529805,

"price": 0.25,

"country": "IND",

"pkg": "com.aranoah.healthkart.plus",

"os": 1,

"min_os": "4.1",

"need_gaid": 0,

"click_url": "

}

],

"qk": "8833219221765339805"

}

Http returns json, field meaning

Field name / Filed type / If it need to be returned / Field meaning
ads / Array / yes / Each element of the array represents an ad
ad_id / Integer / yes / Ad id, id for each offer do not change
price / Floating point number / yes / Ad conversion price, in US dollars
country / character string / yes / target country , multiple countries with "," connection,
Eg: BEL, ESP, IND, ITA, ZAF
pkg / character string / yes / package name of ads
os / Integer / yes / target OS
0: IOS
1:android
min_os / character string / yes / The minimum operating system version required
need_aid / character string / yes / 1: traffic with gaid only 0: no limit
click_url / character string / yes / Ad click on the redirect address

4. Click on the connection to assemble

After getting the ad, publisher needs to splice the necessary fields in the click_url to ensure that the redirection, and the splicing parameters are as follows:

Parametersname / Meaning / if necessary / Sample
os / 0: IOS
1: android / no / 1
osv / current operation system for users / yes / 4.4
udid / current android_id of users,have to be actual value，or there will be risk of payment / no / 5161498c515a0034
gaid / Gaid of users currently / yes / e11d6ce8-9c4b-41c6-8545-7046b837aa3e
pb / need to return the parameters / depends / Fk-jDv0Ai9mWyW5R00mgK85RD1(When this click eventually lead to conversion, the head information were offered for reviewing will be spliced with , and then return to the pubs server: Fk-jDv0Ai9mWyW5R00mgK85RD1
*Note: HTTP GET return

Sample：

Appendix—

Error for Click

Error information / Meaning
Error info [ad not online] / The ad is offline
Error info [os target error] / The operating system of the traffic does not match the ad-oriented operating system
Error info [min_os_version dissatisfy] / Do not meet the minimum version of ad requirements
Error info [no gaid] / do not pass the gaid parameter for gaid requirement offers
Error info [country target error] / wrong target for country
Error info [NISMG] / unknown error , contact us for help