get_stream_rebuffers

Gets errors due to rebuffering of the video for a given tracker or video ID. This includes statistics aggregated over the specified timeframe, plus optional per-day totals.

Explorer

Explore this method

Request URL

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

HTTP method

GET

Arguments

NOTE: dim values can not be specified.

scope (string)

The scope of the method being called. The only valid value is tracker.

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.

interval (string) — Optional

Determines the granularity of list values in the detailed response list. Valid values include perday or none. A value of none will omit the detail list. Defaults to none.

video_id (string) — Optional

The identifier provided for this video in the video player. This must be unique for every distinct video, and must not change over time. This will scope the response to include stats for this video only.

Response Parameters

views (integer)

The number of times the video(s) were viewed. A view is defined as when the video is actually played, i.e. when play is called on the Flash video object.

viewed_minutes (integer)

The total viewed minutes for this video(s).

rebuffers (integer)

The number of streams that had one or more rebuffer events during playback.

rebuffers_pct (number)

The percentage of streams that had one or more rebuffer events during playback.

rebuffers2_pct (number)

The percentage of streams that had two or more rebuffer events during playback. Not returned if video_id is specified.

rebuffers4_pct (number)

The percentage of streams that had four or more rebuffer events during playback. Not returned if video_id is specified.

rebuffers_per_stream (number)

The average number of rebuffering events that occurred for each stream.

lost_viewers_from_rebuffers (integer)

The number of lost viewers from rebuffers represents the number of viewers that stopped watching due to rebuffering errors. The statistic attempts to calculate how many viewers stopped watching when video errors were occuring. Not returned if video_id is specified.

daily_avg (integer)

The average number of rebuffers per day over the specified date range.

daily_max (integer)

The maximum number of rebuffers on any single day over the specified date range.

details (list)

A list of per-day stream rebuffers (above parameters, except for daily_avg and daily_max). The entries will scoped based on the arguments provided in the request.

Example Response

http://api.tubemogul.com/api/v3?date=1230109922&user_id=123456
&scope=tracker&id=TD-PEX-222&method=get_stream_rebuffers&interval=perday
&start=2008-12-10&end=2008-12-31&index=1&max_results=20
&auth=aa6fb416b3cac7861be9c9db2ebeef564b70f2e4

<response name="get_stream_rebuffers" status="ok">
  <views>1910754</views>
  <viewed_minutes>181849272</viewed_minutes>
  <rebuffers>246746</rebuffers>
  <rebuffers_pct>12.91</rebuffers_pct>
  <rebuffers2_pct>7.68</rebuffers2_pct>
  <rebuffers4_pct>4.78</rebuffers4_pct>
  <rebuffers_per_stream>0.13</rebuffers_per_stream>
  <lost_viewers_from_rebuffers>105481</lost_viewers_from_rebuffers>
  <daily_avg>11216</daily_avg>
  <daily_max>14816</daily_max>
  <details interval="perday" has_more_items="true" list_size="22" count="20">
    <entry>
      <date>2008-12-10</date>
      <views>74556</views>
      <viewed_minutes>9534107</viewed_minutes>
      <rebuffers>8209</rebuffers>
      <rebuffers_pct>11.01</rebuffers_pct>
      <rebuffers2_pct>7.14</rebuffers2_pct>
      <rebuffers4_pct>4.53</rebuffers4_pct>
      <rebuffers_per_stream>0.11</rebuffers_per_stream>
      <lost_viewers_from_rebuffers>74556</lost_viewers_from_rebuffers>
    </entry>
    ...
    <entry>
      <date>2008-12-29</date>
      <views>77749</views>
      <viewed_minutes>6414436</viewed_minutes>
      <rebuffers>11495</rebuffers>
      <rebuffers_pct>14.78</rebuffers_pct>
      <rebuffers2_pct>8.51</rebuffers2_pct>
      <rebuffers4_pct>5.23</rebuffers4_pct>
      <rebuffers_per_stream>0.15</rebuffers_per_stream>
      <lost_viewers_from_rebuffers>77749</lost_viewers_from_rebuffers>
    </entry>
  </details>
</response>

Error Codes

Standard error codes