Bulk API

Revision as of 10:05, 19 January 2016

Taptica Bulk API allows you to pull the offers Meta data from our servers, the offers inventory will be associated with your account by Taptica account managers.

Since there are frequent changes in the production offers list,The publisher is responsible to generate the request every hour. In case an offer was returned in a previous response and is no longer in the response, it means you have to Remove the offer from production.

Taptica is limiting the numbers of daily requests per country,once you exceed 3000 requests you will not get response.

Request

• The request is sent via an HTTP "Get request" to the following URL: https://api.taptica.com/v2/bulk?

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

Example: Get to https://api.taptica.com/v2/bulk?token=4rxhjspwWQDZscvPgC6jqw%3d%3d&platforms=iPhone&countries=IL,US&payoutType=&minPayout=&categories=games&format=XML&size=320X480,320X50,728X90&version=1

Request parameters

Response

Response parameters

Id 49552
Name 20130327115527-DJ_Tira_static_Banner_320X320.gif
CreativeLink http://media.go2speed.org/brand/files/taptica/3530/20130327115527-DJ_Tira_static_Banner_320X320.gif
CreativeType banner
CreativeSize 320x320

• The tracking link should be a combination of the response you get in the "TrackingLink" + Bannerid + "DeviceIds" for example:

http://tracking.taptica.com/aff_c?tt_ls=b&offer_id=4390&tt_appid=555150599&aff_id=2004&tt_sub_aff=YYYY&tt_bannerid=49552&tt_mac=&tt_mac_sha1=&tt_mac_md5=&tt_idfa=&tt_idfa_sha1=&tt_idfa_md5=&tt_aff_impid=1321sads35sa&tt_aff_clickid=qa143287w

Taptica Device Keys

 Category List

The optional categories names are:

Error messages

Sample MXL Response

<BulkApi>

 <error>OK</error>
 <errorCode>0</errorCode>
<Offer>
 <OfferId>14943</OfferId>
 <OfferName>Test Offer Black - iPhone</OfferName>
 <OfferDescription>Test Offer Black - iPhone</OfferDescription>
 <SupportedPlatform>IPhone</SupportedPlatform>
 <SupportedPlatform>IPod</SupportedPlatform>
 <MinimumOSVersion>4</MinimumOSVersion>
 <MarketAppId>Test Offer Black</MarketAppId>
 <PreviewLink>
  https://itunes.apple.com/us/app/candy-crush-saga/id553834731?mt=8
 </PreviewLink>
 <TrackingLink>
  http://tracking.taptica.com/aff_c?tt_ls=b&offer_id=14943&aff_id=3125018&tt_appid=Test_Offer_Black&tt_bannerid=
 </TrackingLink>
 <DeviceIdMandatory>false</DeviceIdMandatory>
  <BlockedSubAffiliate>Unavailable</BlockedSubAffiliate>
  <SupportedCountry>US</SupportedCountry>
  <SupportedCountry>GB</SupportedCountry>
  <SupportedCountry>AE</SupportedCountry>
  <SupportedCountry>IL</SupportedCountry>
 <Network>WIFI</Network>
  <Network>3G</Network>
 <PayoutType>CPA</PayoutType>
 <Payout>0.00000</Payout>
 <DailyBudget>Unlimited</DailyBudget>
 <Category>games</Category>
 <Category>multimedia</Category>
 <Category>automotive</Category>
 <Category>books and reference</Category>
 <Category>lifestyle</Category>
 <Category>kids</Category>
 <Category>gambling</Category>
 <Category>education</Category>
 <Category>news and weather</Category>
 <Category>communications</Category>
 <Category>entertainment</Category>
 <Category>financial services</Category>
 <Category>health and fitness</Category>
 <Category>shopping and retail</Category>
 <Category>social</Category>
 <Category>sports</Category>
 <Category>travel and local</Category>
 <Creative>
  <Id>177192</Id>
  <Name>300X250_black_animated.gif</Name>
  <CreativeLink>
   http://76b3ceeab4c855fb9953-3bebc903fd41a20c171fdfefdfe53008.r84.cf2.rackcdn.com/14943/20140616/d1a2268bb8504e8481acaf6678affbe2_300X250_black_animated.gif
  </CreativeLink>
  <CreativeType>FullScreen</CreativeType>
  <CreativeSize>300x250</CreativeSize>
 </Creative>
 <Creative>
  <Id>106245</Id>
  <Name>Dragon1.mp4</Name>
  <CreativeLink>
   http://76b3ceeab4c855fb9953-3bebc903fd41a20c171fdfefdfe53008.r84.cf2.rackcdn.com/14943_da8e34ec13d14419b5dca863fad45657_Dragon1.mp4
  </CreativeLink>
  <CreativeType>Video</CreativeType>
  <CreativeSize>320x480</CreativeSize>
 </Creative>
</Offer>

</BulkApi>