Display Ad Tags - Version 2
Table of Contents
Overview
Digital Turbine’s ad request service provides a platform for the promotion of mobile applications via its network of publisher partners. Advertisers set up campaigns through Digital Turbine’s Developer Portal and can bid for inventory across the network. Advertisements subsequently appear on Digital Turbine’s ad networks/publishers.
Guidelines
The Digital Turbine Display Ad Tags enable partners to deliver ads from their mobile web site or mobile application without requiring any integration.
- Ads are intended to be served for real time presentation, as inventory will be updated at minimum on an hourly basis.
- Both the device user agent and IP address are required to be passed through in the request headers for targeting purposes. Ads will not be returned if these are not set.
JavaScript Tag:
<script type="text/javascript" src="http://ads.appia.com/v2/getAds.jsp?siteId=[siteId]&adTypeId=[adTypeID]&t=[CacheBuster]&placementId=[PlacementId]&androidId=[AndroidID]&idfa=[IDFA]&aaid=[AndroidAdvertisingID]&subSite=[SubSite]"></script>
The javascript tag returns a document.write() method with embedded markup containing a click through URL, creative, and 1x1 pixel.
Ad Request Parameters:
Key | Required | Description |
siteId | Yes | To be provided by Digital Turbine. |
adTypeId | Yes | The type of ad returned, fully formed HTML or various sizes of images. 4 – 300x50 Banner 5 – 320x50 Banner 6 – 300x250 Interstitial 7 – 320x480 Interstitial 8 – 480x320 Interstitial 9 – 768x1024 Interstitial 10 – 1024x768 Interstitial 11 - 390x200 interstitial 12 - 240x350 Interstitial 13 - 750x560 Interstitial 14 - 560x750 Interstitial 15 – 728x90 Banner 16 - 1200x627 Interstitial |
t | Yes | All ad requests require a cache buster. This can be either a timestamp or random number. |
| placementId | Yes | Placement of site id in VIA |
categoryId | No | Allows only ads of a specific category/subcategory to be returned. Category IDs can be comma separated to filter for multiple categories. See the table at the end of the document for a list of IDs and their category names. |
androidId | No | Raw Android ID for optimization and conversion tracking. |
idfa | No | Raw iOS IDFA for optimization and conversion tracking when available. |
| aaid | No | Android Advertising ID for optimization and conversion tracking. |
| subSite | No | An identifier for the site or application (app name, package name, or bundle ID) requesting the ad from within the partner's system that can be used to optimize performance on the publisher network, can be numerical ID or text (e.g., candycrushsaga). Can be alpha or numeric, up to 20 Characters and supported by UTF8 Encoding |
| clickUrl | No | URL encoded click tracking URL that Digital Turbine will call when an ad is clicked. |
Rendered Banner:
Request Ads - Error Response
If no ads are available for the given targeting criteria (IP Address and User Agent), then no ad will be returned.
Campaign Categories
| Category ID | Platform | Category | Sub-Category |
| 9 | Android | Games | All Games |
| 10 | Android | Games | Arcade & Action |
| 11 | Android | Games | Brain & Puzzle |
| 12 | Android | Games | Cards & Casino |
| 13 | Android | Games | Casual |
| 14 | Android | Games | Racing |
| 15 | Android | Games | Sports |
| 33 | Android | Apps | All Apps |
| 2 | Android | Apps | Books & Reference |
| 3 | Android | Apps | Business |
| 4 | Android | Apps | Comics |
| 5 | Android | Apps | Communication |
| 6 | Android | Apps | Education |
| 7 | Android | Apps | Entertainment |
| 8 | Android | Apps | Finance |
| 16 | Android | Apps | Health & Fitness |
| 17 | Android | Apps | Lifestyle |
| 18 | Android | Apps | Local |
| 19 | Android | Apps | Media & Video |
| 20 | Android | Apps | Medical |
| 21 | Android | Apps | Music |
| 22 | Android | Apps | News |
| 23 | Android | Apps | Personalization |
| 24 | Android | Apps | Photography |
| 25 | Android | Apps | Productivity |
| 26 | Android | Apps | Shopping |
| 27 | Android | Apps | Social Networking |
| 28 | Android | Apps | Sports |
| 29 | Android | Apps | Tools & Utilities |
| 30 | Android | Apps | Transportation |
| 31 | Android | Apps | Travel |
| 32 | Android | Apps | Weather |
| 35 | iOS | Games | All Games |
| 36 | iOS | Games | Action |
| 37 | iOS | Games | Adventure |
| 38 | iOS | Games | Arcade |
| 39 | iOS | Games | Board |
| 40 | iOS | Games | Card |
| 41 | iOS | Games | Casino |
| 42 | iOS | Games | Dice |
| 43 | iOS | Games | Educational |
| 44 | iOS | Games | Family |
| 45 | iOS | Games | Kids |
| 46 | iOS | Games | Music |
| 47 | iOS | Games | Puzzle |
| 48 | iOS | Games | Racing |
| 49 | iOS | Games | Role Playing |
| 50 | iOS | Games | Simulation |
| 51 | iOS | Games | Sports |
| 52 | iOS | Games | Strategy |
| 53 | iOS | Games | Trivia |
| 54 | iOS | Games | Word |
| 55 | iOS | Apps | All Apps |
| 56 | iOS | Apps | Books |
| 57 | iOS | Apps | Business |
| 58 | iOS | Apps | Catalogues |
| 59 | iOS | Apps | Education |
| 60 | iOS | Apps | Entertainment |
| 61 | iOS | Apps | Finance |
| 62 | iOS | Apps | Food & Drink |
| 63 | iOS | Apps | Health & Fitness |
| 64 | iOS | Apps | Lifestyle |
| 65 | iOS | Apps | Medical |
| 66 | iOS | Apps | Music |
| 67 | iOS | Apps | Navigation |
| 68 | iOS | Apps | News |
| 69 | iOS | Apps | Newstand |
| 70 | iOS | Apps | Photo & Video |
| 71 | iOS | Apps | Productivity |
| 72 | iOS | Apps | Reference |
| 73 | iOS | Apps | Social Networking |
| 74 | iOS | Apps | Sports |
| 75 | iOS | Apps | Travel |
| 76 | iOS | Apps | Utilities |
| 77 | iOS | Apps | Weather |