Configuring the SharePoint Tag Installer App

Once the app is deployed, various customization and configuration options are available to you. The configuration topics are broken into four categories:

  • General
  • SharePoint
  • User Profile
  • Plugins

Changes are not applied until Save is clicked.

General

In the General section, you are able to set options that would be available to any website, and are not specific to SharePoint.

  • Data Collection URL
    This field allows you to specify what data collection server the app sends data to. It defaults to statse.webtrendslive.com.
  • DCSID
    This field allows you to specify what DCSID to send the collected data to. Webtrends data collectors require a valid DCSID to log any sent data. DCSID’s are generated by the Webtrends UI during the creation of new Datasources in A9 or the creation of new Site Spaces in A10. If you do not have a valid DCSID, contact your Webtrends administrator for one.
  • Time Zone Offset
    This field specifies the default time zone for the Site Collection. Note that the Webtrends.js files auto-detects time zone settings from visitors’ browser as well.
  • Enable Tracking
    This check box enables or disables tracking in the Webtrends app. The app deploys with tracking disabled by default. You must provide a valid DCSID, select Enable Tracking, then click Save to start sending data to Webtrends. After selecting the box and saving, all pages in the Site Collection and its subsites, include the Webtrends tracking code (including subsites and pages added at a later date).
  • Download Types to Track
    The list of file extensions that the scripts consider a download are specified here.
  • Use Hosted Webtrends.js
    Selecting this box uses the webtrends.js found at http://s.webtrends.com/js/webtrends.js. Otherwise, a local copy is used. This is the default configuration of the app. If your SharePoint install is locked down and you can’t use .js files from a remote source, de-select this box.
  • Enable i18n
    Select this to enable internationalization in the Webtrends tracking code.
  • Save
    Commit current the app configuration to the live app.

SharePoint

Under the SharePoint tab, you have options to enable and disable tracking of certain SharePoint features, as well as specify the element information that the Webtrends SharePoint plugin looks for that information in.

  • Collect User Name?
    Select this to retrieve the user name from the HTML code of the page.
  • User name element ID
    This sets the element ID to look for the user name in. The default is determined by the version and environment of SharePoint and does not appear if Collect user name? is not selected.
  • Alternate user name element ID
    If multiple design layouts are being used, a backup element ID may be provided for the user name. This option does not appear if Collect user name? is not selected.
  • Collect content information?
    Select to enable the collection of content information within SharePoint.
  • Collect search information?
    Select to collect information about searches that users are performing.
  • Search box element ID
    Specify the ID of the element that provides the search information. Since this is provided by SharePoint, it should not need to be changed. This option does not appear if Collect search information? is not selected.
  • Search Pages
    This field allows a you to enter a comma delimited list of pages that contain search results so the Webtrends SharePoint plugin can properly execute its search tracking. This option does not appear if Collect search information? is not selected.
  • Collect Breadcrumbs?
    Select this option to collect the page’s breadcrumbs.
  • Breadcrumb element ID
    This field contains the element ID to use when collecting the breadcrumb. This option is not available if Collect Breadcrumbs? is not selected.
  • Collect Web Part impressions?
    Select to track impressions for Web Parts on pages.
  • Collect ECB menu clicks?
    Select to track clicks on the Edit Control Block menu links.
  • Collect list information?
    Select to collect information regarding lists.
  • Collect Social Menu clicks?
    Select to collect clicks on the social menu.
  • Collect all link clicks?
    Select to collect data for all link clicks via dcsMultiTrack on the links.

User Profile

The User Profile tab is different for each tenancy as almost every tenancy has different user profile properties available. This tab shows each property it is able to retrieve, along with an example value, a check box to enable that property’s collection and a field to assign a Webtrends parameter to that field. The default properties that Webtrends collects are prepopulated. To collect additional properties, users need to select Collect? as well as enter a parameter name into the Assigned Parameter field. The parameter name should begin with WT.shp_.

Note: None of these values are collected and the user profile plugin not loaded if Collect user profile information? is not selected at the top of the tab.

Plugins

The final tab is the Plugins tab. Each plugin available for customization is shown on this tab. From here, you can modify the settings for the plugin, aside from the src setting, and enable or disable the plugin. By default, the only plugin available is the Heatmaps plugin, and it is disabled.