The config
function is used to tell the tracker which project you're tracking. It also allows you to set a number of options that can affect your default pageview tracking (woopra.track()
No Args!!), the behavior, domains, and locations of cookies, how the ping works, etc.
The config
function supports key/value singleton argument:
woopra.config("cookie_name", "my_business_cookie");
Or an object of keys and values:
woopra.config({
download_tracking: true,
outgoing_tracking: true,
click_tracking: true
});
Auto tracking Configs
Options | Value | Description |
---|---|---|
|
| Automatically tracks downloads. See below note |
|
| Automatically tracks outgoing link clicks |
|
| Automatically tracks button clicks |
Note on 'download_extentions'
The default list is: avi, css, dmg, doc, eps, exe, js, m4v, mov, mp3, mp4, msi, pdf, ppt, rar, svg, txt, vsd, vxd, wma, wmv, xls, xlsx, zip
If you override the default, you this stops using our default list. You can use our list and include others like:
woopra.config({ domain: 'woopra.com', initialized: function () { woopra.config( 'download_extensions', woopra.config('download_extensions').concat('xml') ); } });
Configuring your Tracker
The Woopra tracker can be customized using the config function. The config options have some defaults for normal website tracking and with the exception of "domain
", can usually be left un-customized.
The tracker will not work, however without a domain
which is your project name in Woopra.
Find the list of options below:
Option | Default | Description |
---|---|---|
| N/A (required) | Required Project name in Woopra. Must be explicitly set for tracker to work. |
|
| Name of the cookie used to identify the visitor |
| Website domain | Domain scope of the Woopra cookie. Use |
|
| Directory scope of the Woopra cookie. |
|
| Expiration date (javascript Date object) of the Woopra cookie |
|
| The protocol used to contact Woopra servers. |
|
| Deprecated. Ping woopra servers to ensure that the visitor is still on the webpage |
|
| Deprecated. Time interval in milliseconds between each ping |
|
| Idle time (in milliseconds) after which the user is considered offline |
|
| Track downloads on the web page |
|
| Overrides default list. See the note above for default extensions and ways to override the list. |
|
| Track external links clicks on the web page |
|
| Do not track links to subdomains as outgoing links |
|
| Ignores the query part of the url when the standard pageviews tracking function ( |
|
| Object with URL parameter keys mapped to action property names. (e.g. |
|
| Enabling this option will remove campaign properties from the URL when they’re captured (using HTML5 |