fr | en | es | de

Clicks (navigation, downloads, exits, actions)

New!
Discover the latest tools in the Analytics Suite, thanks to our new online help.

Contents: ShowHide

There are several methods which can be used to measure clicks. The first one consists of calling a JavaScript function (return xt_click()) at the time of the click. The second one consists of using a redirection URL which allows for a more accurate measurement.

Method 1: carrying out an analysis with a call to JavaScript function

The JavaScript function which is used to measure clicks is contained in the xtcore.js file.

Different methods can be used to call the xt_click() function depending on your needs:

• The clicks can be measured independently, in other words without impacting the HREF and TARGET content:

• It is possible to measure clicks and force the destination URL, in other words it is possible to impose a URL that is different from the URL contained in the HREF:

• You can also measure clicks, force the destination URL and have the destination URL open in a new window:

As is the case with pages, tree structures for clicks can be defined by using "::" to create chapters, for example "Chapters::Sub-chapters::Sub-sub-chapters::Click_name".

1.1 Generating page views with clicks

In some cases it may be necessary to measure clicks as page views.

To do so you need to replace the 'C' parameter with 'F'.

return xt_click(this,'F', 'Level 2 ID', 'page name')

Note

You can add additional variables to the page name such as custom variables, site custom variables, order and sales variables by using "&variable".

Measuring navigation clicks

Measuring navigation consists of measuring the action of clicking on a link which redirects towards another page of the site. This link must be in a page containing a web content tag (xtcore.js file).

For instance, you want to measure the number of clicks on this link:

You have to call the JavaScript function xt_click() via the "OnClick" action:

The variables 'C' and 'N' must remain unchanged. These variables are essential because they are used to indicate that a navigation click is being measured.

You must replace 'level2_number' with the number of the level 2 site and 'click_name' with your own navigation names.

Measuring download clicks

Measuring a download consists of measuring the action of clicking on a document download link. This link must be in a page containing a web content tag (xtcore.js file).

For instance you want to measure the number of download clicks on this document:

You have to call the JavaScript function xt_click() via the "OnClick" action (which will download your document):

The variables 'C' and 'T' must remain unchanged. These variables are essential because they are used to indicate that a download click is being measured.

You must replace 'level2_number' with the number of the level 2 site and 'click_name' with your own document names.

Important

This xtclick() function deactivates the link included in the href tag and makes the link.
If you already use an onclick function in your links which also deactivate the URL included in the href tag, you must not use this function. Use the xt_med() function as follows:
<a href="http://www.site.com" onclick="xt_med('C','level2_number','click_name','N');my_js_function(....)">
The 2 main differences are:
    * the absence of "return"
    * the absence of "this" as a function variable

Measuring exit clicks

Measuring exits of the site involves measuring the action of clicking on a link which redirects Internet users to other websites. This link must be in a page which contains a web content tag (xtcore.js file).

For instance you want to measure the number of clicks on a link which redirects Internet users to another website:

First of all you need to call the JavaScript function xt_click() via the "OnClick" action (which will redirect towards the other website):

The variables 'C' and 'S' must remain unchanged. These variables are essential because they are used to indicate that an exit click is being measured

You must replace 'level2_number' with the number of the level 2 site and 'click_name' with your own exit website names.

Measuring action clicks

Measuring actions on the site involves measuring clicks made on a link. This page must contain a web content tag (xtcore.js file).

For example you want to measure the number of clicks on a link which does not reload the page (AJAX or other):

You have to call the JavaScript function xt_click() via the "OnClick" action:

The variables 'C' and 'A' must remain unchanged. These variables are essential because they are used to indicate that an action click is being measured.

You must replace 'level2_number' with the number of the level 2 site and 'click_name' with your own action names.

Specific case: measuring forms

If you would like to measure a click that has been made on the validation button of a form, you will need to use the xt_form() function which is contained in the 3.4.005 version or later of the xtcore.js file.

By default, this function should be placed directly into the <form> tag, at the level of the "Onsubmit" event.

Important

Our explanations will be illustrated with examples of tagging which have been carried out on navigation clicks (‘N’). Please remember that this specific case is applicable to ALL TYPES OF CLICKS: i.e. navigation, download, exit and action clicks.

Example 1: default use

Let’s take the example of a form for which you would like to measure the number of submit clicks. If the form is in the following format:

Then the JavaScript return xt_form() needs to be called via the "Onsubmit()" event:

'Level2_number' must be replaced with the number of the level 2, and 'click_name' must be replaced with your own navigation labels.

Example 2: the use of an intermediary validation function

If your form is coded as follows:

The code should be completed as shown below:

• You must pass a reference to the form as a parameter of your validation function: onsubmit="return valid_form(this);". The key word this is used to refer to your form.
• If you wish to submit your form, the return xt_form() function must be named as follows: return xt_form(obj,'C','level2_number','click_name','N',true);
• The obj parameter corresponds to the reference to the form, and is retrieved in the validation function.
• 'Level2_number' must be replaced with the number of the level 2, and 'click_name' must be replaced with your own navigation labels.
• The parameter true indicates that you would like the form to be submitted.
• If you do not wish to submit your form, the return xt_form() function must be named as follows: return xt_form(obj,'C','level2_number','click_name','N',false);
• The parameter false indicates that you do not want the form to be submitted. The click, however, is counted.

Example 3: direct submission from a JavaScript form

Example A: if you use a JavaScript function to submit your form which is written as follows:

The code should be completed as shown below:

• The key word return is not placed before the xt_form() function because it is not necessary to generate any results.
• The parameter theForm corresponds to your form.
• 'Level2_number' must be replaced with the number of the level 2, and 'click_name' must be replaced with your own navigation labels.
• The parameter true indicates that you would like the form to be submitted.

Example B: JavaScript submission via a <select> tag:

The code should be completed as shown below:

• The xt_form() function is added in two different places, in other words wherever there is a submit action:
• The following code is added to the <form> tag: onsubmit="return xt_form(this,'C','level2_number','click_name','N',true);"
• The following code is added to the <select>: onchange="xt_form(form,'C','level2_number','click_name','N',true);"

The JavasScript onchange submit ="form.submit();" is replaced with a call to our function:

- The key word return is not placed before the xt_form() function because it is not necessary to generate any results.

- The parameter theForm corresponds to your form.

• 'Level2_number' must be replaced with the number of the level 2, and 'click_name' must be replaced with your own navigation labels.
• The parameter true indicates that you would like the form to be submitted.

Method 2: measuring via redirection

This method involves replacing the destination URL with a special redirection URL that will allow for tracking.

Irrespective of the type of click, you must populate the following variables in the URL:

• "Logxxxx": sub-domain which redirects and measures the click (replace xxxx with the value you can find in your subscriber zone).
• "xts=": your site ID(xtsite of the tag code).
• "s2=": level 2 site ID.
• "p=": name of the click (using the same format and restrictions as for page names).
• "url=": redirection url (with http://).

As is the case with pages, tree structures for clicks can be defined by using "::" to create chapters, for example "Chapters::Sub-chapters::Sub-sub-chapters::Click_name".

In the examples below the parameter 'click' has been written as click=. An alternative spelling, clic=, is also possible.

Measuring navigation clicks

For example, you would like to measure the number of clicks on this link:

You need to replace the URL with:

The variables 'click=N' and type=click' must remain unchanged. These variables are essential because they are used to indicate that a navigation click is being measured.

You must populate logxxxx, xts=, s2=, p= and url=.

Measuring download clicks

For example, you would like to measure the number of download clicks on this document:

You need to replace the URL with:

The variables 'click=T' and 'type=click'' must remain unchanged. These variables are essential because they are used to indicate that a download click is being measured.

You must populate logxxxx, xts=, s2=, p= and url=.

Measuring exit clicks

For example you would like to measure the number of clicks on a link which redirects Internet users to another website:

You need to replace this URL with:

The variables 'click=S' and 'type=click' must remain unchanged. These variables are essential because they are used to indicate that an exit click is being measured.

You must populate logxxxx, xts=, s2=, p= and url=.

Measuring action clicks

If we take the URL action:

You need to replace this URL with:

The variables 'click=A' and 'type=click' must remain unchanged. These variables are essential because they are used to indicate that an action click is being measured.

You must populate logxxxx, xts=, s2=, p= and url=.

www.atinternet.com/support
© AT Internet - 2016 - All rights reserved