The system watches for a site visitor to follow a link from one site page to another. This element is specifically designed for scenarios in which you want to track aspects of visitor navigation through your site. For example, you might want to record the number of times that visitors display a given set of pages during a specified time period, or keep track of the links that visitors follow most often from a given page.

This element is similar to the Visits element (see below), except that the Clicks a Link element works only for links that page developers have set up with an anchor tag that includes a dsource parameter. The following shows an example of the JSP code that a page developer would add to a site page for this type of link:

<dsp:a href="content/welcome.jsp">
  <dsp:param value="OnSale, MemberDiscount" name="dsource"/>
  Click here to see this month's discounts!
</dsp:a>

Here is the same example in JHTML:

<a href="content/welcome.jhtml">
  <param name="dsource" value="OnSale, MemberDiscount">
  Click here to see this month's discounts!
</a>

The values that the page developer specifies for the dsource parameter (in the example, OnSale and MemberDiscount) can be any text that he or she chooses. The system uses them to identify and distinguish the links. For example, the page developer might give several links the same dsource value to identify that they belong to a similar group, such as links that point to a specific set of content pages. (Note that dsource is the default name for this parameter, but developers may change it. To see the parameter name for a given link, display the page containing the link in the Pages and Components area of the ATG Control Center.)

The Clicks a Link element contains the following optional parameters:

Parameter

The element is triggered when…

anywhere

A site visitor clicks any link whose anchor tag contains a dsource parameter.

from page

A site visitor clicks any dsource link on the specified page.

Examples:
Clicks a link from page named /welcome.jsp
Clicks a link from page in folder /content/today/

to page

A site visitor clicks any dsource link that goes to the specified page.

Examples:
Clicks a link to page named /thismonthonly.jsp
Clicks a link to page in folder /content/monthlyspecials

where source name list

A site visitor clicks a link containing a specific dsource parameter.

Examples:
Clicks a link where source name list includes OnSale.
Clicks a link where source name list includes any of [OnSale, MemberDiscount, MonthlyPromo]

You can also use this element for links that you include in e-mail messages that you send to site visitors (for example, as part of a promotional campaign). Make sure that the link contains a dsource parameter as shown above.

 
loading table of contents...