Retrieve Ads

From wiki.taptica.com
(Difference between revisions)
Jump to: navigation, search
(→‎Request)
 
(51 intermediate revisions by one user not shown)
Line 1: Line 1:
 +
{| style="width:100%; border-spacing:0; font-family: 'Segoe UI', Assistant, sans-serif; background-color: #ffffff; border-bottom: 3px solid #E94E24; margin-bottom: 30px;"
 +
| style="padding:30px 20px; text-align:left; vertical-align:middle;" |
 +
<h1 style="margin:0; font-size:36px; font-weight: 800; line-height: 1.2;">
 +
<span style="color:#333;">API:</span> <span style="color:#E94E24;">Advertisement Service</span>
 +
</h1>
 +
|}
 +
 
== Communications ==
 
== Communications ==
−
 
 
The communication will be done using the HTTP protocol.
 
The communication will be done using the HTTP protocol.
  
 
== End Point ==
 
== End Point ==
−
 
 
Service end point:
 
Service end point:
−
 
+
<br>
 
'''POST:'''
 
'''POST:'''
−
 
+
<div style="background: #f9f9f9; padding: 10px; border-radius: 4px; border-left: 4px solid #E94E24; display: inline-block; margin-top: 10px; font-family: monospace;">
 
http://ad.taptica.com/aff_ad
 
http://ad.taptica.com/aff_ad
 +
</div>
  
 
== Request ==  
 
== Request ==  
  
 
• The request is sent via an HTTP POST to the following URL: http://ad.taptica.com/aff_ad
 
• The request is sent via an HTTP POST to the following URL: http://ad.taptica.com/aff_ad
−
 
+
<br>
 
• The content type of the request is application/x-www-form-urlencoded.
 
• The content type of the request is application/x-www-form-urlencoded.
−
 
+
<br>
 
• The body of the POST contains URL encoded key/value pairs separated by "&".
 
• The body of the POST contains URL encoded key/value pairs separated by "&".
  
−
Example:
+
'''Example:'''
 
Post to:
 
Post to:
 
http://ad.taptica.com/aff_ad
 
http://ad.taptica.com/aff_ad
  
 
Body:
 
Body:
−
v=w&t=2&a=8a7e5381-f568-4331-a30d-3b01c8f98dec&uid=84cb5500-d2a5-c788-740d-91bcc70f9342&r=320x48&i=50.57.113.223&sr=1280x800&u=Mozilla/5.0 (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
+
<div style="background: #fff; padding: 15px; border: 1px dashed #ddd; border-radius: 4px; direction: ltr; text-align: left; font-family: monospace; font-size: 13px; margin-bottom: 20px;">
 +
w&t=2&aff_id=1740&tt_sub_aff=15472&r=320x50&i=50.57.113.223&u=Mozilla/5.0 (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&tt_aff_impid=wyts98247asda&tt_aff_clickid=123456asd
 +
</div>
  
 
'''Request parameters'''
 
'''Request parameters'''
  
−
{| border="1" cellspacing="0" cellpadding="2" valign="top"
+
{| border="1" cellspacing="0" cellpadding="10" style="width:100%; border-collapse: collapse; border: 1px solid #ddd; font-family: sans-serif; direction: ltr; text-align: left;"
−
 
+
|- style="background-color: #f8f9fa; color: #333; font-weight: bold; border-bottom: 2px solid #E94E24;"
−
|'''Parameter'''
+
| Parameter || Name In Request || Description || Example || Required?
−
|'''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) || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">YES</span>
−
|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)
+
−
|No
+
 
|-
 
|-
−
 
+
| Application id || a || The id of the applications, as registered in Taptica's AdCore servers. || a=C20DC50B-65B9-4B11-8F62-79F9286896B7 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">YES</span>
−
|Application id
+
−
|a
+
−
|The id of the applications, as registered in Taptica's AdCore servers.
+
−
|a=C20DC50B-65B9-4B11-8F62-79F9286896B7
+
−
|Yes
+
 
|-
 
|-
−
|Device id
+
| Sub affiliate/publisher || tt_sub_aff || Represents lower level of the affiliate traffic source || tt_sub_aff=123529 || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|uid
+
−
|The id of the device
+
−
|uid=9774d56d682e549
+
−
|Yes
+
 
|-
 
|-
−
 
+
| IP Address || i || Client IP Address || i=84.103.57.1 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">YES</span>
−
|IP Address
+
−
|i
+
−
|Client IP Address
+
−
|i=84.103.57.1
+
−
|Yes
+
 
|-
 
|-
−
 
+
| Interval || int || set the refresh rate in milliseconds (minutemen value 10000) || int=15000 || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|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
+
 
|-
 
|-
−
 
+
| 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-uk || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|Network type
+
−
|nt
+
−
|The type of network the device is currently connected to ("wifi" or "carrier")
+
−
|nt=carrier
+
−
|No,
+
 
|-
 
|-
−
 
+
| Network type || nt || The type of network the device is currently connected to ("wifi" or "carrier") || nt=carrier || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|Marital status
+
−
|marital
+
−
|Marital status of the user. options are: "single", "divorced", "engaged", "relationship", or "swinger"
+
−
|marital=single
+
−
|No
+
 
|-
 
|-
−
 
+
| Marital status || marital || Marital status of the user. options are: "single", "divorced", "engaged", "relationship", or "swinger" || marital=single || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|Income
+
−
|income
+
−
|Annual income (in USD) , e.g. 10000.
+
−
|income=10000
+
−
|No
+
 
|-
 
|-
−
 
+
| Income || income || Annual income (in USD) , e.g. 10000. || income=10000 || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|Interests
+
−
|interests
+
−
|a comma separated list of keywords denoting user's area of interests.
+
−
|interests=cars,sports,F1,stocks
+
−
|No
+
 
|-
 
|-
−
 
+
| Interests || interests || a comma separated list of keywords denoting user's area of interests. || interests=cars,sports,F1,stocks || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|Education
+
−
|edu
+
−
|Education level of the user ("UG" or "PG")
+
−
|edu=UG
+
−
|No
+
 
|-
 
|-
−
 
+
| Education || edu || Education level of the user ("UG" or "PG") || edu=UG || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|Resolution
+
−
|r
+
−
|Resolution of the ad request
+
−
|r=320x50
+
−
|No
+
 
|-
 
|-
−
 
+
| Resolution || r || Resolution of the ad request || r=320x50 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">YES</span>
−
|Ad Type
+
−
|t
+
−
|Ad type - Text (1), Banner (2), Html (3), All (0)
+
−
|t=2
+
−
|No
+
 
|-
 
|-
−
 
+
| Ad Type || t || Ad type - Banner (2), Interstitial (3), Video (5) || t=2 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">YES</span>
−
|Gender
+
−
|gender
+
−
|Gender, Male, Female, All
+
−
|gender=male
+
−
|No
+
 
|-
 
|-
−
 
+
| Gender || gender || Gender, Male, Female, All || gender=male || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|Age
+
−
|age
+
−
|Age of the user
+
−
|age=27
+
−
|No
+
 
|-
 
|-
−
 
+
| Age || age || Age of the user || age=27 || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|Date Of Birth
+
−
|dob
+
−
|User's Date of birth(Format: yyyyMMdd)
+
−
|dob=19820211
+
−
|No
+
 
|-
 
|-
−
 
+
| Date Of Birth || dob || User's Date of birth(Format: yyyyMMdd) || dob=19820211 || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|Latitude
+
−
|lat
+
−
|Location by latitudes lines
+
−
|lat=40.714353
+
−
|No
+
 
|-
 
|-
−
 
+
| Latitude || lat || Location by latitudes lines || lat=40.714353 || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|Longitude
+
|-
−
|lon
+
| Longitude || lon || Location by longitude lines || lon=-74.005973 || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|Location by longitude lines
+
−
|lon=-74.005973
+
−
|No
+
 
|-
 
|-
−
 
+
| Response Type || rt || JSON=0, XML=1, XHTML=2, types of response || rt=0 || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|Response Type
+
|-
−
|rt
+
| Pipeline_data || pd || A free parameter for the affiliate use (can be send back to affiliate with S2S postback) || pd=Any Affiliate Data || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
−
|JSON=0, XML=1, XHTML=2, types of response
+
−
|rt=0
+
−
|No
+
 
|-
 
|-
 +
| Affiliate impression id || tt_aff_impid || Used for impression id that the publisher may want to send and get back via S2S postback || tt_aff_impid=asjhbasdk7832sa || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
 +
|-
 +
| Affiliate click id || tt_aff_clickid || Used for click id that the publisher may want to send and get back via S2S postback || tt_aff_clickid=qa143287w || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">NO</span>
 
|}
 
|}
  
−
== Response ==
+
== <span style="color:#333;">Taptica Device Keys</span> ==
  
−
The data is returned in a JSON format.
+
{| border="1" cellspacing="0" cellpadding="10" style="width:100%; border-collapse: collapse; border: 1px solid #ddd; font-family: sans-serif; direction: ltr; text-align: left;"
−
 
+
|- style="background-color: #f8f9fa; color: #333; font-weight: bold; border-bottom: 2px solid #E94E24;"
−
• The JSON returned by Taptica AdCore servers is a single object, composed of simple fields of JSON Type String, described in the section below.
+
| Parameter || Name In Request || Description || Example || Dynamic?
−
 
+
−
Example:
+
−
 
+
−
{"adyxAdRequestGuid":"c1059ef9-424c-4785-8350-cd86a8b71d1e",
+
−
  "adType":"banner",
+
−
  "imageUrl":"http://media.go2speed.org/brand/files/taptica/516/SUMO_Banner_320x50.png",
+
−
  "imageAltText":null,
+
−
  "adUrl":"http://tracking.taptica.com/aff_ic?tt_cid=c1059ef9424c47858350cd86a8b71d1e&el=GbtixRMFpArEVHfprXTgVAQ3WW...",
+
−
  "urlType":"web",
+
−
  "beacon":null,
+
−
  "adInterval":"10"}
+
−
 
+
−
* Note: Not in use for API (urlType, beacon, adInterval)
+
−
 
+
−
• The response type can be either: Textual ad, Graphical Ad or an Error
+
−
Message.
+
−
 
+
−
The JSON of each response type is described below.
+
−
 
+
−
'''Textual Ads'''
+
−
 
+
−
{| border="1" cellspacing="0" cellpadding="2" valign="top"
+
−
 
+
−
|'''Parameter'''
+
−
|'''Description''' 
+
−
|'''Example''' 
+
 
|-
 
|-
−
 
+
| 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 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
−
|adyxAdRequestGuid
+
−
|Unique identifier of an ad request
+
−
|"{21EC2020-3AEA-1069-A2DD-08002B30309D}"
+
 
|-
 
|-
−
 
+
| IMEI SHA1 || tt_imei_sha1 || Use for send Taptica IMEI in SHA1 format || tt_imei_sha1=35eb6d1fc48b502e239b6449e9df534e415cad95 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
−
|adType
+
−
|The type of an ad. Must have the value "text"
+
−
|"text"
+
 
|-
 
|-
−
 
+
| IMEI MD5 || tt_imei_md5 || Use for send Taptica IMEI in MD5 format || tt_imei_md5=946cc1baf8bcaec827bb1828cc6d9a94 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
−
|adText
+
−
|The text to be displayed on the ad
+
−
|"Click here! The best offer you can ever get"
+
 
|-
 
|-
−
 
+
| 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 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
−
|adUrl
+
−
|A URL to which the user should be redirected upon clicking on the ad
+
−
|"http://www.taptica.com"
+
 
|-
 
|-
−
 
+
| Android ID SHA1 || tt_android_id_sha1 || Use for send Taptica Android ID in SHA1 format || tt_android_id_sha1=4f2e52e8157fcb729d799d1ca69160df2edf0cd4 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
−
|}
+
−
 
+
−
 
+
−
'''Graphical Ads'''
+
−
 
+
−
{| border="1" cellspacing="0" cellpadding="2" valign="top"
+
−
 
+
−
|'''Parameter'''
+
−
|'''Description''' 
+
−
|'''Example''' 
+
 
|-
 
|-
−
 
+
| Android ID MD5 || tt_android_id_md5 || Use for send Taptica Android ID in MD5 format || tt_android_id_md5=155551c45efa667f9b470629ae9c0365 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
−
|adyxAdRequestGuid
+
−
|Unique identifier of an ad request
+
−
|"{21EC2020-3AEA-1069-A2DD-08002B30309D}"
+
 
|-
 
|-
−
 
+
| Android Advertising ID || tt_advertising_id || Use for send Taptica Android advertising plain ID || tt_advertising_id=3ee0149b4ccef71bs85d24derg || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
−
|adType
+
−
|The type of an ad. Must have the value "banner"
+
−
|"banner"
+
 
|-
 
|-
−
 
+
| Android Advertising ID SHA1 || tt_advertising_id_sha1 || Use for send Taptica Android advertising ID in SHA1 format || tt_advertising_id=32f2e52e8157fcb729d799d1ca69160df2edf8974 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
−
|imageURL
+
−
|A URL from which the graphical ad image should be retrieved
+
−
|"http://www.taptica.com/images/file1.jpg"
+
 
|-
 
|-
−
 
+
| Android Advertising ID MD5 || tt_advertising_id_md5 || Use for send Taptica Android advertising ID in MD5 format || tt_advertising_id=2315w52e8157fcb729d799d1ca691608speofd2 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
−
|adUrl
+
−
|A URL to which the user should be redirected upon clicking on the ad
+
−
|"http://www.taptica.com"
+
 
|-
 
|-
−
 
+
| 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 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
 +
|-
 +
| Mac Address SHA1 || tt_mac_sha1 || Use for send Taptica Mac Address in SHA1 format (upper case with colon) || tt_mac_sha1=fa6bb084ae52461328eb9f06039be222ef287246 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
 +
|-
 +
| Mac Address MD5 || tt_mac_md5 || Use for send Taptica Mac Address in MD5 format (upper case with colon) || tt_mac_md5=80efe2256d548c85ca2f2d18de241a80 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
 +
|-
 +
| 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=4A9B0CAB-FFA5-4190-8CC0-D974D98FC7DB || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
 +
|-
 +
| IDFA SHA1 || tt_idfa_sha1 || Use for send Taptica IDFA in SHA1 format || tt_idfa_sha1=ee5c19f8cf370b5978f4b9f33343a5e79c58df9a || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
 +
|-
 +
| IDFA MD5 || tt_idfa_md5 || Use for send Taptica IDFA in MD5 format || tt_idfa_md5=bb1e0285fbb97ba83fdb4e72514d62f5 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
 +
|-
 +
| 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 || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
 +
|-
 +
| UDID SHA1 || tt_udid_sha1 || Use for send Taptica UDID in SHA1 format || tt_udid_sha1=1ddfad5e4377b8694b5fea2a4c4556e2add9605b || <span style="background: #EBF7E6; color: #3BB54A; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #D4EDC9;">Yes</span>
 +
|-
 +
| UDID MD5 || tt_udid_md5 || Use for send Taptica IMEI in MD5 format || tt_udid_md5=20fbe500c99939adabb4d06600eb4ee7 || <span style="background: #FEECE8; color: #E94E24; padding: 4px 10px; border-radius: 12px; font-weight: bold; font-size: 11px; border: 1px solid #FDD7D0;">No</span>
 
|}
 
|}
  
−
'''Html Ads'''
+
== Testing application IDs ==
 +
For the integration process ONLY please use the below application IDs:
  
−
{| border="1" cellspacing="0" cellpadding="2" valign="top"
+
    appid iPhone = c82a818c-859b-4faa-bfee-4dde683b9ae5
 +
    appid iPad = fbb159b3-a494-4a5d-bd80-ae9899157556
 +
    appid Android = fced70bd-cf47-44f0-86ae-533443b8155b
  
−
|'''Parameter'''
+
== Response ==
−
|'''Description''' 
+
−
|'''Example''' 
+
−
|-
+
  
−
|AdRequestGuid
+
The data is returned in a JSON format.
−
|Unique identifier of an ad request
+
−
|"{21EC2020-3AEA-1069-A2DD-08002B30309D}"
+
−
|-
+
  
−
|adType
+
• The JSON returned by Taptica AdCore servers is a single object, composed of simple fields of JSON Type String, described in the section below.
−
|The type of an ad. Must have the value "html"
+
−
|"html"
+
−
|-
+
  
−
|adUrl
+
'''Banner response'''
−
|A URL to which the user should be redirected to (usually Html Page)
+
<div style="background: #2d2d2d; color: #8bc34a; padding: 20px; border-radius: 8px; font-family: 'Consolas', monospace; direction: ltr; text-align: left; overflow-x: auto; font-size: 13px; line-height: 1.5;">
−
|"http://www.taptica.com"
+
{
−
|-
+
  adyxAdRequestGuid: "3b327792-f364-41b4-9f34-501f1acc3109"
 +
  adType: "banner"
 +
  imageUrl: "http://media.go2speed.org/brand/files/taptica/4278/Bingo_2tixanimated_Banner_320x50.gif"
 +
  imageAltText: null
 +
  adUrl: "http://tracking.taptica.com/aff_ic?tt_cid=3b327792f36441b49f34501f1acc3109&el=GbtixRMFpAr%2boJEVHfprXTgVAQ3Ld8jjq6x3iEWyaxyyAB9XQaJ2hY1C%2bRbXbyCqSUxUNfry7uYwwqJoGMRB4DXDBgQXPm3cW0TjdSjP3GwU4L4c80snbxBqkCNTlGzYfeDOTGlIBc72p%2bKawW1NjSO6o5imY%2fv08FTGqOkRkhtpsdYOVHKXY6dYrgs57S2lAlmQgY62z3717Io%2f82fSHB4vgiY9rovVowp65VpiBKbt3a6VLqOpERRikOpS6NDRe4qtJFdK326mBMsVETyPW1Egv4eZAnn1baZ5OLwYf9TWP3x1OsgHBD9YV5V2hA%2btjAExs9A%2brj%2b5Tk2lGAGFpK%2bM%2bd3ttbG%2f%2brE2WlbRVHfE3EtatWKJ0g2kh8p2uccF7N5FsRn9PvvRTwgM0pgmw9h5xjcFcG9PfLRrmZ6QXCq5hytHd4B3y7WU1pQUmjtQO8YHaj0wTdZ2NJJtyfuIL78qSwgTqfYiAkg7%2bMDVjs%3d"
 +
  impUrl: "http://ad.taptica.com/aff_i?tt_cid=3b327792f36441b49f34501f1acc3109&el=GbtixRMFpAr%2boJEVHfprXTgVAQ3Ld8jjq6x3iEWyaxyyAB9XQaJ2hY1C%2bRbXbyCqSUxUNfry7uYwwqJoGMRB4DXDBgQXPm3cW0TjdSjP3GwU4L4c80snbxBqkCNTlGzYfeDOTGlIBc72p%2bKawW1NjSO6o5imY%2fv08FTGqOkRkhtpsdYOVHKXY6dYrgs57S2lAlmQgY62z3717Io%2f82fSHB4vgiY9rovVowp65VpiBKbt3a6VLqOpERRikOpS6NDRe4qtJFdK326mBMsVETyPW1Egv4eZAnn1baZ5OLwYf9UTWP3x1OsgHBD9YV5V2hA%2btjAExs9A%2brj%2b5Tk2lGAGFpK%2bM%2bd3ttbG%2f%2brE2WlbRVHfE3EtatWKJ0g2kh8p2uccF7N5FsRn9PvvRTwgM0pgmw9h5xjcFcG9PfLRrmZ6QXCq5hytHd4B3y7WU1pQUmjtQO8YHaj0wTdZ2NJJtyfuIL78qSwgTqfYiAkg7%2bMDVjs%3d"
 +
  urlType: "web"
 +
  beacon: null
 +
  adInterval: "10"
 +
  advAppId: "542781249"
 +
  storeUrl: null
 +
  payout: "1.05000"
 +
}
 +
</div>
  
−
|}
+
'''Full screen response'''
 +
<div style="background: #2d2d2d; color: #8bc34a; padding: 20px; border-radius: 8px; font-family: 'Consolas', monospace; direction: ltr; text-align: left; overflow-x: auto; font-size: 13px; line-height: 1.5;">
 +
{
 +
  adyxAdRequestGuid: "16e3738a-d8de-42eb-b2b2-717f05439d20"
 +
  adType: "html"
 +
  adUrl: "http://tracking.taptica.com/aff_ic?  tt_cid=16e3738ad8de42ebb2b2717f05439d20&el=GbtixRMFpAr%2boJEVHfprXTgVAQ3Ld8jjq6x3iEWya xw0xNkGtmnnjJwNwe44qM0tjC81iuD%2fY2OP%2flWMG4HvDojnhFFTvD6GjipHEVRrNZoBeU5KegCKluTbYLTH1YVt51xNRO2ol6vDbQZ08GhGA oaDDJVtOCueNjYpuRrvCKJuNZLMRlKjlfkUx%2fO6Rlqax5KBBEaOchzJ5CXUoXK2aw%2blgcWmhzU%2ftjQKs0nqY60AeJ%2f2Zi1ZJAKTgqii4exPXrSu4iHeo Oh9w80a1wkFC0s%2bjcFHe0EaDyAyp3zhkV6yrmd0bK%2flHPvR7yDpjOHKXjcEyfhZ%2b5oVMSoFyPhs%2bmM3p%2b5QCuliYboOs4qCgrXlgS4s3BqS4ysSVMm7nteZ 7Xwc89OoX3l73UN2m09BeeQsEWipt6cJdkocIgZpXS7tnJQaP2T8utWEVUiD9v6z50O1ogVrMyCoKrTXGO2iBbYAOQUhhvqxtOKRymKAqHLWLMsTnTfqkkRDgAnL791q"
 +
  impUrl: "http://ad.taptica.com/aff_i?tt_cid=16e3738ad8de42ebb2b2717f05439d20&el=GbtixRMFpAr%2boJEVHfprXTgVAQ3Ld8jjq6x3iEWyaxw0 xNkGtmnnjJwNwe44qM0tjC81iuD%2fY2OP%2flWMG4HvDojnhFFTvD6GjipHEVRrNZoBeU5KegCKluTbYLTH1YVt51xNRO2ol6vDbQZ08Gh GAoaDDJVtOCueNjYpuRrvCKJuNZLMRlKjlfkUx%2fO6Rlqax5KBBEaOchzJ5CXUoXK2aw%2blgcWmhzU%2ftjQKs0nqY60AeJ%2f2Zi1ZJAKTgqii4exPX rSu4iHeoOh9w80a1wkFC0s%2bjcFHe0EaDyAyp3zhkV6yrmd0bK%2flHPvR7yDpjOHKXjcEyfhZ%2b5oVMSoFyPhs%2bmM3p%2b5QCuliYboOs4qCgrXlgS4s3BqS4ysSVMm7 nteZ7Xwc89OoX3l73UN2m09BeeQsEWipt6cJdkocIgZpXS7tnJQaP2T8utWEVUiD9v6z50O1ogVrMyCoKrTXGO2iBbYAOQUhhvqxtOKRymKAqHLWLMsTnTfqkkRDgAnL791q"
 +
  urlType: "web"
 +
  htmlUrl: "http://media.go2speed.org/brand/files/taptica/4328/CandyCrush_playnow_fullscreen_320x480.jpg"
 +
  adInterval: "10"
 +
  htmlAdType: 2
 +
  advAppId: "553834731"
 +
  storeUrl: null
 +
  payout: "2.60000"
 +
}
 +
</div>
  
−
== Error Message ==
+
'''Video response'''
 +
<div style="background: #2d2d2d; color: #8bc34a; padding: 20px; border-radius: 8px; font-family: 'Consolas', monospace; direction: ltr; text-align: left; overflow-x: auto; font-size: 13px; line-height: 1.5;">
 +
{
 +
  adyxAdRequestGuid: "58188bd6-ed46-4f56-aac4-c16b485d4b6b"
 +
  adType: "video"
 +
  imageUrl: "http://e600e6c54b8c990f6738-c4afc8039c721ab8b1a8cb345a16e942.r90.cf2.rackcdn.com/iphone%20320x480.mov"
 +
  imageAltText: null
 +
  videoUrl: "http://e600e6c54b8c990f6738-c4afc8039c721ab8b1a8cb345a16e942.r90.cf2.rackcdn.com/iphone%20320x480.mov"
 +
  replayIcon: "http://e600e6c54b8c990f6738-c4afc8039c721ab8b1a8cb345a16e942.r90.cf2.rackcdn.com/replay.png"
 +
  downloadIcon: "http://e600e6c54b8c990f6738-c4afc8039c721ab8b1a8cb345a16e942.r90.cf2.rackcdn.com/continue.png"
 +
  continueIcon: "http://e600e6c54b8c990f6738-c4afc8039c721ab8b1a8cb345a16e942.r90.cf2.rackcdn.com/download.png"
 +
  adUrl: "http://tracking.taptica.com/aff_ic?tt_cid=58188bd6ed464f56aac4c16b485d4b6b&el=GbtixRMFpAr%2boJEVHfprXTgVAQ3 Ld8jjq6x3iEWyaxxI90tKwhYH8O2%2bNtl2DbVlpaq0uwf6qw81f%2fGyd7brqi8f6IUob547ToFQMI7SyOZbPkaMkObRLIzCDq2dibh0Te uBG%2fk9pqNnC73C9ODN5pM50OIod0IH%2bK5fv%2fF5k%2fqZHoLxeN63xxgFbtkfq8E5Ut4T0oPsCDl%2fM%2fJ7mnsGie04os0%2bb%2 bRrL3BRC%2bvcwv%2fuYqfUjlvc7Pb6HlwsqQ7CaS8EH8bHcim%2f9uP%2be%2b4ZL%2ffpCzwNG7LMui35B%2fhjPD7F95rISd%2fkL483U2 a3pKqU2hnBWDWE7YrN5pMwvAKC7MNzsSBhv0e4%2bnQEVLGwlZpQusm0RVB%2bRyStSzhfWt%2fxNsOriI7dg6WbjQW0Q0kqCns4zN3eeLey% 2betP1bJM5aZFo8BVeW%2fr4v7uxYOi3tGKKhEqlLnAOhjbh6LT0PdZuuW6fdEeg%2fRp6YGVeURsP7QE3CSCExADh0R8QXWxlfj5"
 +
  impUrl: null
 +
  contUrl: "http://ad.taptica.com/aff_i?offer_id=3418&aff_id=1740&tt_cid=58188bd6ed464f56aac4c16b485d4b6b&cont=1"
 +
  urlType: "web"
 +
  beacon: null
 +
  adInterval: "10"
 +
  advAppId: "531275818"
 +
  storeUrl: null
 +
  payout: "1.40000"
 +
}
 +
</div>
  
−
{| border="1" cellspacing="0" cellpadding="2" valign="top"
+
== impUrl ==
  
−
|'''Parameter'''
+
The goal of the ImpURL is to report Taptica that impression take place.
−
|'''Description''' 
+
−
|'''Example''' 
+
−
|-
+
  
−
|errorId
+
<div style="background: #FFF9E6; border: 1px solid #FFE58F; padding: 15px; border-radius: 8px; color: #856404; font-weight: bold; margin: 20px 0; text-align: center; font-family: sans-serif;">
−
|The identifier of the error that occurred. If needed, extra text describing the error will be written into the errorText.
+
⚠️ MAKE SURE YOU FIRE IT WITH THE DEVICE USER AGENT
−
|"5"
+
</div>
 +
 
 +
* The impurl response is depend on your affiliate setting in Taptica
 +
 
 +
== Error Message ==
 +
 
 +
{| border="1" cellspacing="0" cellpadding="10" style="width:100%; border-collapse: collapse; border: 1px solid #ddd; font-family: sans-serif; direction: ltr; text-align: left;"
 +
|- style="background-color: #f8f9fa; color: #333; font-weight: bold; border-bottom: 2px solid #E94E24;"
 +
| 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"
+
 
|-
 
|-
−
 
+
| errorText || Contains additional information regarding the retrieved error. || "The error had happened due to the following unexpected reason: unsupported client"
 
|}
 
|}
−
 
  
 
== List of errors ==
 
== List of errors ==
  
−
{| border="1" cellspacing="0" cellpadding="2" valign="top"
+
{| border="1" cellspacing="0" cellpadding="10" style="width:100%; border-collapse: collapse; border: 1px solid #ddd; font-family: sans-serif; direction: ltr; text-align: left;"
−
 
+
|- style="background-color: #f8f9fa; color: #333; font-weight: bold; border-bottom: 2px solid #E94E24;"
−
|'''errorID'''
+
| errorID || Description
−
|'''Description''' 
+
 
|-
 
|-
−
 
+
| -1 || Unknown error. In this case, the errorText parameter will include the information that describes the error.
−
| -1
+
−
|Unknown error. In this case, the errorText parameter will include the information that describes the error.
+
 
|-
 
|-
−
 
+
| 0 || Server overload
−
|0
+
−
|Server overload
+
 
|-
 
|-
−
 
+
| 1 || Server could not find an appropriate ad (because of age restriction , for example)
−
|1
+
−
|Server could not find an appropriate ad (because of age restriction , for example)
+
 
|-
 
|-
−
 
+
| 2 || Application id is missing
−
|2
+
−
|Application id is missing
+
 
|-
 
|-
−
 
+
| 3 || Application id wasn't found on database
−
|3
+
−
|Application id wasn't found on database
+
 
|-
 
|-
−
 
+
| 4 || User agent is missing
−
|4
+
−
|User agent is missing
+
 
|-
 
|-
−
 
+
| 5 || User agent is not supported
−
|5
+
−
|User agent is not supported
+
 
|-
 
|-
−
 
+
| 6 || Test mode value is not supported
−
|6
+
−
|Test mode value is not supported
+
 
|-
 
|-
−
 
+
| 7 || Resolution size and/or density are not supported
−
|7
+
−
|Resolution size and/or density are not supported
+
 
|-
 
|-
−
 
+
| 8 || Resolution size and/or density are in the wrong format
−
|8
+
−
|Resolution size and/or density are in the wrong format
+
 
|-
 
|-
−
 
+
| 9 || Postal code is in wrong format
−
|9
+
−
|Postal code is in wrong format
+
 
|-
 
|-
−
 
+
| 10 || Area code is in wrong format
−
|10
+
−
|Area code is in wrong format
+
 
|-
 
|-
−
 
+
| 11 || Location is in wrong format
−
|11
+
−
|Location is in wrong format
+
 
|-
 
|-
−
 
+
| 12 || Birth date is in wrong format or is invalid
−
|12
+
−
|Birth date is in wrong format or is invalid
+
 
|-
 
|-
−
 
+
| 13 || Gender is in wrong format
−
|13
+
−
|Gender is in wrong format
+
 
|-
 
|-
−
 
+
| 14 || Unique Identifier is missing
−
|14
+
−
|Unique Identifier is missing
+
 
|-
 
|-
−
 
+
| 15 || Unique Identifier value is in wrong format or is invalid
−
|15
+
−
|Unique Identifier value is in wrong format or is invalid
+
 
|-
 
|-
−
 
+
| 16 || Localization is missing
−
|16
+
−
|Localization is missing
+
 
|-
 
|-
−
 
+
| 17 || Localization value is in wrong format or is invalid
−
|17
+
−
|Localization value is in wrong format or is invalid
+
 
|-
 
|-
−
 
+
| 18 || Net type 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
−
|19
+
−
|Marital status value is not supported
+
 
|-
 
|-
 +
| 20 || Income value is in wrong format or is invalid
 +
|}
  
−
|20
+
<div style="margin-top: 50px; padding: 20px; border-top: 1px solid #eee; color: #888; font-size: 13px; text-align: center; direction: ltr;">
−
|Income value is in wrong format or is invalid
+
© 2026 '''Taptica''' Ltd. | Performance Division of Nexxen
−
|-
+
</div>
−
 
+
−
|}
+

Latest revision as of 11:58, 12 May 2026

API: Advertisement Service

Contents

[edit] Communications

The communication will be done using the HTTP protocol.

[edit] End Point

Service end point:
POST:

http://ad.taptica.com/aff_ad

[edit] Request

• The request is sent via an HTTP POST to the following URL: http://ad.taptica.com/aff_ad
• 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: http://ad.taptica.com/aff_ad

Body:

w&t=2&aff_id=1740&tt_sub_aff=15472&r=320x50&i=50.57.113.223&u=Mozilla/5.0 (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&tt_aff_impid=wyts98247asda&tt_aff_clickid=123456asd

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
Sub affiliate/publisher tt_sub_aff Represents lower level of the affiliate traffic source tt_sub_aff=123529 NO
IP Address i Client IP Address i=84.103.57.1 YES
Interval int set the refresh rate in milliseconds (minutemen value 10000) int=15000 NO
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-uk 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), Interstitial (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
Pipeline_data pd A free parameter for the affiliate use (can be send back to affiliate with S2S postback) pd=Any Affiliate Data NO
Affiliate impression id tt_aff_impid Used for impression id that the publisher may want to send and get back via S2S postback tt_aff_impid=asjhbasdk7832sa NO
Affiliate click id tt_aff_clickid Used for click id that the publisher may want to send and get back via S2S postback tt_aff_clickid=qa143287w NO

[edit] Taptica Device Keys

Parameter Name In Request Description Example Dynamic?
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
Android Advertising ID tt_advertising_id Use for send Taptica Android advertising plain ID tt_advertising_id=3ee0149b4ccef71bs85d24derg Yes
Android Advertising ID SHA1 tt_advertising_id_sha1 Use for send Taptica Android advertising ID in SHA1 format tt_advertising_id=32f2e52e8157fcb729d799d1ca69160df2edf8974 Yes
Android Advertising ID MD5 tt_advertising_id_md5 Use for send Taptica Android advertising ID in MD5 format tt_advertising_id=2315w52e8157fcb729d799d1ca691608speofd2 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_mac_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=4A9B0CAB-FFA5-4190-8CC0-D974D98FC7DB 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

[edit] Testing application IDs

For the integration process ONLY please use the below application IDs: 

   appid iPhone = c82a818c-859b-4faa-bfee-4dde683b9ae5
   appid iPad = fbb159b3-a494-4a5d-bd80-ae9899157556
   appid Android = fced70bd-cf47-44f0-86ae-533443b8155b

[edit] Response

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: "http://media.go2speed.org/brand/files/taptica/4278/Bingo_2tixanimated_Banner_320x50.gif"
 imageAltText: null
 adUrl: "http://tracking.taptica.com/aff_ic?tt_cid=3b327792f36441b49f34501f1acc3109&el=GbtixRMFpAr%2boJEVHfprXTgVAQ3Ld8jjq6x3iEWyaxyyAB9XQaJ2hY1C%2bRbXbyCqSUxUNfry7uYwwqJoGMRB4DXDBgQXPm3cW0TjdSjP3GwU4L4c80snbxBqkCNTlGzYfeDOTGlIBc72p%2bKawW1NjSO6o5imY%2fv08FTGqOkRkhtpsdYOVHKXY6dYrgs57S2lAlmQgY62z3717Io%2f82fSHB4vgiY9rovVowp65VpiBKbt3a6VLqOpERRikOpS6NDRe4qtJFdK326mBMsVETyPW1Egv4eZAnn1baZ5OLwYf9TWP3x1OsgHBD9YV5V2hA%2btjAExs9A%2brj%2b5Tk2lGAGFpK%2bM%2bd3ttbG%2f%2brE2WlbRVHfE3EtatWKJ0g2kh8p2uccF7N5FsRn9PvvRTwgM0pgmw9h5xjcFcG9PfLRrmZ6QXCq5hytHd4B3y7WU1pQUmjtQO8YHaj0wTdZ2NJJtyfuIL78qSwgTqfYiAkg7%2bMDVjs%3d"
 impUrl: "http://ad.taptica.com/aff_i?tt_cid=3b327792f36441b49f34501f1acc3109&el=GbtixRMFpAr%2boJEVHfprXTgVAQ3Ld8jjq6x3iEWyaxyyAB9XQaJ2hY1C%2bRbXbyCqSUxUNfry7uYwwqJoGMRB4DXDBgQXPm3cW0TjdSjP3GwU4L4c80snbxBqkCNTlGzYfeDOTGlIBc72p%2bKawW1NjSO6o5imY%2fv08FTGqOkRkhtpsdYOVHKXY6dYrgs57S2lAlmQgY62z3717Io%2f82fSHB4vgiY9rovVowp65VpiBKbt3a6VLqOpERRikOpS6NDRe4qtJFdK326mBMsVETyPW1Egv4eZAnn1baZ5OLwYf9UTWP3x1OsgHBD9YV5V2hA%2btjAExs9A%2brj%2b5Tk2lGAGFpK%2bM%2bd3ttbG%2f%2brE2WlbRVHfE3EtatWKJ0g2kh8p2uccF7N5FsRn9PvvRTwgM0pgmw9h5xjcFcG9PfLRrmZ6QXCq5hytHd4B3y7WU1pQUmjtQO8YHaj0wTdZ2NJJtyfuIL78qSwgTqfYiAkg7%2bMDVjs%3d"
 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: "http://tracking.taptica.com/aff_ic?  tt_cid=16e3738ad8de42ebb2b2717f05439d20&el=GbtixRMFpAr%2boJEVHfprXTgVAQ3Ld8jjq6x3iEWya xw0xNkGtmnnjJwNwe44qM0tjC81iuD%2fY2OP%2flWMG4HvDojnhFFTvD6GjipHEVRrNZoBeU5KegCKluTbYLTH1YVt51xNRO2ol6vDbQZ08GhGA oaDDJVtOCueNjYpuRrvCKJuNZLMRlKjlfkUx%2fO6Rlqax5KBBEaOchzJ5CXUoXK2aw%2blgcWmhzU%2ftjQKs0nqY60AeJ%2f2Zi1ZJAKTgqii4exPXrSu4iHeo Oh9w80a1wkFC0s%2bjcFHe0EaDyAyp3zhkV6yrmd0bK%2flHPvR7yDpjOHKXjcEyfhZ%2b5oVMSoFyPhs%2bmM3p%2b5QCuliYboOs4qCgrXlgS4s3BqS4ysSVMm7nteZ 7Xwc89OoX3l73UN2m09BeeQsEWipt6cJdkocIgZpXS7tnJQaP2T8utWEVUiD9v6z50O1ogVrMyCoKrTXGO2iBbYAOQUhhvqxtOKRymKAqHLWLMsTnTfqkkRDgAnL791q"
 impUrl: "http://ad.taptica.com/aff_i?tt_cid=16e3738ad8de42ebb2b2717f05439d20&el=GbtixRMFpAr%2boJEVHfprXTgVAQ3Ld8jjq6x3iEWyaxw0 xNkGtmnnjJwNwe44qM0tjC81iuD%2fY2OP%2flWMG4HvDojnhFFTvD6GjipHEVRrNZoBeU5KegCKluTbYLTH1YVt51xNRO2ol6vDbQZ08Gh GAoaDDJVtOCueNjYpuRrvCKJuNZLMRlKjlfkUx%2fO6Rlqax5KBBEaOchzJ5CXUoXK2aw%2blgcWmhzU%2ftjQKs0nqY60AeJ%2f2Zi1ZJAKTgqii4exPX rSu4iHeoOh9w80a1wkFC0s%2bjcFHe0EaDyAyp3zhkV6yrmd0bK%2flHPvR7yDpjOHKXjcEyfhZ%2b5oVMSoFyPhs%2bmM3p%2b5QCuliYboOs4qCgrXlgS4s3BqS4ysSVMm7 nteZ7Xwc89OoX3l73UN2m09BeeQsEWipt6cJdkocIgZpXS7tnJQaP2T8utWEVUiD9v6z50O1ogVrMyCoKrTXGO2iBbYAOQUhhvqxtOKRymKAqHLWLMsTnTfqkkRDgAnL791q"
 urlType: "web"
 htmlUrl: "http://media.go2speed.org/brand/files/taptica/4328/CandyCrush_playnow_fullscreen_320x480.jpg"
 adInterval: "10"
 htmlAdType: 2
 advAppId: "553834731"
 storeUrl: null
 payout: "2.60000"
}

Video response 

{
 adyxAdRequestGuid: "58188bd6-ed46-4f56-aac4-c16b485d4b6b"
 adType: "video"
 imageUrl: "http://e600e6c54b8c990f6738-c4afc8039c721ab8b1a8cb345a16e942.r90.cf2.rackcdn.com/iphone%20320x480.mov"
 imageAltText: null
 videoUrl: "http://e600e6c54b8c990f6738-c4afc8039c721ab8b1a8cb345a16e942.r90.cf2.rackcdn.com/iphone%20320x480.mov"
 replayIcon: "http://e600e6c54b8c990f6738-c4afc8039c721ab8b1a8cb345a16e942.r90.cf2.rackcdn.com/replay.png"
 downloadIcon: "http://e600e6c54b8c990f6738-c4afc8039c721ab8b1a8cb345a16e942.r90.cf2.rackcdn.com/continue.png"
 continueIcon: "http://e600e6c54b8c990f6738-c4afc8039c721ab8b1a8cb345a16e942.r90.cf2.rackcdn.com/download.png"
 adUrl: "http://tracking.taptica.com/aff_ic?tt_cid=58188bd6ed464f56aac4c16b485d4b6b&el=GbtixRMFpAr%2boJEVHfprXTgVAQ3 Ld8jjq6x3iEWyaxxI90tKwhYH8O2%2bNtl2DbVlpaq0uwf6qw81f%2fGyd7brqi8f6IUob547ToFQMI7SyOZbPkaMkObRLIzCDq2dibh0Te uBG%2fk9pqNnC73C9ODN5pM50OIod0IH%2bK5fv%2fF5k%2fqZHoLxeN63xxgFbtkfq8E5Ut4T0oPsCDl%2fM%2fJ7mnsGie04os0%2bb%2 bRrL3BRC%2bvcwv%2fuYqfUjlvc7Pb6HlwsqQ7CaS8EH8bHcim%2f9uP%2be%2b4ZL%2ffpCzwNG7LMui35B%2fhjPD7F95rISd%2fkL483U2 a3pKqU2hnBWDWE7YrN5pMwvAKC7MNzsSBhv0e4%2bnQEVLGwlZpQusm0RVB%2bRyStSzhfWt%2fxNsOriI7dg6WbjQW0Q0kqCns4zN3eeLey% 2betP1bJM5aZFo8BVeW%2fr4v7uxYOi3tGKKhEqlLnAOhjbh6LT0PdZuuW6fdEeg%2fRp6YGVeURsP7QE3CSCExADh0R8QXWxlfj5"
 impUrl: null
 contUrl: "http://ad.taptica.com/aff_i?offer_id=3418&aff_id=1740&tt_cid=58188bd6ed464f56aac4c16b485d4b6b&cont=1"
 urlType: "web"
 beacon: null
 adInterval: "10"
 advAppId: "531275818"
 storeUrl: null
 payout: "1.40000"
}

[edit] impUrl

The goal of the ImpURL is to report Taptica that impression take place.

⚠️ MAKE SURE YOU FIRE IT WITH THE DEVICE USER AGENT

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

[edit] 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"

[edit] 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

© 2026 Taptica Ltd. | Performance Division of Nexxen

Retrieved from "https://wiki.taptica.com/index.php?title=Retrieve_Ads&oldid=724"
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox