get_trackers

Gets the trackers associated with your account. Trackers are a means of forming independent data collection groups, for roll-up in the analytics system along different lines. For example, by CDN provider, website, etc. This allows considerable flexibility in collecting data in arbitrary groups of your choosing.

Explorer

Explore this method

Request URL

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

HTTP method

GET

Arguments

NOTE: Unless otherwise denoted, strings are limited to 256 UTF-8 encoded characters.

NOTE: The arguments for this method do not require all of the Global Arguments specified on the Overview page. The complete list of what is required is provided here.

tracker_id (string) — Optional

If a tracker_id is specified, only information about that tracker will be returned.

index (string) — Optional

Start index of the request when dealing with lists. Each response that contains a <details> list will contain <list_size> (of the complete list) and <has_more_items> elements. In addition, the <details> list contains a count attribute indicating how many items are in this page. Paging through lists is supported by providing an <index> to successive requests, which has been incremented by the count of the previous <details> list response. Defaults to 1.

max_results (string) — Optional

The maximum count value to be returned in a single response. Limited to 1000, and defaults to 50.

filter (string) — Optional

A free-form filter to apply to the list. The syndicating domain will be searched for a case-insensitive match of the provided string.

Response Parameters

details (list)

A list of trackers for this account. The entries will scoped based on the arguments provided in the request.

tracker_id (string)

The identifier for this tracker. Tracker IDs are prefixed with "TR-".

name (string)

The name given to this tracker.

timezone (string) — Optional

The timezone code assigned to this tracker. See timezones for details. If not returned, the account-level timezone is being used.

use_dst (y/n) — Optional

Indicates whether to observe daylight savings time. If not returned, the account-level timezone settings are being used.

Example Response

http://api.tubemogul.com/api/v3?date=1232395951&user_id=123456
&method=get_trackers&index=1&max_results=20
&auth=aa6fb416b3cac7861be9c9db2ebeef564b70f2e4

<response name="get_trackers" status="ok">
  <details has_more_items="false" list_size="5" count="5">
    <entry>
      <tracker_id>TR-ZSA-31G</tracker_id>
      <name>TubeMogul Tracker</name>
	  <timezone>EST</timezone>
	  <use_dst>n</use_dst>
    </entry>
    ...
    <entry>
      <tracker_id>TR-KFO-NTA</tracker_id>
      <name>Test tracker</name>
	  <timezone>PST</timezone>
	  <use_dst>y</use_dst>
    </entry>
  </details>
</response>

Error Codes

Standard error codes