get_os

Provides views, viewed_minutes and viewed_minutes_per_view for each operating system seen over the specified date range.

Explorer

Explore this method

Request URL

http://api.tubemogul.com/api/v3/

HTTP method

GET

Arguments

scope (string)

The scope of the method being called. Valid values are tracker or publisher.

id (string)

The ID corresponding to the scope of the report.

start (string)

The start date for the report. Format is YYYY-MM-DD.

end (string)

The end date for the report. Format is YYYY-MM-DD.

site_id (string) — Optional

The ID for your site. This is required for publisher-scoped queries but not for trackers. Contact us if you do not know your site_id.

interval (string) — Optional

Specifies the interval.

Example Response

http://api.tubemogul.com/api/v3?date=1286569067&user_id=123456
&method=get_os&scope=tracker&id=TD-PEX-222&start=2010-10-01&end=2010-10-08
&interval=perday&auth=9b27a687711c4b020d03b41d75d5d24c06060f9c
<response name="get_os" status="ok">
  <views>649015</views>
  <viewed_minutes>1419823</viewed_minutes>
  <viewed_minutes_per_view>2.19</viewed_minutes_per_view>
  <oses>
    <os name="Android 2.x">
      <views>977</views>
      <viewed_minutes>1591</viewed_minutes>
      <viewed_minutes_per_view>1.63</viewed_minutes_per_view>
      <details interval="perday">
        <entry>
          <date>2010-10-01</date>
          <views>0</views>
          <viewed_minutes>0</viewed_minutes>
          <viewed_minutes_per_view>0.0</viewed_minutes_per_view>
        </entry>
		...
        <entry>
          <date>2010-10-08</date>
          <views>55</views>
          <viewed_minutes>95</viewed_minutes>
          <viewed_minutes_per_view>1.74</viewed_minutes_per_view>
        </entry>
      </details>
    </os>
    <os name="Linux">
      <views>9690</views>
      <viewed_minutes>19186</viewed_minutes>
      <viewed_minutes_per_view>1.98</viewed_minutes_per_view>
      <details interval="perday">
        <entry>
          <date>2010-10-01</date>
          <views>0</views>
          <viewed_minutes>0</viewed_minutes>
          <viewed_minutes_per_view>0.0</viewed_minutes_per_view>
        </entry>
		...
        <entry>
          <date>2010-10-08</date>
          <views>917</views>
          <viewed_minutes>1746</viewed_minutes>
          <viewed_minutes_per_view>1.9</viewed_minutes_per_view>
        </entry>
      </details>
    </os>
    <os name="Mac OS X">
      <views>210174</views>
      <viewed_minutes>455133</viewed_minutes>
      <viewed_minutes_per_view>2.17</viewed_minutes_per_view>
      <details interval="perday">
        <entry>
          <date>2010-10-01</date>
          <views>0</views>
          <viewed_minutes>0</viewed_minutes>
          <viewed_minutes_per_view>0.0</viewed_minutes_per_view>
        </entry>
		...
        <entry>
          <date>2010-10-08</date>
          <views>12925</views>
          <viewed_minutes>29138</viewed_minutes>
          <viewed_minutes_per_view>2.25</viewed_minutes_per_view>
        </entry>
      </details>
    </os>
    <os name="Mac OS X (iPad)">
      <views>4</views>
      <viewed_minutes>4</viewed_minutes>
      <viewed_minutes_per_view>1.05</viewed_minutes_per_view>
      <details interval="perday">
        <entry>
          <date>2010-10-01</date>
          <views>0</views>
          <viewed_minutes>0</viewed_minutes>
          <viewed_minutes_per_view>0.0</viewed_minutes_per_view>
        </entry>
		...
        <entry>
          <date>2010-10-08</date>
          <views>0</views>
          <viewed_minutes>0</viewed_minutes>
          <viewed_minutes_per_view>0.0</viewed_minutes_per_view>
        </entry>
      </details>
    </os>
    <os name="Mac OS X (iPhone)">
      <views>2</views>
      <viewed_minutes>2</viewed_minutes>
      <viewed_minutes_per_view>1.15</viewed_minutes_per_view>
      <details interval="perday">
        <entry>
          <date>2010-10-01</date>
          <views>0</views>
          <viewed_minutes>0</viewed_minutes>
          <viewed_minutes_per_view>0.0</viewed_minutes_per_view>
        </entry>
		...
        <entry>
          <date>2010-10-08</date>
          <views>0</views>
          <viewed_minutes>0</viewed_minutes>
          <viewed_minutes_per_view>0.0</viewed_minutes_per_view>
        </entry>
      </details>
    </os>
    <os name="Unknown">
      <views>180</views>
      <viewed_minutes>360</viewed_minutes>
      <viewed_minutes_per_view>2.0</viewed_minutes_per_view>
      <details interval="perday">
        <entry>
          <date>2010-10-01</date>
          <views>0</views>
          <viewed_minutes>0</viewed_minutes>
          <viewed_minutes_per_view>0.0</viewed_minutes_per_view>
        </entry>
		...
        <entry>
          <date>2010-10-08</date>
          <views>12</views>
          <viewed_minutes>19</viewed_minutes>
          <viewed_minutes_per_view>1.61</viewed_minutes_per_view>
        </entry>
      </details>
    </os>
    <os name="Windows 7">
      <views>97040</views>
      <viewed_minutes>209315</viewed_minutes>
      <viewed_minutes_per_view>2.16</viewed_minutes_per_view>
      <details interval="perday">
        <entry>
          <date>2010-10-01</date>
          <views>0</views>
          <viewed_minutes>0</viewed_minutes>
          <viewed_minutes_per_view>0.0</viewed_minutes_per_view>
        </entry>
		...
        <entry>
          <date>2010-10-08</date>
          <views>6232</views>
          <viewed_minutes>13833</viewed_minutes>
          <viewed_minutes_per_view>2.22</viewed_minutes_per_view>
        </entry>
      </details>
    </os>
    <os name="Windows Vista">
      <views>89530</views>
      <viewed_minutes>200189</viewed_minutes>
      <viewed_minutes_per_view>2.24</viewed_minutes_per_view>
      <details interval="perday">
        <entry>
          <date>2010-10-01</date>
          <views>0</views>
          <viewed_minutes>0</viewed_minutes>
          <viewed_minutes_per_view>0.0</viewed_minutes_per_view>
        </entry>
		...
        <entry>
          <date>2010-10-08</date>
          <views>5516</views>
          <viewed_minutes>13071</viewed_minutes>
          <viewed_minutes_per_view>2.37</viewed_minutes_per_view>
        </entry>
      </details>
    </os>
    <os name="Windows XP">
      <views>240146</views>
      <viewed_minutes>531001</viewed_minutes>
      <viewed_minutes_per_view>2.21</viewed_minutes_per_view>
      <details interval="perday">
        <entry>
          <date>2010-10-01</date>
          <views>0</views>
          <viewed_minutes>0</viewed_minutes>
          <viewed_minutes_per_view>0.0</viewed_minutes_per_view>
        </entry>
		...
        <entry>
          <date>2010-10-08</date>
          <views>15486</views>
          <viewed_minutes>33854</viewed_minutes>
          <viewed_minutes_per_view>2.19</viewed_minutes_per_view>
        </entry>
      </details>
    </os>
  </oses>
</response>

Error Codes

Standard error codes