get_new_viewers

Gets the number of new viewers for a given tracker. A new viewer is one that is appearing in the InPlay system for the first time. This includes statistics aggregated over the specified timeframe, plus optional per-day, week or month 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.

Response Parameters

new_viewers (integer)

The total new viewers over the specified date range. A new viewer is a viewer that has never before been seen (within the specified scope parameter).

daily_avg (integer)

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

daily_max (integer)

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

details (list)

A list of per-day new viewers with the following parameters: date and new_viewers. 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-243&method=get_new_viewers&interval=perday
&start=2008-12-10&end=2008-12-31&index=1&max_results=20
&auth=aa6fb416b3cac7861be9c9db2ebeef564b70f2e4

<response name="get_new_viewers" status="ok">
  <new_viewers>1122151</new_viewers>
  <daily_avg>51006</daily_avg>
  <daily_max>78131</daily_max>
  <details interval="perday" has_more_items="true" list_size="22" count="20">
    <entry>
      <date>2008-12-10</date>
      <new_viewers>35577</new_viewers>
    </entry>
    ...
    <entry>
      <date>2008-12-29</date>
      <new_viewers>54370</new_viewers>
    </entry>
  </details>
</response>

Error Codes

Standard error codes