Table of Contents
...
More information about authentication:
http://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
Example:
<?php
$url = "https://via.digitalturbine.com/ext/api/reports/subsites?siteId=XXXX";
$creds = "example@digitalturbine.com:digitalturbine123";
$c = curl_init();
curl_setopt($c, CURLOPT_URL, $url);
curl_setopt($c, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($c, CURLOPT_HTTPHEADER,array('Authorization: Basic ' . base64_encode($creds)));
$result = curl_exec($c);
curl_close($c);
?>
...
Digital Turbine's reporting is rolled up hourly, so it's recommended that queries be scheduled at most once per hour, at a staggered time so all Publisher requests are not at the top of the hour, thereby reducing response times.
Request
...
URL
https://via.digitalturbine.com/ext/api/reports/subsites
*Please note, Appia endpoints will continue to work (i.e. ..via.appia..)
Headers
| Parameter | Required | Description |
|---|---|---|
| Accept Header | No | XML and JSON are supported |
| Authorization | Yes | See Authentication section above |
...
| Parameter | Required | Description |
|---|---|---|
| siteId | No | ex. https://via.digitalturbine.com/ext/api/reports/subsites?siteId=9999 If not passed in, API will return results for all of your sites |
| subSite | No | ex. https://via.digitalturbine.com/ext/api/reports/subsites?siteId=9999&subSite=test The subSite value that was passed in on the ad request or click Requires SiteId If not passed in, API will return results for all of your sub-sites |
| startDate | No | ex. https://via.digitalturbine.com/ext/api/reports/subsites?startDate=2014-01-01 Requires End Date yyyy-mm-dd |
| endDate | No | ex. https://via.digitalturbine.com/ext/api/reports/subsites?startDate=2014-01-01&endDate=2014-01-31 Requires Start Date yyyy-mm-dd Max 31 day range in 1 API request |
...