Tag Builder - dcsMultiTrack

Description

The function named dcsMultiTrack is used to capture events that occur after a page is loaded. These include client-side mouse events (e.g. onclick, onmouseover), form events (e.g. onfocus, onblur), and interaction with embedded objects (e.g. Flash). This function serves as an entrypoint for callbacks from client-side events.

The function takes paired values as arguments:
   dcsMultiTrack('name1','value1','name2','value2',...)

All arguments are JavaScript strings which must be enclosed in quotes.

The first part of the pair is the parameter name which must be of the form:
   object.name
where,
   object - The name of one of three pre-defined custom objects: WT, DCS, DCSext.
   name - The property name of the custom object (for WT and DCS these are reserved names).

The second part of the pair is the parameter value.

All JavaScript variable assignments from the initial page load remain intact. Unless overridden, these variables are retained and used during each call to dcsMultiTrack. To clear out a variable assignment, assign the empty string ("") as a value at the beginning or end of dcsMultiTrack.

Note:

If you have already implemented dcsMultiTrack for tracking anchor links or for any other type of web site tracking, please consult with Webtrends Support or Services before you use this Tag Builder function.

Examples

  1. URI

    There are three parameters used by data collection to compose a URI: dcssip, dcsuri, dcsqry. These parameters are concatenated together to form the full URI as follows:
    http:// + dcssip + dcsuri + ? + dcsqry

    So the following dcsMultiTrack call:
    dcsMultiTrack('DCS.dcssip','www.webtrends.com','DCS.dcsuri','/solutions/default.asp','DCS.dcsqry','tab=Products')

    Would produce this URI:
    http://www.webtrends.com/solutions/default.asp?tab=products

  2. Page Title

    Webtrends Analytics uses the WT.ti parameter to specify page title.

    The following dcsMultiTrack call demonstrates page title specification:
    dcsMultiTrack('WT.ti','Test Page Title')

    Would produce this query parameter:
    &WT.ti=Test%20Page%20Title

  3. Custom parameters

    The following dcsMultiTrack call demonstrates the use of custom query parameters:
    dcsMultiTrack('DCSext.sport','baseball','DCSext.team','Seattle Mariners')

    Would produce these query parameters:
    &sport=baseball&team=Seattle%20Mariners

JavaScript Reference
n/a