create_tracker

Creates a new tracker. 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

POST

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.

partner_id (string)

A unique partner identifier generated by TubeMogul and given to the partner site.

method (string)

The name of the method being called.

name (string)

The name given to this tracker. Limited to 40 characters.

timezone (string) — Optional

The timezone code assigned to this tracker. See timezones for details.

use_dst (string) — Optional

Indicates whether to observe daylight savings time.

date (integer)

A UNIX timestamp displaying the number of seconds elapsed since January 1st, 1970 (UTC).

auth (string)

A SHA-1 hash that concatenates the query string with the partners secret key (see Authenticating for details).

Response Parameters

tracker_id (string)

The identifier of the tracker that was created. Tracker IDs are prefixed with "TR-".

Example Response

http://api.tubemogul.com/api/v3?date=1232395951&user_id=123456&method=create_tracker
&timezone=PST&use_dst=y&name=Test%20Tracker&auth=aa6fb416b3cac7861be9c9db2ebeef564b70f2e4

<response name="create_tracker" status="ok">
  <tracker_id>TR-JAD-WBQ</tracker_id>
</response>

Error Codes

Standard error codes