Home

"user manual"

1. CLICKTRACKS USER TRACKING REVEALED ClickTracks User Manual 2001 2005 ClickTracks ClickTracks Web Analytics Done Right ClickTracks is the culmination of extensive research and development in the areas of website and user behavior analysis Our goal in creating ClickTracks has been to provide complex data in a simple way and to display that data in context We have tried to keep the software simple to use and the results easy to understand at a glance This manual will help you get the most from ClickTracks and by extension will help you better meet the needs of your website visitors www clicktracks com Contents l Table of Contents Foreword 1 Getting Started 3 System Requirements su sssssssnnsnrsnsnneeneneeneennnnnneneeneeeeennnnnneeneeeeeeeennnne 4 eS T ao al Loto Renee ae ere s ananas seems s man aeece ess ess ner amane ne on e me aa a E 5 Architecture of Version 6 22 ea ane near nee anne one oa we usec ee sees tenant 5 Architecture of Version 5 X nn nnnnnnnnrrrrrrnnnnnnnnnnnnnnnnnenennnnnnenenenenennnnnnnnnnnnneeennnnne 7 Upgrading from 5 x tO 6 issssssnrrrrernnnnennnnnneeneeenenensnnnneeneeeneeeesnnenennnns 10 Processing Engine Administrator QuickStart sise 16 Comparison to Analyzer and Optimizer ss sssssnsnesssnnneenenenenessnnnns 19 Cookie Handling ss isssninnnnnnnnnnnnnnnnnnnnnnnnennnnnnnnnnnnnennnnnnnnnennnnnnnnnnnenennnnnnennnnnnnneennnnnnne 19 Browser Based Reporti
2. See Topics Which Files to Download Importing Local LAN files 3 1 3 3 3 Advanced Web Server Properties The Advanced Web Server Properties dialog will assist you in setting precise values to retrieve the logfiles for your dataset Under normal conditions these settings should not be changed 2001 2005 ClickTracks Processing Engine Administrator 70 FTP Options Delay time between connections seconds Logfile Options Assume Microsoft IIS style logfile rotation Customize apache loafile format M Auto Detect __Gancel_ FTP Options If you experience problems in logfile retrieval such as multiple FTP errors setting these options could correct the situation Delay time between connections TThis value sets the seconds to delay between successive FTP login attempts to retrieve logfiles and is useful when connecting to FTP servers that have a restriction on successive or multiple logins This will effectively throttle the FTP login process back resulting in slightly slower retrieval times for multiple logfiles To set the delay time Uncheck the No delay checkbox Set the delay time in seconds by typing in the digits into the text box or use the spin control Try setting the delay time in 10 to 15 second increments and run the server once again to see if the FTP errors are corrected To remove the delay time Check the No delay checkbox Logfile Options Assume Microsoft IIS style logfi
3. e Server Logging Learn more about the server diagnostic messages Starting and Stopping the Service After installation the server process is set to not running state Once the initial setup is complete you will need to start the server so it can begin processing logfiles You can do this from the Server Administrator on the File menu Menu File Start Service OR Menu File Stop Service Alternately you can click on the green red button in the Server Status panel on the upper right side of the Server UI window The Server Status panel will display the current server statuses of the following Service Stopped button status green Starting Service Service Running button status red Stopping Service In addition you can start stop pause or restart the ClickTracks Server from the Service Manager in the Administrative Tools section of the Control Panel The Service Manager can also set startup to automatic manual or disabled and establish which user account the service should run under For further information see topic Server User Account After Server is started Depending on how many logfiles exist on the server the initial transfer can take from a few minutes to several hours The next session will be shorter as it will only download appended or new logfiles After the server has been running for a period of time you will see files in the NLF Files tab on the lower panel of the Server Administrator window T
4. Additional Server Setup The main screen of ClickTracks Server Administrator shows the hierarchy of Datasets Domains and Web Servers ClickTracks Server Administrator lees Fie Options Help History Errors For each web server defined in the above hierarchy you will define the parameters for reading the logfile Starting and Stopping the Service 2001 2005 ClickTracks Processing Engine Administrator 42 8 1 1 15 1 Multi Domain Logfiles Some web servers generate a single logfile containing data for all the hosted websites Each line in the file specifies the virtual host name the file was served from A special configuration option permits the ClickTracks Server to process such logfiles efficiently 1 Define all the virtual servers as distinct domains as if they each had individual logfiles but don t actually define a Web Server FTP logfile processor for any of them Use the New Domain Wizard to do this For Example Define a new Domain using the New Domain Wizard for each of the virtual servers in your logfile Be sure to add each domain under the same dataset name Logfile contains entries for the following virtual servers www site1 com www site2 com Datasets Domains Web Servers MultiDomain Dataset www site1 com www site2 com 3 Define the Multi domain entry 4 Right Click on the dataset name that contains the virtual server entered above and select Add multi domain logf
5. 1 Port 80 will need to be opened up for serving pages Any firewall settings restricting the serving of files through this port should be disabled 2 Port 8080 will also need to be opened up for serving pages This is the port through which the Site Archiver serves archived sites 3 Both ports need to point to the IP address of the computer where the Reporting Engine is running as described above With these settings in place a user anywhere on the Internet can enter the IP address or domain name of your network into a Web Browser Wizard or New Dataset Wizard of the Pro Client to receive data files directly form the Reporting Engine Troubleshooting Note Firewalls installed on the computer where the Reporting Engine is running or on the router can interfere with file serving If you are having problems receiving files from the Reporting Engine check 2001 2005 ClickTracks 93 ClickTracks Server 4 2 6 with your IT department to ensure that firewalls are not restricting the serving of files Changing Port Numbers The default port setting for HTTP documents is 80 This will rarely be changed If it is necessary to change this setting for some reason perform the the following steps 1 The port specified for serving HTTP docs must be changed at the router 2 The port number is changed in the Reporting Engine Server Configuration field to match the port number on the router 3 In the web browser or Pro Clie
6. Dependencies Log on as C Local System account Di Allow service to interact with desktop This account DOMAIN_NAME domainuser Browse Password 000000000000 Confirm password 000000000000 You can enable or disable this service for the hardware profiles listed below Hardware Profile Service Profile 1 Enabled Enable Disable Cancel Apply Processing Engine Service The Processing Engine service in version 6 is essentially the equivalent of the ClickTracks service in version 5 x This service acquires logfiles or datasets and processes this data on a scheduled basis Reporting Engine Service The Reporting Engine has its own service that runs in the background This service is the web server that actually serves the HTML reports and the complete datasets to the client application The service can be seen and controlled in the Windows Operating System under Administrative Tools Services 2001 2005 ClickTracks Services and Processes 28 u Services File Action View Help e gt E4 ia Services Local Services Local ClickTracks Reporting Engine Name fi Description Status fa Sy Alerter Notifies selected users and co Re Se Sy Application Layer Gateway Service Provides support for 3rd party SE Sy Application Management Provides software installation Sy ASP NET State Service Provides support For out of pr Description Sy Ati HotKey Po
7. If your datasets are small you can choose to upgrade immediately Make your selection and click Next Dataset Upgrade Second Step Select When to Upgrade Welcome to the New Dataset Wizard Do you want ClickTracks to analyze the selected datasets as soon as possible or when during the dataset s next scheduled analysis Upgrade on schedule C Upgrade immediately Click Finish to initiate the upgrade process If you selected Upgrade Immediately the analysis of datasets will begin If you selected Upgrade on Schedule each dataset will be upgraded at its next scheduled run as defined in the dataset properties 2001 2005 ClickTracks 13 ClickTracks Server Dataset Upgrade Completing the Dataset Upgrade Wizard The New Dataset Wizard is now When the ClickTracks Service is started the selected complete datasets will be upgraded to ClickTracks 6 To close this wizard click Finish lt Beck cancel Reporting Engine The Reporting Engine is a new component with version 6 so there is no upgrade to perform However you will probably want to access the Reporting Engine and do some initial setup during the upgrade process See the Reporting Engine Administrator gt Initial Setup section for details on this process Pro Clients 1 2 Install the version 6 Pro Client on your various end user machines These can also be installed on top of version 5 6 Create new datasets on y
8. The Reporting Engine can send data to the ClickTracks Pro Server or send finished reports via a web browser or email 1 1 System Requirements The ClickTracks server can be installed on a standard Windows desktop server computer Installation Requirements The user performing the ClickTracks Server installation will need to be logged into the server computer on an account with administrator privileges when installing the ClickTracks Server Hardware Requirements CPU Pentium 4 1Ghz or faster 2001 2005 ClickTracks ClickTracks Server 1 2 1 3 ClickTracks server places a much lower CPU processing overhead than most other logfile analyzers It will coexist with many other tasks and can run on the web server machine or elsewhere on the network A Pentium 4 processor or better will provide sufficient processing power for most sites RAM 1GB or more ClickTracks does not run as a multi threaded application so a 2 GB dual processor which splits memory up into four 512MB threads will result in only 512MB of memory available for ClickTracks A dual processor is fine but each thread must have at least 1 GB to accommodate ClickTracks as it will only run on one thread at a time Disk Space Allow disk space of approximately 10 the size of the originating logfiles The original logfiles are not kept on the ClickTracks server Depending on how many hits your website receives the ClickTracks server may need to rea
9. stats 36 stop 23 stop service 23 stopping 27 storing 90 system requirements 4 T terminology 114 thumbnails 90 Time split 90 toolbar 16 troubleshooting 40 111 U unix 60 upgrade 33 uppercase 60 url 57 url parameters 64 url pruning 57 user accounts 87 user agent 105 useragentstoignore 107 username 36 users 87 2001 2005 ClickTracks Index version5 7 version6 5 Virtual servers 40 W W3C Extended 105 web reports 91 web server 65 91 web server wizard 51 web based reports 91 windows 60 124 2001 2005 ClickTracks
10. All logfiles for this dataset 1 Select a dataset by clicking on the dataset name in the Server UI window 2 Right click on the dataset name 3 Select Menu Reprocess All logfiles for this dataset The selected dataset will be processed as soon as possible by the ClickTracks Server This operation may be delayed if the server is currently processing another dataset 3 1 1 8 Delete A Dataset Domain Web Server A dataset domain or web server can be deleted if it is no longer needed To Delete a Dataset Select a dataset by clicking the mouse on the dataset name in the Server UI window Right click on the dataset name Select Menu Delete A confirmation dialog will be displayed If you want to permanently delete the dataset click Yes Otherwise click No and your dataset will remain in the server processing list PON To Delete a Domain Select a dataset by clicking the mouse on the dataset name in the Server UI window Select the specific domain name Right click on the domain name Select Menu Delete A confirmation dialog will be displayed If you want to permanently delete the domain click Yes Otherwise click No and your domain will remain in the server processing list OU BOO To Delete a Web Server Select a dataset by clicking the mouse on the dataset name in the Server UI window Select the specific domain name Select the specific web server name Right click on the web server name Select Menu Del
11. See Also New Dataset Wizard New Domain Wizard New Web Server Wizard New Web Server Wizard The New Web Server Wizard guides you through the creation of a web server associated with a domain The properties of the logfiles to be analyzed will be presented here Page 1 Name The Web Server Enter the external name of the web server Examples WWW store secure Page 2 Logfile Retrieval Method Select the logfile retrieval method e FTP transfer Use this method when the logfiles are on a remote computer running an FTP server Enter the FTP Login values for server usern ame and password Click the Test Connection button to verify that the login parameters are correct for the connection Logfile Location Enter the directory path to the logfiles from the web server Use the Browse button to connect to the FTP server and navigate to the proper logfile directory e File System Use this method when the logfiles are on a local or shared network drive Enter the Driver letter and full path to location of the logfiles Use the Browse button to navigate to long path locations The user account on the machine running the ClickTracks server will need to have ample permissions to logfile data location Page 3 Include Exclude Choose which files to include and exclude from analysis Separate each file mask with a semi colon Example Exclude mail old ftp Include log zip gz 2001 2005 ClickTracks Processing Engine Ad
12. See the online help for logfile formats both IIS and Apache Q maintain multiple websites and have created a dataset for each but when load up the data in the Professional Client all the numbers appear to be the same There s no way that all my websites have the same amount of traffic What s up Do you have a multi domain logfile The definition of a multi domain logfile is when the request data for many different websites is logged in one logfile The result is that you will have to load the same logfile for every dataset This is fine but you will need to configure a multi domained web server log source for your datasets Also keep in mind the server aliases You must have the correct server aliases entered for each domain If you accidentally enter a domain that is outside the domain for which you are currently creating a dataset you will get data leakage Check this by right clicking on the domain level in the Server UI and click Properties In the Properties dialog you will see an input box for DNS Lookup Helper Verify that these names are correct for each 2001 2005 ClickTracks FAQ 118 domain Q Can track clicks for data files like exe s Word Docs etc A Absolutely ClickTracks will track any file that gets logged in your logfiles However by default we do exclude some historically not so useful requests These file types are kept in a text file located at Program Files ClickTracks Server
13. Site Archiver The Site Archiver is a fundamental component of the version 6 architecture It underlies many of the features in the Pro Client application such as the ability to view time splits in the Navigation Report By archiving your website at a given time you can view your web statistics in the Navigation Report with the version of the site that actually existed at that time How Does It Work When it is started the Site Archiver acts as a web browser to pull in the pages of your site It does not actually crawl your site by following links rather it goes through the list of previously analyzed pages and looks up each one it finds The Site Archiver captures the HTML document along with any embedded images JavaScript files JS stylesheets CSS and Flash files SWF All of these files are stored in a compressed archive that the Pro Client can access at any time To archive your website one time simply go to the Site Archiver section of the Reporting Engine Administrator select the dataset you want to archive and click Start You will see thumbnail images and the URLs of your website displayed as the Site Archiver loads the files In fact you might even hear Flash animations begin to play as they are loaded by the archiver You can stop the Site Archiver at any point in the process by clicking the Stop button When you click Start the archiver will pick up where it left off Administration Admin Home Site Archiver User Acc
14. Testing Build 912 Glick here to add a new Dataset fi bobsfruitsite More info Click here to add a new Domain Click here to add a new Web server Click here to create a multi domain logfile More info 10 7 2005 3 10 40 PM Initializing 10 7 2005 3 10 40 PM Initialization Complete Configuration Client Edit Properties Error Messages Server status message updated in real time The ClickTracks Way panel General User Interface Use the mouse to activate various Ul elements e Select a dataset name to show related domains e Select a domain to show related web servers Context Menus 2001 2005 ClickTracks Getting Started 18 Dataset Right Click on a dataset name Domain Right Click on a domain name Web Server View Configure Dataset Analysis View Session Record Right Click View Session Record on a web Show History right click to close server Show History right click to close Show Errors right click to close Nare Show Errors right click to close Delete View Session Record Disable SS Delete Add web server Show History right click to Reprocess all logs for this dataset Show Errors right click to c Add domain Add multi domain logfile Properties Delete View NLFs Run schedule now Reprocess all logs For this dataset Reprocess all logs For this c Properties Properties Learning More About The ClickTracks Server Operation Start
15. Unknown Ignored x Field 3 Unknown Ignored Field4 Date Time Field5 Request Field6 HTTP Response Code Field 7 Bytes Sent Field8 Unknown Ignored s Field 9 Unknown Ignored Sample logfile line See Which Files to Download 3 1 3 3 2 File System Logfile Retrieval The Web Server File System Property dialog is shown below 2001 2005 ClickTracks 69 ClickTracks Server Web server Properties win20031IS oj x General Logfile retrieval method C FTP File System FIP Login FTP Server Username Password Di Passive Mode m Logfile Settings Logfile directory F AnetpubiLogfiles w35 al File exclude mask File include mask log zip Ap p ly File System Parameters Logfile Settings Logfile directory The drive letter and path to the location of the logfiles on the local file system or network share Browse button Click this button to browse the local directories or network share to the location of the logfiles Select the directory name from the dialog box and click OK The directory value will be placed into the Logfile directory field File Exclude Mask Exclude this file pattern mask to limit the logfiles selected for processing File include Mask Use this file pattern mask to select only the files to be processed Separate each file mask with a semi colon Typical file masks are log zip gz
16. User Accounts Through the User Administration form you can set up and manage an unlimited number of individual user accounts These are the users who will be able to access ClickTracks reports and or administer the Reporting Engine itself By default the User List has two users user and admin Adding a New User 2001 2005 ClickTracks Reporting Engine 88 4 2 3 To add a new user simply provide a user name and password and specify whether the user is an administrator has access to the Reporting Engine interface Select a group to which the user will belong A user can only belong to one group however it is not necessary for a user to belong to any group See User Groups Select any datasets to which you want this user to have access Hold down the CTRL key and click on any of the datasets in the Available Datasets column right column and then click the top arrow lt to add those datasets to the user Click Update to add the user Editing an Existing User To edit a user simply click on that user in the User List and then edit the information as desired To make a dataset that is currently available to a user unavailable click on the dataset in the User s Datasets column and click on the right arrow gt The dataset will be moved to the Available Datasets column and the user will no longer have access to it Removing a User To remove a user click on that user in the User List and then click Remove a
17. Which Filesto Download nt nn eaa Ms AE E anaE AEEA EEE EA AREA ne AREA EEAS Importing local FANMTIISS 22222 2 mean rasianrennsarraissn dass tasse and ess eee dLai ne dessein re et eme R process Logs NOW sienne sninns trs Inn EAT Delete A Dataset Domain Web Server Enables Disable Dataset sisicsccs ticcccsccsscacacciscsceaciscsceactucacescsacsansecassasaccessassataccaesainacencateadsacasesesacadesasacadesnescasznaccnsexazes WED Server LOG IFONMANS Herrera nd an teasers teraanestsuaevt sobsaneeasetteceedeataaetetiostetens Compressed Rotated Log Files sci sciscciscctesscascisseisscttact internet Virtual Servers Multi domain Logfiles siennes What lf There Are No Og les 25m im RM eens accu neds cds Me MER me iene dedans Anne ne sete au Ant Rates 40 MMPOUDISS MOOT keti mle o MEAE ATE tect Es en mt D MU MON 40 yavololilfelat Rel 1a i2 gcl gt 0 S EER AAA A A AA rrr recta ree 41 Multi Domain Kors NE REAA AA AET 42 Wizards tentent fe nn i a ii 42 NOW DataSet WIZGNE ci 2 ste cotessrssatetbiaaedetavaactathvasndativeandatilssaadathvssntathies stabi vasatehivasadahtwacclehtiscadehivasedsshrasadetusaaedetbraardess 43 2001 2005 ClickTracks ClickTracks Server New IDG Dataset Wizard sii sscivecstecavarsiecdbacatecssesstacavensucavaxptecaxacsscsoecateassesatnaivensbucavesstecavecsuscsobesiuaniosstaciveasSucavecsn 44 New Hosted Dataset WIZ sss sciscisscausxitisesssciiacesssssaciasssan
18. are important for your site s visibility on search engines they re not relevant for visitor behavior analysis Therefore ClickTracks automatically removes sessions that appear to be generated from robots and spiders It does this in three ways e Ifthe session begins by requesting robots txt this and all subsequent pages from this session are ignored e If the user agent contains any string in the Data directory from the file UserAgentsTolgnore txt using partial matching the session is ignored e Finally a visitor session that repeatedly requests the same pattern of pages is ignored Search Engine Parameters amp Keywords Several components of ClickTracks require a definition of search engines and the names of the parameters passed in with the referring URL When ClickTracks shows a list of top search terms it has extracted this by examining each URL and determining if it comes from a known search engine and if so the name of the parameter that contains the original search terms keywords The search engines are defined in the file SearchEngines txt in the Data directory You can edit this file to add your own specific search engines if you wish The syntax is a tab separated list of parameters e Domain name partial match OK e Display name shown in reports e Search parameter If more than one separated by commas This is the parameter picked up in the referrer that contains the keywords e g q for Google e Home page
19. base properties for the server which include a descriptive dataset name the local location of the stored data the server polling frequency and scheduled start time A dataset can contain 1 or more domains which define the properties of the web site Additional dataset properties are Dataset Mirroring The ClickTracks server can replicate the current dataset to a remote FTP server for access by other ClickTracks Professional Client applications that may not be able to access the dataset via a file system or network share The ClickTracks Professional Client will use FTP or HTTP HTTPS protocol to access this mirrored dataset Cookie Tracking The special cookie tracking option should only be enabled when your site is using persistent cookies and you wish to analyze data for ad campaigns When this option is enabled the ClickTracks server generates additional data files used by the client software It also takes additional time and memory for the server to process the logfiles Url Pruning v5 1 URL Pruning is a way to have the ClickTracks Server delete a portion of a URL which you don t want to analyze This feature can be useful to normalize various URLs in your logfiles It can delete a fixed string or a regular expression portion of a URL Domains Domains represent the secondary level of configuration of the ClickTracks server A domain will be created under a named dataset and will define the properties of the web site De
20. events for all datasets The output of the log events will be sent to a text file with the server events listed in chronological order The Session Record text file will also be opened with the associated program for text TXT files To show the Session Record for ALL datasets 1 Select Menu Options View Session Record 2001 2005 ClickTracks 75 ClickTracks Server amp ClickTracks Server Administrator WEB SERVERS Add web server History Errors Message Dataset Domain Web server To Clear the Session Record 1 The server process MUST NOT be running The menu choice Clear Session Record will not be available will be grayed out until the server has stopped 2 Select Menu Options Clear Session Record The Global Session Record log will now be reset to an empty state To show the Session Record for a specific dataset 1 Click on the specific dataset name to be shown with the mouse 2 Right Click on the dataset name Select Menu View Session Record A text file will be generated in the Session Record directory with only events from the selected dataset This text file will also be opened with the associated program for text files 2001 2005 ClickTracks Processing Engine Administrator 76 WEB SERVERS Add web server Show History right click to close Show Errors right click to close Disable Delete Add domain Add multi domain logfile Run schedul
21. is not editable Select a user who will receive the email Type in the user s email address Specify the frequency of distribution daily weekly or monthly Specify the day or date depending on the selection in step 5 Specify a time of day for the task to run Select a dataset Select a specific report to be sent Each task can only send one report Otherwise emails would become far too large risking blockage by email filters or excessive download times Thus you might need to set up multiple email tasks for each individual user When the form has been completed click Submit to save it The Task Name along with the type of task will appear in the list on the left under Current Tasks 2001 2005 ClickTracks 95 ClickTracks Server Administration Admin Home Scheduled Task Configuration User Accounts Current Tasks Task Name u G p r SERRE New Email Task Task Type New Archive Task Yp Site Archiver Archive 1 Archive User Name user Vv Email 1 Email Server User Email Configuration Frequency Daily Mail SRE Time Tom M Confiquration Day Monday v Scheduled Task Dataset bobsfruitste Configuration _ Report Search Report Number of Visitors v Submit Remove To Edit an Existing Task To edit an existing task click on the task under Current Tasks to populate the form with the current settings Change any fields as desired and click
22. not clouded by requests made by the browser for components within the page Files are ignored based on file name extension ie GIF This process takes place within ClickTracks as part of two separate phases logfile Importing When you import the logfiles they are stored in an internal format known as the normalized format During importing each request from the log is compared to a list of extensions contained in a file named FileExtensionsTolgnore txt Although you can edit this file it s inside the data folder in the same location as the ClickTracks_Server exe program you should be aware that any file extensions ignored during importing are permanently removed from the dataset Although you could re import the logfiles this is usually a tedious process and should be avoided It is therefore wise to list files inside FileExtensionsTolgnore txt only when you are certain they will never be required for analysis or used for labeling visitors 2001 2005 ClickTracks 107 ClickTracks Server 6 5 6 6 The file extensions listed in FileExtensionsTolgnore txt by default are jpg Jpeg gif png ico CSS js jar exe mid ida class bmp Vbs See also Ignore Filenames That Contain User Agents To Ignore Many of the requests to your web server are from robots or spiders These programs automatically browse the web for example to compile indexes for search engines Although these requests
23. or more domains which define the website s properties Further properties of a dataset are Dataset General Descriptive Name Location on disk Polling Schedule and Start Time Dataset Mirroring FTP login parameters to copy a ClickTracks dataset to an alternate server for access by the ClickTracks Professional Client e Cookie Tracking The special cookie tracking option should only be enabled when your site is using persistent cookies and advanced ad campaign tracking is necessary e URL Pruning Configure the way certain URLs are processed To Add Additional Domains or Multi domain Entries to an Existing Dataset Entry 1 Select the dataset entry by clicking the dataset name 2 Right click on the dataset name 3 Select Menu Add domain OR Add multi domain logfile Continue to respond to the questions throughout the Domain or Web Server Wizard until complete 2001 2005 ClickTracks 53 ClickTracks Server 3 1 3 1 1 Dataset General Dataset General Properties s Dataset Properties ClickTracks Of x General Dataset Mirroring Cookie Tracking URL Aliasing m Settings Name ClickTracks Location C NewServerData ClickTracks Server mM Schedule Frequency 12 Hours v Start time 8 36 37 AM IV Think Globally analyze on server Cancel Apply General Tab Name A descriptive name given to the dataset Entered at creation time read only L
24. panel below select a subdomain and add the session cookie identifier If you have more than one subdomain select each in turn insert the session cookie ID and click Apply before moving on to the next one in the list For nameless cookies check Use only unnamed cookies and leave the other fields blank The fields will become disabled when this option is selected 2001 2005 ClickTracks 57 ClickTracks Server Click OK to save changes and close the dialog Note The special cookie tracking option should only be enabled when your site is using persistent cookies and you wish to analyze data for ad campaigns When this option is enabled the ClickTracks Server generates additional data files used by the client software It also takes additional time and memory for the server to process the logfiles 3 1 3 1 4 URL Pruning URL Pruning is a way to have the ClickTracks Server delete a portion of a URL which you don t want to analyze This feature can be useful to normalize various URLs in your logfiles It can delete a fixed string or a regular expression portion of a URL There are two main uses for URL pruning Remove a Portion of a URL In some logfiles the URL file html and sitename file html are the same file You can use this feature to delete sitename from all URLs that are in this form Remove a Session ID When a session ID a dynamic string gets into the URL you can delete it with this feature a
25. random number appended is good enough 2001 2005 ClickTracks 105 ClickTracks Server 6 3 6 3 1 2 Set the cookie with an expiry many weeks or months in the future 3 Never reset the value of the cookie in other words if it exists don t replace it Setting the cookie will probably require some small custom development within the website You ll then configure the ClickTracks Server to use this cookie name and that s it ClickTracks will take care of all the rest automatically Apache mod_usertrack For users of Apache there is a very convenient way to handle both session and persistent cookies without changing any code in the website Install mod_usertrack configure cookies to be logged within the logfile and set up the ClickTracks Server to Use Only Unnamed Cookies Cookies set by mod_usertracks are strange in that they have no name only a value Configuring Web Servers ClickTracks requires certain fields to be present in the logfile If possible check the sever configuration to confirm the fields are present If your website is hosted by your ISP you might have little choice over the logfile fields present The ISP should be able to confirm the settings or make any changes needed ClickTracks requires these fields Date and Time Client IP Address HTTP Method Requested file and Query string User Agent Referrer Status code Cookie preferable but not required Virtual server n
26. the various data wizards with additional tips to assist in the configuration decisions The Way Content is useful when you are first learning how to work with the ClickTracks Server Once you have mastered most of the routine tasks it might be useful to turn off The Way Content To Turn Off The Way Content Menu Help Hide the ClickTracks Way The Way content panel will be removed from the Server window and data wizards To Turn On The Way Content 2001 2005 ClickTracks 109 ClickTracks Server Menu Help Show the ClickTracks Way The Way content panel will be displayed in the Server window and data wizards 2001 2005 ClickTracks Tro 111 ClickTracks Server 7 Troubleshooting 2001 2005 ClickTracks Troubleshooting 112 7 1 Logfile Import Warning When importing a logfile ClickTracks performs a basic check to make sure the log is for the specified domains within the dataset Most logfiles do not specify the domain to which they belong so ClickTracks examines the referrer field Most referrer entries will be the domain being analyzed with a few from Google and other external sources of traffic If the majority of referrers are not within the domain or domain aliases an error is generated The error most commonly indicates that the logfile is from a different domain and should not be imported Make sure the FTP login and directory are set up for th
27. they all fit into the overall architecture of ClickTracks 6 2001 2005 ClickTracks Getting Started 6 ClicKTracks Professional Processor Browser EEEE End User 2 End User 3 ClickTracks Service Configuration Client 1 Data is acquired by the Pro Processor by way of the Processing Engine a service that runs in the background Data can be gathered from the logfiles of web servers or from the ClickTracks JavaScript Data Collector JDC depending on the products owned The service is designed to periodically connect to the web servers pull in the latest logfile data and process it Once configured the server runs unattended 2 The Processing Engine Administrator is the user interface through which datasets are created and managed Once a dataset has been established through the Server Administrator the ClickTracks service will continue to gather data from its raw data source and process that data on a scheduled basis 3 The Configuration Client is launched from within the Processing Engine Administrator This is essentially the same application as the Pro Client Application used by end users The Configuration Client allows the administrator to adjust settings create labels load campaigns and make various other changes to datasets at the global level These changes will then be incorporated into data sent to the Pro Client application or into reports served to web browsers or sent v
28. to a file in other programs such as Microsoft Word Just as a Word file contains text relating to a single project book article and so forth a dataset contains all the information ClickTracks needs to analyze a single website The term dataset is used because it s actually a collection of files serving different purposes not a single file as it would be in Word 2001 2005 ClickTracks 31 ClickTracks Server 3 1 1 3 1 1 1 Each website you analyze will have its own dataset which will serve to Keep data for each website separated from data for other websites Make imported logfiles part of the dataset so old logs never need to be imported Retain a complete historical record for the website permitting analysis of any period of time Automatically save all your settings and analysis parameters so when you quit ClickTracks and later reopen you ll be exactly where you left off PON When you start the ClickTracks Server for the first time the New Dataset Wizard will guide you through the process of creating a dataset followed by creating a domain and finally a web server If you re a consultant you will create many different datasets one for each client website You can launch the New Dataset Wizard from the Server UI or the File menu at any time All server configuration information is saved in ClickTracksScheduler xml which resides in the ClickTracks Server directory Create a new dataset with the New
29. want them access 2 gz It s safest to grab them all and let ClickTracks work out the dates Cobalt RaQ web cache web cache new web log lt Download this file web stats lt NOT this file which contains internal data used by the stats package that ships preinstalled on a RaQ See Also Compressed Rotated logfiles Importing local LAN files You can also import logfiles from a local hard drive or network share A network share is most common for IIS users By default IIS logfiles are stored in the c winnt system32 LogFiles W3SVC1 directory These files have the naming convention ex log Example directory of IIS logfiles W3SYC1 File Edit View Favorites Tools Help Back Qsearch 4 Folders amp as LE Xx A Ea Ee Address o Go s efnpe mois a 4KB Text Document 2 4 2002 5 00 PM ex020205 l0g SKB Text Document 275 2002 5 00 PM ex020208 log 3KB Text Document 2 8 2002 5 00 PM ex020209 log 10KB Text Document 2 10 2002 3 15 AM ex020213 log 64KB Text Document 2 12 2002 9 12 PM ex020214 log 4KB Text Document 2 14 2002 9 06 PM W3SVC1 Select an item to view its description See also ex020217 log SKB Text Document 2 17 2002 5 01 PM My Documents ex020219 l0g 6KB Text Document 2 19 2002 5 00 PM My Network Places ex020220 log 14KB Text Document 2 20 2002 5 00 PM My Computer FF ex020222 log 1KB Text Document 2
30. 2001 2005 ClickTracks Advanced Topics 100 6 1 Advanced Topics Strip Out File Types Robots amp Spiders Search Engine Parameters amp Keywords How ClickTracks Uses Cookies A To use cookies within ClickTracks you must both set the cookie within your website code and record the cookie within the logfile If the site sets a persistent cookie then simple new versus returning comparisons of visitors can be made Analysis of visitors with specific cookie values is also possible ClickTracks Professional Client Custom session cookies are supported Persistent cookie database tracks unique visitors and extends campaign and conversion tracking to work across long periods of time latent conversions See Cookie Tracking What is a cookie A cookie is a piece of information that gets sent to a user s browser by a website Cookies are typically used to store user information like name address online buying patterns login details and so on The website can then use this information to provide useful information as the user surfs through the websites Typically a session cookie is used only throughout the duration of the user s visit or session on the website and is removed when the user leaves However there is a second variety of cookie called a persistent cookie A persistent cookie is similar to a session cookie except a physical text file is written to the user s machine and stays there for a website defined amou
31. 21 2002 11 11 PM The name indicates the range of dates contained in YYMMDD format The top file in the above example contains data for February 4th 2002 Your LAN administrator can give you direct access to this directory so you can read the files In some instances typically a small intranet you may even have the files on your own machine File System method When File System retrieval radio button is selected the FTP login section will be grayed out In the edit box for Logfile Directory enter the fully qualified path to the logfiles If the files are located on a 2001 2005 ClickTracks Processing Engine Administrator 38 network share use a UNC network path Example Host D Drive Files SolidWorks If you have a mapped drive to a network share you may enter the map drive letter and path The mapped drive path will be converted to UNC path when you finish 3 1 1 7 Reprocess Logs Now If the need arises that a dataset needs to have the logfiles processed immediately the Server UI will allow the polling schedule to be over ridden In addition a complete dataset can be reprocessed if configuration property changes file include exclude masks and others require a major change in the manner that the logfiles are processed To Process logfiles Now 1 Select a dataset by clicking on the dataset name in the Server UI window 2 Right click on the dataset name 3 Select Menu Run schedule now To Reprocess
32. Campaign Tracking cccccssssessseeeeeeeeeeeeeseeees 104 Configuring Web Servers Internet Information Server IIS Apache sucadustevecectesdeiscsductusdecucasdiedscteddvsncesddatsdteschaudgddvetuedeestesiadddedevdeddvuritdsuntssvadscaudasvicisedesuvasvecddniecteddeesuteersady File Extensions To lg ore 1 ices eens aden dene cect aaa aHan 2001 2005 ClickTracks Contents lll User Agents To IQnore sn rrrnnnssnnnennenennnessnnnneneeeeneesssnnnnenneeeeneennnns 107 Search Engine Parameters amp KeywordS ss nnnnnnnesnsnnneenns 107 Distinguishing Duplicated Links ss issssssnssreerssssnnneneeneeneesnnnes 108 The Way Content Help iiiiicicischccctetcteccsschecccccttizccssabacccccatizecscabaccccatizecesdbesccacassseccesnccacieaesxitee 108 Troubleshooting 111 ogfile Import Warning 232522538125 niaaa aia 222 222 2 lice 112 Terminology 114 FAQ 116 Acknowledgements 120 Index 121 2001 2005 ClickTracks Foreword Foreword ClickTracks is a completely unique way of understanding website visitor behavior We hope you find the software powerful and easy to use We constanily strive to perfect our products If you have feedback or comments would like to hear from you My email address is jmarshall clicktracks com Sincerely John Marshall CEO 2001 2005 ClickTracks ClickTracks Server Getting Started The ClickTracks Professional Pro
33. Dataset Wizard Create a new domain with the New Domain Wizard Create a new web server with the New Web Server Wizard Advanced Topics Analyze On Server Processing v5 1 Configure Client Analyze On Server Datasets v5 1 Processing Logfiles Processing logfiles is the single most difficult problem you will encounter in setting up the ClickTracks Server We strive to make the process as easy as possible but there are always some problems we can t anticipate The most common difficulty is simply logging in to the correct server and account password There is no common standard among ISPs for how this works but the following tips might be of help If you login over FTP to a server this server name is usually the same as the domain name for your website If it s not then your ISP should have given you a different FTP servername for uploading web pages The FTP server for logfiles is almost certainly the same The username and password are usually the same as those for uploading web pages or your admin account You might need to enable passive firewall mode depending on your network configuration If you can t find the logfiles contact your ISP and ask them for access to the raw web server logs for your site Analyze On Server Processing The new ClickTracks server v5 1 takes the burden of the log data analyze phase off the client and onto the server This option can be enabled or disabled at the server only Think Globally Anal
34. Field 6 HTTP Response Code z Field 9 Unknown Ignored gt Sample logfile line Logfile index of Server IP Apache only Version 5 1 In versions earlier than 5 1 a less capable method of establishing the format of Apache logs was used If you are experiencing problems with the processing of multi domain web sites on Apache server due to the Server IP field not being recognized and detected use this setting to specify which column in the logfile contains the Server IP value To set the Server IP value Uncheck the Use default checkbox Set the Server IP column by selecting the number from the dropdown list that corresponds to the column that contains the Server IP 2001 2005 ClickTracks Processing Engine Administrator 72 amp Advanced Web Server Properties Oj x FTP Options Delay time between connections 0 2 Seconds No delay V Logfile Options Server is Microsoft IIS E Logfile index of Server IP D r for multi domain sites Use default IV cs 3 2 Server Logging Once the ClickTracks Server has been started all processing events from all datasets will be logged to the History or Errors tab listed in chronological order The server events will be continuously updated while the Server UI program is running If the UI is closed historical data can be viewed with Show Session Record The event information that is logged Date and Time Message from the Ser
35. Helper Use the DNS Lookup Helper to add additional alias names for your website as needed Enter each alias name on a separate line See Alternate Domain Names See Also Domain Advanced Properties 3 1 3 2 1 1 Case Sensitive Server Files A URL s path name component is sometimes case sensitive depending on the web server s operating system Although the domain name component is never case sensitive the path name can be For example if the website is hosted on a Windows server www bobsfruitsite com catalog fruit asp and www bobsfruitsite com CATALOG Fruit asp are the same page whereas on a UNIX server they would be different pages A website built on a Windows server can therefore have URLs in both uppercase and lowercase or a combination thereof that refer to the same file presented to the browser The web designer might not intentionally create links in mixed case but the fact that a Windows web server permits these links without error means they inevitably happen Conversely on UNIX servers the above pages would be different A mistake made by the web designer is not hidden the page named with the wrong case would result in a 404 not found error At logfile processing time ClickTracks needs to gather data for all unique pages On a Windows server the above requests are for the same page so ClickTracks needs to know that the web server is not case sensitive Usually the case sensitivity of a web server is determined by t
36. NIX case sensitive pe type the domain URL and click Lookup Windows not case sensitive Jwww sitenamecom SSS http www sitename com http sitename com M Server Scripting Select which scripting technology is used by this domain PHP 7 Auto detect Server Settings OK Cancel Apply Case Sensitivity Select either the UNIX case sensitive or Windows not case sensitive setting to correctly identify how the web server handles file names See Case Sensitive Server Files Server Scripting Use the scripting language selection to set a range of default options For example choosing PHP will cause ClickTracks to use session cookies within the logfile named PHPSESSID and to chose index php as the default page name ASP causes ASPxxx cookies to be used and default asp for the default page name The static option cannot use a session cookie only standard session cookies from the shown scripting systems are supported in ClickTracks Analyzer ClickTracks Pro permits any cookie to be used Select the correct server side scripting technology that is being used by the domain Possible values are e ASP ASP NET ColdFusion PHP JSP None 2001 2005 ClickTracks Processing Engine Administrator 60 Click the button Auto detect Server Settings to automatically find the server side scripting technology that is being used on this domain DNS Lookup
37. P 59 B blank 111 browser reports 91 browser based reports 91 C campaign 56 100 campaign tracking 19 case 60 case sensitive 64 case sensitivity 59 central management 31 ClickTracksScheduler xml 52 client 105 combined 106 compressed 39 configuration client connection 69 32 cookie 19 100 104 105 106 cookie tracking CPU 4 create 43 create dataset 43 CustomLog 106 D Dataset 30 53 dataset properties default page 61 delete 38 diagnostics 72 diagram 5 7 directory 39 disable 39 disk 4 distinguish 108 Document 30 domain name 60 domain properties domain wizard 48 duplicated 108 E email configuration emailed reports empty 111 enable 39 end users 87 error 78 errors 72 56 100 cookies 100 104 52 58 59 93 exclude 61 63 106 exclusions 106 extension 106 external 60 E FAQ 116 2001 2005 ClickTracks Index 122 field 105 fields 105 file 106 file permissions 24 file share 68 find replace 57 five 7 FTP 34 36 65 ftp delay 69 G groupings 88 groups 88 H history 72 74 host 61 hosted 45 hosted dataset 45 ignore 106 IS 36 37 39 69 105 import 16 include 61 62 index html 61 IP 61 IP address 105 iplanet 39 ISP 105 J javascript 40 44 jdc 45 jdc wizard 44 JSP 59 K keywords 107 w n LAN 37 license 5 local system account 24 location 37 log files 31 log fo
38. Pro Client This document will cover the upgrade process as it applies to each of these components Processing Engine Important Notes ClickTracks 6 does not support dataset mirroring If you have datasets configured to mirror data to a server you need to turn it off first which will cause each dataset to be reanalyzed This could take some time depending on how large your datasets are To turn mirroring off in version 5 6 1 Click on the El icon next to the dataset name Click on the Dataset Mirroring tab and un check the Enable mirroring for this dataset checkbox 3 The dataset will now be reanalyzed 4 Do not attempt to run both versions 5 6 and 6 on the same machine They share registry settings that require different settings and it will not work When you first launch the ClickTracks 6 Pro Processor after installing it on top of version 5 x you will initially see a Dataset Upgrade Wizard to facilitate the upgrade process Step through this process 2001 2005 ClickTracks 11 ClickTracks Server Dataset Upgrade Welcome to the Dataset Upgrade Wizard The following pages will assist you in upgrading your existing datasets Welcome to the New Dataset Wizard The first step is to determine which datasets you want to upgrade to version 6 Once a dataset has been upgraded to version 6 it is no longer compatible with earlier versions So if you think you ll want to keep a dataset at an earlier
39. S2 Server normal win2003qa IIS Log 3 00 57 created nlf file C NewServerData DS2 Server normal win2003qa IIS Log E 3 23 20 Created nlf file C NewserverData Ds2 Server normal win2003qa IIS Log _2004 02 25_21 09 23 Created nlf file C NewserverData Ds2 Server normal win2003qa IIS Log _2004 02 27_01 15 32 n1f v valid request lines 202993 win2003QA QA Domain IIS Log Files Invalid request lines 0 win2003Qa Qa Domain IIS Log Files start downloading file 200403marchlogs zip win2003QA QA Domain IIS Log Files Reading all of file 200403marchLogs zip try 1 win2003Q4 QA Domai AlItS Log Files Return from reading full file win2003QA QA Domain IIS Log Files 2001 2005 ClickTracks 77 ClickTracks Server 3 2 3 History The History tab will display all events for all datasets in chronological order The server events will be continuously updated while the Server UI program is running The History tab will contain up to 2 weeks of server events before current logfile ServerState bin will be rotated out and renamed as ServerState old You can filter the History events of a single dataset to isolate the events for viewing To show the specific History events of a single dataset 1 Select a specific dataset by clicking on it with the mouse 2 Right Click on the dataset name 3 Select Menu choice Show History right click to close amp ClickTracks Server Administrator WEB SERVERS Add web server The ClickTracks se
40. Submit To delete an existing task click on the task and then click Remove Scheduled Archive Tasks You can also schedule the Reporting Engine to archive your website on a daily weekly or monthly basis To create a scheduled archive Click on New Archive Task under Current Tasks Give the task a meaningful name Select a dataset to archive Select whether to archive daily weekly or monthly Specify a day of the week or date of month depending on your selection in step 4 Specify a time of day to perform the archive Click Submit to save the changes ALO O eA O N The task will now appear under Current Tasks To edit the task simply select the task from Current Tasks and make any desired changes To delete the task select the task and then click Remove 2001 2005 ClickTracks Reporting Engine Administration Admin Home Scheduled Task Configuration User Accounts Current Tasks Task Name ET New Email Task New Archive Task Site Archiver Task Type cheduled Site Archive Seni Dataset bobsfruitsite v Configuration Daily Mail Server Frequency Configuration r Time 11 am 1 Scheduled Task Monday a Configuration Day 2001 2005 ClickTracks Configuration Client Configuration Client 98 5 Configuration Client The Configuration Client allows an administrator to make global changes to
41. System Enables ClipBook Viewer to stor Manual Local System Ba COM Event System Supports System Event Notifica Started Manual Local System By COM System Appli Manages the configuration and Manual Local System Sa Computer Browser Maintains an updated list of co Started Automatic Local System So Cryptographic Servi Provides three management se Started Automatic Local System SRA DHCP Client Manages network configuration Started Automatic Local System Sy Distributed Link Tra Maintains links between NTFS fi Started Automatic Local System Ce oe Tuem mm m Pe a nS ee ns LL re ree 1 eee E zl Standard Make sure that the ClickTracks Server service is currently stopped 4 Double click on the ClickTracks Server Service in the Services Manager 5 Click on the Log On tab of the ClickTracks Server Properties 2001 2005 ClickTracks 25 ClickTracks Server Select the proper account type A Local System Account Use this type of account when e Accessing logfiles via the FTP protocol on remote computers e Accessing logfiles on the local computer when the Web server and the ClickTracks Server are on the same machine ClickTracks Server Properties Local Computer 2 x General Log On Recovery Dependencies Log on as Local System account Allow service to interact with desktop This account Browse Password Confirm password You can enable or disable th
42. TTP_COOKIE_ VARS CLICKTRACKSID setcookie CLICKTRACKSID MYVALUE time 86400000000 JavaScript Sample Code The following is a standard cookie library to save in a js file and include on your website For example lt script language JavaScript src cookie js gt lt script gt 2001 2005 ClickTracks Advanced Topics 102 Inside cookie js you should paste the following Cookie Functions Second Helping 21 Jan 96 Written by Bill Dortch hIdaho Design lt BDORTCH NETW COM gt The following functions are released to the public domain The Second Helping version of the cookie functions dispenses with my encode and decode functions in favor of JavaScript s new built in escape and unescape functions which do more complete encoding and which are probably much faster The new version also extends the SetCookie function though in a backward compatible manner so if you used the First Helping of cookie functions as they were written you will not need to change any code unless you want to take advantage of the new capabilities The following changes were made to SetCookie 1 The expires parameter is now optional that is you can omit it instead of passing it null to expire the cookie at the end of the current session 2 An optional path parameter has been added 3 An optional domain para
43. Test IIS NLF Files Normalized Logfiles NLF are the end results of processing your web server logfiles You can review the created NLF files associated with a specific web server To see all of the Normalized Logfiles for a specific dataset domain web server 1 Select the specific dataset with the mouse This will reveal the domains associated with this dataset 2 Select the specific domain with the mouse This will reveal the web servers associated with this domain 3 Select the specific web server with the mouse A new tab NLF Files will be displayed and contain the following information File Name The actual file name of the NLF file giving the date range of the data stored in that file Size The file size of the NLF file in kilobytes Created The date and time that the NLF file was created Example NLF tab 2001 2005 ClickTracks 83 ClickTracks Server History Errors NLF Files File Name Size Created _ G2004 02 18_16 36 27_to_2004 02 19_07 58 53 nlf G2004 02 19_08 00 04_to_2004 02 20_07 59 55 nlf G2004 02 20_08 00 11_to_2004 02 21_00 39 09 nlf G2004 02 23_19 49 40_to_2004 02 23_23 00 57 nlf G2004 02 24_20 05 46_to_2004 02 25_03 23 20 nlf G2004 02 25_08 00 03_to_2004 02 25_21 09 23 nlf G2004 02 26_08 00 03_to_2004 02 27_01 15 32 nlf G2004 02 27_08 00 03_to_2004 02 28_07 27 42 nlf G2004 02 28_08 00 03_to_2004 02 28_10 55 02 nlf G2004 02 29_08 00 06_to_2004 02 29_10 55 15
44. Web server represents the lowest level of configuration of the ClickTracks server The web server configuration will tell the server how to retrieve logs and which logfiles to process One or more web server configurations can be defined under a domain Logfile Retrieval Method Logfiles can be retrieved by either the FTP protocol or from a local file system or network share FTP Logfiles are downloaded via the FTP protocol from the remote server A valid set of FTP login parameters are required to use this method File System Logfiles are retrieved from a local file system or network share directory for processing Logfile Settings Logfile directory The directory name on the FTP or file system where the logfiles reside File exclude mask Use this file mask pattern to exclude files from being processed by the server File include mask 2001 2005 ClickTracks Getting Started 10 1 5 Use this file mask pattern to include only the logfiles specified to be processed by the server Logfile index of Server IP New Dataset Wizard Upgrading from 5 x to 6 ClickTracks 6 can be installed on top of 5 x It is not necessary to uninstall 5 x first However because of the architectural differences between versions 5 x and 6 there are some specific steps to be taken in the upgrade process There are three different components of the application 1 the Processing Engine 2 the Reporting Engine and 3 the
45. a dataset These changes are then passed along to the end users either through the downloaded dataset or via the rendered reports The Configuration Client is essentially the same application as a Pro Client although it does have some significant differences It does not include the ability to create a dataset as it always uses the dataset that was clicked in the Processing Engine Administrator to launch the application Likewise it has no ability to synchronize with the server It does not include the option to switch from Instant Reports to Custom Analysis rather it is always in Custom Analysis mode because that is the essential purpose of the application Otherwise the application is the same as the standard Pro Client For additional help on using the Configuration Client go to http way clicktracks com help en pr ClickTracks Server Testing Build 912 Expires Thursday October 13 2005 Dataset ae Currently analyzing these dates from your imported data http www bobsfruitsite com Tuesday August 02 2005 Thursday September 15 2005 Import Data Enhance Reports View Reports Imported data spans Tuesday August 02 2005 Thursday September 15 2005 Quick Labels 4 B Splits a Search Report Robot Report Funnel Report Ad d eaten tele Time Splits Cki y Edit Labels Edit Splits Navigation Report campaigns Sales and ROI Options Change Dates Site Overview What s Changed Report Check for updates
46. a is very efficient because logfiles contain much repetitive data resulting in files that are 10 of the original size 2001 2005 ClickTracks Processing Engine Administrator 40 3 1 1 12 3 1 1 13 3 1 1 14 Thus a very common scenario is to have the following files on the web server access log april_2001 gz march_2001 gz february_2001 gz Access log contains all web requests from May 1 onward The other three files contain data for each month as indicated by the names When you use ClickTracks you do not need to worry about reading the same data twice If you import a logfile that ClickTracks has read part of before it will simply ignore the lines it has previously read Virtual Servers Multiple Domain Logfiles Virtual Servers Multi domain Logfiles A single web server is often used to host many individual websites through a process known as virtual servers An ISP will almost always divide the resulting entries in the main logfile into individual logfiles for each distinct website so each customer s logfile contains only requests for its website If you host your own servers you might generate a logfile that contains requests for all the subdomains of different sites and you want to see these distinctly from each other Your logfile contains a field that specifies the domain name of the site to which the request was directed Logfiles in this format are known as multi domain or multi home If thi
47. ach time someone clicks from Google to the target site a new session should be started otherwise those clicks will not match the pay per click PPC campaign clicks 2001 2005 ClickTracks 61 ClickTracks Server A problem arises when the site is known by several different domain names e g both www bobsfruitsite com and www bobsfruitsite co uk The second domain must be listed as an alternate otherwise every page clicked in www bobsfruitsite co uk will result in a new session and an additional visitor session The New Dataset Wizard attempts to find cases like this based on examining the website s IP and DNS entries A related problem is having pages on an external site such as a newsletter sign up ClickTracks Analyzer cannot track users across these different domains only Professional can do this Howver it is possible to use a goal page that lives on the main site and the visitor would see this page after completing the process on the external server In this case the external domain should be listed as an alternate RULES e Alternate domains should include any domain that is inside the website as your visitors perceive it Visitors coming from any domain not listed will by default be coming from outside and will count as an additional new visit e Separate domains in the list with a semicolon e f alternate domain names are added altered or removed after the server dataset has been created the server lo
48. ame CO CT Logs Web Server Name NLF Files Here Server User Account The ClickTracks Server service will need to run on the installed machine with the proper login account If you use the File System as opposed to FTP when processing logfiles some security issues need to be considered If the ClickTracks Server is accessing logfiles on another machine located on a local area network you need to ensure that the service has permission to access the remote file system This is true both when the logfiles are being read from a remote network drive and when you are storing the resulting NLF files on a remote network drive To Change the Server User Account 1 Windows Start Menu Control Panel 2 Administrative Tools Services 3 Select the ClickTracks Server service ioix File Action View Help e mE AR m 1 Notifies selected users and com Manual Local Service Apache 1 3 29 Win32 PHP 4 Manual Local System Sy Application Layer G Provides support for 3rd party Manual Local Service Sa Application Manage Provides software installation s Manual Local System SA ASP NET State Serv Provides support for out of pro Manual Network 5 Sy Automatic Updates Enables the download and inst Started Automatic Local System Background Intellig Uses idle network bandwidth to Manual Local System e ClickTra Version 5 Automatic Local
49. ame required only for multi domain logs The referrer and user agent fields are essential for ClickTracks to generate reliable reports Internet Information Server IIS Apache Internet Information Server IIS The default installation of Microsoft IIS writes minimal information to the logfile Most websites have changed the IIS configuration to write more detailed information ClickTracks requires W3C Extended Logfile Format Date Time Client IP Address Method URI Stem URI Query User Agent sc status Cookie preferable but not required Referrer cs host only required for multi domain logfiles Other fields can be logged and will be safely ignored by ClickTracks 2001 2005 ClickTracks Advanced Topics 106 Open Control Panels from the system Start menu Open Administrative Tools Open Computer Management Expand Services and Applications Now expand Internet Information Services Right click on Default Web Site Logfile settings are contained in the Web Site tab at the bottom Click Properties then Extended Properties to verify the settings above D ORO eGo NO 6 3 2 Apache Apache is configured through a text file that contains many other settings that are beyond the scope of this document The settings relating to logfiles are oe LogFormat v h combined 1 Su St Sr S gt s Sb S Referer i S User Agent i CustomLog var log httpd a
50. ame of the server containing logfiles This is often the same as the domain name for your web server eg www mydomain com but it s sometimes a generic name such as ftp hostingcompany net The username and password are usually the same for administering the site or uploading pages Your ISP should have given you this administrative account when you signed up See also Which Files to Download Troubleshooting amp Help and What If You Have No Logfiles Which Files to Download When you first view the directory in the FTP window you might see a set of files named Stats or similar Often these files will have extensions like BIN and a group of HTML files It s important to realize that such files are not the logfiles ClickTracks needs to read but are in fact output files from some other stats program such as Analog or WUseage running on your server ClickTracks needs access to the raw logfiles Examples of the files you should download IIS on Windows ex020626 log or ex020626 log gz The name indicates the date range in YYMMDD format and the file typically soans one day The above example 2001 2005 ClickTracks 37 ClickTracks Server 3 1 1 6 would contain all transactions for June 26 2002 Download whichever dates you want to analyze Apache on Linux access lt This is the current logfile Download it access 1 gz lt These are older rotated logfiles Depending on the rotation schedule you might not
51. an existing dataset This option can only be enabled or disabled on the server See Topic Analyze On Server Processing 3 1 3 1 2 Mirroring Data To Another Server The term dataset mirroring refers to copying a fully processed dataset to another server via FTP The mirroring process is continuously updated as the server processes logfiles This is useful when you process logfiles from the web server and then need to push the results to a server with a public IP address so that other people without LAN access can view the data with the ClickTracks Professional Client via FTP HTTP or HTTPS rather than a local network file system Open the Properties dialog of the dataset to be mirrored select the dataset mirroring tab and specify an FTP upload location where the data will be stored The Dataset Mirroring dialog below appears 2001 2005 ClickTracks 55 ClickTracks Server s Dataset Properties ClickTracks of x General Dataset Mirroring Cookie Tracking URL Pruning ClickTracks will replicate the directory tree for this dataset Choose an existing directory on your FTP server as well as a new subdirectory that will be created by ClickTracks M Enable mirroring for this dataset M Server Info Server ftp sitename com Username webmaster Password eeeceee I Use passive firewall mode M Directories Initial Directory Browse New directory Mirror Dataset will be mirrored at ZMi
52. ataset you will be prompted to specify the location where client dataset data will be stored Similar to the method in version 5 x Click the Finish button 2001 2005 ClickTracks 15 ClickTracks Server New Dataset Wizard Final Page New Dataset Wizard Final page Enter the location to save this dataset Select the locally cached dataset atasets wwwbobsfruitsitecom wwwbobsfruitsitecom tks location What is a dataset Default location is My Documents ClickTracks Datasets Important Note Do not save your client dataset to the same folder where the corresponding dataset for the Pro Processor has been saved You must be particularly careful about this if the Pro Processor is running on the same computer as the Pro Client or if you are saving your datasets to a network drive After completing the New Dataset Wizard on the Client you will see reports in Instant Reports Mode by default In this mode pre analyzed reports are delivered in HTML format directly from the Reporting Engine to the Pro Client No analysis of data is required or possible in this mode When you shift to Custom Analysis mode you will be prompted to initiate the synchronization with the dataset on the Pro Processor 2001 2005 ClickTracks Getting Started 16 ClickTracks This will switch your dataset into Custom Analysis Mode which will allow you to use many powerful features but will req
53. cascihsadvsatlansesctisadkassnsadiacbisaivsccheasssatcassessiasadesssssaciasessadasate 45 New Domain Wizard acne ccc area secu sa elect ac date cinta ed as get nee gee aca ds ed Pi ee 48 New Multi Domain Wizar Gass cssscisccis cctsccissceesctcscts catcastcsatcasteccdsestuestuisieseieecissttesstessisasiesstenetnesteesnctaesieeicciscieicieecisd 49 New WED SORVOMNVIZANG isseire Leman nent mines colncacestecsueesbicastebdcaescehecsaucsteasates intl natale este 51 Properties ssi asiitreneenestiaretennettas nteeeane titane aires aenneesesre tee sant trees atarege anenanete enaid ete sage tatanesate 52 DAlASCL PROD SIMICS ARS ARR nn nd nd Aaea diese ee en di di ae 52 Dataset eneral sisi tn seta caicasti sata tctesacntvicsees satasetsostusats sate at et ni iii ArSeN 53 Mirroring Data To Another Server see oe as su D4 Cookie Tracking asituaninatannndnesianatnnitirttinenterdrtsitiintirtntntinnitis dent A NAAMAA ASi 56 MRL acess eect seca geese cate tu a tes eta a a e aaa eaaa a eaea na daaa EEan 57 D main Properties R A AA EA nine TAN ds 58 Domain General Case Sensitivity Server Scripting ss 59 Case Sensitive Server Files Alternate DOMAINNAMES 225255222502 he cxZik ee code va cide reines dale aar nine have au tes Sierre Teens t sets nine sante Domain Advanced RER aa as en ee eect ae ae ee ce File Domain INCIUSIONS 5 lt 2ssc 5 ce ccisecaeestesexscotecakezatecausceSncastesQeccvacehncchiceestaeaeizaaisai
54. ccess combined The first line defines a log format named combined containing the fields in the order specified The second line ties the named format to the actual file name to be used when writing the information Other fields can be present in the logfile and the order of fields is not critical Most Apache installations are similar to the above and require no further modification Logging cookies If your site is setting cookies either through the built in session cookie of a scripting language like PHP or your own custom cookie you ll get better results through ClickTracks if the cookies are present in the log Modify your logformat line as follows LogFormat Sv Sh 1 Su St Sr S gt s Sb S Referer i S User Agent i S cookie i combined For more information see How ClickTracks Uses Cookies 6 4 File Extensions To Ignore A typical web page is made up of many individual files Beyond the HTML page itself each graphic element is a separate GIF PNG or JPG file As the browser requests these elements the web server will record them in the logfile Most of these requests can be ignored by ClickTracks because the containing HTML page request is all that is required to determine visitor behavior patterns Stripping the requests has two benefits 1 Increased performance because much data from the original logfile is not analyzed 2 Better visitor behavior data because reports show the actions initiated by visitors and are
55. cessor is a powerful back end set of applications that does the heavy lifting of processing analyzing rendering and distributing reports so that the end user has the simplest yet most customizable experience possible The Professional Processor can generate reports in HTML format for the user to view reports instantly it can also distribute complete datasets so that users on a ClickTracks Client application can perform their own custom analysis The system consists of services that process and serve data to end users as well as administrative interfaces to manage those services and the datasets themselves The various components of the Professional Processor are typically installed and configured by the IT department though marketing or analytics staff could have input in this process The ongoing administration of the components might also require involvement from both types of staff as some aspects of the functionality are technical in nature while others involve website design and marketing objectives The installer for ClickTracks Professional Processor installs five separate executable programs each of which performs a specific function in the system These programs are associated with the three main components of the system Component Name Executable File Function Processing Engine CT_Scheduler Service runs in the background performing low level tasks of acquiring and processing logfiles ClickTracksServer User interface to set up datase
56. ch files to include and exclude from analysis Separate each file mask with a semi colon Example Exclude mail old ftp Include log zip gz Carefully choose the Include and Exclude file masks to narrow down the logfile lists to be processed by the server Pay attention to logfile rotation schemes used by the web server For example www sitename com access Today s logfile text format www sitename com access 1 gz Today 1 day logfile gz binary format www sitename com access 2 gz Today 2 days logfile gz binary format A proper include file mask for this file rotation would be www sitename com access This file mask would allow the current logfile and all rotated logfiles to be accessed and processed by the server For example setting the file Exclusion entry to mail old ftp will mean files containing the pattern of mail old or ftp in the name are never downloaded See also Compressed Rotated logfiles 2001 2005 ClickTracks 51 ClickTracks Server 3 1 2 6 The results of the Multi domain Wizard will be a new special domain entry Multi domain and a new user named web server entry To add additional Web Servers to this special Multi domain entry 1 Select the domain entry Multi domain by clicking the domain entry under a specific dataset 2 Right click on the Multi domain entry 3 Select Menu Add web server Continue to respond to the questions until complete
57. ck some days later to purchase Because the click on the PPC ad and the purchase happened across two visitor sessions there is no way to tie these two operations together and log a conversion in ClickTracks The only way to accurately tie these two sessions together is to set a cookie for the visitor Thus every time the visitor comes to your site ClickTracks will treat him or her as a unique visitor and will log the conversion because it s almost as if the PPC ad click and the purchase happened in the same session even though this session lasted many days 2001 2005 ClickTracks 101 ClickTracks Server How Do I Set Cookies for My Website Visitors IFor ClickTracks to track cookies we require that you set a persistent cookie for all your visitors When you set this cookie you should set its expiry date to never expire Cookies are set using either your server technology PHP ASP etc or your client side technology JavaScript VBScript etc Cookies are usually set using the following name value scheme Name value Each cookie that you set must be unique for every visitor You can come up with any kind of convention that you like One example is to use a Timestamp followed by a random string So for example MYCOOKIE 06012004ABCD This is a sufficient example of a unique value because it is almost impossible to have two requests logged at the same time Even if this does happens adding another random string
58. clicking on the green icon next to the dataset for all clients to receive global labels import campaigns and configure revenue See Configure Client Analyze on Server Datasets JDC Dataset Support v5 1 As of version 5 1 the Pro Server can handle JDC datasets from the ClickTracks Hosted service A configuration can be created to retrieve the JDC dataset from the hosted machine and make this data available to desktop client machines just as is done with any other server dataset See New JDC Dataset Wizard System Overview Diagram Analyze On Server Datasets 7 Analyze On Server ClickTracks file share Pre processed FEZ Server Process or FTP and compressed a Processing ile Share I data NLF Files BIN files A ClickTracks ENO Server Admin ff SS eo ee HTTP FTP File Share HTTP FTP File Share Olek Tracks Server ClickTracks ClickTracks ClickTracks Click Tracks Client Client Client Client Regular Dataset Regular Dataset AOS Dataset AOS Dataset Desktop Desktop Desktop Desktop The ClickTracks Server can read logfiles from multiple web sites load balanced servers and multiple 2001 2005 ClickTracks Getting Started 8 subdomains The major user configurable components of the Server UI are Datasets Datasets represent the top level configuration layer of the ClickTracks server A dataset will be configured to define the
59. ctet 208 64 72 214 219 Range amp wildcard 208 64 72 74 Subnet mask 208 64 72 218 23 Note f you need to modify data in this section it is necessary to reimport all your logfiles in order to apply these filters See Reprocess Logs Now 3 1 3 2 2 3 URL Parameters The URL settings on the Domain Advanced tab effect the way the ClickTracks Server handles various URLs s Domain Settings CT Domain General Advanced Here you can configure inclusions and exclusions based on files or hostnames m File inclusions exclusions Host exclusions Inclusions Exclude hosts Exclusions Options IV URL parameters are case sensitive URL parameter used to distinguish between links to the same page Default pages index htm index html default htm default htmlindex php index php3 Cancel Apply URL parameters are case sensitive Set this checkbox for the ClickTracks Server to differentiate between the case of URL parameters Turning on this setting will result in a more accurate and precise site analysis For example with URL parameters are case sensitive selected http www sitename com checkout html PurchaseAmt 100 would be a completely different URL from 2001 2005 ClickTracks 65 ClickTracks Server 3 1 3 3 http www sitename com checkout html purchaseamt 100 URL parameter used to distinguish between links on the same page A page that links to anot
60. d multiple gigabytes of logfile data A faster CPU and more RAM will make a big difference to performance Software Requirements Supported Operating Systems Windows 2000 Windows 2000 Server Windows XP Home Professional Windows Server 2003 Note that Windows NT 4 is not supported for server use Also note that Windows 2000 Server may require special configuration in order to enable the ClickTracks Reporting Engine Network ClickTracks Processing Engine reads logfiles from a web server either by downloading over FTP or through Windows file sharing LAN and places the resulting data store in a folder where they can be served via the HTTP protocol The Processing Engine must have an FTP login account with read access to the web server s The computer must have an open port to the web usually port 80 through which ClickTracks Client apps and web browsers can download data This may require making adjustments to firewall settings Server Licensing If you encounter an error message about exceeding the maximum license and you need to add additional web servers please contact ClickTracks Sales sales clicktracks com You are permitted to add additional web servers to the configuration provided they are from the same IP address Architecture of Version 6 There has been a major architecture change between version 5 x and version 6 The following diagram illustrates the various components of the ClickTracks Professional Processor and how
61. data FileExtensionsTolgnore txt Open this file in Notepad or any other text editor to see if the file extension you are trying to track is in there If it is carefully remove that entry save the file and rerun ClickTracks The logfiles from the site need to be reprocessed Q Why can t my Pro Client download any data files from a mirrored dataset via the HTTP protocol A The web server serving up the data will need to be configured to handle the retrieval of the NLF and other ClickTracks files used for dataset mirroring The web server will need to have the following MIME types added for the file types MIME Type NLF application octet stream TCS application octet stream INI text plain See your server documentation for details on adding a MIME type 2001 2005 ClickTracks Acknowledgements Acknowledgements 120 10 Acknowledgements Regular expression support is provided by the PCRE library package which is open source software written by Philip Hazel and copyright by the University of Cambridge England PCRE can be obtained from www pcre org or ftp ftp csx cam ac uk pub software programming pcre 2001 2005 ClickTracks 121 ClickTracks Server Index A A B split 90 AB split 90 access log 36 accounts 87 add new 43 administrator 24 adminsitrator 85 advanced topics 100 alternate 60 analyze onserver 31 AOS 31 apache 36 39 106 architecture 5 7 archiving 90 AS
62. e Important This is the file system location where ClickTracks server will save the configuration files and normalized logfiles that are read by the client machines This location must be a network share that is readable from the client machines The default location will almost certainly need to be changed Use the Browse button to navigate to long path locations 2001 2005 ClickTracks Processing Engine Administrator 46 Page 3 Hosted account login Enter the login information for the hosted account for which you want to create a dataset You can click the Test Login button to confirm you have the right login although this isn t necessary New Hosted dataset Wizard Partner Login Enter the username and password required to login to your partner account Page 4 Select the dataset to analyze All the datasets under this hosted account will appear in a drop down menu Select the dataset you wish to process with the Pro Server If there are multiple domains under this dataset you can narrow it to a single domain 2001 2005 ClickTracks 47 ClickTracks Server New Hosted dataset Wizard Dataset Domain settings Choose your dataset and selecthow domains will be processed Available Datasets Select Dataset x Domain Settings All Domains default C Single Domain Process domain Page 5 Configure Schedule In the drop down menu under Schedule Frequency c
63. e FTP Page 4 HTTP Dataset Retrieval Enter the following information URL of config file The location of the ClickTracks_Config xml Username The account name Password The password for the account OR Page 4 FTP Dataset Retrieval Enter the following information FTP Server The address of domain name for the FTP server Username The account name Password The password for the account Config file location The location of the ClickTracks_Config xml on the FTP server Use the Browse button to navigate to long path locations Use passive firewall mode Select this checkbox if your site needs to use passive FTP mode OR Page 4 Local File System Dataset Retrieval 2001 2005 ClickTracks 45 ClickTracks Server 3 1 2 3 Enter the following information Location The location of the ClickTracks_Config xml on the local file system Use the Browse button to navigate to long path locations Page 5 Configure Schedule In the drop down under Schedule Frequency choose how often you want to update the log data For low to moderate traffic websites the interval should be longer than those sites that have a high volume of traffic Keep in mind that when the service is actively running a retrieval session your CPU load will go up so schedule according to your own preferences You can delay when the software does its first retrieval by setting the Start Date Normally you can leave it with default curren
64. e correct server and domain If you re sure the logfile is part of the website being analyzed and should be included in the dataset you might need to add the domain for this logfile to the list of domain aliases inside the options dialog 2001 2005 ClickTracks Terminology 114 8 Terminology ClickTracksScheduler xml All server configuration information is saved in this file which resides in the ClickTracks Server directory Dataset A unique website It could consist of multiple sub domains or load balanced servers Domain A logical group of web servers could be just one that is part of the makeup of the overall website This also includes load balanced servers Normalized logfile A file with the extension NLF that resides in special folders to be accessed by the client software The NLF file created by the ClickTracks service is a preprocessed compressed file that contains web logfile data that is stripped down to contain only relevant data used by the ClickTracks Client software Server A physical computer running a website 2001 2005 ClickTracks FAQ 116 9 FAQ Frequently Asked Questions Licensing Issues Q My server license has expired What can do A Contact ClickTrack Sales sales clicktracks com to purchase a permanent license Once you have purchased the licenses activate them via the Server UI Menu Help Activate License Q have exceeded my serve
65. e directory logs El File exclude mask 0 File include mask lod The FTP login account must have at least read privileges for the logfile directory See your network administrator for further information on the privileges of the FTP login account being used FTP Login Parameters FTP Server The domain name that the ClickTracks Server will use to read the logfiles In many cases this will be the same as the web server domain name User Name The user name for FTP login This account must have read access to the logfiles Password Corresponding password for login Passive Mode Some firewall configurations require this setting Secure Mode As of version 5 6 0 ClickTracks will support Secure FTP Simply check the box to make the data download secure Test Connection Button Click this button to verify that the FTP parameters entered will successfully log you into the FTP server If the connection fails check your login parameters or contact your network administrator for additional help 2001 2005 ClickTracks 67 ClickTracks Server Logfile Settings Logfile Directory The path to the location of the logfiles on the FTP server Browse Click this button to log in to the FTP server and browse the directories to the location of the logfiles Select the directory name from the dialog box and click OK The directory value will be placed into the Logfile Directory field File Exclude Mask Exclude this fi
66. e getting imported It is too late to process cookies once the logfiles are loaded Using Persistent Cookies To Improve Campaign Tracking Campaign tracking relies on tying a conversion event back to a campaign or search engine keyword that generated the lead The complication for web analytics tools is that the clickthrough and conversion often occur hours days or even weeks apart Because the user s IP address and other data are almost sure to change across such a long period of time a unique and persistent cookie is the only reliable method for tracking It cannot be overstated that good campaign data depends on setting a unique persistent cookie Configuring Persistent Cookies Cookies are a part of the HTTP protocol and are exchanged between browser and server during the time the browser requests pages They are then logged in the logfile It s important to understand that ClickTracks cannot set any cookies Only the website can do this It s in the interest of the website owner to set and manage the cookies as this provides the best possible long term solution Even though writing website code to handle the cookies seems complex and time consuming you should do it It s too important to ignore The persistent cookie you use can have any name and the contents are unimportant as long as they are unique and won t be changed later To meet these requirements you must 1 Create a unique value for the cookie The system time epoch time with a
67. e now Reprocess all logs for this dataset Message Dataset Domain web server Example Session Record file B serverstate txt Notepad service Started version number 5 0 8 720 Ftp Trace Logging ON Initializing overriding schedule win2003Qa No previous archive pinana aa aona Log Files Reading FTP server directory win2003QA QA Domain IIS Log Files Directory file count is 20 Win2003Q4 Q4 Domain IIS Log File Start downloading file 200402FebLogs zip win2003Q4 Q4 Domain IIS Log Files Reading all of file 200402FebLogs zip try 1 win2003Qa Qa Domatn iris Log Files Return from reading full file win2003QA Qa Domain IIS Log Files File size of c program Files ClickTracks ClickTracks Server temp 200402FebLogs zip is 903978 win2003QA QA Domain IIS Log F Finished downloading file 200402FebLogs zip Wwin2003Q4 QA Domain IIS Log Files successfully received file 200402FebLogs ziplwi g QA Domain IIS Log Files Normalizing file 200402FebLogs zip win2003QA QA Domain IIS Log Files created nlf file C NewServerData Ds2 Server norma win2003qa IIS Log created nlf file C NewServerData Ds2 server normal win2003qa IIS Log Created nlf file C NewserverData Ds2 server normal win2003qa IIS Log created nlf file C NewserverData ps2 Server normal win2003qa IIS Log created nlf file C NewServerData ps2 Server normal win2003qa IIS Log 7 59 55 created nlf file C NewServerData Ds2 Server normal win2003qa IIS Log 10 39 09 created nlf file C NewServerData D
68. e server during the Configure Client session Create labels using the Label Wizard or the Advanced Labeling Wizard After labels have been defined and the dataset analyzed the labels will be synchronized to the desktop clients during the next Synchronize with Server operation Note Global labels will only flow downstream to the client datasets Users can define their own local labels in addition to the global labels Global labels can be hidden from view on the local client so their values will not appear in reports Locally defined labels will not be synchronized back to the server dataset Global and Local Label Behavior 2001 2005 ClickTracks 33 ClickTracks Server 3 1 1 3 Operation Synchronize to Client Global Label Created on Server Yes Updated Label definition on Server Yes Global Label Deleted on Server No Label will be removed from local dataset on next synch Local Label Created on Client No Label stays in local dataset only Dataset will count locally now Importing Campaign Data Campaign data can be imported from Google Overture or other format from CSV files The Other Campaign tab can also be configured by manually entering the campaign name type landing page and cost Select Menu Tools Configure Ad Campaign or click the Configure Campaign link on the Campaign Report The Campaign data will be synchronized to the client dataset during the next Synchron
69. ead by the client machines This location must be a network share that is readable from the client machines The default location will almost certainly need to be changed Use the Browse button to navigate to long path locations Page 3 Configure Schedule In the drop down menu under Schedule Frequency choose how often you want to update the log data For low to moderate traffic websites the interval should be longer than those sites that have a high volume of traffic Keep in mind that when the service is actively running a retrieval session your CPU load will increase so schedule according to your own preferences You can set the start date manually to delay when the software does its first retrieval Normally you can leave the default start date current day Start time sets the time the software will begin the first session Set the polling frequency of the ClickTracks server to one of these values 15 Minutes 30 Minutes Hourly 12 Hours Daily Weekly Monthly Set the polling frequency cautiously to avoid excessive network traffic Page 4 Analysis Location v5 1 This page allows you to choose where your dataset will be analyzed If you choose Think Globally analyze on server your data will be analyzed by the ClickTracks Server after the logfiles are normalized The analyzed data can then be synchronized with a client and further operations performed If you choose Think Locally analyze on client you will have
70. er name here Default pages lists pages to treat as a default landing page when a web browser opens a directory name Note f you need to modify data in this section it is necessary to reimport all your logfiles in order to apply these filters See Topic Reprocess Logs Now 3 1 3 2 2 1 File Domain Inclusions Sometimes it is necessary to have the ClickTracks server ignore certain requests for documents or directories or requests from certain IPs s Domain Settings CT Domain General Advanced Here you can configure inclusions and exclusions based on files or hostnames m File inclusions exclusions Host exclusions Inclusions Exclude hosts Exclusions Options IV URL parameters are case sensitive URL parameter used to distinguish between links to the same page Default pages index htm index html default htm default html index php index php3 File Inclusions Enter a top level URL path of which section to include 2001 2005 ClickTracks 63 ClickTracks Server For instance Include web foo In this example the software will only import entries in the logfile that are within web foo so a logfile entry in web other will be skipped The include exclude field uses wildcards lf no wildcard is specified then an exact match is performed Note f you need to modify data in this section it is necessary to reimport all your logfiles in ord
71. er to apply these filters See Reprocess Logs Now See Also File Domain Exclusions 3 1 3 2 2 2 File Domain Exclusions Sometimes it may be necessary to have the ClickTracks server ignore certain requests for documents or directories or requests from certain IPs s Domain Settings CT Domain General Advanced Here you can configure inclusions and exclusions based on files or hostnames m File inclusions exclusions Host exclusions Inclusions Exclude hosts Exclusions Options IV URL parameters are case sensitive URL parameter used to distinguish between links to the same page Default pages index htm index html default htm default html index php indes php3 File Exclusions Cancel Apply The software applies the file inclusions first Enter any files or directories that should be excluded For instance Include web foo Exclude web foo ignore In this example all log entries in web foo are imported except for those in web foo ignore The include exclude field uses wildcards lf no wildcard is specified then an exact match is performed 2001 2005 ClickTracks Processing Engine Administrator 64 Host Exclusions Enter a semi colon delimited list of hosts to filter again within the inclusion filter For example Exclude hosts 102 128 30 4 68 55 2 12 Single IP 208 64 72 218 Wildcard on octet s 208 64 72 Range on o
72. erver settings will need to be changed accordingly Each computer on a network has an assigned IP address To find out the IP address of a computer Click on the Start button Click on Run Type cmd into the Open field and click OK This will open a command line screen At the command line type ipconfig The number you need is the IP Address see image below PoON gt ex C WINDOWS System32 cmd exe lol x Microsoft Windows RP Version 5 1 2600 lt C gt Copyright 1985 2661 Microsoft Corp C Documents and Settings dc gt ipconf ig Windows IP Configuration Ethernet adapter Local Area Connection Connection specific DNS Suffix CLICKTRACKS IP Address 2 660 ee ee a n a 192 168 060 167 subnet Mask a 5 sa a 0 255 255 255 686 Default Gateway I 192 168 0 1 C Documents and Settings dc gt Enter the IP address of the computer in the above example 192 168 0 167 into the IP address field in place of 127 0 0 1 Any computer on your network can now access reports in a web browser by entering that IP address in the location field Any computer can also access reports and datasets by entering that IP address into the Pro Client s Dataset Setup Wizard Serving Files Over the Internet You can also serve reports and datasets to computers anywhere on the Internet by making your server location publicly accessible To do this you need to make adjustments on your network router as follows
73. erver and no files are showing up What s wrong A There could be many of reasons for this Check that your File Include specs are correct Are you using any odd extensions other than the standard log gz etc Are you not using an extension at all This information can be found in the web server settings dialog Does your windows user login have administrator privileges to write to your machine s disk Without this NLFs cannot be created and an error will be logged in the session record Do you have permission to access the logfile source directory place you are pulling files from Does the ClickTracks Admin service have logon permissions Check to see if this is the case in Control Panel Admin Tools Services Right click on the ClickTracks Server in the list and go to properties You will see a Log On tab that contains these permissions Did you check your Session Records for any error messages that may help In the Server Ul go to the Options menu and select View Session Record The session record is a kind of log created and maintained by the server admin software All the major tasks that the software performs are logged in this file along with errors Most of the output statements in here are for IT use but some errors can be obvious indicators that something is wrong This could point you in the right direction One such error is Import error Are your logfiles in the correct format that ClickTracks requires W3C Extended
74. erver directory Win2003Q4 QA Domain IIS Server Logs 4 19 2004 12 47 17 PM Reading file ex040419 log at offset 4582954 Win2003Q4 QA Domain IIS Server Logs 4 19 2004 12 47 17 PM Appended Size 734104 Win2003Q4 QA Domain IIS Server Logs 4 19 2004 12 47 17 PM New Size 5317058 Win2003Q4 QA Domain IIS Server Logs 4 19 2004 12 47 17 PM Finished reading 734104 bytes of file C Program Files Cl Win2003Q4 QA Domain IIS Server Logs 4 19 2004 12 47 17 PM Valid request lines 3720 Win2003Q4 QA Domain IIS Server Logs 4 19 2004 12 47 17 PM Invalid request lines 0 Win2003Q4 QA Domain IIS Server Logs 4 19 2004 1 46 59 PM Reading FTP server directory Win2003Q4 QA Domain IIS Server Logs 4 19 2004 1 47 20 PM Reading file ex040419 log at offset 5317058 Win2003Q4 QA Domain IIS Server Logs 4 19 2004 1 47 20 PM Appended Size 923400 Win2003Q4 QA Domain IIS Server Logs 4 19 2004 1 47 20 PM New Size 6240458 Win2003Q4 QA Domain IIS Server Logs 4 19 2004 1 47 20 PM Finished reading 923400 bytes of file C Program Files Cli Win2003Q4 QA Domain IIS Server Logs 4 19 2004 1 47 21 PM Valid request lines 4660 Win2003Q4 QA Domain IIS Server Logs 4 19 2004 1 47 21 PM Invalid request lines 0 Win2003Q4 QA Domain IIS Server Logs To Close the filtered history tab 1 Right Click on the History dataset name tab 2 Select Close The History tab will be closed 3 2 4 Errors When an error occurs on a specific dataset a caution icon wi
75. es when the UI and the service need to access this information at the same time Anytime the scheduler is updated it is stored in the ClickTracksScheduler xml and then 2001 2005 ClickTracks 117 ClickTracks Server copied to the BIN file Sometimes there is a problem and the scheduler doesn t read the newly updated schedule If this occurs go to your Program Files Clicktracks ClickTracks Server Archive directory where you will find BIN files Delete these files so the system will be forced to read the ClickTracksScheduler xml and then recreate the BIN file Q looked in the normal folder and noticed some NL_ files Is this right Can delete these files A Do not delete these files They are created during the stage when the CTC files are created for cookie tracking When cookie tracking is turned on the order of events occurs as follows 1 All the logfiles are converted into NLF 2 Once all the files are normalized the server temporarily renames the NLF containing cookies into NL_ files 3 The corresponding CTC cookie tracking files are created 4 Once the CTC files are done the server renames the NL_ files back to NLF If you delete the NL_ files or stop the service in the middle of this process the server is left in limbo and the whole process will need to start again This can potentially be a problem if you have a lot of logfiles with a lot of cookie data Q have set up the s
76. ete oO PON 2001 2005 ClickTracks 39 ClickTracks Server 3 1 1 9 3 1 1 10 3 1 1 11 6 A confirmation dialog will be displayed If you want to permanently delete the web server click Yes Otherwise click No and your web server will remain in the server processing list Enable Disable Dataset A dataset can be disabled if there is a need to temporarily stop processing the logfiles associated with this dataset To Disable a Dataset 1 Select a dataset by clicking the mouse on the dataset name in the Server UI window 2 Right click on the dataset name 3 Select Menu Disable The dataset will now have a red icon x in front of it and this dataset will be skipped when the server poll schedule is executed To Enable a Disabled Dataset 1 Select a disabled dataset by clicking the mouse on the dataset name in the Server UI window 2 Right click on the dataset name 3 Select Menu Enable The dataset will now be enabled and will be processed during the next server poll schedule Web Server Log Formats The ClickTracks Server can read logfiles generated from the following web servers e Microsoft IIS 3 0 through 6 0 W3C extended format e Apache e Netscape iPlanet the convlog command line utility supplied by Microsoft can be used to convert the older proprietary IIS 3 and 4 log format to W3 extended which can then be imported into ClickTracks The ClickTracks Server will automatica
77. ets in the Available Datasets column right column and then click the top arrow lt to add those datasets to the user Click Update to add the group Editing an Existing Group To edit a group simply click on that group in the Group List and then edit the information as desired To make a dataset that is currently available to a group unavailable click on the dataset in the User s Datasets AU should this be Group Datasets column and click on the right arrow gt The dataset will be moved to the Available Datasets column and the group will no longer have access to it Removing a Group To remove a group click on that group in the Group List and then click Remove at the bottom of the page Note User settings will override group settings when determining what reports the user will receive If a user has rights to all datasets but a group only has rights to a few that user will be able to receive all datasets Administration Admin Home Group Administration User Accounts User Groups Group List Current Group Marketing New Group Site Archiver Server Configuration Group Name Marketing This group has access to the following reports Mail Server Configuration M Search M Site Overview M Robot Scheduled Task Confiquration i V Campaign ROI D What s New FT Funnel Group Datasets Available Datasets bobsfruitsite a a Update Remove 2001 2005 ClickTracks Reporting Engine 90 4 2 4
78. expires null expires expires toGMTString path null path path domain null domain domain secure true secure Function to delete a cookie Sets expiration date to current date time 2001 2005 ClickTracks Advanced Topics 104 6 2 name String object containing the cookie name function DeleteCooki name var exp new Date xp setTime exp getTime 1 This cookie is history var cval GetCookie name document cookie name cval expires exp toGMTString Once you have this setup you can use this JavaScript cookie library by executing the following code SetCookie CLICKTRACKSID MYVALUE expDate How Does ClickTracks Start Tracking Cookies In the ClickTracks ServerAdmin find the dataset you want to work with Click or double click on the Dataset Properties icon Select on the Cookie Tracking tab Check the Enable cookie tracking checkbox In the text field for entering persistent cookie names enter the name of the persistent cookie you are setting on your website as follows CLICKTRACKSID Then click OK and close the dialog box Once you have cookie tracking set up you will need to reimport your logfiles if you have already imported your logfiles This is because cookies in your logfiles must be processed as they ar
79. firewall setting in advanced options Some firewalls actually work correctly if the setting is inverted from what you would expect Can t connect to server The server name is probably your website domain name or a generic name like ftp hostingco net or sometimes an IP address If you upload pages to your web server using FTP then try that server name and login here Ask you hosting company for FTP access to your raw logfiles 2001 2005 ClickTracks 41 ClickTracks Server 3 1 1 15 Incorrect username password These are almost certainly the same as your user name and password for uploading pages or administering the site Can t find logfiles Try clicking c Up Dir and or looking inside other directories See Which Files to Download Wrong format The most common cause of this error is that the file is not actually a logfile Sometimes the server has directories of files named stats or similar but these are not actually logfiles that ClickTracks can read Instead They are typically HTML output files from an old stats program running on your server Missing fields ClickTracks requires a certain minimum number of fields present in the logfile See Configuring Web Servers No logfiles Some hosting companies simply don t provide logfiles In this case you can signup for ClickTracks Hosted You ll get the same great reports and analysis and the data is gathered through a JavaScript object placed in each page of your site
80. ged by marketing personnel whereas the Processing Engine Administrator is typically accessed primarily by IT personnel Serving Data to Clients Among other things the Reporting Engine is a web server As such it is capable of serving reports in the form of HTML documents to web browsers as well as complete datasets to ClickTracks Client applications via HTTP Thus via the Reporting Engine users can view reports through various methods that suit their needs They can view pre analyzed reports anytime anywhere through a standard web browser They can receive HTML documents via email They can view pre analyzed Instant Reports through the ClickTracks Client They can do custom analysis of the complete dataset on the ClickTracks Client PoON gt Site Archiving The other primary function of the Reporting Engine is to archive websites This function will archive the pages of a given website that is part of an existing dataset Once a site has been archived this version of the site can be accessed in the Navigation Report of the ClickTracks Pro Client When looking at past data a user can see how this data applied to the site as the site actually appeared at a corresponding point in the past Archives can be done routinely or whenever significant changes are made on the website Reporting Engine Service The Reporting Engine has its own service that runs in the background This service is the web server that actually serves the HTML rep
81. gs must be reprocessed for the changes to take place In ServerAdmin select the dataset name right click and select Reprocess All Logs for This Dataset e f your site has HTTPS and those pages are the same as under HTTP you must specify https domain com as a domain alias of HTTP equivalent e f your site has HTTPS and the pages are in a different domain you must create a separate domain for them 3 1 3 2 2 Domain Advanced The Domain properties Advanced tab dialog is displayed below s Domain Settings CT Domain Of x General Advanced Here you can configure inclusions and exclusions based on files or hostnames File inclusions exclusions Host exclusions Inclusions Exclude hosts Exclusions Options IV URL parameters are case sensitive URL parameter used to distinguish between links to the same page Default pages index htm index html default htm default html index php indes php3 Cancel Apply File Inclusions Exclusions 2001 2005 ClickTracks Processing Engine Administrator 62 Inclusions Exclusions Host Exclusions Exclude hosts Options URL parameters are case sensitive Set this checkbox for the ClickTracks Server to differentiate between the case of URL parameters URL parameter used to distinguish between links to the same page If your site is set up to distinguish duplicated hyperlinks enter the paramet
82. h which Datasets are created and edited It is the access point for the Configuration Client It provides a button to start and stop the ClickTracks service It provides controls to start and stop the Reporting Engine service It provides a control to launch the Reporting Engine Administrator It displays logging information about the activity of the ClickTracks service including errors as well as a control to access more in depth diagnostic data It is provides help files via The Way panel and serves as an entry point to the entire help system Oo O1 O D gt N Reporting Engine ew Dataset Wizard New Domain Wizard New Web Server Wizard Dataset Names Domain Names Web server names Start Stop server Server status panel ioj xi s ClickTracks Server Administrator Testing Build 912 f o ene SERVERS Add web server click here to add a new Dataset bobsfruitsite El eee fd More info H Click here to add a new Domain Click here to add a new Web server Click here to create a multi domain logfile More info History Errors Message Dataset domain Web server 10 7 2005 3 10 40 PM Initializing 10 7 2005 3 10 40 PM Initialization Complete a a SSS Configuration Client Edit Properties Error Messages Server status message updated in real time The ClickTracks Way panel Datasets A central concept within ClickTracks is the dataset A dataset is analogous
83. he Service Manager FTP only Domain name for FTP login The domain name that ClickTracks will use to read the logfiles In many cases this will be the same as the web server domain name Passive mode Some firewall configurations need this setting User name The user name for FTP login This account must have read access to the logfiles Password Corresponding password for login Test FTP connection Click this to test the above parameters and make sure they are correct Logfile Directory Location on the server where logfiles are located File Exclude mask In the logfile directory it is possible to have many different files in addition to the web server logfiles For example a Cobalt RaQ server has logfiles from the mail server and the FTP server as well as from the web server To prevent the ClickTracks Server from reading these files by mistake specify a list of 2001 2005 ClickTracks Processing Engine Administrator 36 partial file names that will be excluded from download and processing For example setting this entry to mail ftp means that files containing either mail or ftp in the name are never downloaded File Include mask Only files matching part of the name listed here are downloaded Logfile index of Server IP Logfile Processing How it works 3 1 1 4 1 Logfile Processing How it works The ClickTracks Server periodically connects to the web server and determines whether new logfile data
84. he dataset folder is where the ClickTracks Professional client will access data In a typical case the dataset folder is located on a shared network drive making easy access for ClickTracks Professional clients running on other computers Other data access methods are direct HTTP or HTTPS from the same machine or data can be mirrored to another server typically a remote web server again for clients to access See Mirroring AU Which section is this referring to There is no one section specifically titled Mirroring OK Analyze on Server v5 1 The concept of Analyze on Server was introduced with the ClickTracks Server v5 1 It was designed to take the burden of the log data Analyze phase off the client and put it onto the server This option can only be enabled or disabled at the server You can select Analyze on Server when creating a new dataset in the New Dataset Wizard or later when setting the properties of an existing dataset After the ClickTracks service has completed processing the logfiles and created NLF files a second phase of analysis and visitor counting auto analyze will take place This phase which is started by the server processes the dataset s existing and new NLF files and generates BIN files refined data files per day of data The Pro Client can then use these files directly for further analysis and reporting See Analyze on Server Processing The server administrator can then configure this dataset by
85. he server s operating system Windows and MacOS pre OSX are not case sensitive UNIX including MacOSX and Linux is case sensitive The one exception to this rule concerns Apache which can be configured with non case sensitive page names even on a UNIX system This situation is rare however Unsure Choose Not Case Sensitive Not case sensitive is a safe choice because a site is very unlikely to contain both Index html and index html in the same directory The effect of this setting is to convert all page file names to lowercase when Not case sensitive is chosen and to leave them as is for when Case sensitive is chosen A Windows web server sees requests for Index html and index html as the same page and yet they are recorded in the logfile as distinct pages In this situation ClickTracks needs to convert entries in the logfile into a single form which it does by making everything lowercase Case is preserved for UNIX servers because the page requested and the page logged are always the same and Index html might be a different page than index html 3 1 3 2 1 2 Alternate Domain Names The list of alternate domain names is fundamentally important to the way ClickTracks determines the visitor session In general the correct behavior is for ClickTracks to start a new session and therefore count a new visitor whenever the referrer is coming from an external website Using the example of visitors coming from Google it s certainly correct that e
86. her often does so from several different hyperlinks The most common example is a home page with a navigation bar at the top and text only links at the bottom Because both hyperlinks point to the same URL the request is identical regardless of whether the user clicks the top link or the bottom See Topic Distinguishing Duplicated Links Note f you need to modify data in this section it is necessary to reimport all your logfiles in order to apply these filters See Reprocess Logs Now Web Server Properties The web server properties represent the lowest level of configuration of the ClickTracks Server The web server configuration tells the ClickTracks Server how to retrieve data and which logfiles to process One or more web server configuration can be defined under a domain Each web server definition will use one of the following properties to retrieve the web server logfiles ETP logfile Retrieval File System logfile Retrieval Advanced Web Server Properties See Also Processing Logfiles 3 1 3 3 1 FTP Logfile Retrieval The Web Server FTP Property dialog is shown below 2001 2005 ClickTracks Processing Engine Administrator 66 Web server Properties projectorpros A 3 General Logfile retrieval method FTP File System FTP Login FTP Server ftp sitename com Username webmaster Password oo000000 NM Passive Mode Secure SFTP Mode Test Connection m Logfile Settings Logfil
87. his verifies that the system is up and running you can now access the files from the client software If no files are listed on the NLF File tab then there is no data for the client software to synchronize with Directory and File Layout When you create a dataset for a website the server software creates a set of folders The root folder which is in the directory you specified when running the New Dataset Wizard has the name of the dataset For instance for a dataset named ClickTracks if you chose a destination directory named C SiteData you would find a resulting directory called C SiteData ClickTracks Inside the root folder you will find a configuration file named ClickTracks_Config XML and a folder named normal This is the root folder the client software will access to synchronize with The normal folder contains the set of folders for each domain There might be one or multiple domain folders corresponding to your configuration The domain folder includes a list of web server folders named by the web server name in the Server Ul with the informal server name you entered when you created the server dataset Held within the web server folder are any normalized NLF logfiles processed by the server Server Directory Layout 2001 2005 ClickTracks Services and Processes 24 2 1 2 5 Q SiteData E ClickTracks 4 Configuration Files Here E 2 normal E G wwwelicktrackscom Formal Server N
88. hoose how often you want to update the log data For low to moderate traffic websites the interval should be longer than those sites that have a high volume of traffic Keep in mind that when the service is actively running a retrieval session your CPU load will increase so schedule according to your own preferences You can set the start date manually to delay when the software does its first retrieval Normally you can leave the default start date current day Start time sets the time the software will begin the first session Set the polling frequency of the ClickTracks server to one of these values 15 Minutes 30 Minutes Hourly 12 Hours Daily Weekly Monthly Set the polling frequency cautiously to avoid excessive network traffic NOTE All Hosted Dataset are Think Globally analyze on server by default and cannot be changed Also Cookie Tracking and URL Pruning are NOT available for Hosted Datasets After the New Hosted Dataset Wizard finishes a domain and web server entry will be created automatically for you The resulting server configuration is read only You will not be able to alter these settings Dataset Mirroring If the hosted account was set to Analyzed within the Agency Program account setup this dataset will automatically be configured to mirror data to the hosted service where it can be downloaded by the OEM Viewer 2001 2005 ClickTracks Processing Engine Administrator 48 X Dataset P
89. ia email 4 The Reporting Engine is a service running in the background that distributes reports and datasets as well as archives websites for analysis of past versions The Reporting Engine is managed through a web based interface called the Reporting Engine Administrator which is also launched from within the Processing Engine Administrator 5 The Reporting Engine serves data to the end users in various ways End users on the ClickTracks Client application can receive either finished Instant Reports or full datasets upon which to perform custom analysis Users can also view HTML reports in a web browser s Mail Server Configuration or receive those reports via email 2001 2005 ClickTracks ClickTracks Server 1 4 Architecture of Version 5 x The ClickTracks Server component is a Windows service that runs on a machine dedicated to retrieving downloading logfiles from one or more web servers The usual method for this retrieval is FTP however the software also supports reading physical files from the file system over the network or locally on the same machine The software uses a schedule to determine when to make a connection and begin the process of downloading and processing the remote logfiles After each file is downloaded and processed the result is a normalized NLF logfile which is then written to the dataset folder The dataset folders can be located either on the same machine or elsewhere on your network T
90. ile 5 Input the required data as prompted by the Multi domain Wizard This will create a single Web Server entry Example LogFiles Datasets Domains Web Servers MultiDomain Dataset www site1 com www site2 com Multi domain LogFiles As the server processes logfile lines it will place the virtual servers into the appropriate domain on the fly 3 1 2 Wizards The ClickTracks Server user interface assists the user in creating all the necessary configuration files via step by step wizards which ask for specified information at each step There are five wizards available from the server UI New Dataset Wizard New Domain Wizard New Multi Domain Wizard New Web Server Wizard New JDC Dataset Wizard 2001 2005 ClickTracks 43 ClickTracks Server 3 1 2 1 New Dataset Wizard When you start the ClickTracks Server for the first time the New Dataset Wizard appears to guide you through the process of creating a dataset You are then prompted to create a domain and finally a web server Page 1 Name The Dataset Enter a descriptive name for the dataset Page 2 Specify Data Location Enter the local disk location where the dataset will be saved This data location can be on the same computer that is running the ClickTracks Server software or on a network shared drive Important This is the file system location where ClickTracks Server will save the configuration files and the normalized logfiles that are r
91. ing and Stopping the Server Run The ClickTracks Server Service to process logfiles e Dataset Wizards Create configuration files by the use of step by step wizard panels asking for the specified information at each step e Server Configuration Properties Dataset Properties Domain Properties New Multi Domain Wizard Web Server Properties e Analyze On Server Processing Learn more about Analyze On Server processing v5 1 e Configure Client Analyze On Server Datasets a Learn more about configuring Analyze on Server datasets v5 1 e Analyze on Server Conversion Issues Learn more about converting existing server dataset to Analyze on Server processing v5 1 e New JDC Dataset Wizard Learn more about creating a JDC dataset v5 1 e Server Logging Learn more about the server diagnostic messages e The Way Receive additional tips from The ClickTracks Way e Processing Logfiles Learn more about how The ClickTracks Server processes logfiles e Terminology Learn more about the key terms of The ClickTracks Server e FAQ Find the answers to Frequently Asked Questions 2001 2005 ClickTracks 19 ClickTracks Server 1 7 1 7 1 1 7 2 Comparison to Analyzer and Optimizer ClickTracks Professional contains a number of enhancements over Analyzer and Optimizer such as additional reports In addition Pro works in a significantly different way with regard to logfile processing and cookie handli
92. is available Many web servers generate a new logfile each day perhaps using a unique name each time or rotating the names through a fixed set ClickTracks Server maintains a detailed database of state information for each file This enables it to track cases when the file is new modified since last processing interval and so on By maintaining this information ClickTracks Server always downloads the minimum possible information from the logfile Even in the case of a single large logfile that grows each day ClickTracks will download only the new portion of the file The benefits of this system are as follows e Minimal processing time and consumption of network bandwidth e Logfiles are not stored on the ClickTracks server After processing the local copy of the file is deleted e Transparently handles all logfile generation and rotation schemes used on the server Important the server goes to great lengths to process only new data It scans the logfiles to determine whether new data has been appended to an existing file or if a file is completely new 3 1 1 4 2 What Do Enter For Username amp Password 3 1 1 5 Look for logfiles on your web server Different ISPs have different ways of granting access to the logfiles Although there s no standard the most common is FTP using the same server name login password that are used for uploading web pages Ask your ISP How do get access to my raw logfiles Server refers to the domain n
93. is service for the hardware profiles listed below Hardware Profile Service Profile 1 Enabled Enable Disable Cancel Apply B A Specific Local Account Change the selection to This account Enter a local machine username and password combination that ensures correct permissions to access the remote drive s Click the Apply button and RESTART the service Use this type of account when e Accessing logfiles via the FTP protocol on remote computers e Accessing logfiles on the local computer when the Web server and the ClickTracks Server are on the same machine 2001 2005 ClickTracks Services and Processes 26 ClickTracks Server Properties Local Computer HE zi xi Recovery Dependencies T Allow ice to interact with desktop oar Enabled an _ ce __ C Domain Account Change the selection to This account Enter a domain username and password combination that ensures correct permissions to access the remote drive s Click the Apply button and RESTART the service Use this type of account when e Accessing logfiles via the FTP protocol on remote computers e Accessing logfiles on a network shared drive Domain Account Requires Permissions e Read e List Folder Contents 2001 2005 ClickTracks 27 ClickTracks Server 2 2 2 3 ClickTracks Server Properties Local Computer D 7 x General Log On Recovery
94. ize with Server operation Configuring Revenue Revenue data can be configured by selecting either a logfile parameter or a goal page and fixed monetary amount Select Menu Tools Configure Revenue Options or click the Revenue Tracking link on the Campaign Report Campaign Report The Revenue data will be synchronized to the client dataset upon the next Synchronize with Server operation Configure Frames Web Sites If the website you have configured for Analyze on Server contains frames one additional configuration step must be taken On the Frames dataset open the Navigation Report during the Configure Client session The Configuration Client session must navigate through each frameset page and establish which page is the primary one for the frameset This configuration will exclude the navigation header and footer pages This page exclusion information will be synched to the client machines otherwise each client will have to perform this configuration step This Frame Page Exclusion data will be synchronized to the client dataset during the next Synchronize with Server operation Configure Dynamic Page Parameters Select Menu Tools Dynamic Page Parameters to mask any URL parameters so that the base URL is normalized to a common value The Page Parameter Masking will be synchronized to the client dataset during the next Synchronize with Server operation You are now ready to proceed to the client and synchronize data Analy
95. kTracks Server amp ClickTracks Server Administrator WEB SERVERS dd web server The ClickTracks server has encounted an FTP connect error on the server specified in the Web server properties of this dataset Verify the Web server properties to ensure the correct FTP settings of servername username and password are being used for this connection Verify that the network connection is valid close Historr errors To Close the specific Errors dataset name tab 1 Click the tab Errors dataset name to select it 2 Right Click on the Errors dataset name 3 Select Menu Close The Errors dataset name tab will be closed 2001 2005 ClickTracks Processing Engine Administrator 82 3 2 5 ClickTracks Server Administrator a Miei x File Options Help WEB SERYERS Add web server The ClickTracks server has encounted an FTP connec error on the server specified in the Web server properties of this dataset Verify the Web server properties to ensure the correct FTP settings of servername username and password are being used for this connection Verify that the network connection is valid dose History Errors Errors Test DataSet Message 4 19 2004 3 15 45 PM FTP Connect Error on Server win2003qa1 Test DataSet test domain Test IIS 4 19 2004 3 30 43 PM FTP Connect Error on Server win2003qa1 Test DataSet test domain
96. l not take advantage of the available speed enhancements Important It is recommended that a new client dataset be created on any dataset that is converted to Think Globally Analyze on Server processing Use the New Dataset Wizard to create a new client dataset in the Pro Client software on the desktop machines Reading Logfiles For each web server ClickTracks must read and process the logfiles This dialog defines the parameters for each web server 2001 2005 ClickTracks 35 ClickTracks Server Web server Properties win20031IS Of xj General m Logfile retrieval method FTP C File System FTP Login FTP Server ftp sitename com Usemame webmaster Password ossoosse IV Passive Mode Test Connection M Logfile Settings Logfiediectoy fogs File exclude mask J old File include mask www sitename com access E Cancel Apply Name of this server A unique name that will identify this server in the UI The name is actually a nickname It does not need to correspond to the actual server domain name Log Retrieval Method Specify either FTP or file system including LAN retrieval of the logfiles When using LAN access to the files you should understand that the service runs under a certain user account and the LAN access will be performed using this same account with the same permissions You can change the account under which the service runs using t
97. le pattern mask to limit the logfiles selected for processing Separate each file mask with a semicolon File Include Mask Use this file pattern mask to select only the files to be processed Separate each file mask with a semicolon Typical file masks are log zip gz Advanced Settings Under the Advanced Settings tab additional settings allow you to control the FTP download and provide more information about the nature of your logfiles FTP Options Delay time between connections seconds Logfile Options Assume Microsoft IIS style logfile rotation Customize apache loafile format MN Auto Detect Delay time between connections This is set to no delay by default It is only necessary if the program is having difficulty connecting Assume Microsoft IIS If ClickTracks knows that the logfile is rotated in the typical fashion of IIS then it can inspect which files to download much more quickly Customize Apache logfile format Because Apache logfiles do not include a header it is possible that the logfile might not be clear as to which field is which This dialog allows you to manually specify which fields contain which data in the logfile 2001 2005 ClickTracks Processing Engine Administrator 68 Customize apache logfile format Specify fields as read from left to right or select a common format from the list Common Log Format CLF m Logfile Fields Field 1 Client Host gt Field 2
98. le rotation logfile format is automatically detected by the server process If your server processing results are not generating NLF files and you are using a version of the Microsoft IIS web server set this checkbox to checked option to force the server into IIS logfile mode Customize apache logfile format It may be necessary to specify exactly which logfile fields contain which data for Apache logfiles This is because Apache does not include header data ClickTracks determines which fields are which by parsing the first 100 requests in a logfile and assigning the type based on the format of the data found Sometimes that data does not correspond to expected formats This could be caused by a preponderance of spiders crawling the site or a multi domain logfile that contains a very large number of domains Whatever the reason the solutions is to click the Customize apache logfile format button and specify specifally which type of data is in which field 2001 2005 ClickTracks 71 ClickTracks Server Customize apache logfile format Specify fields as read from left to right or select a common format from the list Common Log Format CLF Logfile Fields Field 1 Cient Hot v Field4 Date Time Field7 Bytes Set Field 10 Unknown lgnored Field 2 Unknown Ignored sA Field5 Request gt Field 8 Unknown Ignored Field 11 Unknown lgnored 7 Field 3 Unknown Ignored
99. led In the Processing Engine Administrator go to Reporting Engine Show A web browser will be launched If a web page is displayed then the Reporting Engine server is the localhost IP address 127 0 0 1 If the page cannot be displayed chances are that another server is running on that box and is the localhost Keep looking until you find the other server and then turn it off Once the Reporting Engine is running as the localhost you will see a login page in the web browser when you click on Reporting Engine Show as described above Log in to this form with the user name admin and the password none These are the default settings You should change the admin login information immediately upon entering the admin site 2001 2005 ClickTracks 87 ClickTracks Server 4 2 2 mu VHS ew Fs ClickTracks Reporting Engine Dataset Please Choose a Dataset w Available Data View Reports No Loaded Dataset Search Report Campaigns Sales and ROI Site Overview What s Changed Report Robot Report Funnel Report Click on the Administrator icon to access the main administration console Click the User Accounts section in the left menu and select admin In the form on the right change the user name and password to something easy to remember but difficult for others to guess Click Update You are now ready to begin managing your Reporting Engine
100. like from or similar 2 Decide on a consistent set of values for example from topnav and from bottomnay or linkid 1 and linkid 2 The value needs to be unique within a page for a given link but it does not have to be unique for every single link and page For example although the links news php from topnav and product php from topnav have the same distinguishing parameter this is OK because they re referencing different pages 3 The parameter must appear as the last one on each link e g news php catalogid 5 amp from topnav 4 Once the site is modified to include the parameter on each page you ll need to set the date range in ClickTracks to include only the dates after this 5 Be aware of possible side effects in search engine optimization Adding this parameter to each link could affect the ability of search engine spiders to crawl and index your site This depends on the particular search engine and the technology it currently employs Consult a specialist search engine consultant and have them evaluate this for you Once the parameter is setup on your site you simply need to configure the ClickTracks server to use it Select the Domain Properties Advanced Options and enter the parameter name from the text box 6 8 The Way Content Help The ClickTracks Way is a dynamic context sensitive help system that will display useful information in a panel on the right side of the screen The Way Content will also be displayed during
101. ll be display in front of the dataset name Example Error condition on a dataset 2001 2005 ClickTracks 79 ClickTracks Server amp ClickTracks Server Administrator File Options Help WEB SERVERS Add web server The ClickTracks server has encounted an FTP Test us E connec error on the server specified in the Web server properties of this dataset Verify the Web server properties to ensure the correct FTP settings of servername username and password are being used for this connection Verify that the network connection is valid close History Errors NLF Files 4 19 2004 2 45 44 PM FTP Connect Error on Server win2003qa1 Test DataSet test domain Test IIS To see ALL error messages for ALL of the datasets 1 Click on the Errors tab Review the error messages given by the server and take corrective actions to fix the problem To see ALL error messages for a specific dataset Select a dataset with the mouse Right Click on the dataset name Menu Show Errors right click to close Click on the tab Errors dataset name cores 2001 2005 ClickTracks Processing Engine Administrator 80 amp ClickTracks Server Administrator 2 51 xi File Options Help WEB SERVERS Add web server The ClickTracks server has encounted an FTP connect error on the server specified in the Web server properties of this dataset Verify the Web server pro
102. ller Started Promers aco paed reporting for users Sy Automatic Updates Enables the download andinst Started y Background Intelligent Transfer Service Uses idle network bandwidth t k lt ClickKTracks Reporting Engine Provides web based reporting 88s ClickTracks Server Performs unattended web ser Started Sy ClipBook Enables ClipBook Viewer to sto By COM Event System Supports System Event Notific Started By COM System Application Manages the configuration an Sy Computer Browser Maintains an updated list of co Started z o aa ai EE f RTE S lt gt Extended 4 Standard The Reporting Engine service can also be controlled through the Processing Engine Administrator In the main menu simply select Reporting Engine Start to start the service and Reporting Engine Stop to stop it Until the service has started the administration interface will not be accessible because it is the service itself that serves that web based interface The Reporting Engine must be the only web server running on the computer If other web servers are installed on the server they will compete for the ability to serve pages 2001 2005 ClickTracks Processing Engine Administrator Processing Engine Administrator 30 3 3 1 Processing Engine Administrator The Processing Engine Administrator provides the interface for several important components of the Pro Processor It is the interface throug
103. lly configure itself according to the logfile format There is no need to specify this format or the fields If you d like to know which fields ClickTracks requires or if you are considering adjusting the server configuration please see Configuring Web Servers Compressed Rotated Log Files As the web server writes transactions to the logfile it will grow potentially becoming unmanageably large over time Many web servers are configured to periodically rotate the logfile to keep the size manageable while avoiding the loss of any data The server typically does this once per month for smaller sites and weekly or daily for higher traffic websites A typical web server writes to a logfile named access log or similar When the logfile is rotated it is given a name that reflects the period of time it soans such as access_april log After renaming the file the server creates a new file under the access logfile name and starts writing the latest data to it in this example data for May Thus the older data is rotated into archive files The directory containing the logfiles on the server might have several older files with names indicating the periods they span as well as a file containing data for the current period which is updated with each client request as it s received In addition the web server often compresses the older data as it is rotated into archive On UNIX systems the format most often used is gz GNU Zip Compressing the dat
104. mail These services can be seen in the Windows Services under Administrative Tools 2 1 The ClickTracks Service The ClickTracks Service is installed into the services manager and perform the low level tasks of gathering and processing logfiles Analyze On Server Datasets ClickTracks ee FIP 7 Server Process Pre processed 7 Analyze On Server N File Share and compressed _ 4 Processing data NLF files BIN files ClickTracks a e HTTP FTP File Share HTTP FTP File Share ClickTracks ClickTracks client Client Glick Tracks Server Regular Dataset AOS Dataset Learn more about the ClickTracks Server e Server User Account Configure the ClickTracks Server service user account e Starting and Stopping the Server Run The ClickTracks Server Service to process logfiles e Dataset Wizards Create configuration files by the use of step by step wizard panels asking for the specified information at each step e Server Configuration Properties Dataset Properties Domain Properties New Multi Domain Wizard Web Server Properties e Processing Logfiles Learn more about how The ClickTracks Server processes logfiles e Analyze On Server Processing Learn more about Analyze On Server processing v5 1 e Configure Client Analyze On Server Datasets Learn more about configuring Analyze on Server datasets v5 1 2001 2005 ClickTracks 23 ClickTracks Server 2 1 1
105. meter has been added 4 An optional secure parameter has been added For information on the significance of these parameters and and on cookies in general please refer to the official cookie spec at http www netscape com newsref std cookie_spec html Internal function to return the decoded value of a cookie function getCookieVal offset var endstr document cookie indexOf offset if endstr 1 endstr document cookie length return unescape document cookie substring offset endstr Function to return the value of the cookie specified by name name String object containing the cookie name returns String object containing the cookie value or null if the cookie does not exist function GetCookie name var arg name var alen arg length var clen document cookie length var i 0 while i lt clen var j i alen 2001 2005 ClickTracks 103 ClickTracks Server if document cookie substring i j arg return getCookieVal j i document cookie indexOf i 1 if i 0 break return null Function to create or update a cookie name String object object containing the cookie name value String object containing the cookie value May contain any valid string characters expires Date object containing the expi
106. ministrator 52 3 1 3 1 Carefully choose the nclude and Exclude file masks to narrow down the logfile lists to be processed by the server Pay attention to logfile rotation schemes used by the web server For example www sitename com access Today s logfile text format www sitename com access 1 gz Today 1 day logfile gz binary format www sitename com access 2 gz Today 2 days logfile gz binary format A proper include file mask for this file rotation would be www sitename com access This file mask would allow the current logfile and all rotated logfiles to be accessed and processed by the server For example setting the file Exclusion entry to mail old ftp will mean files containing the pattern of mail old or ftp in the name are never downloaded See Also Compressed Rotated logfiles Properties All ClickTracks server configuration information is saved in the file ClickTracksScheduler xml that resides in the ClickTracks Server directory The configuration properties are divided into the following categories Dataset Properties Domain Properties Web Server Properties Dataset Properties Datasets represent the top level configuration layer of the ClickTracks Server A dataset will be configured to define the server s base properties including a descriptive dataset name the local location of the stored data the server polling frequency and the scheduled start time A dataset can contain one
107. mp Dataset Properties ClickTracks iol x General Dataset Mirroring Cookie Tracking URL Pruning Delete parts of pathnames M Use regular expression J Use regular expression J Use regular expression 7 Use regular expression 7 Use regular expression I Use regular expression M Use regular expression Cancel Apply 2001 2005 ClickTracks Processing Engine Administrator 58 Examples Remove a fixed URL portion In a logfile perhaps there was an old portion of the URL from a prior version of the website megasite OLD customer html old version of URL megasite OLD areacode html megasite customer html new version of URL megasite areacode html In the URL Pruning dialog enter OLD Save and re process your logfiles This will normalize your URLs to only contain only the values megasite customer html megasite areacode html URLS can be pruned using a more advanced regular expression regexps syntax Regular expressions are often know as regexps and are familiar to web developers through programming languages such as Perl and PHP Regular expressions are useful if you want to remove a variable string such as a session ID from your URLs Suppose your URLS look like http www example com catalog pineapple html 102 0590433 8620953 where the last part is a session ID that you want to remove Then you could specify the regular ex
108. n this machine will need to be configured to handle the retrieval of the NLF and other ClickTracks specific files The web server will need to have the MIME type added for the file type NLF Consult your web server documentation for details on adding a MIME type 2001 2005 ClickTracks Processing Engine Administrator 56 MIME Type NLF application octet stream TCS application octet stream INI text plain 3 1 3 1 3 Cookie Tracking When tracking Ad Campaigns using persistent cookies or to specify session cookies first select the dataset you want to modify Click on the property icon for the selected dataset and then click the Cookie Tracking tab The Cookie Tracking dialog will appear Dataset Properties ClickTracks loj x General Dataset Mirroring Cookie Tracking URL Pruning M Enable Cookie Tracking J Use only un named cookies Persistent Cookies Enter one or more persistent cookie identifiers ex SESSID SESSIONID M Session Cookies Select subdomain www clicktracks com x Session Cookie O OE Insert one or more persistent cookie identifiers if applicable to your website The cookie identifier should be entered as used on the website Case sensitivity considerations should be used For example SessionlD and SESSIONID will yield different results Use Ctrl Enter to advance the cursor to the next line when entering multiple cookie identifiers On the
109. ng Convenience Features Ability to list multiple pages in a single PDF or Excel export Multiple user access with each user able to create and manipulate their own reporting Hassle free logfile processing Most processing takes place on a server with the powerful iterative analysis taking place on the client Logs are downloaded and processed on a nightly or hourly schedule The ClickTracks Server connects automatically and intelligently decides which logs are new and must be downloaded and processed greatly reducing the hassle of log processing Built for large sites The server side processing of ClickTracks Pro includes support for sites that span multiple domains and sites deployed on load balanced servers See Sites That Span Multiple Domains Under the hood enhancements Persistent cookie database to track unique visitors and campaign conversion metrics across long periods of time See Cookie Handling Cookie Handling ClickTracks Professional Server can be configured to use a specific session cookie to improve the accuracy of following visitors through the site especially if your site has many visitors from AOL Professional Server also uses a powerful database to store data about visitors and to lookup that data when a visitor comes back to the site The database stores the persistent ID the landing page referrer time of last visit time of first visit Using this data ClickTracks can calculate simple data like the number of
110. ng ii inisisinnnnnnnnnnnnnnnnnennnennennnnnnnnnennnnnennnnnnnnnnennnennnennnennnnnnee 19 Site Archiving ssecissisasccnteccsesacssscenedcesvessvesceusaiessnedsiacsnesecsisnisedcesuuiesesaed utedspedaieusnesuduisuedesedsidiudesdeuiaieasnessiiirausedsienenebens 20 Sites That Span Multiple Domains is ininrsrsnnrnnennennennnnnnnnnennnnnnnnnennnnsnnnnensnnsnnnennnsnnenennnnnnnne 20 Services and Processes 22 MLS CLICK TRACKS SON MICO esc cee seo ve ve a a sea vaca roca ee seca vaca menage aa nstans aa a aaa scan arte 22 Starting and Stopping the Service ccccescssssseeesessessesseseeseneseeseessneseeseseeeneesessneneesaeseeeneesaeseeesaesesaneneseesenenneseneas 23 Server User ACCOUNT 5 24 ceeecekd ectccedd cake saraaa araea anaoat aa ceevecudcnazenaddesus chicestexidaeesecedeetsonisduedectianttesiiesseessueesteeate 24 Processing Engine Service 8 8 0 cesecteecdeeedes dvsucteeddeeceendsuuctuncderders 27 Reporting Engine Service aaa 27 Processing Engine Administrator 30 Datasets Processing Logfiles Analyze On Serv r Processing sets sszcsstcesscccaccaacevanceusacieceteectysstesctyceieseissnteesanseancsinesteesieseiniciestdeacteatteaieaadeasteeais Configure Client Analyze On Server Datasets sise Analyze on Server Conversion Issues sise Readingi Logies RS A needs an dm dant cantante date de es ras es mean Logfile Processing How it works What Do I Enter For Username amp Passwor
111. nlf G2004 03 01_08 00 08_to_2004 03 02_06 17 52 nlf G2004 03 02_12 02 52_to_2004 03 02_23 16 01 nlf G2004 03 03_08 00 05_to_2004 03 04_02 40 45 nlf G2004 03 04_08 00 03_to_2004 03 05_00 20 27 nlf G2004 03 05_08 00 03_to_2004 03 05_22 55 57 nlf G2004 03 06_08 00 04_to_2004 03 06_22 55 08 nlf G2004 03 07_08 00 03_to_2004 03 07_22 55 17 nlf 4 14 2004 10 02 AM 4 14 2004 10 02 4M 4 14 2004 10 02 4M 4 14 2004 10 02 AM 4 14 2004 10 02 4M 4 14 2004 10 02 4M 4 14 2004 10 02 4M 4 14 2004 10 02 4M 4 14 2004 10 02 4M 4 14 2004 10 02 AM 4 14 2004 10 03 AM 4 14 2004 10 03 4M 4 14 2004 10 03 4M 4 14 2004 10 03 4M 4 14 2004 10 03 4M 4 14 2004 10 03 4M 4 14 2004 10 03 4M 2001 2005 ClickTracks Reporting Engine 85 ClickTracks Server 4 1 4 2 Reporting Engine The Reporting Engine is a core component of the ClickTracks 6 architecture It is integrally linked to the Processing Engine and has access to any datasets that have been set up there The Reporting Engine has two primary functions 1 It manages the distribution of reports and datasets generated by the Processing Engine 2 It controls the archiving of websites for use in the various reports The Reporting Engine has a service that carries out its routine tasks in the background It also has an administrator user interface through which its functions are controlled The Reporting Engine Administrator is a web based interface Once set up it is typically mana
112. nt Dataset Wizard the URL will need to specify the port number e g stats bobsfruitsite com 888 In this example this URL would be used if the port setting had been changed to 888 at both the router and the Reporting Engine The Site Archiver port has been set to 8080 This is the port where the ClickTracks Client will look for archive files from the Reporting Engine Again there will rarely be a need to change this setting from the default If you need to change this port number follow the steps above Mail Server Configuration The Mail Server Configuration form allows you to establish a mail server to handle the sending of reports via email Any mail server can be used for distribution The mail server does not need to be running on the same computer as the Reporting Engine Server Name This is the SMTP address of the mail server e g mail yourdomain com smtp yourdomain com etc Server Port The default port for SMTP servers is 25 Unless you know that the port of this SMTP server is different leave this at 25 AutoMail Email This is the FROM and Return address for the email header indicating who the emails will appear to be from AutoMail User Name This is the user account It must correspond to a valid account on the email server AutoMail Password This is the password for the above email address Email Subject This is the text that will appear in the subject line of all emails sent as scheduled tasks Once you have e
113. nt of time This is quite useful Now the same information that was stored before can be accessed every time the user comes back to the website for multiple visits How do cookies work with ClickTracks Cookies can be very useful in helping you get the most out of your ClickTracks analysis Two applications of cookies are calculating unique visitors and tracking delayed conversions The first application for cookies is calculating unique visitors By default ClickTracks deals in visits when running its analysis This means that the same visitor can come to a website multiple times and will be tracked as a separate visitor each time Often it is important to see how many distinct unique visitors are coming to your website The only way to know if a visitor has come to your site before and therefore if the visitor is unique is to set a cookie for each visitor who comes to your site The second application of cookies is tracking delayed conversions A typical scenario in web marketing is to find out how many visitors who come to your website as a result of pay per click PPC actually convert into a sale If a visitor who clicks on a PPC ad that leads to your site purchases within the same visitor session ClickTracks will log the visitor as a conversion and calculate the numbers with no problem However the reality is that many times a visitor will reach your site as a result of a PPC ad leave your site think about it for a while and then come ba
114. ocation The drive and path location where the ClickTracks Server will save the configuration files and the normalized logfiles Entered at creation time read only Schedule The polling schedule for the ClickTracks Server service In the drop down menu under Schedule Frequency choose how often you want to update the log data For low to moderate traffic websites the interval should be longer than those sites that have a high volume of traffic Keep in mind that when the service is actively running a retrieval session your CPU load will increase so schedule according to your own preferences You can set the start date manually to delay when the software does its first retrieval Normally you can leave the default start date current day Start time sets the time the software will begin the first session Set the polling frequency of the ClickTracks Server to one of these values 2001 2005 ClickTracks Processing Engine Administrator 54 e 15 minutes e 30 minutes e Hourly e 12 hours e Daily e Weekly e Monthly Set the polling frequency cautiously to avoid excessive network traffic Start time The starting time for the ClickTracks Server service Analyze on server The new ClickTracks Server v5 1 takes the burden of the log data Analyze phase off the client and onto the server You can select this option when creating a new dataset in the New Dataset Wizard or later when updating the properties of
115. of engine Search page of engine ClickTracks will visit this URL with the search parameter set to a string if the user clicks this option in the UI All parameters are tab delimited with a carriage return at end of line Sample Data 2001 2005 ClickTracks Advanced Topics 108 google Google q aq as_q query p www google com www google com googlesyndication Google content targeted g p www googlesyndication com www googlesyndication com 6 7 Distinguishing Duplicated Links A page that links to another often does so from several different hyperlinks The most common example is a home page with a navigation bar at the top and another bar at the bottom with text only links Because both hyperlinks point to the same URL the request is identical regardless of whether the user clicks the top link or the bottom Marketers sometimes need to know which link is really being used more since this can heavily influence site design decisions ClickTracks is able to distinguish these links if a parameter is added to them within the HTML Each time the link is used on a given page a parameter with a different value should be added so the links can be distinguished when ClickTracks reads the logfile Because this requires a modification to the site you should plan carefully and thoroughly understand what needs to be done 1 Decide on a single parameter that will be easy to distinguish and that has an easy to recognize name
116. omain Test IIS See Also FTP Logging 2001 2005 ClickTracks 73 ClickTracks Server 3 2 1 Show Session Record History Errors NLF Files FTP Logging Additional FTP logging information can be sent to the History tab by enabling FTP logging To Enable FTP Logging 1 Select Menu Options Enable FTP Logging gt ClickTracks Server Administrator Testing Build 768 lol xi File Options Help view Session Record 1 Click here to add a new Dataset More info QA Domain us Logs FTP Click here to add a new Domain Click here to add a new Web server Click here to create a multi domain logfile More info History Errors NLF Files Message Dataset Domain web server To Disable FTP Logging 1 Select Menu Options Disable FTP Logging 2001 2005 ClickTracks Processing Engine Administrator 74 gt ClickTracks Server Administrator Testing Build 768 Ee E File Options Help view Session Record Clear Session Record Click here to add a new Dataset More info Click here to add a new Domain Click here to add a QA Domain El us Logs FTP new Web server Click here to create a multi domain logfile More info History Errors NLF Files Dataset Domain Web server 3 2 2 Show Session Record Use the Show Session Record menu choice to view all server
117. orts and the complete datasets to the client application The service can be seen and controlled in the Windows Operating System under Administrative Tools Services The Reporting Engine service can also be controlled through the Processing Engine Administrator In the main menu simply select Reporting Engine Start to start the service and Reporting Engine Stop to stop it Until the service has started the administration interface will not be accessible because it is the service itself that serves that web based interface Reporting Engine Administrator 2001 2005 ClickTracks Reporting Engine 86 4 2 1 Log Out Administration Home Admin Home User Accounts User Groups Site Archiver Server Configuration Mail Server Configuration Scheduled Task Configuration Initial Setup The first step in setting up the Reporting Engine is to ensure that the Reporting Engine service is running as shown in the previous section Furthermore the Reporting Engine service must be the only web server running on the computer If any other web servers are running on the server they will compete for ownership of the localhost status and of Port 80 through which files are served to the web To determine whether any other web servers are running go to Control Panel Administrative Tools Services and look for services that appear to be web servers It is easy to tell when you have all other servers disab
118. ounts Available Datasets for Archiving User Groups amp bobsfruitsite Site Archiver Server Configuration Mail Server Configuration Scheduled Task Configuration duitsite conv fruit php id 1 amp topic Description amp id 3 Status 448 of 455 pages archived 0 7 sec page about 0 min 4 sec Scheduled Archiving To Schedule Regular Archives of Your Website 1 Choose Scheduled Task Manager from the Reporting Engine Administrator menu 2 Select Current Tasks New Archive Task 3 Give the archive a meaningful name such as the name of the dataset followed by the date of the archive AU okay to change to date of the archive 4 Select a dataset to be archived 5 Choose a frequency daily weekly or monthly 6 Select the time of day to perform the archive 7 Select the day of the week for weekly archives or the date of the month for monthly archives 8 Click Submit The archive will run on the next scheduled date 2001 2005 ClickTracks 91 ClickTracks Server Administration fie Scheduled Task Configuration User Accounts rc Current Tasks Task Name User Group oe New Email Task New Archive Task Site Archiver Task Type ne Dataset bobstutste We Configuration Mail Server Frequency Day Configuration me EEL Scheduled Task Bee Mondey fl Configuration 4 2 5 Server Configuration In ClickT
119. our clients via the New Dataset Wizard to take advantage of the Browser Based Reporting Start the New Dataset Wizard in the Client Application by going to File gt New Dataset in the main menu You will be presented with a screen to access the dataset from the Reporting Engine If the Reporting Engine is running on the same computer as the client enter the Reporting Engine URL either localhost or http 127 0 0 1 If the Reporting Engine is running on your local area network this address will be its network address e g http 192 168 0 123 If the Reporting Engine is running outside your local area network the host name will be a fully qualified URL e g http demo clicktracks com Enter a user name and password of a user who has been set up on the Reporting Engine and who has ownership of the dataset you are trying to create See Reporting Engine gt User Accounts Click the Select button You will be presented with a list of datasets for which the user you just specified has ownership Select the specific dataset you want to create on the client and click the Next button 2001 2005 ClickTracks Getting Started 14 Clicktracks Reporting Engine New Dataset Wizard Reporting Engine Configuration Hostname http 127 0 0 1 Username aa Select the location of bobsfruitsite the dataset on the ClickTracks Server Password se Selected Dataset Once you ve selected the d
120. pending on the structure and function of your web site 1 or more domains can be defined under a dataset In turn domains can contain multiple web servers The Domain properties are General Properties Case Sensitivity This property tells the server if the files on the web server are case sensitive or not UNIX web servers are case sensitive so the page index html and INDEX HTML are different Windows web servers are not case sensitive and treat all pages without regard to case Server Scripting This property tells the server what server side scripting technology the web server is using 2001 2005 ClickTracks ClickTracks Server Advanced Properties File Inclusions Include only certain directories when processing logfiles File Exclusions Exclude certain directories from the Included directories Host Exclusions Host IP addresses can be excluded from the logfile processing URL parameiers are case sensitive This property will inform the server to treat URL parameters with case sensitivity to differentiate between them URL parameter used to distinguish between links on the same page This property defines a particular parameter that can be used to differentiate between multiple links to the same page so that a user can see the differences in clicks to the links Default pages This is the list of pages to treat as a default loading page when a web browser opens up a directory name Web Servers
121. perties to ensure the correct FTP settings of servername username and password are being used for this connection Verify that the network connection is valid close History Errors Message D taset Domain Web server 4 4 19 2004 3 47 21 PM Invalid request lines 0 Win2003Q4 QA Domain IIS Serve 4 19 2004 4 00 34 PM Reading FTP server directory Test Data test domain Test IIS 4 19 2004 4 00 56 PM Reading file ex040419 log at offset 8004558 Test Data test domain Test IIS 4 19 2004 4 00 56 PM Appended Size 274360 Test Data test domain Test IIS 4 19 2004 4 00 56 PM New Size 8278918 Test Data test domain Test IIS 4 19 2004 4 00 56 PM Finished reading 274360 bytes of file C Program Files Cli Test Data test domain Test IIS 4 19 2004 4 00 56 PM Valid request lines 1390 Test Data test domain Test IIS 4 19 2004 4 00 56 PM Invalid request lines 0 Test Data test domain Test IIS To Clear the error status from on a specific dataset Once you have addressed an error condition reported by the server and would like to clear reset the Server UI 1 Select the dataset in error by clicking the mouse on the dataset name 2 Right Click on the dataset name 3 Select menu choice Clear Error Status To clear the additional error information from the ClickTracks Way panel 1 Click the close link on The Way content panel 2001 2005 ClickTracks 81 Clic
122. pression I0 91 3 0 91 7 0 91 7 to remove the session ID from the end More information on regular expressions and syntax can be found through Google A good primer is at http aspn activestate com ASPN docs Expect_for Windows 1 0 regex html 3 1 3 2 Domain Properties Domains represent the secondary level of configuration of the ClickTracks server A domain will be created under a named dataset and will define the properties of the web site Depending on the structure and function of your website one or more domains can be defined under a dataset In turn domains can contain multiple web servers Further properties of a domain are Domain General Server Case Sensitivity Server Scripting Domain Advanced File Inclusion Exclusions Host exclusions URL parameters Default pages To add additional Web Servers to an existing Domain entry 1 Select the domain entry by clicking the domain name under a specific dataset 2001 2005 ClickTracks 59 ClickTracks Server 2 Right Click on the domain name 3 Select Menu Add web server Continue to respond to the questions throughout the Web Server Wizard until complete 3 1 3 2 1 Domain General Case Sensitivity Server Scripting The Domain properties General tab dialog is displayed below s Domain Settings CT Domain General Advanced Case Sensitivity DNS Lookup Helper E To automatically obtain a list of server U
123. r license number of servers How do get more server licenses A Contact ClickTracks Sales sales clicktracks com to purchase additional server licenses Once you have purchased the licenses activate them via the Server UI Menu Help Activate Upgrades Errors and Logs Q How many days of server logs are kept by the ClickTracks Server A The ClickTracks Server keeps 14 days of server logs in the file ClickTracks Server SessionRecord ServerState bin Q A server error condition happened while the Server UI was not running How can find what the error was A Start the Server UI Select Menu Options Show Session Record to see a full listing of all server events A If you know the specific dataset that caused the error select the dataset Right Click Show Session Record to see a full server log of that specific dataset See Topic Show Session Record User Accounts and Permissions This applies only to version 5 x NOT 6 Q What account permissions are needed for the ClickTracks Professional Client to download a dataset by Local File System FTP HTTP or HTTPS A The account permissions required are File Share READ FTP READ HTTP HTTPS READ Server Operation Q just changed my server scheduler settings but they aren t taking effect What do do A The scheduler information is stored in the ClicktracksScheduler xml file and is also copied into a BIN file This ensures that there aren t any file locking issu
124. racks 6 datasets and fully rendered reports are served to the Pro Client as well as to web browsers by a built in web server over the HTTP protocol The server configuration settings specify the location on the Internet for this web server Administration Beta babs Server Configuration User Accounts Configuration List User Groups Name Setting2 New Configuration Site Archiver Setting2 IP Address 270 01 Server Configuration Port 80 Mail Server Configuration Archiver Port 8080 Scheduled Task 5 Debug Logging Confiquration A K Set as current 2001 2005 ClickTracks Reporting Engine 92 Serving Files to the Local Machine By default the IP address is set to 127 0 0 1 This IP address represents the localhost on the computer and allows the server to serve files to applications running on the same computer as the server Before the server can display anything it must be started To start the Reporting Engine go to the Processing Engine Administrator and click Start under Reporting Engine in the main menu If you are able to view the Reporting Engine Administrator in a web browser the Reporting Engine must be running already If you are not able to view the Reporting Engine Administrator then chances are it has not been started Serving Files to Other Network Computers Assuming that you want to serve files to applications running on other computers on the network the s
125. ration data of the cookie If fof omitted or null expires the cookie at the end of the current session path String object indicating the path for which the cookie is valid If omitted or null uses the path of the calling document domain String object indicating the domain for which the cookie is valid If omitted or null uses the domain of the calling document secure Boolean true false value indicating whether cookie transmission requires a secure channel HTTPS The first two parameters are required The others if supplied must be passed in the order listed above To omit an unused optional field use null as a place holder For example to call SetCookie using name value and path you would code SetCookie myCookieName myCookieValue null Note that trailing omitted parameters do not require a placeholder To set a secure cookie for path myPath that expires after th current session you might code SetCookie myCookieVar cookieValueVar null myPath null true function SetCookie name value var argv SetCookie arguments var argc SetCookie arguments length var expires argc gt 2 argv 2 null var path argc gt 3 argv 3 null var domain argc gt 4 argv 4 null var secure argc gt 5 argv 5 false document cookie name escape value
126. ress by viewing the Server Administrator status window Right click on the dataset you want to configure on the main Server Administrator window select View Configure Dataset Analysis Alternatively you can just click the icon A A warning message will appear alerting you that auto analyze will be blocked for the server until you finish configuration This is to protect the integrity of the files since both auto analyze which is performed by the Windows service process and Configure Client both share the same files Only Think Globally Analyze on Server datasets can be configured from the server If the View Configure Dataset Analysis menu item on the Server Administrator is disabled then the dataset has not been initially analyzed is in the process of being analyzed or is not an Analyze on Server dataset This first auto analysis step is necessary for the software to calculate all web pages referrers and so forth used during configuration Once you have started Configure Client you can create one or more labels import campaigns and configure revenue all on the server If the software asks you to reanalyze you can choose to wait until all configurations have been completed However be sure to perform the analysis before exiting the Configure Client session Remember to close the Configure Client session so that server scheduled auto analyze sessions can take place Creating Global Labels A set of global labels can be defined on th
127. rmat 105 log formats 39 log processing 36 log read 65 log source 65 68 logging 72 login account 24 logs 31 lower case 60 mail server 93 memory 4 method 105 mirror 54 multi domain 49 multi homed 42 multidomain 40 49 multihome 40 multihomed 42 multiple domains 20 multiple sites 20 42 multiple websites 40 N navigation report 90 Netscape 39 network 34 new dataset wizard 43 NLF 82 no reports 111 0 old logfile 36 overview 5 7 2001 2005 ClickTracks 123 ClickTracks Server P parameter 107 password 36 past sites 90 performance 31 persistent 56 104 PHP 59 pro client 19 processing 31 Q query 105 quickstart 16 R RAM 4 raw logfile 36 read logfile 34 referrer 105 regular expression 57 remove 38 reportserver 85 reportin engine setup 86 reporting engine 27 85 reporting engine interface 85 reporting engine ui 85 reports 16 reprocess 38 robots 107 rotated 39 run schedule 38 running 27 S Save 30 scheduled archives 94 scheduled emails 93 94 scheduled tasks 94 schematic 5 7 search engine 107 search term 107 searchengines txt 107 sensitive 60 seo 108 server administrator 30 server configuration 91 server name 40 server scripting 59 service 24 27 85 serving reports 91 sessionrecord 74 setup 43 share 24 34 site archiver 90 94 site history 90 six 5 spiders 107 start 23 start service 23 starting 27 static 59
128. roperties mentornet_hosted ClickTracks will replicate the directory tree for this dataset Choose an existing directory on your FTP server as well as a new subdirectory that will be created by ClickTracks V Enable mirroring for this dataset Server Info Server stats1 clicktracks com Username SIEZA3AxbTYD1A Password eeee V Use passive firewall mode F Use secure SFTP connection m Directories Initial Directory New directory SSS Dataset will be mirrored at analyzed 3 1 2 4 New Domain Wizard The New Domain Wizard guides you through the creation of a domain associated with a dataset Page 1 Name the Domain The domain name is usually the externally published name of the server Examples e ClickTracks e Bobs Fruit Site Page 2 Enter the URL Enter the top level URL of the website to be analyzed Click the Go button to see a preview of the site to confirm that the URL is correct 2001 2005 ClickTracks 49 ClickTracks Server 3 1 2 5 Page 3 Specify Aliases for the Web Site The New Domain Wizard will try to find as many default site aliases as it can and will present them to you in the text area Enter any other names or IP addresses by which this same site is accessible to users Edit this list to ensure all variants of the domain name are set up For example if you entered www bobsfruitsite com into the first page you would enter bobsfruitsite com and the IP addre
129. rror CkckTracks To Enable Dataset Mirroring 1 Check the Enable mirroring for this dataset at the top of the dialog This will enable the fields below 2 Enter the FTP host address username and password The FTP login must have sufficient rights to read write update and create directories on the remote FTP server Consult with your network administrator for further account related information Click on Passive Mode firewall mode if necessary for your site Click on the Browse button This will login to the remote FTP server and an FTP browser window appears and will allow you to browse to the root directory where the data should be stored To verify that the directory is valid you must select and enter the directory by double clicking rather than just selecting it in the browser dialog Click the OK when you are at the final data location aew The selected root path is then automatically inserted into the Initial Directory field which is a read only field Then in the New directory field which can be left blank enter a subdirectory to store the clicktracks data This directory will be created the first time the server uploads the data files The resulting combined path is displayed in the Dataset will be mirrored at information NOTE If you are mirroring your dataset to another computer where the resulting dataset will be accessed from a ClickTracks Pro client via the HTTP protocol the web server o
130. rsions of the same website page side by side with the statistics for each version applied appropriately Sites That Span Multiple Domains Larger sites are often built with multiple subdomains like www bobsfruitsite com secure bobsfruitsite com ClickTracks Professional uses a more sophisticated session tracking algorithm that accounts for visitors moving across the multiple domains Pro maintains a relationship between the page index html and the domain within which it occurs Analyzer cannot distinguish between index html across two domains and treats them as the same page Pro also maintains several techniques for tracking users when their session cookies disappear as they move from domain to domain 2001 2005 ClickTracks Services and Processes Services and Processes 22 2 Services and Processes It is important to understand that the Pro Processor includes services that run in the background carrying out the low level tasks required to process and serve files These services can be controlled through the administrative interfaces but the simple Start Stop functionality in the controls do not fully reflect the significance of these services There are two main services e ClickTracks Server Responsible for gathering and processing logfiles or datasets from the JavaScript Data Collector JDC e ClickTracks Reporting Engine Responsible for serving reports and datasets to client apps web browsers and e
131. rver has encounted an FTP connect error on the server specified in the Web server properties of this dataset Verify the Web server properties to ensure the correct FTP settings of servername username and password are being used for this connection Add domain Add multi domain logfile Run schedule now Reprocess all logs For this dataset Verify that the network connection is valid dose History Errors Message Dataset Domain Web server 4 19 2004 3 45 53 PM Invalid request lines 0 Test Data test domain Test IIS 4 19 2004 3 47 00 PM Reading FTP server directory Win2003Q4 QA Domain IIS Serve 4 19 2004 3 47 21 PM Reading file ex040419 log at offset 7113598 Win2003Q4 QADomain IIS Serve 4 19 2004 3 47 21 PM Appended Size 922580 Win2003Q4 QA Domain IIS Serve 4 19 2004 3 47 21 PM New Size 8036178 Win2003Q4 QA Domain IIS Serve 4 19 2004 3 47 21 PM Finished reading 922580 bytes of file C Program Files Cli Win2003Q4 QA Domain IIS Serve 4 19 2004 3 47 21 PM Valid request lines 4650 Win2003Q4 QA Domain IIS Serve 4 19 2004 3 47 21 PM Invalid request lines 0 Win2003Q4 QA Domain IIS Serve New History Tab filtered for the specific dataset displayed 2001 2005 ClickTracks Processing Engine Administrator 78 History Errors History Win2003Q4 Message o o o Dataset Domain web server 4 19 2004 12 46 56 PM Reading FTP s
132. s field is present ClickTracks will compare the value against the site names specified in the New Dataset Wizard The comparison matches in turn the domain names from the wizard both the main site name and the alternate names Lines from the log are discarded if they originated from a server not listed If the logfile is multi domain and does not contain the virtual server name field then ClickTracks has no way to determine in which domain the request belongs For Apache this field is the virtual server name or v in the log directive line for IIS it s cs host See Configuring Web Servers If your site has a number of subdomains that you d like to analyze separately make a new dataset for each and set the alternate server names such that only the matching names are included Then import the same single logfile into each dataset What If There Are No Logfiles Some ISPs simply don t provide logfiles for example Yahoo Stores In this case you can signup for ClickTracks Hosted a special script you place on each page will gather the data and you ll use that instead of logfiles to get the same great analytics tools and reporting Troubleshooting amp Help Tip After clicking Connect you ll see a hyperlink in The ClickTracks Way that will let you View FTP Diagnostics You will see the actual communications commands from the FTP dialog to the FTP server including error messages returned from the remote server Can t find server Change the
133. ss Do not list subdomains or other websites here The ClickTracks Server uses these aliases to differentiate between internal and external web links for the analyzed website Notes for sites with HTTPS protocol e If your site serves the same pages in the same domain for both HTTP and HTTPS list both as aliases of the domain e Create two separate domains for each HTTP and HTTPS URLs if they have different content and are served by different web servers under the current dataset This allows for proper analysis of these HTTPS pages as well as of the HTTP pages in your dataset Page 4 Case Sensitivity Choose the case sensitivity of the web server machine being analyzed Specify whether this web site is running on a Windows not case sensitive or UNIX Linux case sensitive server Page 5 Server Scripting Specify the server side scripting used on the web server being analyzed The default value is chosen by the New Domain Wizard and will most likely be correct If the default selection is incorrect override the value by selecting another choice See Also New Dataset Wizard New Multi Domain Wizard New Web Server Wizard New Multi Domain Wizard The New Multi Domain Wizard will guide you through the creation of a Multi Domain logfile associated with a dataset This wizard is a slight variation of the New Web Server Wizard but it will create a special Multi domain domain entry and a new Web Server entry Before setting up the M
134. stablished your settings click the Test Email button If you have used valid data in the settings you will receive a success message If you have entered invalid data e g incorrect mail server nonexistent account wrong password etc then you will receive an error message stating The connection failed to send the test email 2001 2005 ClickTracks Reporting Engine 94 Administration User Accounts User Groups sets Mail Server Configuration Current SMTP Settings oo Nes mail yourdomain com Server Port 25 Site Archiver x AutoMail Email automail yourdomain com Server Configuration Mail Server AutoMail Username user AutoMail Password password Configuration Email Subject AutoMail Feature Scheduled Task Test Email Update Configuration The connection failed to send the test email 4 2 7 Scheduled Task Configuration Scheduled Task Configuration is used to set up schedules for distributing reports via email as well as for site archiving To schedule tasks click Scheduled Task Configuration in the left menu of the Reporting Engine Administrator Scheduled Email Tasks To Create a New Scheduled Email Task 1 D OND OP w The New Email Task form is displayed in this section by default If it is not already displayed click on New Email Task under Current Tasks Give the task a meaningful name The Task Type is based on the type of task selected and
135. t day Start time sets the time the software will begin the first session Set the polling frequency of the ClickTracks server to one of these values e 15 Minutes 30 Minutes Hourly 12 Hours Daily Weekly Monthly Set the polling frequency cautiously to avoid excessive network traffic NOTE All JDC Dataset are Think Globally analyze on server by default and cannot be changed Also Cookie Tracking and URL Pruning are NOT available for JDC Datasets After the New JDC Dataset Wizard finishes a domain and web server entry will be created automatically for you The resulting server configuration is read only You will not be able to alter these settings New Hosted Dataset Wizard The ClickTracks Server v5 6 also allows you to create a dataset directly from a hosted account Like the JDC Dataset this wizard will create a special configuration in which the properties will be read only after the initial dataset creation This feature is primarily intended for the ClickTracks Agency Program CAP and is integrally linked with both the Agency program and the ClickTracks Hosted Service This wizard is available only from Menu File Hosted Dataset Page 1 Name The Dataset Enter a descriptive name for the dataset Page 2 Specify Data Location Enter the local disk location where the dataset will be saved This data location can be on the same computer that is running the ClickTracks server software or on a network shared driv
136. t the bottom of the page Administration Admin Home User Administration User Accounts User Groups User List Current User New User New User Site Archiver Server User User Name z admin Configuration Password Mail Server Confiquration Is Admin E Scheduled Task Group Defaut z Configuration Datasets chosen here will always be available to this user Note regardless of what group you assign this user to Users Datasets Available Datasets bobsfruitsite a Update Remove User Groups User Groups allow you to create different groups with access to different datasets as well as to reports within that dataset For example one group could be for web developers with access to the Site Overview What s New and Funnel reports and another group could be for marketing staff with access to the Search Site Overview Robot and Campaign reports Or you could set up different groups responsible for different websites 2001 2005 ClickTracks 89 ClickTracks Server so each group is only allowed access to datasets within its scope of responsibility Adding a New Group To add a new group click the New Group link just above the Group List Assign a name to the group spaces are not allowed in the name Check the specific reports this group should have access to Select any datasets to which you want this group to have access Hold down the CTRL key and click on any of the datas
137. to synchronize the NLFs with your client and perform the analysis and visitor counting there See Topic Analyze On Server Processing Analyze on Server Conversion Issues Reading Logfiles See Also New Domain Wizard New Multi Domain Wizard New Web Server Wizard 2001 2005 ClickTracks Processing Engine Administrator 44 3 1 2 2 New JDC Dataset Wizard The ClickTracks Server v5 1 can now retrieve data from JDC datasets ClickTracks Hosted for analysis by the desktop client This wizard will create a special configuration in which the properties will be read only after the initial dataset creation This wizard is available only from Menu File JDC Dataset Page 1 Name The Dataset Enter a descriptive name for the dataset Page 2 Specify Data Location Enter the local disk location where the dataset will be saved This data location can be on the same computer that is running the ClickTracks Server software or on a network shared drive Important This is the file system location where ClickTracks Server will save the configuration files and the normalized logfiles that are read by the client machines This location must be a network share that is readable from the client machines The default location will almost certainly need to be changed Use the Browse button to navigate to long path locations Page 3 Dataset Retrieval Select the retrieval method for your JDC dataset configuration file e HTTP
138. to the end of the value further ensures its uniqueness The code that you write on your website would do the following 1 When the visitor first comes to your website a persistent cookie is set on the visitor s machine 2 This cookie need only be set once As long as the cookie s expiry date is set to never expire this cookie will stay with the visitor s machine forever When a visitor returns to your site your code should check the visitor s machine for the presence of your cookie and should not set another one if a cookie already exists The cookie should never be set twice for any given visitor 3 You must make sure that this cookie is also getting logged in your web server logs Please see the help documents in the ClickTracks application on how to configure your web server to log the proper logfile format How Do Implement Cookies There are a variety of ways to implement cookies on your website It all depends on the website technology you are using The following are some sample implementations using ASP PHP and JavaScript ASP Active Server Pages Sample Code If Response Cookies strCookieName mny Response Cookies strCookieName strCookieValue This will make the cookie expire in 1000000 days Response Cookies strCookieName Expires Date 1000000 PHP Sample Code Cookie is Valid for 1000000 days 3rd value in function is the time expiration in seconds 3600 seconds 1 hour if isset SH
139. ts and control the Processing Engine Reporting Engine CT_ReportingEngine Service to serve datasets and reports to client apps browsers and email and do site archiving CT_ReportProcessor Converts reports into various portable formats for viewing in web browsers or email Configuration Client CT _DatasetProcessor Client app used to adjust global settings of the datasets for end users The following diagram shows the basic outline of how the various components fit into the whole system 2001 2005 ClickTracks Getting Started 4 2 3 4 5 Web Server AE Configuration Client 1 ClickTracks 2 Professional ae SSE Processor Browser Ss End User 2 End User 3 Log Files ClickTracks Service Server Administrator Reporting Engine Administrator Raw data in the form of logfiles or datasets created on a JDC is aquired and processed on a scheduled basis by the ClickTracks Service aka Processing Engine The schedule for the service the location of the raw data and the other definitions of the datasets are established in the Server Administrator interface Once a dataset has been created through the Server Administrator and processed by the service it can be further configured by the Configuration Client All datasets created by the Processing Engine are available to the Reporting Engine which is administered through a web based interface
140. uire you to copy several files to your own computer and analyze the data locally Switching to this mode may therefore require a long wait Only continue if this is what you want to do Clicking the OK button will begin the synchronization process during which the entire dataset is downloaded from the Reporting Engine to the Pro Client Once the dataset has been synchronized custom analysis of the data creating labels parameter masking changing options etc can be done on the Pro Client 1 6 Processing Engine Administrator QuickStart ClickTracks Processing Engine Administrator presents the user interface for configuring and adding datasets domains and web servers viewing server diagnostic information accessing the Configuration Client and controlling the Reporting Engine service The Processing Engine Administrator UI is opened only when changes to the configuration are needed To start the ClickTracks Processing Engine Administrator Windows Start Menu All Programs ClickTracks ClickTracks Pro Server A ClickTracks Server APA Administrator OR Double click on the ClickTracks Server Administrator icon on the desktop Server Administrator User Interface 2001 2005 ClickTracks 17 ClickTracks Server ew Dataset Wizard New Domain Wizard New Web Server Wizard Domain Names Web server names Server status panel Start Stop server Reporting Engine g ClickTracks Server Administrator
141. ulti domain entry it is generally a good practice to define all of the Domain entries prior to running this wizard For a Multi domain planning example see section Multi Domain Logfiles To start the Multi domain Wizard a dataset name must be selected first 1 Select a dataset by clicking the mouse on the dataset name 2 Right Click on the dataset name 3 Select Menu Add multi domain logfile OR 3 Menu File Add Multi domain logfile The properties of the logfiles to be analyzed will be presented here 2001 2005 ClickTracks Processing Engine Administrator 50 Page 1 Name The Web Server Enter the external name of the web server Examples WWW store secure Page 2 Logfile Retrieval Method Select the logfile retrieval method e FTP transfer Use this method when the logfiles are on a remote computer running an FTP server Enter the FTP Login values of Server Username Password Click the Test Connection button to verify that the login parameters are correct for the connection Logfile Location Enter the directory path to the logfiles from the web server Use the Browse button to connect to the FTP server and navigate to the proper logfile directory e File System Use this method when the logfiles are on a local or shared network drive Enter the Driver letter and full path to location of the logfiles Use the Browse button to navigate to long path locations Page 3 Include Exclude Choose whi
142. unique visitors and can map conversion events back to the original campaign and search engine keyword A The following applies to ClickTracks Pro when using logfiles ClickTracks Pro Hosted using JavaScript automatically sets suitable cookies and requires no configuration Configuring session cookies A session cookie goes away when the user closes the browser window It s the opposite of a persistent cookie Many dynamic site generation tools like PHP and ASP contain easy session cookie management ClickTracks both Analyzer and Pro contains support for these standard session cookies ClickTracks Pro can be configured to use any custom session cookie If your site uses a custom cookie simply define this inside the ClickTracks Pro Server Persistent cookie tracking for better campaign accuracy See Using Persistent Cookies To Improve Campaign Tracking Browser Based Reporting The Reporting Engine component of the Pro Processor allows you to generate pre analyzed reports in HTML format These reports can then be viewed in a web browser in an email application or within the Pro Client in the form of Instant Reports 2001 2005 ClickTracks Getting Started 20 1 7 3 1 7 4 Site Archiving The Reporting Engine can create archives of websites thus allowing analysis of historical data against the website that existed when the visitor data was gathered This makes it possible to show comparisons of two different ve
143. ver Dataset name causing the event Domain name causing the event Web server name causing the event History Errors Message Dataset Domain web server 4 19 2004 2 00 34 PM Valid request lines 1170 Test DataSet test domain Test IIS 4 19 2004 2 00 34 PM Invalid request lines 0 Test DataSet test domain Test IIS 4 19 2004 2 15 35 PM Reading FTP server directory Test DataSet test domain Test IIS 35 PM Reading file ex040419 log at offset 6445908 Test DataSet test domain Test IIS 35 PM Appended Size 201420 Test DataSet test domain Test IIS 35 PM New Size 6647328 Test DataSet test domain Test IIS 35 PM Finished reading 201420 bytes of file C Program Files Cli Test DataSet test domain Test IIS 35 PM Valid request lines 1020 Test DataSet test domain Test IIS 4 19 2004 2 15 35 PM Invalid request lines 0 Test DataSet test domain Test IIS 4 19 2004 2 17 02 PM Initializing 4 19 2004 2 30 36 PM Reading FTP server directory Test DataSet test domain Test IIS 4 19 2004 2 30 57 PM Reading file ex040419 log at offset 6647328 Test DataSet test domain Test IIS 57 PM Appended Size 240080 Test DataSet test domain Test IIS 57 PM New Size 6887408 Test DataSet test domain Test IIS 57 PM Finished reading 240080 bytes of file C Program Files Cli Test DataSet test domain Test IIS 58 PM Valid request lines 1220 Test DataSet test domain Test IIS 4 19 2004 2 30 58 PM Invalid request lines 0 Test DataSet test d
144. version you should not convert it in this upgrade wizard A dataset can always be upgraded at a later time Select all datasets that you want to upgrade from the left column and click on the gt gt button to set them up for upgrade then click the Next button Dataset Upgrade First Step Select Datasets to Upgrade By default ClickTracks has disabled analysis of all datasets created before version 6 Once the dataset has been upgraded it will no longer be compatible with previous versions of ClickTracks Datasets that remain disabled in this dialog may be enabled later in the Server Administrator Retain Previous Version Upgrade to ClickTracks 6 bobsfruitsite gt gt lt Back Next gt Cancel Welcome to the New Dataset Wizard 2001 2005 ClickTracks Getting Started 12 Dataset Upgrade First Step Select Datasets to Upgrade Welcome to the New By default ClickTracks has disabled analysis of all datasets created before Dataset Wizard version 6 Once the dataset has been upgraded it will no longer be compatible with previous versions of ClickTracks Datasets that remain disabled in this dialog may be enabled later in the Server Administrator Retain Previous Version Upgrade to ClickTracks 6 bobsfruitsite You can upgrade the datasets immediately or the next time the schedule runs Upgrading involves reanalyzing the dataset so if your datasets are very large use the schedule
145. vestscetccabtehesieecstucebeazs File Domaim EXClustons nirani er RM Rs AE cae Cece ies ded cg ad ee eee aoe alee URCPRarameiers M ER seen nd ss ne nd ln een maider Web Server Propertio S sistema tintin niNetan nn nina tan attats aiae ene E AET nee ne ae tn ler eme dre an ra enfin te dents File System Logfile Retrieval Advanced Web Server Properties Server LoggiNg RE Re an i Van ES e E E 73 Show Session Record iene 74 La LES Ce AE SE nen 77 EMROVS NN HR nn E dan een E enr en Diane ot at dans Dane ste eus E n etage 78 N E Riles UM dns nee no ne a te 82 Reporting Engine 85 Reporting Engine Service ss issssssssernnnnsnneeenenenennssnnnneeneeeneenesneneennes 85 Reporting Engine Administrator sise 85 Initial Setup E T 86 WserAccounts acceding 87 User GroupS oo eescesesseseneenesteseeennesneseeeneesaeseeeseesaeseeesnesaeseeeseesaesseeseesaeseeesnesaeseeeseesaeseeennesaeseneseesaesenesnesaesseesnesaesanennenansane 88 Site Archivers acces T T A E E E E E E E E E ans d tale dune sat dent d ne 90 Server Configuration we 91 Mail Server Configuration si inisiirnnnnnnnnnnnnnnnnennnnennnnnnennnnnnnnennennnnnneneennsnennennnnnnnnee 93 Scheduled Task Configuration ss isssniisnnannnnnnnnennnnnnennnnnnennnnnennnnennennnnnnnse 94 Configuration Client 98 Advanced Topics 100 How ClickTracks Uses Cookies ccccccccccecereeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeneenees 100 Using Persistent Cookies To Improve
146. yze on server can be selected when creating a new dataset in the New Dataset Wizard or later when setting the properties of an existing dataset After the ClickTracks Service has completed processing the logfiles and created NLF files a second phase of analysis and visitor counting will take place auto analyze The auto analyze process will be started by the server and process the datasets existing and new NLF file and generate BIN file which are refined data files per day of data which the Pro Client can use directly for further analysis and reporting You may also create define global labels on the server and import Campaign and define Revenue data which then will show up on the client dataset after synchronizing to the server 2001 2005 ClickTracks Processing Engine Administrator 32 When Should Analyze on Server be Used e Large amp Complex Datasets e High Traffic Websites Why Should Analyze on Server be Used Centralized control at the server over Global Labels on the dataset Campaign Data Revenue Data e Client reports and analysis will be faster See section Configure Client Analyze On Server Datasets 3 1 1 2 Configure Client Analyze On Server Datasets After selecting Think Globally Analyze on Server for a dataset you must then start the service and allow it to cycle and complete the analysis of the dataset before you can configure it You can monitor the analysis prog
147. ze on Server Conversion Issues Existing ClickTracks Server datasets can be converted to the new Think Globally Analyze on Server processing scheme to take advantage of the speed benefits of this new feature The dataset conversion can only take place in the Think Locally Analyze on Client PC legacy datasets to the new Think Globally Analyze on Server direction 2001 2005 ClickTracks Processing Engine Administrator 34 3 1 1 4 Converting Existing Server Datasets to Think Globally Analyze on Server Existing server datasets can be converted to the new Think Globally Analyze on Server scheme by editing the dataset properties Check the Analyze on Server checkbox Click Apply and then OK to save your property changes The server dataset will be converted to Think Globally Analyze on Server processing on the next scheduled processing of this dataset To process the dataset immediately select the dataset name right click and select Run Schedule Now Impact on Client Datasets Existing client datasets legacy datasets can still synchronize to existing server datasets after converting to version 5 1 The software on the server and client will function as in prior versions If a server dataset is converted to Think Globally Analyze on Server existing client datasets will still be able to synchronize data from the server but the client dataset will still be in Think Locally Analyze on Client PC and it wil

"user manual"

Contents

Download Pdf Manuals

Related Search

Related Contents

&quot;user manual&quot;

Contents

Download Pdf Manuals

Related Search

Related Contents

"user manual"