Tracking Code - Reference

The tracking code consists of a single code block. The code can be placed anywhere on your page between the <BODY> tags. Place it at the point where you want the Click-To-Chat graphic to appear. The code must be placed between <SCRIPT> tags. 

 

The Code:

 

<!-- Embedded ParaChat: Insert the script below at the point on your page where you want the Click To Chat link to appear -->

<script type='text/javascript' src='http://testdrive.parachat.biz/include.js?domain=www.webpage.biz'></script>

<script type='text/javascript' >

if(typeof sWOTrackPage=='function')sWOTrackPage();

</script>

<!-- End of embedded ParaChat -->

 

The code has some configurable options

 

The src= parameter should point to the http://{ParaChat LiveHelp Server dns}/include.js?source={domain}

 

 

The {domain} is the domain name of the monitored site in ParaChat LiveHelp. This doesn't have to match your actual domain name - it is just a unique reference to match against a site in ParaChat LiveHelp.

 

Additional Fields

 

A number of additional fields can be defined before the if(sWOTrackPage)sWOTrackPage(); line.

 

sWODepartment

Department name - this is optional. It allows you to configure department specific chat. Any number of departments can be used. You can use different departments on different pages if you choose.

 

For example:

 

<!-- Embedded ParaChat: Insert the script below at the point on your page where you want the Click To Chat link to appear -->

<script type='text/javascript' src='http://testdrive.parachat.biz/include.js?domain=www.webpage.com'></script>

<script type='text/javascript'>

sWODepartment='Sales';

if(sWOTrackPage)sWOTrackPage();

</script>

<!-- End of embedded ParaChat -->

 

sWOResponse

Set this to 'Y' if you want the function to return an 'available' or 'not available' graphic link that the visitor can click to start a chat session. The Gateway will send the relevant graphic file to the visitors browser. You can therefore have some pages which display a chat link and others that do not by using this parameter. Set to a blank string if you don't want a graphic link shown.

 

sWOChatStart

Set this to the URL of the CHATSTART.HTM page. This is only required if the above sWOResponse parameter is set to 'Y' and you want to use a different chat url than the default.

 

sWOLanguage

This controls the language for text used in the chat window. Set to 'en' or blank for English or use the following: fr=French, it=Italian, es=Spanish, ge=German, nl=Dutch, pl=Portuguese. You can set this in the site properties - so this entry is only required if you want to override the default.

 

sWOInvite

Set this to 'N' to disable invite polling. Invite pollng allows ParaChat LiveHelp Clients to send chat 'invite' requests to visitors. The Invite will appear as a moving image on the visitors browser. It uses additional bandwidth, so should only be used if you will actually be using the invite feature.

 

sWOCost

This variable allows you to pass a 'cost' back to the visitor. This will be recorded with the visit and visitor in the database.

 

sWORevenue

Allows you to pass a revenue amount. This is recorded against the visitor. This can be used on e-commerce order pages to record the actual revenue generated by a visitor.

 

sWOName, sWOCompany, sWOEmail, sWOTelephone

These are optional string values that you can pass to ParaChat LiveHelp to be stored with the visitor's contact record.

 

sWOUser

This value will show in the 'User name' column of the WhosOn Current Visitors views. By default the tracking code creates a unique string value that it stores as a cookie. You can replace this with your own user name value if you wish.

 

 

Precisely Positioning The Chat Graphic Using A DIV Tag

You can control exactly where the chat graphic appears on your page using a DIV tag. This enables you to place the include file at the end of your page.

 

EG:

 

<DIV style="position: absolute; left: 4px; top: 230px; width:168px; height:17px" id="parachat_live_help">

{script goes here}

</DIV>

</BODY>

 

In this example the code is placed at the end of the page, but is positioned at using the DIV tag. The advantage of this method is that it ensures that your full page loads before the graphic appears.

 

 

How The Code Works

When the code is first executed it creates a cookie for the visit. This cookie uses a random number to uniquely identify the visit. Subsequent page requests from the visitor will use the existing cookie value.

 

The code then builds an Image request URL which contains the visitors unique cookie value and the current page name, domain name/department and referrer information. If a graphic file response is required the Image URL is requested as a standard image. The Gateway serves the relevant image depending on operator availability for the domain/department.

 

If no image response is specified then the image is requested as a hidden layer and the Gateway just serves a blank image.

 

Once the Gateway has completed the response it then sends the visitor data to the ParaChat LiveHelp Server which is handling the domain.