Retrieve Ads

Revision as of 10:08, 10 July 2013 by Admin (Talk | contribs)

Jump to: navigation, search



The communication will be done using the HTTP protocol.

End Point

Service end point:



• The request is sent via an HTTP POST to the following URL:

• The content type of the request is application/x-www-form-urlencoded.

• The body of the POST contains URL encoded key/value pairs separated by "&".

Example: Post to:

Body: w&t=2&a=8a7e5381-f568-4331-a30d-3b01c8f98dec&tt_idfa=84cb5500-d2a5-c788-740d-91bcc70f9342&tt_mac_md5=80efe2256d548c85ca2f2d18de241a80&r=320x48&i= (iPhone; U; CPU iPhone OS 4_0 like Mac OS X; en-us) AppleWebKit/532.9 (KHTML, like Gecko) Version/4.0.5 Mobile/8A293 Safari/6531.22.7

Request parameters

Parameter Name In Request Description Example Required?
User agent u The browser user agent of the device making the request u= Mozilla/5.0 (Linux;U; Android 2.1-update1;iw-il; HTC LegendBuild/ERE27) Yes
Application id a The id of the applications, as registered in Taptica's AdCore servers. a=C20DC50B-65B9-4B11-8F62-79F9286896B7 Yes
IP Address i Client IP Address i= Yes
Localization loc The localization (Language & Country) that is currently chosen for the device ,following the standards of ISO 639-1,ISO 3166-1. loc=en_GB No
Network type nt The type of network the device is currently connected to ("wifi" or "carrier") nt=carrier No,
Marital status marital Marital status of the user. options are: "single", "divorced", "engaged", "relationship", or "swinger" marital=single No
Income income Annual income (in USD) , e.g. 10000. income=10000 No
Interests interests a comma separated list of keywords denoting user's area of interests. interests=cars,sports,F1,stocks No
Education edu Education level of the user ("UG" or "PG") edu=UG No
Resolution r Resolution of the ad request r=320x50 Yes
Ad Type t Ad type - Banner (2), Html (3), Video (5) t=2 Yes
Gender gender Gender, Male, Female, All gender=male No
Age age Age of the user age=27 No
Date Of Birth dob User's Date of birth(Format: yyyyMMdd) dob=19820211 No
Latitude lat Location by latitudes lines lat=40.714353 No
Longitude lon Location by longitude lines lon=-74.005973 No
Response Type rt JSON=0, XML=1, XHTML=2, types of response rt=0 No
Category Name cat Specified the offer category (spaces should be replace with %20) cat=Games,Travel%20and%20Local, No

Taptica Device Keys

Parameter Name In Request Description Example Daynamic?
IMEI tt_imei Use for send Taptica Plain IMEI or when you don’t know what is the format of IMEI you have. tt_imei=86453214567892 Yes
IMEI SHA1 tt_imei_sha1 Use for send Taptica IMEI in SHA1 format tt_imei_sha1=35eb6d1fc48b502e239b6449e9df534e415cad95 Yes
IMEI MD5 tt_imei_md5 Use for send Taptica IMEI in MD5 format tt_imei_md5=946cc1baf8bcaec827bb1828cc6d9a94 Yes
Android ID tt_android_id Use for send Taptica Plain Android ID or when you don’t know what is the format of Android ID you have. tt_android_id=3ee0149b4ccef71b Yes
Android ID SHA1 tt_android_id_sha1 Use for send Taptica Android ID in SHA1 format tt_android_id_sha1=4f2e52e8157fcb729d799d1ca69160df2edf0cd4 Yes
Android ID MD5 tt_android_id_md5 Use for send Taptica Android ID in MD5 format tt_android_id_md5=155551c45efa667f9b470629ae9c0365 Yes
Mac Address tt_mac Use for send Taptica Plain Mac Address or when you don’t know what is the format of the Mac Address you have. (upper case with colon) tt_mac=44:2A:60:G5:GE:G5 Yes
Mac Address SHA1 tt_imei_sha1 Use for send Taptica Mac Address in SHA1 format (upper case with colon) tt_mac_sha1=fa6bb084ae52461328eb9f06039be222ef287246 Yes
Mac Address MD5 tt_mac_md5 Use for send Taptica Mac Address in MD5 format (upper case with colon) tt_mac_md5=80efe2256d548c85ca2f2d18de241a80 Yes
IDFA tt_idfa Use for send Taptica Plain IDFA or when you don’t know what is the format of IDFA you have. tt_idfa=771468523E3346ABAA04E207BBAF094B Yes
IDFA SHA1 tt_idfa_sha1 Use for send Taptica IDFA in SHA1 format tt_idfa_sha1=ee5c19f8cf370b5978f4b9f33343a5e79c58df9a Yes
IDFA MD5 tt_idfa_md5 Use for send Taptica IDFA in MD5 format tt_idfa_md5=bb1e0285fbb97ba83fdb4e72514d62f5 Yes
UDID tt_udid Use for send Taptica Plain UDID or when you don’t know what is the format of UDID you have. tt_udid=dc1816eac806878e8d1d5a8ee9406a3f71452c80 Yes
UDID SHA1 tt_udid_sha1 Use for send Taptica UDID in SHA1 format tt_udid_sha1=1ddfad5e4377b8694b5fea2a4c4556e2add9605b Yes
UDID MD5 tt_udid_md5 Use for send Taptica IMEI in MD5 format tt_udid_md5=20fbe500c99939adabb4d06600eb4ee7 No

Category List

The optional categories names are:

Financial Services
Health and Fitness
Shopping and Retail
Travel and Local
Books and Reference
News and weather


The data is returned in a JSON format.

• The JSON returned by Taptica AdCore servers is a single object, composed of simple fields of JSON Type String, described in the section below.

Banner response

 adyxAdRequestGuid: "3b327792-f364-41b4-9f34-501f1acc3109"
 adType: "banner"
 imageUrl: ""
 imageAltText: null
 adUrl: "
 impUrl: "
 urlType: "web"
 beacon: null
 adInterval: "10"
 advAppId: "542781249"
 storeUrl: null
 payout: "1.05000"

Full screen response

 adyxAdRequestGuid: "16e3738a-d8de-42eb-b2b2-717f05439d20"
 adType: "html"
 adUrl: "  tt_cid=16e3738ad8de42ebb2b2717f05439d20&el=GbtixRMFpAr%2boJEVHfprXTgVAQ3Ld8jjq6x3iEWya
 impUrl: "
 urlType: "web"
 htmlUrl: ""
 adInterval: "10"
 htmlAdType: 2
 advAppId: "553834731"
 storeUrl: null
 payout: "2.60000"

Video response

 adyxAdRequestGuid: "58188bd6-ed46-4f56-aac4-c16b485d4b6b"
 adType: "video"
 imageUrl: ""
 imageAltText: null
 videoUrl: ""
 replayIcon: ""
 downloadIcon: ""
 continueIcon: ""
 adUrl: "
 impUrl: null
 contUrl: ""
 urlType: "web"
 beacon: null
 adInterval: "10"
 advAppId: "531275818"
 storeUrl: null
 payout: "1.40000"

  • The impurl response is depend on your affiliate setting in Taptica

Error Message

Parameter Description Example
errorId The identifier of the error that occurred. If needed, extra text describing the error will be written into the errorText. "5"
errorText Contains additional information regarding the retrieved error. "The error had happened due to the following unexpected reason: unsupported client"

List of errors

errorID Description
-1 Unknown error. In this case, the errorText parameter will include the information that describes the error.
0 Server overload
1 Server could not find an appropriate ad (because of age restriction , for example)
2 Application id is missing
3 Application id wasn't found on database
4 User agent is missing
5 User agent is not supported
6 Test mode value is not supported
7 Resolution size and/or density are not supported
8 Resolution size and/or density are in the wrong format
9 Postal code is in wrong format
10 Area code is in wrong format
11 Location is in wrong format
12 Birth date is in wrong format or is invalid
13 Gender is in wrong format
14 Unique Identifier is missing
15 Unique Identifier value is in wrong format or is invalid
16 Localization is missing
17 Localization value is in wrong format or is invalid
18 Net type value is in wrong format or is invalid
19 Marital status value is not supported
20 Income value is in wrong format or is invalid
Personal tools