Bulk API

Revision as of 08:59, 9 January 2014

Taptica Bulk API allows you to get offers Meta data from your account. The offers you receive in the results will come from the offers that were connected to your account by your account manager.

Important!

Since there are frequent changes in the production offer lists The publisher is responsible to generate the request every hours. 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.

Request

• The request is sent via an HTTP Getto 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=pj14X%2fDPYLA4b%2fW9u52FkQ%3d%3d&platforms=iPhone&countries=IL,US&payoutType=&minPayout=0.5&categories=Games&format=XML

Request parameters

Response

Request 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?offer_id=4390&tt_appid=555150599&aff_id=2004&tt_aff_sub=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

• Device Parameters: Keep in mind, the more parameters you provide us with, your conversion rate will be higher. In case "IsDeviceIdMandatory" is set to true, you must provide at least one parameter from the DeviceIds list

• Taptica supports 4 parameters for publisher use.

In order to use them the publisher need to add them to the TrackingLink as in the above example.

Taptica Device Keys

Category List

The optional categories names are:

Error messages

Sample MXL Response

<BulkApi>
 <error>OK</error>
 <errorCode>0</errorCode>
 <Offer>
  <OfferName>Slotomania- iPad US</OfferName>
  <OfferDescription>
  Play Slotomania, the #1 slot machine game on iPhone, iPad, and Facebook! Enjoyed by millions worldwide; Slotomania is the favorite social slots game online   providing unlimited FREE entertainment, top-tier graphics, and high-quality sound effects. Players love Slotomania’s: *Huge variety of themed slot machines *Unique new games added all the timefrom bonus rounds, free spins, gifts, and mini games *Free gifts you can send and receive from friends *Many ways to quickly unlock games *Instant accessib
  </OfferDescription>
  <SupportedPlatform>ipad</SupportedPlatform>
  <MinimumOSVersion>4.9</MinimumOSVersion>
  <SupportedPlatform/>
  <MinimumOSVersion>Unavailable</MinimumOSVersion>
  <MarketAppId>483165745</MarketAppId>
  <PreviewLink>https://itunes.apple.com/app/id483165745?mt=8</PreviewLink>
  <TrackingLink>http://tracking.taptica.com/aff_c?offer_id=3914&aff_id=2004&tt_appid=483165745&tt_bannerid=
  </TrackingLink>
  <DeviceIdMandatory>false</DeviceIdMandatory>
  <UniqueDeviceId>tt_idfa</UniqueDeviceId>
  <UniqueDeviceId>tt_idfa_sha1</UniqueDeviceId>
  <UniqueDeviceId>tt_idfa_md5</UniqueDeviceId>
  <UniqueDeviceId>tt_mac</UniqueDeviceId>
  <UniqueDeviceId>tt_mac_sha1</UniqueDeviceId>
  <UniqueDeviceId>tt_mac_md5</UniqueDeviceId>
  <UniqueDeviceId>tt_udid</UniqueDeviceId>
  <UniqueDeviceId>tt_udid_sha1</UniqueDeviceId>
  <UniqueDeviceId>tt_udid_md5</UniqueDeviceId>
  <SupportedCountry>US</SupportedCountry>
  <SupportedCountry>UK</SupportedCountry>
  <Network>Unavailable</Network>
  <DailyBudget>Unlimited</DailyBudget>
  <PayoutType>CPA</PayoutType>
  <Payout>1.2</Payout>
  <DailyBudget>500.000</DailyBudget>
  <Category>Entertainment</Category>
  <Category>Gambling</Category>
  <CreativeData>
  <Id>49544</Id>
  <Name>DJ_Tira_animated_Banner_168X28.gif</Name>
  <CreativeLink>http://media.go2speed.org/brand/files/taptica/3530/DJ_Tira_animated_Banner_168X28.gif
  </CreativeLink>
  <CreativeType>banner</CreativeType>
  <CreativeSize>168x28</CreativeSize>
  </CreativeData>
  <CreativeData>
  <Id>49546</Id>
  <Name>DJ_Tira_animated_Banner_216X36.gif</Name>
  <CreativeLink>http://media.go2speed.org/brand/files/taptica/3530/DJ_Tira_animated_Banner_216X36.gif
  </CreativeLink>
  <CreativeType>banner</CreativeType>
  <CreativeSize>216x36</CreativeSize>
  </CreativeData>
  <BlockedSubAffiliate>Unavailable</BlockedSubAffiliate>
  <BannerText>Unavailable</BannerText>
  <AppIconURL>
   http://a2.mzstatic.com/us/r30/Purple4/v4/7b/62/bd/7b62bd85-dc63-ab21-dff5-341c7a1c4e82/mzl.ikgtlknp.175x175-75.jpg
  </AppIconURL>
  <AppProviderName>Playtika LTD</AppProviderName>
  <AppName>Slotomania HD - FREE Slots</AppName>
 </Offer>
</BulkApi>