get_attention_span

Gets the attention span statistics time for a given tracker or publisher. 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

scope (string)

The scope of the method being called. Valid values are tracker and 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.

dim (string) — Optional

Allows filtering by a specific category, player_embed or country dimension. If this parameter is not provided, a default of country is used. Note this is different from the default behavior for this parameter.

dimdetail (string) — Optional

This will filter the response to only include a specific dim value.

Response Parameters

dimension (string)

The dimension being analyzed.

pct_views_10s_plus (integer)

The percentage of views that watched for at least 10 seconds.

pct_views_20s_plus (integer)

The percentage of views that watched for at least 20 seconds.

pct_views_30s_plus (integer)

The percentage of views that watched for at least 30 seconds.

pct_views_60s_plus (integer)

The percentage of views that watched for at least 60 seconds.

pct_views_2min_plus (integer)

The percentage of views that watched for at least 2 minutes.

pct_views_3min_plus (integer)

The percentage of views that watched for at least 3 minutes.

pct_views_5min_plus (integer)

The percentage of views that watched for at least 5 minutes.

pct_views_10min_plus (integer)

The percentage of views that watched for at least 10 minutes.

pct_views_15min_plus (integer)

The percentage of views that watched for at least 15 minutes.

pct_views_30min_plus (integer)

The percentage of views that watched for at least 30 minutes.

Example Response

http://api-inplay.tubemogul.com/data/v2?date=1230109922&user_id=123456
&scope=tracker&id=all&method=get_attention_span&start=2008-12-10&end=2008-12-31
&dim=country&auth=aa6fb416b3cac7861be9c9db2ebeef564b70f2e4
<response name="get_attention_span" status="ok">
  <details has_more_items="true" list_size="205" count="20">
    <entry>
      <dimension>United States</dimension>
      <pct_views_10s_plus>288830</pct_views_10s_plus>
      <pct_views_20s_plus>227253</pct_views_20s_plus>
      <pct_views_30s_plus>51869</pct_views_30s_plus>
      <pct_views_60s_plus>172825</pct_views_60s_plus>
      <pct_views_2min_plus>118122</pct_views_2min_plus>
      <pct_views_3min_plus>64560</pct_views_3min_plus>
      <pct_views_5min_plus>160135</pct_views_5min_plus>
      <pct_views_10min_plus>57455</pct_views_10min_plus>
      <pct_views_15min_plus>4352</pct_views_15min_plus>
      <pct_views_30min_plus>10376</pct_views_30min_plus>
    </entry>
    ...
    <entry>
      <dimension>China</dimension>
      <pct_views_10s_plus>1177</pct_views_10s_plus>
      <pct_views_20s_plus>776</pct_views_20s_plus>
      <pct_views_30s_plus>503</pct_views_30s_plus>
      <pct_views_60s_plus>943</pct_views_60s_plus>
      <pct_views_2min_plus>815</pct_views_2min_plus>
      <pct_views_3min_plus>510</pct_views_3min_plus>
      <pct_views_5min_plus>764</pct_views_5min_plus>
      <pct_views_10min_plus>430</pct_views_10min_plus>
      <pct_views_15min_plus>172</pct_views_15min_plus>
      <pct_views_30min_plus>160</pct_views_30min_plus>
    </entry>
  </details>
</response>

Error Codes

Standard error codes