NetInsight Admin Guide

Unica NetInsight
Version 8.2.1
Administrator's Guide Administrator'
Publication Date: January 17, 2011
Copyright
Copyright Unica 2010. Unica, an IBM Company Reservoir Place North 170 Tracer Lane Waltham, MA 02451-1379
Examples and Data

All software and related documentation is subject to restrictions on use and disclosure as set forth in the Unica Software License and Services Agreement, with restricted rights for U.S. government users and applicable export regulations. Companies, names, and data used in examples herein are fictitious unless otherwise noted.
Trademarks and Patents

Unica, the Unica logo, NetInsight, Affinium and MarketingCentral are registered trademarks of Unica, an IBM Company ("Unica"), with the U.S. Patent and Trademark Office. MARKETING SUCCESS STARTS WITH U is a trademark. All other trademarks are the property of their respective owners. Portions of the software described in this document are covered by U.S. Patent Numbers: 6,317,752, 6,269,325, 6,542,894, and 6,782,390. The NetTracker and Unica NetInsight products are licensed under the following patents and patent publications: US5,675,510, US6,115,680, US6,108,637, US5,796,952, US6,138,155, US6,653,696, US6,763,386, AU0701813, BR9609217, CA2223919, EP0843946, JP03317705, MX193614, NO09705728, AU735285, CA2246746, CN1174316, CN1547123, CN1547124, DK870234, DE69720186, ES2195170, AU727170, BR9808033, CA2284530, CN1251669, IL131871, JP2000514942, KR341110, NZ337756, WO9641495, EP0870234, EP1130526, EP1168196, US20040078292, WO9810349, US20050114511, US20040221033, WO9843380. Markup functionality in Unica Marketing Operations is enabled through use of third-party software components from AdLib eDocument Solutions and Adobe Acrobat. "Powered by AdLib." NOTICE: This document contains confidential and proprietary information of Unica. Use, duplication, or disclosure without the express written consent of Unica is prohibited.
Table of Contents
Preface Contacting Unica technical support............................................................................................ 28 1 Introduction to Unica NetInsight .................................................................................. 30 ..................................................................................30
About Unica NetInsight ....................................................................................................................... 30 About data collection methods............................................................................................................ 30 The stages of Web site tracking ......................................................................................................... 32 About Unica NetInsight reports........................................................................................................... 32 About profiles ...................................................................................................................................... 35
2 Connecting to and Using the NetInsight Interface ...................................................... 36 ......................................................36

About Unica NetInsight logons ........................................................................................................... 36 To log on to NetInsight........................................................................................................................ 37 To connect to other Unica applications from Unica NetInsight...........................................................37 To change your user password in NetInsight .....................................................................................37 To change your user password in Unica Marketing Platform.............................................................38 Viewing profiles and reports ............................................................................................................... 38 About the Unica NetInsight interface .............................................................................................. 38 About the Profile Manager screen .................................................................................................. 38 About the Profile screen.................................................................................................................. 40 To set the default profile ................................................................................................................. 45 About the geographic report interface ............................................................................................ 46 Using the NetInsight Homepage......................................................................................................... 47 About using the Unica NetInsight Homepage.................................................................................47 To view a profile as an authenticated user .....................................................................................47 About using Unica NetInsight documentation as an authenticated user ........................................48 About the Unica NetInsight Homepage .......................................................................................... 48 Version 8.2.1 3
To change your default view and reporting mode for a profile ......................................................49
3 Creating and Configuring Profiles ............................................................................... 50 ...............................................................................50

About profiles ...................................................................................................................................... 50 Configuring Database Connections .................................................................................................... 50 About database connections........................................................................................................... 51 To configure a database connection............................................................................................... 51 Example database connection XML ............................................................................................... 51 Updating data in a profile.................................................................................................................... 52 About deleting profile data .............................................................................................................. 53 To delete profile's data.................................................................................................................... 53 To update a profile's data ............................................................................................................... 54 To create a profile............................................................................................................................... 54 To create a profile to analyze logs from clustered servers .............................................................55 To create a profile from a copy ....................................................................................................... 56 To edit a profile's options ................................................................................................................ 56 To delete a profile ........................................................................................................................... 57 About general profile options .......................................................................................................... 57 To set general profile options...................................................................................................... 58 About locale options........................................................................................................................ 59 About character sets ................................................................................................................... 60 To change locale options ............................................................................................................ 61 About page tags.............................................................................................................................. 62 To enable page tags ................................................................................................................... 64 Restricting access to profiles .............................................................................................................. 64 Restricting access to profiles .......................................................................................................... 64 To restrict access to profile functions by password ........................................................................67 Filtering profiles................................................................................................................................... 67 About filtering profiles ..................................................................................................................... 68 To filter profiles ............................................................................................................................... 68 About profile filter options ............................................................................................................... 69
4 Importing Log Files ...................................................................................................... 70 Files......................................................................................................

To add log files to a profile ................................................................................................................. 70 To add clustered log files to a profile.................................................................................................. 71 Manually specifying a log file format................................................................................................... 73
Unica NetInsight - Administrator's Guide
To define a custom log file format................................................................................................... 73 About fields in custom log format definitions ..................................................................................73 About dates in custom log format definitions ..................................................................................76 About tab-delimited fields in custom log format definitions.............................................................78 About log files on FTP servers ........................................................................................................... 78 To specify the date format of your log files.........................................................................................79 To process only data for the configured site.......................................................................................79 To select a time zone for a new profile............................................................................................... 79 To stop conversion of dates and times in W3C log files ....................................................................80
5 Working with Page Tags ............................................................................................. 82 .............................................................................................82

What is page tagging? ........................................................................................................................ 82 Introduction to page tagging ............................................................................................................... 82 When to use page tagging.............................................................................................................. 83 How page tagging works................................................................................................................. 83 Basic page tagging data, dimensions, and metrics ........................................................................83 About the page tag image query string........................................................................................... 85 Page tagging options settings in Unica NetInsight ........................................................................85 Planning your tags .......................................................................................................................... 86 Setting up basic page tagging ............................................................................................................ 86 Basic page tagging deployment checklist .......................................................................................87 About the page tags package ......................................................................................................... 87 To deploy the page tag image ........................................................................................................ 87 To edit and deploy the page tag script ........................................................................................... 88 To tag your site pages .................................................................................................................... 88 Verifying that the page tags are working ........................................................................................89 To enable page tags ....................................................................................................................... 89 What to do when JavaScript is disabled .........................................................................................90 Using page tagging with secure pages........................................................................................... 90 To normalize query string parameter values ..................................................................................91 Adding dimensions to tags.................................................................................................................. 91 About adding dimensions to tags.................................................................................................... 91 Default dimensions ......................................................................................................................... 92 Standard dimensions Unica NetInsight recognizes automatically ..................................................92 Example: site dimension ............................................................................................................. 94
Version 8.2.1
About using custom dimensions ..................................................................................................... 95 Constructing the dimension name-value pair..............................................................................95 Passing multiple values............................................................................................................... 95 Planning your custom dimensions .............................................................................................. 96 Adding a dimension to a tag ........................................................................................................... 96 Including cookie data in page tag requests ........................................................................................98 About including cookie data in page tag requests ..........................................................................98 About visitor identification cookies .................................................................................................. 98 To capture data from additional cookies......................................................................................... 98 Tagging events ................................................................................................................................... 99 What is an event? ........................................................................................................................... 99 About event tagging ...................................................................................................................... 100 Tracking an event as a page view ................................................................................................ 100 Ensuring link and submit page tag requests are submitted before the page unloads..................101 To tag JavaScript or AJAX events ................................................................................................102 To tag events in Flash 8 or greater............................................................................................... 102 Flash page tagging examples ....................................................................................................... 103 Marking link tags as links to an external site ................................................................................105 Sending visit-level data when an event occurs.............................................................................105 Tagging retail activity ........................................................................................................................ 105 About retail activity........................................................................................................................ 105 Tagging product views .................................................................................................................. 106 Tagging additions to a shopping cart............................................................................................107 Tagging removals from a shopping cart .......................................................................................108 Tagging the checkout process ...................................................................................................... 108 Retail page tag parameters summary........................................................................................... 109 Retail metrics ................................................................................................................................ 109 Differences between Product Revenue and Revenue ..............................................................111 Tagging applications and widgets..................................................................................................... 111 About tagging applications and widgets .......................................................................................111 Anatomy of a direct tag................................................................................................................. 112 Best practices for direct tags ........................................................................................................ 112 About the lc parameter.................................................................................................................. 112 When NOT to pass the lc parameter ............................................................................................ 113
Where to place your direct tags .................................................................................................... 113 Minimizing the number of tags...................................................................................................... 113 Reference ......................................................................................................................................... 114 Introduction ................................................................................................................................... 114 Required variables ........................................................................................................................ 114 About required variables ........................................................................................................... 114 NTPT_IMGSRC......................................................................................................................... 114 NTPT_SET_SESSION_COOKIE............................................................................................... 115 NTPT_FIELDS .......................................................................................................................... 115 NTPT_MAXTAGWAIT ............................................................................................................... 116 Optional global variables............................................................................................................... 116 About optional global variables ................................................................................................. 117 NTPT_HTTPSIMGSRC ............................................................................................................. 117 NTPT_GLBLEXTRA .................................................................................................................. 117 NTPT_GLBLREFTOP ............................................................................................................... 117 NTPT_GLBLCOOKIES ............................................................................................................. 118 NTPT_SET_IDCOOKIE............................................................................................................. 118 NTPT_IDCOOKIE_NAME ......................................................................................................... 118 NTPT_IDCOOKIE_EXPIRE ...................................................................................................... 118 NTPT_IDCOOKIE_DOMAIN .................................................................................................... 119 NTPT_SESSION_COOKIE_NAME ........................................................................................... 119 NTPT_SET_SESSION_COOKIE............................................................................................... 120 Page-specific variables ................................................................................................................. 120 About page-specific variables ................................................................................................... 120 Where to put page-specific variables........................................................................................120 NTPT_PGEXTRA ...................................................................................................................... 120 NTPT_PGREFTOP ................................................................................................................... 121 NTPT_NOINITIALTAG .............................................................................................................. 121 NTPT_PGCOOKIES ................................................................................................................. 121 Event tagging functions................................................................................................................. 122 ntptAddPair ............................................................................................................................... 122 ntptDropPair .............................................................................................................................. 122 ntptEventTag............................................................................................................................. 123 ntptLinkTag ............................................................................................................................... 123
Version 8.2.1
ntptSubmitTag ........................................................................................................................... 124
6 Configuring Reporting Options ..................................................................................125 Options.................................................................................. 125

About reporting options..................................................................................................................... 125 Specifying auto-updated reports ....................................................................................................... 125 About auto-updating...................................................................................................................... 126 To specify which reports auto-update ........................................................................................... 126 Creating custom metrics ................................................................................................................... 127 About custom metrics ................................................................................................................... 127 To create a custom filtered metric ................................................................................................ 127 To create a multiple input custom metric ......................................................................................129 To edit a custom filtered metric..................................................................................................... 130 To edit a multiple input custom metric .......................................................................................... 132 To delete a custom metric ............................................................................................................ 134 Extending the data model ................................................................................................................. 134 About the data model.................................................................................................................... 134 About extending the data model ................................................................................................... 134 To add a data model extension package......................................................................................135 About deleting or editing data model extension packages ...........................................................135 Creating filter groups ........................................................................................................................ 135 About filter groups......................................................................................................................... 135 To create a filter group.................................................................................................................. 136 To edit a filter group...................................................................................................................... 137 To edit filters for a filter group ....................................................................................................... 137 To delete a filter group.................................................................................................................. 139 Accessing geographic data............................................................................................................... 139 About the NetInsight geographic database...................................................................................139 To configure a profile to use the geographic database ................................................................139 Configuring integration models ......................................................................................................... 140 About integrations ......................................................................................................................... 140 To configure a profile to use an integration module .....................................................................140 To edit an integration module ....................................................................................................... 141 To delete an integration module ................................................................................................... 141 Paid search integration fields........................................................................................................ 141 Privileges for integrations.............................................................................................................. 142
Specifying the date range of pre-generated reports .........................................................................142 About report generation options.................................................................................................... 142 About aggregate data ................................................................................................................... 143 To edit dates for which reports are pre-calculated .......................................................................143 To edit dates for which aggregate data is generated ...................................................................144 Specifying reportability of dimensions .............................................................................................. 144 About reportable dimensions ........................................................................................................ 144 To change reportable dimensions................................................................................................. 144 Specifying the sample size ............................................................................................................... 145 About data samples ...................................................................................................................... 145 To specify the sample size ........................................................................................................... 146 Permissions for sampling features................................................................................................ 147
7 Creating Reports ....................................................................................................... 148

About creating reports ...................................................................................................................... 148 To create a standard report .............................................................................................................. 149 Creating a crosstab report ................................................................................................................ 150 About crosstab reports.................................................................................................................. 150 To create a crosstab report........................................................................................................... 151 To create a trend report .................................................................................................................... 152 Creating a custom dashboard........................................................................................................... 153 About dashboards......................................................................................................................... 153 To create a dashboard.................................................................................................................. 154 To create a graph dashboard section ........................................................................................... 155 To create a text dashboard section .............................................................................................. 155 To create a table dashboard section ............................................................................................157 Creating a path summary ................................................................................................................. 157 To create a Path Summary between two specific pages..............................................................158 To create a Path Summary from a specific page .........................................................................159 To create a Path Summary to a specific page..............................................................................161 Creating a scenario report ................................................................................................................ 162 To create a scenario report........................................................................................................... 162 About scenario reports.................................................................................................................. 164 Specifying a time frame .................................................................................................................... 166 About time frames......................................................................................................................... 166
Version 8.2.1
To specify a fixed time frame using the calendar .........................................................................166 To specify a relative or fixed time frame using a date filter ..........................................................167 Specifying dimensions ...................................................................................................................... 168 About dimensions ......................................................................................................................... 168 To specify dimensions for a report in the Custom Report Wizard ................................................168 Specifying metrics............................................................................................................................. 169 About metrics ................................................................................................................................ 169 To specify metrics for a report in the Custom Report Wizard.......................................................169 To add a metric through the Discovery Panel ..............................................................................170 Creating an A/B report ...................................................................................................................... 171 About A/B reports.......................................................................................................................... 171 To create an A/B report through the Discovery Panel ..................................................................173 To create an A/B report using the Custom Report Wizard ...........................................................174 Creating a comparative report .......................................................................................................... 175 About comparative reports............................................................................................................ 175 To create a comparative report..................................................................................................... 176 To save a customized report ............................................................................................................ 176 Changing the content of a report ...................................................................................................... 177 To edit a report using the Report Summary page ........................................................................178 To display axis labels for dashboard reports ................................................................................178
8 Archiving, Emailing, and Exporting Reports ..............................................................179 Reports.............................................................. 179

About archiving reports ..................................................................................................................... 179 To archive a report............................................................................................................................ 179 To view archived reports................................................................................................................... 180 To remove archived reports.............................................................................................................. 180 Emailing reports ................................................................................................................................ 181 About emailing reports .................................................................................................................. 181 To email a report........................................................................................................................... 181 To create an email task ................................................................................................................ 182 To create an email task............................................................................................................. 182 To add or edit reports for an email task ....................................................................................183 To add or edit recipients for an email task................................................................................184 To test an email task................................................................................................................. 185 To edit an email task................................................................................................................. 185
10
To delete an email task............................................................................................................. 186 To execute an email task.............................................................................................................. 186 To execute an email task .......................................................................................................... 186 To execute an email task from the command line ....................................................................186 To execute all email tasks from the command line...................................................................187 To create an email alert ................................................................................................................ 188 To create an email alert ............................................................................................................ 188 To modify filters for an email alert.............................................................................................189 To test an email alert ................................................................................................................ 190 To edit an email alert ................................................................................................................ 190 To delete an email alert ............................................................................................................ 190 To execute an email alert ............................................................................................................. 191 To execute an email alert.......................................................................................................... 191 To execute an email alert from the command line....................................................................191 To execute all email alerts from the command line ..................................................................191 About scheduling email tasks and email alerts.............................................................................192 To export a report as a file................................................................................................................ 193 Working with portlets......................................................................................................................... 194 About portlets ................................................................................................................................ 194 To export a report as a portlet ...................................................................................................... 195 Working with group selections .......................................................................................................... 196 About group selections ................................................................................................................. 196 To open or close the Selected Groups panel ...............................................................................197 To add groups to a group selection .............................................................................................. 198 To modify a group selection.......................................................................................................... 198 To save a group selection............................................................................................................. 199 To use a group selection in Unica Campaign...............................................................................200
9 Analyzing Content ..................................................................................................... 202 .....................................................................................................202

About analyzing content ................................................................................................................... 202 Analyzing banner ads ....................................................................................................................... 202 About analyzing banner ads ......................................................................................................... 203 About moving ntadtrack.cgi or ntadtrack.exe to a CGI-accessible directory ................................203 To redirect all banner ads ............................................................................................................. 203 To configure banner ad options .................................................................................................... 204
Version 8.2.1
11
Analyzing content groups ................................................................................................................. 205 About analyzing content groups.................................................................................................... 205 To create a content group............................................................................................................. 206 About determining the content group for files that fit multiple groups ..........................................206 Analyzing indexes ............................................................................................................................. 206 About specifying directory indexes ............................................................................................... 207 To add a directory index ............................................................................................................... 207 Analyzing links .................................................................................................................................. 208 About analyzing links .................................................................................................................... 208 About analyzing links using a redirect program ............................................................................208 About moving ntlinktrack to a CGI-accessible directory ...............................................................208 To redirect all external links .......................................................................................................... 209 About analyzing links using page tags.......................................................................................... 209 About enabling the link summary.................................................................................................. 210 To configure link options ............................................................................................................... 210 Analyzing keywords .......................................................................................................................... 211 About analyzing local keywords.................................................................................................... 211 To configure local keyword options .............................................................................................. 211 To include specific redirection scripts in the reports.........................................................................212
10 Analyzing Dynamic Content .................................................................................... 213 ....................................................................................213

About data conduits .......................................................................................................................... 213 To configure Unica NetInsight to use a data conduit........................................................................215 Adding dynamic pages ..................................................................................................................... 216 About dynamic pages ................................................................................................................... 216 To add dynamic pages.................................................................................................................. 216 To delete a dynamic page ............................................................................................................ 217 To edit a dynamic page filter......................................................................................................... 217 Analyzing events............................................................................................................................... 217 About events ................................................................................................................................. 217 Configuring Unica NetInsight to track events................................................................................218 To define an event title ................................................................................................................. 218 To edit an event title ..................................................................................................................... 218 To delete an event title ................................................................................................................. 218 Analyzing parameters ....................................................................................................................... 219
12
About parameters ......................................................................................................................... 219 About parameter types.................................................................................................................. 220 To define a parameter................................................................................................................... 223 To delete a parameter................................................................................................................... 225 To edit a parameter....................................................................................................................... 226 Replacing or deleting characters in URLs ........................................................................................226 About replacing or deleting characters in URLs ...........................................................................226 To replace or delete characters in the URLs in your reports........................................................229 To delete a search and replace rule .............................................................................................230 To edit a search and replace rule ................................................................................................. 230 Examples ...................................................................................................................................... 231
11 Analyzing Marketing Efforts .................................................................................... 234 ....................................................................................234

About analyzing marketing efforts .................................................................................................... 234 Analyzing campaigns ........................................................................................................................ 234 About campaigns .......................................................................................................................... 235 About dynamic and static campaigns ........................................................................................... 236 About dynamic and static campaigns .......................................................................................236 About campaign channels............................................................................................................. 238 About campaign segments ........................................................................................................... 239 About entry pages for campaign segments ..................................................................................240 To create a campaign in NetInsight .............................................................................................. 241 To specify campaign channels...................................................................................................... 242 To specify campaign segments .................................................................................................... 242 To specify entry pages.................................................................................................................. 243 Configuring paid search campaigns.............................................................................................. 244 About paid search data ............................................................................................................. 244 To analyze paid search data without the integration module ...................................................244 Creating paid search campaigns to analyze in Unica NetInsight .............................................244 Creating a paid search campaign in Unica NetInsight .............................................................246 Analyzing keywords .......................................................................................................................... 246 About analyzing keywords ............................................................................................................ 247 About character sets and keywords.............................................................................................. 247 To create a keywords parsing rule................................................................................................247 To specify keyword parameters for a keyword rule ......................................................................248
Version 8.2.1
13
To specify referrers for a rule........................................................................................................ 249 To specify an excluded URL for a keyword rule ...........................................................................249 To specify a character set parameter for the keyword rule ..........................................................250 Keyword parsing example............................................................................................................. 251 Analyzing referrers............................................................................................................................ 251 About analyzing referrers.............................................................................................................. 251 To create a referrer group............................................................................................................. 252 To add referrers to a referrer group .............................................................................................. 252 Determining the group for referrers that fit multiple groups ..........................................................253 Analyzing visits from indexing agents............................................................................................... 253 About analyzing visits from indexing agents.................................................................................253 To classify a host, user agent, or referrer as a robot or spider ....................................................253 To add visitors to a robot/spider group .........................................................................................254 Determining the group for visitors that fit multiple groups ............................................................254 Analyzing visit cost ........................................................................................................................... 254 About visit cost.............................................................................................................................. 255 About collecting visit cost data...................................................................................................... 255 About including visit cost data in Unica NetInsight reports...........................................................255
12 Analyzing Page Titles ..............................................................................................256 Titles.............................................................................................. 256

About analyzing page titles............................................................................................................... 256 Resolving page titles......................................................................................................................... 256 About resolving page titles............................................................................................................ 257 To resolve page titles.................................................................................................................... 257 To resolve page titles through a proxy server ..............................................................................258 To edit page title mappings............................................................................................................... 258 To limit the pages whose titles Unica NetInsight should resolve......................................................259 To add pages whose titles Unica NetInsight should not resolve ......................................................259 Security realms ................................................................................................................................. 260 About adding security realms........................................................................................................ 260 To create a security realm ............................................................................................................ 261 About determining the security realm for pages that fit multiple realms.......................................261
13 Analyzing Retail Activity .......................................................................................... 262 ..........................................................................................262

About retail activity............................................................................................................................ 262 How Unica NetInsight gathers retail data .........................................................................................262
14
What retail data Unica NetInsight can gather ...................................................................................262 Retail reports..................................................................................................................................... 263 About retail reports........................................................................................................................ 263 About enabling retail reports ......................................................................................................... 263
14 Analyzing Visitors or Users ..................................................................................... 264 .....................................................................................264

About analyzing visitors ................................................................................................................... 264 Analyzing visitors or users by browser .............................................................................................264 About analyzing visitors by browser .............................................................................................265 To create a browser ...................................................................................................................... 265 To add user agents to a browser .................................................................................................. 265 About determining the browser for user agents that fit multiple browsers....................................266 Analyzing visitors or users by department........................................................................................266 About analyzing visitors by department ........................................................................................266 To create a department................................................................................................................. 267 To add hosts and users to a department......................................................................................267 About determining the department for hosts and users that fit multiple departments ..................268 Analyzing visitors by host ................................................................................................................. 268 About analyzing visitors by host ................................................................................................... 268 To create a host group.................................................................................................................. 268 To add hosts to a host group ........................................................................................................ 269 About determining the host group for hosts that fit multiple groups .............................................270 Analyzing visitors or users by platform ............................................................................................. 270 About analyzing visitors by platform ............................................................................................. 270 To create a platform...................................................................................................................... 270 To add user agents to a platform.................................................................................................. 271 About determining the platform for user agents that fit multiple platforms ...................................271 To change the number of minutes between visits ...........................................................................272 To specify an opt-out cookie value ................................................................................................... 272 To use the sessionization parameter value for visitor identification .................................................273 To change how Unica NetInsight sessionizes traffic ........................................................................274 About using visitor identification cookies .......................................................................................... 275 Analyzing visitor profiles ................................................................................................................... 276 About analyzing visitor profiles ..................................................................................................... 276 To create a visitor profile .............................................................................................................. 276
Version 8.2.1
15
About changing the order of visitor profiles ..................................................................................277
15 NetInsight System Administration ........................................................................... 278 ...........................................................................278

About database sessions.................................................................................................................. 278 Administering the Inbox .................................................................................................................... 279 About NetInsight options................................................................................................................... 279 About database sessions.............................................................................................................. 279 About custom log file formats ....................................................................................................... 280 About environment variables ........................................................................................................ 280 About Unica NetInsight email options ........................................................................................... 280 About locale options...................................................................................................................... 280 About Unica options...................................................................................................................... 281 About DNS options ....................................................................................................................... 281 About proxy servers ...................................................................................................................... 282 About authentication options......................................................................................................... 282 About Unica Marketing Platform authentication............................................................................282 About restricting access to the Profile Manager ...........................................................................283 About roles .................................................................................................................................... 283 About user managers.................................................................................................................... 284 About user configuration ............................................................................................................... 284 Configuring main options .................................................................................................................. 284 To specify database sessions....................................................................................................... 285 To define a custom log file format................................................................................................. 285 To add an environment variable ................................................................................................... 285 To edit an environment variable ................................................................................................... 286 To delete an environment variable ............................................................................................... 286 To change the time format............................................................................................................ 287 To change the date format............................................................................................................ 287 To change the character set ......................................................................................................... 288 To change the language used ...................................................................................................... 288 Inbox options................................................................................................................................. 288 Configuring network options ............................................................................................................. 289 To modify Unica options ............................................................................................................... 289 To specify DNS options ................................................................................................................ 289 To modify Unica NetInsight email options ....................................................................................290
16
Configuring security .......................................................................................................................... 291 To specify the internal database as the authentication method ...................................................291 To specify the Unica Marketing Platform as the authentication method ......................................292 To specify LDAP as the authentication method............................................................................292 To specify the Web Server as the authentication method ............................................................293 Configuring roles and users.............................................................................................................. 294 To create a role............................................................................................................................. 294 To copy a role ............................................................................................................................... 295 To assign or edit privileges for a role............................................................................................295 To edit a role ................................................................................................................................. 296 To delete a role ............................................................................................................................. 296 To create a user manager ............................................................................................................ 297 To create a user............................................................................................................................ 297 To modify a user ........................................................................................................................... 298 To specify a user's profile settings................................................................................................299 To delete a user ............................................................................................................................ 300 About customizing the NetInsight interface ......................................................................................300 About profile views........................................................................................................................ 300 About dimension lists .................................................................................................................... 301 About filter lists.............................................................................................................................. 301 About metric lists........................................................................................................................... 301 About the profile default role, view, and reporting mode ..............................................................302 About role default view settings .................................................................................................... 302 Working with views ........................................................................................................................... 302 To create a profile view................................................................................................................. 302 To edit a profile view..................................................................................................................... 303 To copy a profile view ................................................................................................................... 304 To delete a profile view................................................................................................................. 304 To change to another profile view................................................................................................. 304 About accessing a profile view through a URL.............................................................................305 Working with roles and views ........................................................................................................... 305 To set the default role, view, and reporting mode for a profile ....................................................305 To set a new role default view ...................................................................................................... 306 To edit a role default view setting ................................................................................................. 306
Version 8.2.1
17
To delete a role default view setting .............................................................................................307 Working with report lists.................................................................................................................... 307 To create a report list.................................................................................................................... 307 To edit a report list ........................................................................................................................ 308 To copy a report list ...................................................................................................................... 308 To manage folders for a report list................................................................................................ 309 To delete a report list .................................................................................................................... 310 Working with dimension lists............................................................................................................. 310 To create a dimension list............................................................................................................. 310 To edit a dimension list ................................................................................................................. 311 To copy a dimension list ............................................................................................................... 311 To manage groups for a dimension list......................................................................................... 312 To delete a dimension list ............................................................................................................. 312 Working with filter lists ...................................................................................................................... 313 To create a filter list ...................................................................................................................... 313 To edit a filter list........................................................................................................................... 313 To copy a filter list......................................................................................................................... 314 To manage groups for a filter list .................................................................................................. 314 To delete a filter list....................................................................................................................... 315 Working with metric lists ................................................................................................................... 315 To create a metric list ................................................................................................................... 316 To edit a metric list........................................................................................................................ 316 To copy a metric list...................................................................................................................... 316 To manage groups for a metric list ............................................................................................... 317 To delete a metric list.................................................................................................................... 318 About default profile options ............................................................................................................. 318 Data and license administration........................................................................................................ 318 To set profile defaults.................................................................................................................... 318 To upgrade your license ............................................................................................................... 319 To back up and restore Unica NetInsight data .............................................................................319 To move Unica NetInsight to another computer ...........................................................................320 To move Unica NetInsight to another computer without reimporting log file data ........................320 Troubleshooting NetInsight ............................................................................................................... 321 About Unica NetInsight system logs .............................................................................................321
18
To configure Unica NetInsight system logs ..................................................................................322 About the Unica NetInsight process log........................................................................................ 323
16 Working with Data Conduits ....................................................................................325 Conduits.................................................................................... 325

About the NetInsight data conduit..................................................................................................... 325 About deploying a data conduit ........................................................................................................ 326 About lookups versus rewrites.......................................................................................................... 326 To install the data conduit on Windows ............................................................................................327 To install the data conduit on UNIX .................................................................................................. 327 To set environment variables............................................................................................................ 327 About the data conduit configuration file .......................................................................................... 328 Using the APITest utility.................................................................................................................... 329 To use the APITest utility.............................................................................................................. 329 APITest command-line examples ................................................................................................. 331 Using the data conduit ...................................................................................................................... 332 To configure NetInsight to use a data conduit for rewrites and lookups.......................................333 To configure Unica NetInsight to use a data conduit for user authentication ...............................333 To configure NetInsight to use a data conduit for user information..............................................334 Example: How to configure a parameter lookup...........................................................................334 To regenerate summaries for a profile.......................................................................................... 338 Example: How to configure a cookie lookup.................................................................................339 Data conduit directives ..................................................................................................................... 341 About data conduit directives........................................................................................................ 341 Database and directory server connection string directives .........................................................341 About the clip, cookie, host, user, and visitor lookup directives ...................................................344 About parameter lookup directives ............................................................................................... 346 About department lookup directives.............................................................................................. 347 About page title lookup directives ................................................................................................. 348 About product directives ............................................................................................................... 349 About rewrite directives................................................................................................................. 350 User information directive ............................................................................................................. 351 User authentication directives....................................................................................................... 352 Debug directive ............................................................................................................................. 353 Unloadme directive ....................................................................................................................... 353
17 Working with User-Defined Processes ....................................................................354 Processes.................................................................... 354

Version 8.2.1 19
About user-defined processes .......................................................................................................... 354 How Unica NetInsight runs user-defined processes.........................................................................355 To configure Unica NetInsight to run a user-defined process ..........................................................355 About the <userdefinedprocesses> and <process> elements .........................................................356 Creating generic processes for multiple profiles...............................................................................357 User-defined process examples ....................................................................................................... 357 User-defined processes and database permissions.........................................................................359
18 Using Regular Expressions with NetInsight ............................................................ 360 ............................................................360

About regular expressions ............................................................................................................... 360 Basics of regular expressions........................................................................................................... 361 Metacharacters ................................................................................................................................. 361 Metacharacter examples................................................................................................................... 362 Special characters ............................................................................................................................ 363 Special character examples.............................................................................................................. 364 Combining metacharacters ............................................................................................................... 364 Using regular expressions ............................................................................................................... 365
19 NetInsight Command-Line Options ......................................................................... 367 .........................................................................367

About command-line options ............................................................................................................ 367 About regular expressions with command-line options ....................................................................368 Profile command-line options............................................................................................................ 368 -abort............................................................................................................................................. 369 -addreport filename [-title newtitle] [-rptlist listname] [-rptfolder foldername] ................................370 -alert .............................................................................................................................................. 370 -alerttask alertname ...................................................................................................................... 370 -archive YYYYMM......................................................................................................................... 371 -archive YYYYMM,YYYYMM ........................................................................................................ 371 -checkdb........................................................................................................................................ 371 -clear ............................................................................................................................................. 372 -compactdb filename..................................................................................................................... 372 -email ............................................................................................................................................ 373 -emailtask taskname ..................................................................................................................... 373 -expiretitles.................................................................................................................................... 373 -forget log_filename ...................................................................................................................... 374 -import .......................................................................................................................................... 374
20
-module ......................................................................................................................................... 375 -quiet ............................................................................................................................................. 376 -reaggregate.................................................................................................................................. 376 -reanalyze ..................................................................................................................................... 377 -recalc ........................................................................................................................................... 377 -recipients list ................................................................................................................................ 378 -regen............................................................................................................................................ 379 -reindex ......................................................................................................................................... 379 -reindex-missing............................................................................................................................ 379 -remove YYYYMM or YYYYMMDD .............................................................................................. 379 -remove YYYYMM,YYYYMM........................................................................................................ 380 -reports.......................................................................................................................................... 380 -reprofile ........................................................................................................................................ 381 -resample ..................................................................................................................................... 381 -reseed seed_number ................................................................................................................... 381 -resolvetitles .................................................................................................................................. 382 -samplecalc entity number ............................................................................................................ 382 -update .......................................................................................................................................... 382 Administrative command-line options ............................................................................................... 383 -add ............................................................................................................................................... 383 -addlang pathname_for_language_pack .......................................................................................385 -adduser user_name [-email emailaddress] [-fullname fullname] [-password password] [-role role] [-reportingmode reportingmode] ................................................................................................... 386 -assignuser user_name short_profile_name {[-role role_name] | [-view view_name]} ..................387 -changeuser user_name [-email emailaddress] [-fullname fullname] [-password password] [-role role] [-reportingmode reportingmode] ........................................................................................... 388 -clear ............................................................................................................................................. 389 -dbpasswd..................................................................................................................................... 389 -delete short_profile_name............................................................................................................ 390 -deleteuser user_name ................................................................................................................. 390 -dir dir............................................................................................................................................ 390 -list or -list %regex ........................................................................................................................ 391 -listroles......................................................................................................................................... 391 -listusers short_profile_name [-explicit] .........................................................................................391 -quiet ............................................................................................................................................. 392 Version 8.2.1 21
-roleinfo role_name ....................................................................................................................... 392 -userinfo user_name [-explicit] ...................................................................................................... 392
20 NetInsight Configuration Files ................................................................................. 393 .................................................................................393

About Unica NetInsight configuration files ........................................................................................393 NetTracker.cfg: NetInsight Program Configuration File ....................................................................393 About the Unica NetInsight configuration file................................................................................395 activationkey ................................................................................................................................. 396 adminbutton .................................................................................................................................. 396 adminemail.................................................................................................................................... 396 authentication................................................................................................................................ 396 backgrounddrilldowns ................................................................................................................... 397 cachesize ...................................................................................................................................... 397 cgidir.............................................................................................................................................. 397 cgiextension .................................................................................................................................. 398 cgiurl.............................................................................................................................................. 398 checkpointmegs ............................................................................................................................ 398 database ....................................................................................................................................... 398 datastoredir ................................................................................................................................... 399 dbconnect...................................................................................................................................... 399 dbpassword................................................................................................................................... 400 dbsessionoptions .......................................................................................................................... 400 dnsserver ...................................................................................................................................... 400 disablehtmlwithlinks ...................................................................................................................... 401 email.............................................................................................................................................. 401 envvars.......................................................................................................................................... 402 helpurl ........................................................................................................................................... 402 homepagebutton ........................................................................................................................... 402 htmldir ........................................................................................................................................... 403 htmlurl ........................................................................................................................................... 403 httpproxy ....................................................................................................................................... 403 indextablespace ............................................................................................................................ 403 license ........................................................................................................................................... 404 locale............................................................................................................................................. 404 logbrowsing ................................................................................................................................... 405
22
logformats ..................................................................................................................................... 405 loginexpiration ............................................................................................................................... 405 mailfrom ........................................................................................................................................ 406 mailserver...................................................................................................................................... 406 maxcache...................................................................................................................................... 406 maxcompletedperuser................................................................................................................... 407 maxdnsrequests............................................................................................................................ 407 maxqueuedlines ............................................................................................................................ 408 maxrunningglobal.......................................................................................................................... 408 maxrunningperuser ....................................................................................................................... 408 method .......................................................................................................................................... 409 network.......................................................................................................................................... 409 pagesize........................................................................................................................................ 409 passiveftp ...................................................................................................................................... 410 pathsep ......................................................................................................................................... 410 platform ......................................................................................................................................... 410 plugin............................................................................................................................................. 411 processlog element....................................................................................................................... 411 progdir ........................................................................................................................................... 411 reportinbox .................................................................................................................................... 411 reportlimits..................................................................................................................................... 412 reportsduringimport ....................................................................................................................... 412 reportsduringupdate ...................................................................................................................... 413 restrictprofilemanager ................................................................................................................... 413 resultsetretention........................................................................................................................... 413 runreportscheduler ........................................................................................................................ 414 secure ........................................................................................................................................... 414 serialnumber ................................................................................................................................. 414 source ........................................................................................................................................... 415 syncmode...................................................................................................................................... 415 tempstore ...................................................................................................................................... 415 tempstoredir .................................................................................................................................. 416 titleresolutiontimeout ..................................................................................................................... 416 Web.cfg : Global Profile Configuration File ......................................................................................416
Version 8.2.1
23
About the global profile configuration file......................................................................................419 aggdeffile....................................................................................................................................... 419 aggsrequired ................................................................................................................................. 420 bannerads ..................................................................................................................................... 420 browsers........................................................................................................................................ 420 campaigns..................................................................................................................................... 421 casesensitivepages....................................................................................................................... 422 casesensitiveusernames............................................................................................................... 422 connection..................................................................................................................................... 422 contentgroups ............................................................................................................................... 423 converttimes.................................................................................................................................. 423 cookielookup ................................................................................................................................. 424 custommetrics ............................................................................................................................... 424 dashboardsize............................................................................................................................... 426 daterange ...................................................................................................................................... 426 defaults.......................................................................................................................................... 426 departments .................................................................................................................................. 427 dimensionlists................................................................................................................................ 428 dimensionsfile ............................................................................................................................... 429 dirindexes...................................................................................................................................... 429 dmpackages.................................................................................................................................. 429 donotconverttimes......................................................................................................................... 430 dynamicpages ............................................................................................................................... 430 element ......................................................................................................................................... 431 emailalerts..................................................................................................................................... 431 emailtasks ..................................................................................................................................... 433 entity.............................................................................................................................................. 435 excludedagents ............................................................................................................................. 435 excludedhosts ............................................................................................................................... 436 excludedpages .............................................................................................................................. 436 excludedparametervalues ............................................................................................................. 437 excludedusers ............................................................................................................................... 437 filtergroups .................................................................................................................................... 437 filterinstances ................................................................................................................................ 438
24
filterlists ......................................................................................................................................... 444 ftpdebug ........................................................................................................................................ 446 hidelinks ........................................................................................................................................ 446 hostgroups .................................................................................................................................... 446 hostlookup..................................................................................................................................... 447 ignoredfields.................................................................................................................................. 447 includedagents .............................................................................................................................. 448 includedhosts ................................................................................................................................ 448 includedpages ............................................................................................................................... 449 includedparametervalues .............................................................................................................. 449 includedusers ................................................................................................................................ 449 keywordrules ................................................................................................................................. 450 levels ............................................................................................................................................. 451 linklength ....................................................................................................................................... 451 locale............................................................................................................................................. 452 localkeywords................................................................................................................................ 452 logs................................................................................................................................................ 453 maildebug...................................................................................................................................... 454 maxpathlength............................................................................................................................... 454 member ......................................................................................................................................... 454 metriclists ...................................................................................................................................... 455 metricsfile ...................................................................................................................................... 456 module .......................................................................................................................................... 456 modules......................................................................................................................................... 457 nodefaultautoupdate ..................................................................................................................... 458 nodefaultautoupdatefull................................................................................................................. 458 nodefaultautoupdatesample.......................................................................................................... 459 noimportreindex ............................................................................................................................ 459 nonreportabledimensions.............................................................................................................. 459 notableanalysis ............................................................................................................................. 460 ntadtrack ....................................................................................................................................... 460 ntdi ................................................................................................................................................ 460 ntlinktrack ...................................................................................................................................... 461 outdefext ....................................................................................................................................... 461
Version 8.2.1
25
parameters .................................................................................................................................... 461 password....................................................................................................................................... 463 platforms ....................................................................................................................................... 463 precalcdates.................................................................................................................................. 464 redirectscripts................................................................................................................................ 465 referrergroups ............................................................................................................................... 465 reportlists....................................................................................................................................... 466 resolvehosts .................................................................................................................................. 467 referrergroups ............................................................................................................................... 467 resolvetitles ................................................................................................................................... 468 retrievebatchsize ........................................................................................................................... 468 roledefaults.................................................................................................................................... 468 rows............................................................................................................................................... 468 sampling........................................................................................................................................ 469 schemafile ..................................................................................................................................... 469 securityrealms ............................................................................................................................... 469 seed .............................................................................................................................................. 470 segment ........................................................................................................................................ 470 servers .......................................................................................................................................... 471 sessionization................................................................................................................................ 472 siteurl............................................................................................................................................. 473 spiders........................................................................................................................................... 473 summarysize ................................................................................................................................. 474 tagimages...................................................................................................................................... 474 title................................................................................................................................................. 474 titlelength....................................................................................................................................... 475 titles............................................................................................................................................... 475 unexcludedpages .......................................................................................................................... 476 unresolvedtitles ............................................................................................................................. 476 url .................................................................................................................................................. 476 urlsearchrules................................................................................................................................ 477 user ............................................................................................................................................... 478 userlookup..................................................................................................................................... 478 variablesfile ................................................................................................................................... 478
26
viewlist........................................................................................................................................... 478 virtual............................................................................................................................................. 480 visitorlookup .................................................................................................................................. 480 visitorprofiles ................................................................................................................................. 481 visitthreshold ................................................................................................................................. 481 writebatchsize ............................................................................................................................... 482
Version 8.2.1
27
N10010
Preface
N40001
Contacting Unica technical support

If you encounter a problem that you cannot resolve by consulting the documentation, your companys designated support contact can log a call with Unica technical support. Use the information in this section to ensure that your problem is resolved efficiently and successfully. If you are not a designated support contact at your company, contact your Unica administrator for information.
Information you should gather

Before you contact Unica technical support, you should gather the following information: A brief description of the nature of your issue. Detailed error messages you see when the issue occurs. Detailed steps to reproduce the issue. Related log files, session files, configuration files, and data files. Information about your product and system environment, which you can obtain as described in "System Information" below.
System information
When you call Unica technical support, you might be asked to provide information about your environment. If your problem does not prevent you from logging in, much of this information is available on the About page, which provides information about your installed Unica applications.
28
You can access the About page by selecting Help > About Unica If the About page is Unica. not accessible, you can obtain the version number of any Unica application by viewing the version.txt file located under each applications installation directory.
Contact information for Unica technical support

For ways to contact Unica technical support, see the Unica Product Technical Support website: (http://www.unica.com/about/product-technical-support.htm).
Version 8.2.1
29
N10018
1 Introduction to Unica NetInsight

N50001
About Unica NetInsight About data collection methods The stages of Web site tracking About Unica NetInsight reports About profiles
About Unica NetInsight

Unica NetInsight provides the critical information and insight you need to improve web site design, internet marketing effectiveness, and your customer's experience. Using Unica NetInsight, you can identify which content is popular and which is ignored. You can see where users are dropping off your site. Unica NetInsight lets you analyze online campaigns (including media buys, email, and search engine marketing) and offline campaigns (including direct mail, catalog, and call center activities). You can even analyze the response to campaigns across channels.
N60001
About data collection methods

NetInsight lets you choose the most appropriate data collection method, whether it is log files, page tags, or a hybrid approach. You can change your data collection method at any time. The following tables show comparisons of data collection methods.
30
About data collection methods
Information captured
Page Tagging Log Files Measure events in Web 2.0 rich Internet applications built with Ajax or Flash Default Web Server Log Files Monitor paths and drop-off points of search engine robots that index your site to help you with search engine optimization Capture click fraud activity that does not execute JavaScript and remains invisible to page tags Monitor page delivery performance, abandoned page views, and incomplete downloads Securely capture http user names
Measure behavior within Web pages, such as scrolling down or changing form fields Measure shopping cart activity
Measure client side information, such as the browser's screen size, etc. Capture additional information items such as user login names or form field data that are passed through customized tags
Convenience
Page Tagging Log Files Reduce Web server log file management Default Web Server Log Files Load historical information from before page tagging Avoid the effort of modifying your Web pages and scripted pages for inserting tags and then acceptance testing the modifications
Avoid log file transfer from disparate Web server farms
Measure traffic on portions of your site embedded Avoid the effort of monitoring your site for pages in other Web sites where you don't have access to that are missing page tags logs
Accuracy
Page Tagging Log Files Track page views even if they were cached in ISP proxy servers Default Web Server Log Files Measure views, for example, of your PDF documents that were directly found and clicked from Google Measure sessions of mobile browsers which may not fire JavaScript page tags
Track page views following a click on the browser's back button
Version 8.2.1
31
1 - Introduction to Unica NetInsight
Page Tagging Log Files
Default Web Server Log Files Measure page views even if the viewer clicked on to the next page before the page tag fired
N70001
The stages of Web site tracking

Web site tracking consists of four stages: 1. Data Gathering The data gathering stage consists of parsing your web server's log Gathering: files or your page tag data (or both, if you use a hybrid approach). For Unica NetInsight to work, you must have access to your web server's log files or your page tag server's log files. Your webmaster, ISP, or the person managing your page tag server should be able to help you gain access to these files. 2. Data analysis Once the data has been gathered, it needs to be analyzed. During analysis: the data analysis stage, complex heuristics are applied to the raw data to sessionize the data into visits and page views instead of simply hits. Once the data has been analyzed, it is placed in a database to facilitate reporting. 3. Report generation The third stage of Web site tracking is generating reports generation: (including graphs) from the analyzed data. During this stage, the analyzed visit and page view data is read from the database and tabulated into many different reports, each answering a specific question. For example, a report on what people viewed on a Web site might consist of the pages that were viewed, how many times each page was viewed, and how long, on average, visitors spent looking at each page. 4. Acting on the data The final stage of Web site tracking is acting on the data. During data: this stage, you make modifications to your web site or marketing based on the Unica NetInsight analysis. For example, you improve the layout of your site to help customers answer their questions more quickly, adjust bids on keywords to maximize your ROI, or follow up with visitors who have abandoned a conversion process on your site.
N80002
About Unica NetInsight reports

Unica NetInsight contains more than 100 pre-defined reports. These range from dashboard reports that present quick views of key trends, to breakdown reports that provide detailed statistics on specialized areas of interest. Unica NetInsight graphs report data and lets you switch reports between different graph types. You can use the drag-and-drop interface to filter and modify Unica NetInsight reports. You can create custom reports of your own. Your custom reports can be saved and added to the list of reports Unica NetInsight updates regularly. You can access Unica NetInsight reports via an intranet or remotely via the Internet. You can configure Unica NetInsight to email reports, ensuring that key managers have the up-to-date information they need as soon as a Unica NetInsight update is complete.
32 Unica NetInsight - Administrator's Guide
About Unica NetInsight reports
Unica NetInsight reports contain drilldown capabilities that let you dynamically link to additional relevant information. You can maintain this feature in reports you email to others. Report data can be exported for use in popular software packages such as Microsoft Excel, Access, and Word, as well as other Unica applications. Unica NetInsight comes with these built-in reports: 3-digit Zip Code Summary 5-digit Zip Code Summary Area Code Summary Banner Ad Summary Browser Breakdown Browser Summary Campaign Channel Summary Campaign Channel Type Summary Campaign Segment Summary Campaign Summary Cart Activity Trend City Summary Clickthrough Breakdown Connection Type Summary Content Dashboard Content Summary Continent Summary Cookie Summary Country Summary Date Summary Day of the Week Summary Department Summary Directory Summary DMA Summary Domain Summary Entry Page Breakdown Entry Page Summary Error Breakdown
Version 8.2.1 33
1 - Introduction to Unica NetInsight
Error Summary Executive Dashboard Exit Page Breakdown Exit Page Summary Geographic Dashboard Host Summary Impression Breakdown Initial Referrer Breakdown Initial Referrer Summary Keyword Summary Link Breakdown Link Summary Local Keyword Summary Marketing Dashboard Organization Summary Page Breakdown Page Delivery Summary Page Summary Page View Summary Paid Keyword Summary Paid Search Campaign Channel Summary Paid Search Campaign Channel Types Summary Paid Search Campaign Segment Summary Paid Search Campaign Summary Paid Search Paid Keywords Summary Path Summary Platform Summary Product Abandonment Summary Product Action Summary Product Conversion Summary Referrer Breakdown Referrer Summary Repeat Visitor Summary
About profiles
Retail Dashboard Revenue Trend Robot/Spider Breakdown Robot/Spider Summary Robot/Spider View Breakdown Robot/Spider Visit Breakdown Screen Resolution Summary Server Performance Summary Server Summary Spider Executive Dashboard State/Province Summary Technical Dashboard Time Summary Time Zone Summary Traffic Dashboard Traffic Summary User Summary View Breakdown Visit Breakdown Visit Duration Summary Visitor Dashboard Visitor Profile Summary Visitor Retention Summary Visitor Summary
N90001
About profiles
A profile is a collection of reports that analyze the same Web site. You can create a single profile to analyze an entire Web site. Or, if you have a large Web site with several different areas, you can create different profiles for different sections of the site.
Version 8.2.1
35
N10036
2 Connecting to and Using the NetInsight Interface

NA0002
About Unica NetInsight logons To log on to NetInsight To connect to other Unica applications from Unica NetInsight To change your user password in NetInsight To change your user password in Unica Marketing Platform Viewing profiles and reports Using the NetInsight Homepage
About Unica NetInsight logons

Use the Profile Manager to determine whether Unica NetInsight requires users to log on to access NetInsight. When you access Unica NetInsight for the first time using the installation URL, you are directed to the logon page, even though you do not have a username and password. To bypass this page, access the Profile Manager by appending admin/index.html to the NetInsight URL. For example: http://www.yourdomain.com/NetInsight/admin/index.html From the Profile Manager, you can define user accounts to restrict access to profiles by user, and you can restrict access to the Profile Manager. To avoid being accidentally locked out, create the NetInsight Administrator first so that you can log on with full privileges. For information about configuring Unica NetInsight authentication, see the NetInsight System Administration chapter.
NB0001
36
To log on to NetInsight
To log on to NetInsight
1. In your Web browser, enter the Unica NetInsight URL. The Unica NetInsight User Logon page appears. 2. In the User name box, enter your user name. (The user name is case-insensitive.) 3. In the Password box, enter your Unica NetInsight password. 4. Click Log on on.
NC0001
To connect to other Unica applications from Unica NetInsight

Follow the instructions below when you are logged into a Unica NetInsight installation that authenticates users through Unica Marketing Platform and you want to open another installed Unica component in a new browser. 1. In the upper-right corner, click Unica The menu expands to show links for each Unica. Unica application installed. 2. Click the link for the application you want to open.
ND0001
To change your user password in NetInsight

If your Unica NetInsight installation is configured to authenticate users against an internal database, you change your password in Unica NetInsight. If Unica NetInsight is configured to use an external database or the Web server for authentication, you will need to consult the database or Web server documentation for details on how to change your password. 1. Display your Unica NetInsight Homepage. 2. Click the Options tab. 3. In the Options panel, select Preferences > Password Password. 4. In the Old password box, enter your current Unica NetInsight user password. 5. In the New password box, enter the password you want to use. 6. In the New password (again) box, re-enter the new password. 7. Click Save Options and then click Continue Continue.
NE0001
Version 8.2.1
37
2 - Connecting to and Using the NetInsight Interface
To change your user password in Unica Marketing Platform

If Unica NetInsight is configured to use Unica Marketing Platform for authentication, you change the password in Unica Marketing Platform. If Unica NetInsight is configured to use an external database or the Web server for authentication, you will need to consult the database or Web server documentation for details on how to change your password. 1. Open Unica Marketing Platform. 2. Log in using your existing password. 3. Enter and confirm the new password, following the password rules established for Unica Marketing Platform. 4. Save the new password.
NF0001
Viewing profiles and reports

NF000A
About the Unica NetInsight interface About the Profile Manager screen About the Profile screen To set the default profile About the geographic report interface
About the Unica NetInsight interface

This section describes the Unica NetInsight interface methods for navigating in Unica NetInsight. There are two sections of Unica NetInsight: the Profile Manager and the individual profiles. A profile is a collection of reports that analyze the same site. Note: If you are using a Unica NetInsight installation that authenticates users, see instruction for using the Unica NetInsight homepage.
N110001
About the Profile Manager screen

When you start Unica NetInsight, it opens to the Profile Manager. This is where you can view, create, edit, and remove profiles. It is also where you can set global administrative options that apply to all of your Unica NetInsight profiles. If you are concerned about the security of your profiles, use your Web servers security features to protect the Profile Manager; setting the Unica NetInsight password option for a profile will not prevent users from deleting, editing, or creating profiles in the Profile Manager itself. You can also restrict access to the Profile Manager using administrative options.
Viewing profiles and reports
The Profile Manager screen contains these controls:

Control Name Profiles tab Description Use the Profiles tab to view, create, edit, and remove profiles. Use the Options tab to edit the administrative options, set default profile options, or upgrade your Unica NetInsight license. Use the Homepage icon to display your list of customized profiles (for logged in users) or the login page (if you are not logged in). Use the Help link to view help for the current page.
Options tab
Homepage icon
Help link
N120001
Version 8.2.1
39
About the Profile screen
Once you select a profile and click View Profile, you leave the Profile Manager and enter the profile screen (pictured above set to the Options tab). The Profile screen contains these controls:
Control Name Reports tab Description Use the Reports tab to view the reports that contain this profiles data. Use the Inbox tab to view reports you requested. Use the Custom tab to create new reports. Use the Archive tab to view archived reports. Use the Options tab to set the options for the profile, remove data from the profile, and remove archived reports. Use the Reporting Mode drop-down to specify whether reports should include all data generated during the last profile update or a sampled subset of that data.
Inbox Custom tab Archive tab Options tab
Reporting Mode drop-down list
40
Viewing profiles and reports Control Name Unica NetInsight Options drop-down list Description When you select the Options tab, the Unica NetInsight Options drop-down list displays. Use items from this list to edit your profile options, remove archived reports, or remove data from the profile.
About the Reports Tab

When you select the Reports tab from the Profile screen, the screen switches to the report view. The Reports display consists of three panels: the Reports Selection panel (on the left) where you select the report you want to display; the Report panel (center) which displays the selected report; and the Discovery panel (right), which you can use to add and remove filters, metrics, and dimensions to a report. The Discovery panel only displays when you select the Discovery panel command.
About the Report Selection panel

The Report Selection panel on the Reports tab lists all available reports.
Version 8.2.1
41
2 - Connecting to and Using the NetInsight Interface Panel Section Calendar Description You can use the calendar to specify the time period whose data you want to see in a report. By default, the data from the latest month for which the profile has data is used. Available reports are listed and grouped by category (for example, Marketing Analysis, Content Analysis). To expand a category, click the plus (+) sign next to its name. If the profile contains multiple views, the Change View icon appears in the report list title bar. Clicking it displays a list of all the views available for the profile. Click the Close button to close the list of views.
Report List
About the Report panel

The Report panel on the Reports tab displays the current report. The top line displays the name of the profile and the name of the report on the left, and the time period whose data is being displayed on the right. If any filters have been applied to this report, they will be listed on the next line. (Date filters are usually not listed with the other filters. Instead, date filters change the time period listed on the top line.) The next part of the report is the graph. (A graph is not available on all reports.) You can click an item in the graph to display a breakdown report for that item. The graph title displays to the upper left of the graph. The report data appears below the graph. A small triangle indicates the column by which the report is sorted, and whether the data is sorted in ascending or descending order. To change the column by which a report is sorted, click another column name. To change the sort order of a column, click the column name, or right-click and select a sort order. To move a column, click and drag it to a new location. The last part of the report is the page help, which provides a definition for each column in the report.
The Report panel contains these command icons:

Icon Data Set icon Description You can change which report column is being graphed by clicking the Data Set icon on the far right of the graph title bar.
42
Viewing profiles and reports Icon Graph Type icons Description The graph type icons are to the upper right of the graph, in the graph title bar. Use these icons to choose the type of graph you want. Basic options include Bar Chart, Pie Chart, and Line Chart. A Funnel Chart option is also available. For scenario reports, and some report types may have an additional graph type. Not all the options are available for all reports. Below the report data are six icons for Search, First, Previous, Next, Last, and Rows. Use the Search icon to enter criteria for the report items you want to find. You can only search the data in the left-most column (not counting the row number). Use the Rows icon to change the number of rows that display on each page of the report.
Search, Record, and Rows icons
About the Discovery panel

The Discovery panel on the Reports tab displays lists of filters, metrics, and dimensions you can apply to the current report. To open the Discovery panel, click the Discovery panel command in the toolbar. To close the Discovery panel, click the command again. Filters, metrics, and dimensions are grouped separately and arranged by category within those groups (for example, Marketing Analysis, Content Analysis). Use the up/down arrows and plus/minus buttons to expend or contract groups and their categories. To add a filter, metric, or dimension to a report, drag it from the Discovery panel and onto the report, or click it in the Discovery panel. Most filters require you to enter some additional information to define the filter. To remove a filter, metric, or dimension, drag it off of the report and onto the Discovery panel. The lists in the Discovery Panel update based on the items you add to or remove from the report.
About the Profile Options tab

Use the Options tab to set configuration options for a profile. The Unica NetInsight Options drop-down list that displays on the Options tab lets you remove archived reports and data from the profile.
About the Unica NetInsight toolbar

The Unica NetInsight toolbar includes the following command commands. Depending on your privileges, not all of these commands may be available to you. Commands are listed below in the order they appear left to right.
Version 8.2.1
43
2 - Connecting to and Using the NetInsight Interface Name Update Description Use the Update command to update the profile with any new data in your log files and to regenerate the reports. Use the Calendar command to toggle display of the calendar on and off. Use the Selected Groups command to toggle display of the group selection box on and off. Use the Discovery Panel command to display or hide the Discovery panel. The Discovery panel lets you narrow the results displayed in the current report to a subset of the data or add metrics or dimensions to the current report. This command is only available on the Reports tab. Use the Sticky Filters command to turn sticky filters on or off. When filters are sticky, any currently-applied filters are kept and re-applied when you switch to a new report. When filters are not sticky, filters from one report do not carry over to another report. This command is only available on the Reports tab. Use the Comparative Reports command to display a second calendar so you can specify two time periods and view the data for both time periods side-by-side in one report. This command is only available on the Reports tab. Use the A/B Testing command to display two filter areas on the report so you can use drag-and-drop to create two sets of filters and view the report data using each set of filters side-by-side in one report. This command is only available on the Reports tab. Use the Report Designer command to display the Report Summary page, where you can edit the report. This command is only available on the Reports tab.
Calendar
Selected Groups
Discovery Panel
Sticky Filters
Comparative Reports
A/B Testing
Report Designer
44
Viewing profiles and reports Name Export Description Use the Export command to display the Export options dialog box so you can export the report data to a spreadsheet, database, or word processor. This command is only available on the Reports and Archive tabs. Use the Email command to display the Email options screen so you can specify a recipient and report format and email the current report. This command is only available on the Reports tab. Use the Print command to print the current report. This command is only available on the Reports and Archive tabs. Use the Default Report command to display an authenticated users default report (if one has been set) or to display the first report in the first folder of the current report list (if a default report has not been set). This command will not appear for unauthenticated users. Use the Homepage command to close the profile and display your customized list of profiles (for logged in users) or the login page (if you are not logged in). This command will not appear if it has been disabled in the administrative options. Use the Administration command to close the profile and open the Profile Manager. This command will not appear if it has been disabled in the administrative options.
Email
Print
Default Report
Homepage
Administration
N130002
To set the default profile

If you are an authenticated user you can define a default profile for yourself. When you define a default profile, that profile opens automatically when you log in to Unica NetInsight. When viewing the Unica NetInsight Homepage, you can go to your default profile by clicking the Default Profile icon. If you also define a default report for your default profile, your default profile opens automatically to that report. Your default profile is indicated on the Homepage by a lighted star icon next to its title. This icon will not appear if it has been disabled by your administrator. To set your default profile: 1. Open the Unica NetInsight Homepage.
Version 8.2.1 45
2. To: a. Set your default profile, click the star icon next to the profile you want as your default. The icon lights, indicating it is now the default. b. Change your default profile, click the star icon of the profile you want as your new default. c. Clear the setting so that you have no default profile, click the star icon of your current default. The icon unlights.
N140001
About the geographic report interface

If your Unica NetInsight installation includes the geographic database, geographic reports that include map graphs are available to you. The Unica NetInsight geographic database is available for download from Unica Customer Central.
Map graphs include the following functionality to aid navigation:

Action Zooming Description To zoom in and out, use the plus and minus buttons in the upper left corner of the graph. To select and zoom to a particular area of the map, click and drag over that area while holding down the Shift key. To return the map to its default zoom level, click the box between the plus and minus buttons.
Resetting the zoom level
46
Using the NetInsight Homepage Action Panning Description To pan the map, click and drag while holding down the Ctrl key.
Changing the Controls for changing the metric range displayed by a map are located at the map's metric range bottom of each map. To change the metric range, enter values for lower and upper bounds in the range text fields OR click and drag either end of the range bar towards the center OR click the center of the range bar and drag it left or right. After changing the range values, click the Apply Metric Range link to apply the new values to the map. Viewing city details City reports include city bubbles." The size of a citys bubble is proportional to the number of visitors from that city. To view the name of a city, hover your pointer over its bubble.
N100001
Using the NetInsight Homepage

N10000A
About using the Unica NetInsight Homepage To view a profile as an authenticated user About using Unica NetInsight documentation as an authenticated user About the Unica NetInsight Homepage To change your default view and reporting mode for a profile
About using the Unica NetInsight Homepage

If you are an authenticated Unica NetInsight user, you will usually access your Unica NetInsight profiles through your Unica NetInsight Homepage instead of through the Profile Manager. If your Unica NetInsight administrator has given you the ability to manage your account, you will access these options from the Unica NetInsight Homepage as well.
N150001
To view a profile as an authenticated user

The method for viewing a profile differs for authenticated Unica NetInsight users. To view a profile as an authenticated Unica NetInsight user: 1. Display your Unica NetInsight Homepage. 2. Click the name of the profile you want to view. Depending on the privileges your NetInsight administrator gave you, some icons and options may not appear in your interface.
N160001
Version 8.2.1
47
About using Unica NetInsight documentation as an authenticated user

The instructions in the Unica NetInsight documentation assume you are using the default interface, which does not include authenticated users. As an authenticated user, you will need to make some adjustments. First, whether an option is available to you depends on the privileges your Unica NetInsight administrator has given you. Some options and icons described in the manual may not appear in your interface. Second, your method for viewing a profile will differ from that for unauthenticated users. See the instructions for viewing a profile as an authenticated user.
N170001
About the Unica NetInsight Homepage

The Profiles tab on the Unica NetInsight Homepage contains a table listing the title and name of each profile you have permission to access. From the Unica NetInsight Homepage you can do the following:
Option Sorting profiles Description The column by which the profile list is sorted is indicated by a small triangle to the right of the column heading. If the triangle is pointing down, the list is sorted in descending order. If the triangle is pointing up, the list is sorted in ascending order. You can sort the list by any column in the table by clicking the column heading. By default, the list will be sorted on the data in the new column in descending order. Click the column heading again to sort the data in ascending order. To view a profile, click the profile name or title. Click the Rows icon to change the number of profiles that display on a page. If your list of profiles spans multiple pages, there will be four arrow icons that allow you to move from page to page. These buttons are First, Previous, Next, and Last. To log out of Unica NetInsight, click Logout in the upper-right corner of the screen. Note: Logout does not appear if Unica NetInsight is configured to authenticate users using Web server authentication. Click the Inbox tab.
Viewing profiles Changing the number of profiles displayed Displaying additional profiles
Logging out
Accessing the reports you have requested
Changing your password, default If your Unica NetInsight administrator has given you permission to view or reporting mode, or Inbox change your password, your default views or reporting mode for preferences profiles, or your Inbox preferences, an Options tab will appear next to the Profiles tab in the upper-left corner of the screen. 48 Unica NetInsight - Administrator's Guide
Using the NetInsight Homepage

N180001
To change your default view and reporting mode for a profile

If your Unica NetInsight administrator has given you permission, you can change the default view and reporting mode for any profile to which you have access. (The default view controls which reports, dimensions, filters, and metrics are available, and how these are grouped within their lists. The reporting mode determines whether the reports show all the profile data or projections based on a data sample.) The default view and reporting mode you specify from the Homepage will take precedence over a default view or reporting mode specified anywhere else. 1. Display your Homepage. 2. Click the Options tab. 3. In the Options panel, select Preferences > Default Views Views. 4. Select the profile for which you want to specify a default view and click Continue Continue. 5. In the Default view box, select the view you want from the list of views. 6. In the Default reporting mode box, select the reporting mode you want from the list. 7. Click Save Options and then click Continue Continue. Profiles for which a default view has been specified will be listed first and will be followed by an asterisk.
Version 8.2.1
49
N10090
3 Creating and Configuring Profiles

N190002
About profiles Configuring Database Connections Updating data in a profile To create a profile Restricting access to profiles Filtering profiles
About profiles
A profile is the basic unit of organization within NetInsight. In it's simplest sense, a profile is a collection of reports that examine a particular web site. You can further shape a profile by the filters, views, permissions, and other customizations you define for it. There is no limit to the number of profiles you can create. While it is common to create a single profile for each web site you want to report on, you can also create multiple profiles for a single site. For example, if your site contains subdomains, you may want to create a separate profile for each.
N1A0002
Configuring Database Connections

N1A0009
About database connections To configure a database connection Example database connection XML
50
Configuring Database Connections
About database connections

Each profile requires a connection to a database. When you install Unica NetInsight , it creates a default database connection, named _default using the database information _default, that you supplied during the installation process. If you have other databases or database logins that you want to use for different profiles, you must configure these additional connections manually by adding the appropriate XML to the NetTracker.cfg file.
N1F0002
To configure a database connection

Follow these steps to configure a database connection. 1. Open the NetTracker.cfg file in a text editor. 2. In the <database> container element under <connections>, add a child element <connection> for each of the database connections you want to add. Follow the correct syntax for your database type (see the examples). 3. If your connection uses a password, follow these steps to set the password in the connection XML: a. Copy the encrypted password from the _default connection and use this as the value of the <password> element for the new connection. b. Run the following command: nettracker admin -dbpasswd <new_connection_name> c. When you are prompted for the old password, enter the password for the _default connection. d. Set the password for the new connection. 4. Save the NetTracker.cfg file. When you create a profile, the connections that you added to NetTracker.cfg will be available.
N200002
Example database connection XML

Follow these examples for the supported dabase types.
DB2
<connections> <connection name="_default" type="db2"> <user>username</user> <password>encrypted_password</password> <driver>{IBM DB2 ODBC DRIVER}</driver> <dbalias>dbalias</dbalias> </connection> </connections>
Version 8.2.1
51
3 - Creating and Configuring Profiles
Oracle
<connections> <connection name="_default" type="oci"> <user>username</user> <password>encrypted_password</password> <service>service</service> </connection> </connections>
SQL Server (with Windows authentication)

<connections> <connection name="_default" type="mssql"> <driver>{SQL Server}</driver> <database>database_name</database> <server>server_name</server> </connection> </connections>
SQL Server (with username/password)

<connections> <connection name="_default" type="mssql"> <user>username</user> <password>encrypted_password</password> <driver>{SQL Server}</driver> <database>database_name</database> <server>server_name</server> </connection> </connections>
N1B0001
Updating data in a profile

N1B000A
About deleting profile data To delete profile's data To update a profile's data
52
Updating data in a profile
About deleting profile data

As necessary you can delete data for one or more months from a profile. When you delete data, it is permanently removed from the database. If you think you might need data again at some point in the future, before you delete it make sure you have its log file source. When you delete profile data, you have the option of archiving it. Archiving data means users can continue to view reports that contain the data. However, because the data is no longer in the database, they cannot drill into the archived reports--archived reports have no links. When you delete data, it is removed from both the sample tables and the full tables, regardless of a profile's current reporting mode. If you are using an integration module, the module data for the selected months is also deleted from the database. Depending on how old the data is, it may not be available to add to the profile in the future.
N210002
To delete profile's data profile'

Deleting data for all months from a profile deletes all of the profile's data. When you delete profile data, it is removed from both full and sample tables regardless of the profile's current reporting mode. Because deleting profile data removes information on unique visitors, it will affect the identification of new and repeat visitors when you subsequently import new data. To delete data from a profile. 1. View the profile from which you want to remove data. 2. Click the Options tab. 3. From the NetInsight Options drop-down list select Remove Data from Profile Profile. The Remove Data from Profile screen opens. 4. If your installation requires authentication to remove profile data, you will be prompted for a password. Type the password and click Enter Enter. 5. If you only want to remove data for certain months, select those months. 6. If you want to still be able to view the reports for the months whose data you are deleting, check the Archive data box. Otherwise, clear Archive data data. 7. To delete data for the selected months, click Remove Selected Months Otherwise, Months. to delete data for all months, click Remove All Months Months.
N220001
Version 8.2.1
53
To update a profile's data profile'

To import the latest data from your web server log files into a profile, you run an update on the profile. In addition to importing data, updates are also required in order for changes to certain profile options to take effect. In addition. You can trigger profile updates manually, or you can schedule updates to occur automatically at regular intervals. To update a profile manually: 1. Open the profile you want to update. 2. On the toolbar, click the Update icon.
N1C0002
To create a profile
When you create a profile, you must specify at least a profile name and title, and a log file location and format. The procedure below is only for single servers. 1. Display the list of profiles at the Profile Manager. 2. Click Create Profile Profile. 3. In the Short profile name (one word) box, enter the name that will be used for files associated with this profile. 4. In the Database connection box, select the database connection you want to use for this profile. 5. Click Continue Continue. 6. Enter the profile title (which will appear at the top of all the reports) and the URL of the site you want to analyze. Click Continue Continue. 7. In the Location of log file(s) list, select an option. If your logs are located on the computer that is running Unica NetInsight, or are available on the local network, select Local/network file system system. If your logs are available via FTP and you want Unica NetInsight to retrieve them for you, select FTP server server. 8. In the Format of log file(s) list, select the format of the log file. Select Auto Detect to have Unica NetInsight determine your log format automatically. If your log files are in a nonstandard format, you must first manually specify the log file format. Unica NetInsight can process log files that have been compressed using gzip. 9. Do one of the following: a. If you selected Local/network file system enter the log file path and file name in system, the Full path to log file(s) box.
To create a profile
You may use the wildcard character "*" to specify multiple files. You may also click Browse to find the file. The Browse button does not appear if it has been disabled in the administrative options. b. If you selected FTP server click Browse and enter the following information server, about the FTP server from which you will be downloading the log files. Host name The name of the server (yourdomain.com not name: yourdomain.com, ftp://yourdomain.com ) User name Your user name for the FTP server. If you access the server name: anonymously, leave this blank. Password Your password for the FTP server. If you access the server Password: anonymously, leave this blank. Password (again) The same password you entered above. (again): Initial path The directory in which the log file can be found on the server. path: When you have entered the information about the FTP server, click Browse to select the log file.
10. Click Add Add. 11. If you have other log files you want to analyze, click Continue If you have entered Continue. all of your log files, click View Profile Profile. 12. After clicking View Profile click the Update icon, which is the left-most icon in the Profile, icon group, to generate the reports for this profile.
N230001
To create a profile to analyze logs from clustered servers

If the log files you want to analyze come from clustered servers, the procedure for creating a profile is somewhat different than for single servers. To create a profile to analyze logs from clustered servers: 1. Display the list of profiles at the Profile Manager. (For details, see instructions for displaying the list of profiles.) 2. Click Create Profile Profile. 3. In the Short profile name (one word) box, enter the name that will be used for Unica NetInsight files associated with this profile. 4. Click Continue Continue. 5. Enter the profile title (which will appear at the top of all the reports) and the URL of the site you want to analyze, and click Edit Profile Profile. Unica NetInsight opens the profile options for this profile. Now you need to point Unica NetInsight to the log files you want to analyze. 6. In the Options panel, select Main > Log Files Files.
Version 8.2.1 55
7. Now you need to specify the clustered log files. 8. When you are finished specifying the log files, click the Update icon to generate the reports for the profile.
N240002
To create a profile from a copy

You can create a new profile by copying an existing one. The original profile's configuration and reports serve as the basis for the new one. To copy a profile 1. Open the Profile Manager. 2. Click Copy Profile Profile. 3. Select the profile you want to copy and click Continue Continue. Selecting Default template settings is equivalent to creating a new profile from scratch--it leads you through the same screens you complete when you create a new profile. 4. Enter a short, one-word name for the new profile. 5. In the Database connection box, select the database connection you want to use for this profile. 6. Click Continue Continue. The new profile is created, with configuration settings and reports identical to the profile it was copied from. After creating a new profile by copying, you will need to modify some of the new profile's options. Which options you need to modify will vary, depending on how you want the copied profile will differ from its original. At the very least you will probably want to modify the settings for: The profile title The URL of the site being analyzed The profile's log files Profile passwords
You also need to assign users access to the profile.

N250001
To edit a profile's options profile'

You can access a profile's opions for editing from the Profile Manager or while viewing the profile's reports. 1. To edit a profile's options:
56
From the Profile Manager, select the profile and click Edit Profile or... Profile, While viewing the profile's reports, on the toolbar, click Administration Administration.
To create a profile
N260001
To delete a profile
You cannot undo a delete. If you think you might need a profile again, back up its files prior to deleting it. To delete a profile: 1. Open the Profile Manager. 2. Select the profile you want to remove and click Remove Profile Profile.
N270002
About general profile options

You can set the following general options for a profile:
Option Profile title Description A profile's title is the display name that users see when viewing the profile. It appears on all of the profile's reports. You must specify the URL of the site you want to analyze. The URL cannot include a path. If you want a profile to only include certain pages at the URL, set the Included Pages option. If your log files contain data on more than one site and you have selected the Only process traffic to the configured site option (on the Advanced page), ensure that the URL (after the http://) matches exactly how your site is recorded in your log files. To ensure the URL you enter exactly matches your log files, examine one of your logs in a text editor and then enter the URL exactly as it appears. Where the site name appears in the log will depend on your log file format. In NCSA logs the site name appear in the second column. Netscape and W3C log files have column headings that identify the correct column. In W3C logs the correct column is usually cs-host. Case-sensitivity in page names and user names You can specify whether upper and lower case characters in page names and user names are treated as distinct. If case-sensitivity is enabled, uppercase and lowercase characters are treated as different characters. Otherwise, they are considered the same. If case-sensitivity is not enabled, page and user names are imported as lowercase. This affect the use of regular expressions and filters. In most cases, if your logs come from a UNIX system you should enable case-sensitivity if they come from a Windows system you should disenable case-sensitivity.
URL of the site being analyzed
Version 8.2.1
57
3 - Creating and Configuring Profiles Option Rows per summary Description By default, each report page displays ten rows. You can change the default, and/or customize the number of rows initially displayed in any given report. Users can also change the number of rows displayed when working with a report. By default, each dashboard report graph displays five values. (The exception is graphs for dated summaries which display all available values in the underlying summary). Changes to this default will affect to all graphs on all pre-defined dashboards. You can specify the maximum number of consecutive pages (2 to 10) that can be in a path. This number is used to calculate the paths that appear in your Path Summary.
Values per dashboard graph
Maximum path length
Page title and page name length You can specify a maximum display length for page titles and page names. Limiting the length makes reports easier to read and print. The default length is 41 characters. Host name resolution Most servers can resolve the host names of clients requesting files (that is, look up the host names for their corresponding IP addresses). However, some servers are not configured to perform this function. You can have NetInsight resolve host names that are not resolved by the server. By default, Unica NetInsight calculates metric percentages using the total count for the time period as the denominator. You can choose to hide metric percentages on reports or to calculate them using page or report totals instead.
Metric percentages based on
N280002
To set general profile options

1. View the profile whose general options you want to set. 2. Click the Options tab. 3. In the Options panel, select Main > General General. The General options screen opens. 4. Set options as needed.
58
Profile title URL of the site being analyzed Case sensitive pages Case sensitive user names Number of rows per summary Number of values per dashboard graph
To create a profile
Maximum length of a path Page title display length Page name length Resolve host names Metric percentages based on Anonymous FTP root directory
5. Click Save Options . If you changed one of the case-sensitivity options, the Resolve host names option, or the Anonymous FTP root directory option, you must delete your profile data and reimport your log files to apply those changes to existing data. Otherwise, the changes are applied to subsequently imported data when the profile is next updated. Be aware that if you do not still have all previously imported log files then deleting profile data will result in permanent data loss.
N290001
About locale options

You can configure Unica NetInsight to work with your specific locale, including the way that it displays dates and times and language settings. Locale options include the following settings: Week begins on You select the first day of the week. The default is Sunday on. Sunday. Weekend You select the weekend days. The default is Saturday and Sunday Weekend. Sunday. Display time as Display time as option. You select whether you want times as. displayed using the 12-hour clock or the 24-hour clock. Display date as Display date as option. You select the date format you want to use. as. The date and time settings primarily affect the automatically generated footer on report pages, which include a date and time stamp. Character set Character set option. You select the character set used to display set. text in the reports and the profile interface. This is also the character set used to send data to the database. In general, you should not change the character set. Language You select the language that is used to display text. The languages Language. available depend on which Language Packs you have installed. Log file date format If you are analyzing Microsoft log files, you need to tell Unica format. NetInsight in what format dates are stored in the log files. (For example, is July 10, 2009 stored as 10/07/08 or as 07/10/08?) This option is only for Microsoft log files in the IIS Standard/Extended log file format. Currency. You select the currency that defines the format to be used for currency values in reports.
59
Version 8.2.1
Administrators can also set the default locale options to apply to each new profile users create.
N2A0001
About character sets

Character sets map written characters to a number that can be stored electronically. Some character sets only contain characters for certain languages. For example, the character set Western European (ISO-8859-1) contains the characters in the Latin script and can represent most European languages, but not Arabic or Mandarin. The Unicode character set contains the characters needed to represent almost all written languages. Unica NetInsight uses UTF-8, a common implementation of Unicode.
About character sets in Unica NetInsight

Several character sets affect Unica NetInsight: The character set of the data (log file or page tag) you are analyzing. The character set specified in your external database application. The character set specified for the profile, which is used for the reports and the profile interface, and is also the character set used to send data to the database. The character set specified in the administration options, which is used for the Profile Manager and the administrative options.
The character sets of your profiles must match the database's character set. If they do not, you may end up with junk characters in your database. In most database applications, the character set is specified at the application level, so for the profile character set and the database character set to match, all of your profiles must use the same character set. Likewise, if the profile's character set is different than the Profile Manager character set, the profile title may not display properly in the Profile Manager. Unica strongly recommends that all of your settings use the same character set.
Support for UTF-8

Unica NetInsight supports UTF-8 for DB2 and Oracle databases. UTF-8 is not supported for SQL Server. If you are planning on using UTF-8, contact Unica technical support for additional guidance.
When to change character sets

Unica NetInsight creates the database tables for a profile the first time it is updated. The database tables are created using the character set specified in the Locale options. Do not change the character set for a profile whose database has already been created. If you need to change the character set for an existing profile, contact Unica technical support.
60
To create a profile
Which character set to use

If you anticipate needing to analyze keywords or page titles in a variety of languages, Unica recommends using UTF-8 if it is available for your database. Otherwise, use the character set that is the best match for the data you are analyzing.
Using the UTF-8 character set in DB2

If you are using a DB2 database and you want to use the UTF-8 character set, you must set the value of the environment variable named DB2CODEPAGE to 1208 in the Nettracker.cfg file before you import data into any of your profiles. For example:
<envvars> <envvar name="DB2CODEPAGE">1208</envvar> </envvars>
Using the UTF-8 character set in Oracle

If you are using an Oracle database and you want to use the UTF-8 character set, you must set the value of the environment variable named NLS_LANG to AMERICAN_AMERICA.AL32UTF8 in the Nettracker.cfg file before you import data into any of your profiles. For example:
<envvars> <envvar name="NLS_LANG"> AMERICAN_AMERICA.AL32UTF8 </envvar> </envvars>
This setting assumes that you are using AL32UTF8 (the Oracle UTF-8 character set supported by Unica NetInsight) as the database and client character set.
N2B0002
To change locale options

You must install the language pack for the language you want to use prior to modifying the language setting. Changing the default locale only affects profiles created after the change; it does not affect existing profiles. 1. While viewing the profile, click the Options tab. 2. From the Options panel, select Main > Locale Locale. The Locale Options screen opens. 3. Change locale options as necessary: a. In the Week begins on list, you can select Sunday (the default) or Monday Monday. b. In the Weekend list, you can select Friday and Saturday or Saturday and Sunday (the default).
Version 8.2.1
61
c. In the Display time as list, you can select 12 hour clock (the default) or 24 hour clock clock. d. In the Display date as list, you can select mm/dd/yyyy (the default), dd/mm/yyyy dd/mm/yyyy, or yyyy/mm/dd yyyy/mm/dd. e. In the Character set list, you can select the character set to use. You should not change the character set after creating the profile. f. In the Language drop-down list, select the language to use.
g. If you are using Microsoft log files, in the Log file date format list, you can select mm/dd/yy (the default), dd/mm/yy or yy/mm/dd dd/mm/yy, yy/mm/dd. h. In the Currency list, select the currency to use for the profile. 4. Click Save Options then click Continue Options, Continue. If you change the language, you must update the profile for the complete translated interface to appear.
N2C0001
About page tags

If your Unica NetInsight license permits, you can analyze data collected from page tags. You collect the data by tagging Web pages with JavaScript that causes a visitors browser to send information about the visitors visit to a page tag server. This information, which appears in the page tag server log as a request for the page tagging image, can then be imported by Unica NetInsight for analysis. The requests for the page tag image can be analyzed either isolated from, or to augment, the actual Web server log entries that contain the original request for the tagged page. This lets you either selectively tag the pages you would like to track, or tag those pages for which you want to have additional information available for analysis. In addition, because the image requested does not need to be on the same Web server as the page in which it is embedded, you can use page tagging to track pages on sites for which you do not have access to the Web server log files. Refer to the Unica NetInsight Administrator's Guide for complete details about deploying page tagging with Unica NetInsight. If your Unica NetInsight license does not permit page tag analysis, the Page Tagging option will not appear.
Possible page tag modes

There are several possible ways to use page tag data in your profile: Not used Disables page tagging. However, requests for the page tag image will count as hits. Used only to augment log files with additional data
62
To create a profile
Requests for the page tag image will count as hits. They will not count as page views. Augmenting log files with data collected by page tags enables you to capture additional client-side information such as screen resolution, or to track events such as visitors adding or removing items from shopping carts. Used instead of log files to collect data for a single site Requests for the page tag image will count as page views. Non-page tag requests will not be counted. This mode is the typical page-tagging mode. In this mode, you will only load traffic that is recorded from page tags placed in your HTML pages. Ensure that you tag every page you want to track. You can tag non-HTML views (such as file downloads) by tagging the link to the file. In addition, you can use event tags to track on-page events (such as adding a product to a shopping cart). For this mode, pages are expected to be logged in the format http://www.host.com/page.html. Unica NetInsight will parse the host (for example, www.host.com) and compare it (without respect to case) to the URL of the site being analyzed option in the General options, or the server URL if your log files are clustered for multiple sites. If they match, Unica NetInsight will remove the host from the URL and count the request as a page view. If they do not match, the request will not be counted. Used instead of log files to collect data for multiple sites Requests for page tag images will count as page views. Non-page tag requests will not be counted. Pages will appear in Unica NetInsight reports as full URLs (as they would if Unica NetInsight were configured to process log files that are clustered for multiple sites). If you are using page tags instead of log files, you will need to use this mode so that you can distinguish a page tag generated for a page on one site from a page tag generated for a page with the same name on another site (such as index.html). Used in addition to log files to collect data for multiple sites Requests for page tag images will count as page views. Non-page tag requests will also be counted as page views. (Non-page tag requests will be prefixed with the URL in the General options, or the server URL if the log files are clustered for multiple sites.) Use this mode if you want to use log files in conjunction with event tags for your main site, or have remote site portions that are hosted within other Web sites for which you do not have access to the log files. In this case, you would place the page tags in the pages on those remote sites. Page tags generated from the remote sites will count as page views. The pages from each site will be prefixed with the sites name (for example, http://www.ourpartner.com/remotepage.html). Both regular log records and page tag records will count as page views. Therefore, do not add page tags to your main site for which you are using log files, as traffic will be counted twice. Using event tags only will not result in traffic being counted twice.
N2D0001
Version 8.2.1
63
To enable page tags

1. View the profile in which you want to analyze data collected from page tags. 2. Click the Options tab. 3. In the Options panel, select Main > Page Tagging Tagging. 4. In the Page tags are list, select the mode that matches the data collection mechanism you want to use. 5. Click Save Options and then click Continue Continue. If you selected Not used you do not need to continue with the remaining steps. used, 6. Specify the images used to collect page tag data: a. To add an image, click Add enter a filter that describes the image, and click Add again. b. To edit a filter, select the filter in the list, click Edit, make your changes and click Save Changes. c. To delete an image, select the image and click Delete. When you import data into Unica NetInsight from now on, Unica NetInsight will analyze the data collected by the page tag images that match the current filters. 7. If this is what you want or if you have additional changes to make to the list of filters, click Continue Continue. If you want Unica NetInsight to use the current image list on data you have already imported, you need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
N1D0002
Restricting access to profiles

N1D0009
Restricting access to profiles To restrict access to profile functions by password

Unica NetInsight contains a number of mechanisms you can use to restrict access to profiles (or to certain features within a profile). These are summarized here. Essentially, you control access either by using authentication (that is, through password protection) or by the privileges you assign to different user roles. You can also use a combination of these methods.
64
Controlling access to administrative functions

If you want to restrict access to what are typically considered administrative functions, there are three areas you need to consider: 1. The Profile Manager: The Profile Manager is where you create and delete profiles. From there you can also access Unica NetInsightsystem-level options (such as the ability to create users and roles) and define the default values used for new profiles. 2. Profile Options: The Profile Options settings are where you define a profile's options. Access to these can be controlled on an option-by-option basis. 3. Commands on the Reports and Archive tabs: There are a number of functions available from the Reports and Archie tabs you might want to control access to. For example, from the Reports tab you can initiate a profile update, delete data from a profile, and create and delete reports.
Ways to control profile access

To Do This Description This limits access to this profile to those users you specifically assign a role for this profile. Users without a designated role cannot access the profile, nor do they see it listed on the Homepage. By itself this type of security does not prevent users from accessing the Profile Manager (where you can create and delete profiles). Nor does it prevent access to the Unica NetInsight system-level administration options (which includes default profile options). Restrict access to a pro- Password-protect the file (by password) profile using your Unica NetInsight web server's authentication You can use the NetInsight web servers security to password-protect a profile (by restricting access to its directory). This is an effective way to quickly limit access to all of a profile's reports and options settings. However, creating accounts to grant access can become labor intensive. By itself this type of security does not prevent users from accessing the Profile Manager or system-level administration options (which includes default profile options).
Restrict access to a pro- Set the profile's default file (by roles) role access to No Access and do not assign users specific roles to that profile
Version 8.2.1
65
3 - Creating and Configuring Profiles To Restrict access to the Profile Manager Do This Create and assign users to roles which do not have access to the Administration : Profile Manager privilege Description Restricting access to the Profile Manager prevents users from creating and deleting profiles. It also prevents them from accessing system-level administration options (which includes default profile options). By itself this type of security does not prevent users from accessing an individual profile's administration options. Restrict access to one or more of a profile's options Create and assign users You can prevent users from accessing a profile's to roles which do not administrative options by assigning them to a role have the one or more of that does not have privileges to Options. the Options : privileges By itself this type of security does not prevent users from accessing the Profile Manager or system-level administration options (which includes default profile options). You can use a profile's Passwords settings to password protect the ability to perform these actions in a profile: updating or deleting profile data, saving or deleting reports, specifying which web server log files the profile uses, and modifying the password protection of these options itself. By itself this type of security does not prevent users from accessing the Profile Manager or system-level administration options (which includes default profile options). Restrict access to specific features within a profile Create and assign users to roles which do not have the one or more of the Interface : and/or Removal : privileges By assigning users to a role which you the selectively assign Interface and Removal privileges, you can control just about any access or action a user can person within a profile.
Restrict access to Use the Passwords setsaves, deletes, and log tings in profile options file specification within a profile (by password)
Special administration privileges

There are two override privileges you can use to grant special administration permissions if the need arises. Both are described in greater detail elsewhere in this guide. Administration : User Manager The User Manager privilege gives a user the ability Manager: to create and edit non-administrator user accounts. Assign it when you want to give a person the ability to create user accounts while still restricting access to other administration functionality.
66
Filtering profiles
Profiles : Override No Access This privilege gives a user the ability to access a Access: profile even when the profile's default role is set to No Access It should be reserved Access. for users you want to have access to all profiles.
N2E0002
To restrict access to profile functions by password

1. View the profile in which you want to restrict access. 2. Click the Options tab. 3. In the Options panel, select Main > Passwords Passwords. 4. In the New password box, enter the password you want to use. 5. In the New password (again) box, enter the password a second time. 6. Select one or more of the following options: The Protect the Remove Data from Profile page option by itself does not prevent users from removing profile data. NetInsight still provides users with the opportunity to delete all the profile data when they change certain profile options. To prevent users from deleting profile data, select both Protect the Remove Data from Profile page and Protect all of the profile options options. a. Protect all of the profile options optionsRequires users to enter a password in order to change any of the profile options. b. Protect only the log file and password options optionsRequires users to enter a password in order to change the log file or password options. c. Protect the Remove Data from Profile page pageRequires users to enter a password in order to remove data from the profile. d. Protect the updating of this profile profileRequires users to enter a password in order to update the profile. e. Protect saving/removing reports reportsRequires users to enter a password in order to save reports they create or remove reports. 7. Click Save Options and then click Continue Continue. The new settings will take effect immediately.
N1E0001
Filtering profiles

N1E000A
About filtering profiles To filter profiles About profile filter options
Version 8.2.1
67
About filtering profiles

Profile filters allow you to specify which data should be included or excluded by Unica NetInsight during data import. This creates the superset of data stored by Unica NetInsight and available to Unica NetInsight reports. Users can then further filter the data at the report level. By creating and applying your own filters to a profile, you can specify additional data you want to include or exclude from that profile during import. For example, you can limit data to specific dates, pages, hosts, users, and so on. Unica NetInsight excludes certain data by default. For example, files ending with .gif, .GIF, .jpg, .JPG, .png, .PNG, .css, .CSS, .js, .JS, and .class are automatically excluded.
Include versus Exclude filters

Many of the filtering options available for profiles can be specified as either an include or an exclude. Which to use usually depends upon which is the bigger list: the data that you want to include or the data that you want to exclude. Include filters supersede exclude filters and are absolute...so only use include filters whose contents constitute the entirety of what you want in your profiles. For example, if you create an include filter for hosts whose lone entry is mysite.org, mysite.org will be the only host whose data is imported into your profile. Filtering affects view and download statistics but does not affect hit counts. For example, if you exclude a particular domain, that domain will be excluded from your page view statistics but will still factor into your hit count. Hits are listed on the Executive Dashboard and the Traffic Summary.
N2F0001
To filter profiles
To filter a profile: 1. View the profile you want to filter. 2. Click the Options tab. 3. In the Options panel, select the filter option you want. See the About Profile Filtering Options topic for information on using specific filter types. 4. Click Add Add. If you are creating a date filter, select the date range and click Save Options Options. Otherwise proceed to the next step. 5. Enter a filter that describes the data you want to include or exclude and click Add Add. 6. The filter will be applied to data you import from now on. If this is what you want, or if you have additional filters to enter, click Continue Continue.
68
Filtering profiles
If you want to apply this filter to already imported data, you will need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
N300002
About profile filter options

You can filter profile data as follows:
Filter Dates Hosts Use Notes You can limit the data in your profile to a specific date range. You can include or exclude specific host data from your profile. For example, you could include only traffic from within your company. You can restrict the page data in your profile to only those pages included in a certain list. You can include or exclude data from your profile based on the value of a certain parameter in the log file. Before you can define included/excluded parameter values, you must define one or more parameters in the profile options. Requests are included/excluded according to the parameter values associated with each individual request. Parameter values associated with the visit are therefore excluded at the view level, not the visit level. User agents You can include or exclude data from specific user agents from your profile. Traffic from certain user agents is excluded by default. For example, to resolve page titles Unica NetInsight requests information from your Web server and these requests are recorded in your log file. By default, Unica NetInsight does not import this traffic data. Users You can include or exclude data about specific users from your profile. For example, you could exclude user names from your company in order to get an accurate analysis of who is visiting your site from outside your company. You can include selected pages from the excluded page types in your profile. For example, if Unica NetInsight is configured to exclude all .shtml files, you could specify a particular .shtml file to be allowed.
Pages
Parameter values
Selected pages from excluded page type
Version 8.2.1
69
N10123
4 Importing Log Files

N310001
To add log files to a profile To add clustered log files to a profile Manually specifying a log file format About log files on FTP servers To specify the date format of your log files To process only data for the configured site To select a time zone for a new profile To stop conversion of dates and times in W3C log files
To add log files to a profile

These instructions are for single servers. If you need to analyze log files from clustered servers, see the instructions for working with clustered log files. Although you normally specify a log file when you create a profile, you can add log files to a profile at any time. 1. View the profile to which you want to add log files. 2. Click the Options tab. 3. From the Options panel, select Main > Log Files Files. 4. Click Add Add. 5. Specify whether the files are available on the local network or via an FTP server. 6. Specify the format of the log file(s) or select Auto Detect to have Unica NetInsight determine the format. If your log files are in a non-standard format, you must first create a custom log format definition in Unica NetInsight. See the instructions for defining a custom log file format.
To add clustered log files to a profile
7. Specify the path to the log file(s). If the files are available on the local network, enter the path and file name. Or, if it is available, click Browse to find the file. If the files are available from an FTP server, click Browse and enter the connection information for the server. On some UNIX FTP servers, the initial path is the complete system path to directory containing the log files. On Windows FTP servers the initial path is usually relative to the FTP root directory. You can use pattern matching to specify which log files to use at the given path location. For example, to use all log files at the specified path, modify the file name portion of the path to *.*. Or, to specify that only log files that match the pattern mydomain.com-MMM-YYYY.gz be used (for example, mydomain.comJan-2010.gz) enter mydomain.com-???-20[0-9][0-9].gz.
8. Click Add Add.

N320001
To add clustered log files to a profile

Unica NetInsight can analyze log files that are clustered for a single site or for multiple sites. The log files can be from load-balanced servers or from servers that each deliver different content. It is even possible to analyze Web servers clustered for multiple sites when each site in the cluster also has multiple load-balanced servers. However, if you want to analyze clustered log files, the servers must all rotate log files at the same time and the log files must use the same naming scheme. This means that all the log files for any given day will have the same exact name. For example, suppose you have three load-balanced servers and you rotate the log files daily at midnight. If, for January 1, 2008, the log file for each server is named 20080101.log, Unica NetInsight can analyze the log files. If the log files are named Server1.20080101.log, Server2.20080101.log, and Server3.20080101.log, Unica NetInsight will not be able to analyze the log files correctly. (You may find it helpful to store the log files for each server in a separate directory with the same name as the server.) 1. View the profile for which you want to use clustered log files. 2. Click the Options tab. 3. In the Options panel, select Main > Log Files Files. 4. In the Log files are list, select the configuration that matches the log files you want to analyze: Clustered for a single site Multiple servers, all of which are serving the same site: content. Hits to the servers are load balanced among the different servers so that a request to the site can go to any one of the servers. For example, if a user requested your home page, any one of the servers could serve the page.
Version 8.2.1
71
4 - Importing Log Files
Clustered for multiple sites Multiple servers that are part of the same domain. sites: Each site serves different content. For example, in the yoursite.com domain the domain, server home.yoursite.com serves the home page and general content, and the server catalog.yoursite.com serves the catalog pages. Within each site in the cluster, you can also have multiple load-balanced servers. For example, the catalog pages could be served by any of three servers clustered as catalog.yoursite.com catalog.yoursite.com. The servers should usually be part of the same domain. If you need to cluster servers from different domains, contact Unica technical support.
5. Click Save Options > Continue Continue. 6. Click Server 1 > Edit Edit. 7. Enter a unique name and a URL for the server. If the servers are clustered for multiple sites, you must enter a different URL for each site. In the example earlier, you would use http://home.yoursite.com for the first server and http://catalog.yoursite.com for the second. (Load-balanced servers within a site should all use the same URL. For example, all three servers clustered as catalog.yoursite.com would use http://catalog.yoursite.com http://catalog.yoursite.com.) If you are analyzing log files from servers clustered for multiple sites, the URL you enter here overrides the URL of the site being analyzed setting in your profile's General options. 8. Click Add to add additional servers. You must create a server entry for each server in the cluster. When you are through adding all of the servers, you need to specify the location of each servers log files. 9. To specify the location of a servers log files, select the server, and click Add/Edit Log Files Files. 10. Click Add Add. 11. Specify whether the files are available on the local network or via an FTP server. 12. Specify the format of the log file(s) or select Auto Detect to have Unica NetInsight determine the format. If your log files are in a non-standard format, you must first create a custom log format definition in Unica NetInsight. See the instructions for defining a custom log file format. 13. Specify the path to the log file(s). If the files are available on the local network, enter the path and file name. Or, if it is available, click Browse to find the file. If the files are available from an FTP server, click Browse and enter the connection information for the server. On some UNIX FTP servers, the initial path is the complete system path to directory containing the log files. On Windows FTP servers the initial path is usually relative to the FTP root directory.
72
Manually specifying a log file format
You can use pattern matching to specify which log files to use at the given path location. For example, to use all log files at the specified path, modify the file name portion of the path to *.*. Or, to specify that only log files that match the pattern mydomain.com-MMM-YYYY.gz be used (for example, mydomain.comJan-2010.gz) enter mydomain.com-???-20[0-9][0-9].gz.
14. Click Add > Continue Continue. 15. Repeat 10 through 14 until you have specified all of the log files for this server. 16. When you have finished adding log files for one server, click Back to Servers and repeat 9 through 15 for the remaining servers.
N330001

N33000A
To define a custom log file format About fields in custom log format definitions About dates in custom log format definitions About tab-delimited fields in custom log format definitions
To define a custom log file format

1. On the toolbar, click the Administration icon. 2. Click the Options tab. 3. In the Options panel, select Main > Custom Log Formats Formats. 4. Click Add Add. 5. Enter a name for the log file format. 6. Enter the log file format. 7. Click Save Options Options. After you specify a custom log format, it appears in the Format of log file(s) list when you add or edit log files. Custom log formats cannot be automatically detected, so you must specify the format for each log file that uses it.
N390001
About fields in custom log format definitions

The log format that you enter should consist of field identifiers and literal characters. Field identifiers are strings of the form %NAME%. Field identifiers are place-holders for variable information. Literal characters include any character that is not part of a field identifier, including spaces and tabs. Literal characters must be specified in the custom format exactly as they appear in the log file.
Version 8.2.1
73
Matching literal characters appearing immediately before and after a field identifier are treated as field delimiters indicating that any value between them should be considered the field value. The most common field delimiter is a quotation mark. A field value cannot contain a field delimiter. A field that does will cause the log file line to be parsed incorrectly and subsequently ignored. Unique field identifiers can be used only once per custom log format. A custom log format must contain the mandatory field identifiers listed below.
Mandatory Field Identifiers:

Field Identifier %HOST% %REQUEST% Or %URL% Or %PAGE% %DATETIME% Or %CUSTOMDATE format% Or %CUSTOMDATE_GMT format% Field Value Remote host or IP address First line of the request (for example, "GET /index.html HTTP/1.0") Path and file name of the file requested (may also include a query string) Path and file name of the requested page (must not include a query string) Date and time in Common Log Format (for example, "01/Jan/2010:01:01:01 -0500") Timestamp; date and time are treated as local time Timestamp; date and time are treated as GMT and converted to local time
Additional information is parsed automatically from the log file if any of the following field identifiers are present.
Other Recognized Field Identifiers:

Field Identifier %BYTES% Field Value Bytes sent. A value of '-' in the log file will be considered equal to a value of 0. If this field identifier is not present in the custom log format, the bytes transferred for each request will be considered zero. %COOKIE% Cookie as supplied by the Web server ("full cookie")* Unica NetInsight - Administrator's Guide
74
Manually specifying a log file format Field Identifier %FILESIZE% %REFERRER% %QUALITY% %QUERYSTRING% Field Value Size of the requested file* Referrer, as sent by the browser* Quality of the connection* Query string supplied with the request (can be used only with %PAGE%)* Cookie as supplied by the Unica Web Server Plugin* Connection status as supplied by the Unica Web Server Plug-in Host name or IP address of the site to which the request is made (can be used only with %PAGE%) Status of the request (HTTP status code). If this field identifier is not present in the custom log format, the status code of the request will be considered 200. %TIMETAKEN% %USERAGENT% Time taken to serve the request, in seconds Browser and platform information, as sent by the browser* Remote user name* Virtual host name*
%SANECOOKIE%
%SANESTOP%
%SITE%
%STATUS%
%USERNAME% %VHOST%
* Dashes and null strings are acceptable values for these fields. They are interpreted to mean that no value for the given field is available. Unica NetInsight skips any field identifier not listed in the tables above unless it is named as a field from which parameter data should be parsed. If your log file contains a field not listed in the table above, you must enter an "arbitrary" field identifier for it in the custom log format. The arbitrary field identifier serves as a placeholder that tells Unica NetInsight to skip the field. Some custom log formats may contain place-holders such as %SKIP1%, %SKIP2%, etc.
Version 8.2.1
75
Examples
NCSA Common Log Format The following log format (one line) defines the standard NCSA Common Log Format:
HOST% %IDENT% %USERNAME% [%DATETIME%] "%REQUEST%" %STATUS% %BYTES%
Note that literal characters (in this example, the brackets and quotes are literal characters) must appear in the log file exactly as they are specified in the custom format. NCSA Combined Log Format with Unica Web Server Plug-in The following log format (one line) defines an extension of the NCSA Combined Log Format that includes the information generated by the Unica Web Server Plug-in:
%HOST% %IDENT% %USERNAME% [%DATETIME%] "%REQUEST%" %STATUS% %BYTES% "%REFERRER%" "%USERAGENT%" "%SANECOOKIE%" %SANESTOP% %TIMETAKEN%
N3A0001
About dates in custom log format definitions

You can define a custom timestamp format to allow Unica NetInsight to parse log files that do not store dates in a common log format. To define a custom timestamp format, use the %CUSTOMDATE timestamp_format% or %CUSTOMDATE_GMT timestamp_format% field identifier in place of %DATETIME% when you define your custom log file format. The timestamp format you specify should consist of timestamp component identifiers and literal characters. A timestamp component identifier is one or more uppercase letters that are place holders for variable information. A literal character is any character that is not part of a timestamp component identifier, including spaces. Literal characters must appear in the CUSTOMDATE or CUSTOMDATE_GMT field format exactly as they appear in the log file. Legal literal characters are those that are not, by themselves or in combination with others, timestamp component identifiers. Because there is no surrounding delimiter for timestamp component identifiers, any character string that can be interpreted as a timestamp component identifier is treated as one. The table below lists the component identifiers that can be used in CUSTOMDATE and CUSTOMDATE_GMT timestamp formats. To be valid, the format must include one (and only one) of the following:
76
D, H, MI, and S. Either an M or MM. Either a Y, YY, or YYYY.

Timestamp Component Identifiers:

Component Identifier D M MM Component Value Day number, with or without leading zeros Month number, with or without leading zeros Abbreviated month name in English (for example, Mar) Four-digit year Two-digit year Four-digit year Hour, with or without leading zeros Minutes, with or without leading zeros Seconds, with or without leading zeros Time zone, in the format NNNN (for example, 0500)
Y YY YYYY H MI S TZ
Examples
Custom Date Formats The following field identifiers define a timestamp format that can be used to parse dates such as 2010-10-01 12:34:56:
%CUSTOMDATE Y-M-D H:MI:S%
%CUSTOMDATE_GMT Y-M-D H:MI:S%
The following field identifiers define a timestamp format that can be used to parse dates such as 10/01/2010 12:34:56:
%CUSTOMDATE M/D/Y H:MI:S%
%CUSTOMDATE_GMT M/D/Y H:MI:S%

N3B0001
Version 8.2.1
77
About tab-delimited fields in custom log format definitions

Outside of field identifiers and the CUSTOMDATE and CUSTOMDATE_GMT fields, NetInsight interprets \t as an embedded tab. It will expect to see a literal tab character in the log file at that location. The interpetation is case-sensitive; NetInsight interprets \T as a back slash followed by the letter T. When defining a custom log format, if you need to type a back slash followed by a lower-case letter t and not have it interpreted as a tab, type \\t. This only works in nonfield-identifier portions of the custom log format.
Examples
Tab-Delimited Fields The following log format defines a variation of the standard NCSA Common Log Format where fields are tab delimited and the request method and protocol are stored separately from the URL requested (all one line):
%HOST%\t%IDENT%\t%USERNAME%\t[%DATETIME%]\t %METHOD%\t"%URL%"\t%PROTOCOL%\t%STATUS%\t %BYTES%
The following field identifiers define a timestamp format that can be used to parse dates such as 2010-04-01<tab>12:34:56:
%CUSTOMDATE Y-M-D\tH:MI:S%
%CUSTOMDATE_GMT Y-M-D\tH:MI:S%
N340001
About log files on FTP servers

When you specify the location of a profile's log files you can specify the location as an FTP server. There are several considerations related to FTP servers to be aware of. Each time you update a profile Unica NetInsight contacts the FTP server. If a log files size has changed since the last time the profile was updated Unica NetInsight downloads the file again. For large log files this can be a slow process. Therefore, it is recommended that you rotate your log files daily (or weekly if your traffic is low). If a firewall separates the Unica NetInsight server and the FTP server, you may need to configure Unica NetInsight to access the FTP server in passive mode. This option is enabled by default in Unica NetInsight. For details, see instructions for accessing FTP servers in passive mode.
N350001
78
To specify the date format of your log files
To specify the date format of your log files

This configuration applies only to Microsoft log files in the IIS Standard/Extended or Microsoft Proxy format. If you are analyzing Microsoft log files, you must specify in what format the log files store dates. For example, is July 10, 2010 stored as 10/07/10 or as 07/10/10? 1. View the profile for which you want to specify the date format for your log files. 2. Click the Options tab. 3. In the Options panel, select Main > Locale Locale. 4. In Log file date format select the date format used in your log files. format, 5. Click Save Options Options. The change will be applied to all new log file data you import. If you want this change to be applied to log file data you have already imported, you must delete your profile data and reimport the log files.
N360001
To process only data for the configured site

If your log files contain data for more than one site, you can configure Unica NetInsight to only import data for the site the profile is configured to analyze. To use this option successfully, the profile's URL of the site being analyzed setting must be an exact, case-sensitive match of the site name recorded in the log files. For details, see the instructions for specifying the URL of the site being analyzed. 1. View the profile in which you want to analyze traffic to only one site in the log files. 2. Click the Options tab. 3. In the Options panel, select Main > Advanced Advanced. 4. Check Only process traffic to the configured site site. 5. Click Save Options Options. The change will be applied all new log file data you import. If you want this change to be applied to log file data you have already imported, you must delete your profile data and reimport the log files.
N370001
To select a time zone for a new profile

A profile can display data in any time zone, regardless of the time zone in the web site or page tag server log file. If you use web site log files instead of page tags, ensure your web server includes the time zone in the log files. Unica NetInsight cannot change the display time zone if the initial time zone is unknown.
Version 8.2.1 79
This option is only available for logs in NCSA, Netscape Flexible, or a custom format. W3C Extended logs record time using Greenwich Mean Time. By default, Unica NetInsight converts the times in W3C Extended logs to the local time of the Unica NetInsight installation. It is strongly recommended that the time zone not be changed after production data has been imported into the profile. 1. View the profile in which you want to select a time zone. 2. Click the Options tab. 3. In Options panel, select Main > Advanced Advanced. 4. Check Convert dates and times to local time zone zone. 5. Select the time zone to use from the drop-down list. The values in the list are the time zones that apply to the current date. For example, in December the list contains standard time zones, not daylight saving time zones. The value you select is stored in the profile's configuration file in the <converttimes> element. If the local time zone you select observes daylight saving time, the profile will display the correct times and dates all year. If the local time zone you select does not observe daylight saving time, you must manually modify the profile's configuration file so the value of the <converttimes> element is a time zone identification that is valid all year. For example, for most locations in Arizona, <converttimes>America/Phoenix</converttimes> ensures the correct times and dates all year. If you do not modify the configuration file, you will need to change the value in the profile options after each time change but before you import any post-change data into the profile. 6. Click Save Options Options.
N380001
To stop conversion of dates and times in W3C log files

Most W3C log files store date and time in Greenwich Mean Time. By default, Unica NetInsight converts dates and times in W3C log files to the local date and time of the Unica NetInsight installation. If your W3C log files do not store dates and times in Greenwich Mean Time you must configure Unica NetInsight not to convert them. 1. View the profile in which you want to stop date and time conversion. 2. Click the Options tab. 3. In the Options panel, select Main > Advanced Advanced. 4. Check convert dates and times to local time zone zone. 5. Click Save Options Options.
80
To stop conversion of dates and times in W3C log files
The change will be applied to all new log file data you import. If you want this change to be applied to log file data you have already imported, you must delete your profile data and reimport the log files.
Version 8.2.1
81
N10166
5 Working with Page Tags

N3C0002
What is page tagging? Introduction to page tagging Setting up basic page tagging Adding dimensions to tags Including cookie data in page tag requests Tagging events Tagging retail activity Tagging applications and widgets Reference
What is page tagging?

Page tagging is an alternate method for traffic information about your site that goes beyond the standard data recorded by default in your Web server log files. Basic page tagging involves sending information to Unica NetInsight every time a page loads in a visitor's web browser. You can customize page tagging to also send information when a visitor interacts with a tagged page (for example, uses a particular navigation item or starts a video). You can use direct tags to send data to Unica NetInsight when JavaScript rendering is not possible (such as in cell phone applications or Flash widgets). Direct tags are also known as web beacons.
N3D0001
Introduction to page tagging

82
When to use page tagging How page tagging works Basic page tagging data, dimensions, and metrics

N3D0007
About the page tag image query string Page tagging options settings in Unica NetInsight Planning your tags
When to use page tagging

Use page tagging when: You do not have access to the log files of your Web sites server and you want to analyze traffic on the site. You want to analyze additional information (such as screen resolution) about your sites visitors that is not transferred during a page request but is transferred during a page tag request. You want to track events, which are any actions on your Web site other than loading a page. Events include but are not limited to the following: changing a field on a form, selecting an option in a drop-down list box, submitting a form. Events are plentiful in Rich Internet Applications (RIAs) such as Flash or AJAX applications.
N450002
How page tagging works

Page tagging works as follows. 1. In each page on your site that you want to track, you place a page tag. A page tag is an HTML reference to the page tag script. If you want to track every page on your site, you can paste the page tag in a common include file such as a footer. 2. The page tag script (ntpagetag.js is a JavaScript file that includes functions that ntpagetag.js) collect information about visitors to your tagged pages. It converts the information into name/value pairs that can be read by Unica NetInsight. Unica provides you with the page tag script. You customize it as desired and place it on a publicly accessible Web server (typically the same one that serves your site). 3. The page tag script includes a request for the page tag image. The page tag image is a one-pixel transparent image which you place on a publicly accessible Web server, usually in the servers HTML document root or in an image folder. Although you can place the page tag image on the same server as the Web site you want to tag, it is not necessary. In some cases, it is preferable to place it on a separate Web server. When a request for the image file is sent, the visitor information that was processed by the page tag script is sent with the request. A request for the page tag image is made each time a visitor loads a tagged page or executes a tagged event.
N460002
Basic page tagging data, dimensions, and metrics

By default, page tagging collects the following visitor information: IP address GMT date/time Page request with query string
83
Version 8.2.1
5 - Working with Page Tags
Referring URL Screen resolution Screen color depth Browser language Browser Java support User agent Cookie information
This information appears in your reports through the default dimensions and metrics. These are the default dimensions: Page Entry Page Exit Page Referrer Browser Platform Geographic Data (Country, City, Time Zone, Organization, etc.) Date Time Day of the Week
These are the default metrics: Number of visitors Number of views Number of visits Number of new visitors Number of repeat visitors Total time online Average viewing time Average visit duration Views per visit
You can customize page tagging to track and report on a range of other visitor activities such as shopping cart activity, form interaction, clicks on links to external sites, interaction with a Rich Internet Applications (RIA) like Flash, or any other event. Page tags can be customized on a page-by-page basis using optional page-specific variables.
N470002
84
About the page tag image query string

The information Unica NetInsight analyzes is sent via name-value pairs in requests for the page tag image. NetInsight recognizes some names by default and will store and analyze the values. If you want to analyze more information, you can add name-value pairs to the page tag and then create parameters in NetInsight so that information is stored and reported on. Below is a sample HTTP request for the page tag image. In the request: js=JavaScript support; ts=a JavaScript timestamp; lc=requested page; rf=referrer; rs=screen resolution; cd=color depth; ln=browser language; tz=time zone; jv=java support; ck=cookies.
192.168.0.64 - - [25/Jul/2009:07:30:49 -0400] "GET http%3A //mysite.com/images/ntpagetag.gif?js=1&ts=1089199849489.408&lc=http% 3A//www.mycompany.com/index.html&rf=http%3A//www.google.com&rs=1280x1024&cd= 24&ln=en&tz=GMT%20-04%3A00&jv=1&ck=SaneID%3DASZGlNYNbU1-V9Fop9P HTTP/1.1" 200 85 "http://www.mycompany.com/index.html" "Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.3.1) Gecko/20030425"
N480002
Page tagging options settings in Unica NetInsight

Page tag image requests can be analyzed either separate from or along with the web server log entries for the original page request. So you can selectively tag the pages you want to track, or collect additional information on a specific subset of pages. You can also track pages in instances when you don't have access to a site's web server logs. There are several ways to use page tag data in a profile: Not used Disables page tagging. However, requests for the page tag image count used: as hits. Used only to augment log files with additional data Requests for the page tag image data: count as hits but not as page views. Augmenting log files with page tag data lets you capture additional client-side information like screen resolution or track like shopping cart adds and removes. Used instead of log files to collect data for a single site This is the most common site: page-tagging mode. Requests for the page tag image count as page views. Nonpage tag requests are not counted. If you use this option, make sure you tag every page you want to track. Tag nonHTML views (such as file downloads) by tagging the link to the file. Use event tags to track on-page events like shopping cart activity. This mode expects pages to be logged in the format http://www.host.com/page.html. NetInsight parses the host from the URL and compares it (without respect to case) to the URL of the site being analyzed (as defined in General options or the server URL if your log files are clustered for options), multiple sites. If they match the host is removed from the URL and the request counts as a page view. If they do not match, the request is not counted.
Version 8.2.1 85
Used instead of log files to collect data for multiple sites Requests for page tag sites: images count as page views. Non-page tag requests are not counted. Pages appear in NetInsight reports as full URLs (as they do when NetInsight is configured to process log files clustered for multiple sites). If you are using page tags to collect data for multiple sites, you must use this mode so that NetInsight can differentiate between page tags generated for identically named pages from different sites . Used in addition to log files to collect data for multiple sites Requests for page tag sites: images and non-page tag requests both count count as page views. (Non-page tag requests are prefixed with the URL in the General options or the server URL if the options, log files are clustered for multiple sites.) Use this mode if you want to use log files in conjunction with page tags for your main site, or if portions of your site come from other web sites whose logs you cannot access. In that case you would tag the pages on those remote sites. Page tags generated from the remote sites count as page views. The pages from each site re prefixed with the sites name (for example, http://www.ourpartner.com/remotepage.html). Both regular log records and page tag records will count as page views. Therefore, do not add page tags to your main site for which you are using log files, as traffic will be counted twice. Using event tags only will not result in traffic being counted twice. If a page tag request includes pv= or ev= those values will override the Page ev=, Tagging options default behavior for page views.
N490002
Planning your tags

In order to get the most from page tags, you must understand your organization's reporting needs. Unica strongly recommends that you review the reporting needs with Unica Professional Services. If Professional Services is not involved, use iterative rounds of testing in a data validation profile to ensure the tags meet the reporting requirements. When you implement page tagging for web analytics, you will be customizing individual web site pages. You may need to revise these tags, which involves working with your IT department to change your web site pages.
N3E0002
Setting up basic page tagging

86
Basic page tagging deployment checklist About the page tags package To deploy the page tag image To edit and deploy the page tag script To tag your site pages Verifying that the page tags are working To enable page tags
Setting up basic page tagging

N3E0008
What to do when JavaScript is disabled Using page tagging with secure pages To normalize query string parameter values
Basic page tagging deployment checklist

Basic page tagging encompasses those tasks and considerations necessary to deploy page tagging at its out-of-the-box level of functionality. These are listed here. Individual steps are described in greater detail later in this document.
1. Acquire the Page Tag package from Unica. 2. Deploy the page tag image to a web server that meets the requisite accessibility and log format requirements. 3. Edit the page tag script to point to the location of the page tag image. Deploy the page tag script to a location accessible to your tagged pages. 4. Tag you web pages. At a minimum individual pages need to include a call to the page tag script. 5. Verify that page tagging is working. 6. In NetInsight's Profile Administration, configure your profile(s) to import logs from the page tag image's web server. In Profile Administration > Main > Page Tagging Tagging, specify how NetInsight should use page tag data (for example, to augment standard log data or in place of standard log data).
N4A0002
About the page tags package

In order to use page tags you need the Page Tags package. The Page Tags package is a zip file that includes the files you need to get started tagging your site. Specifically it contains: The the page tag script (ntpagetag.js). The page tag image (ntpagetag.gif) A sample of a tagged HTML (sample.html). The sample page contains the script call to ntpagetag.js that you will need to place in all your tagged pages. It also includes examples of page-specific variables you can place on individual pages that you want to process specially.
To download the Page Tags package go to http://customers.unica.com/home.cfm > Software Downloads > Unica Web Analytics Page Tagging Script.
N4B0002
To deploy the page tag image

Deploying the page tag image means simply placing it (ntpagetag.gif) in an accessible location on a publicly accessible web server. This is typically in the server's HTML document root or in an image folder. You can place the image on the same web server as the site you want to tag but it is not necessary.
Version 8.2.1 87
Log format requirements for the page tag image web server It is important to understand that it is from the page tag image's web server logs that NetInsight gets its page tag data. So you must be able to access these logs, and they must be in a format Unica NetInsight can read. Supported formats include: Microsoft IIS Standard and Extended NCSA Common and Combined Netscape Flexible W3C Extended
If you need more information, see the topics on importing log data. Once you have deployed the page tag image you are ready to edit and deploy the page tag script.
N4C0002
To edit and deploy the page tag script

1. Open the page tag script (ntpagetag.js) in a text editor. 2. Change the value of the NTPT_IMGSRC variable to the location of the page tagging image. If your web content, the page tag image, and the page tag script will all be delivered from the same server you can use a relative path. Otherwise, use an absolute path. You can use NTPT_HTTPSIMGSRC to specify the location using secure protocol. 3. Make any desired changes to the required or optional variables in the page tagging script to control which fields are included in the page tag and the default page tag settings. Unica does not recommend disabling the default fields (defined in the NTPT_FIELDS variable). 4. Place the page tag script on a publicly accessible web server. Confirm that the script is publicly accessible. You are now ready to tag your pages.
N4D0002
To tag your site pages

To tag your web site pages: 1. Open sample.html in a text editor and find the NetInsight page tag, which consists of these lines:
  <script language="JavaScript" src="/scripts/ntpagetag.js"></script> <noscript> <img src="/images/ntpagetag.gif?js=0" height="1" width="1" border="0" hspace="0" vspace="0" alt=""> 88 Unica NetInsight - Administrator's Guide
Setting up basic page tagging </noscript> 
2. If necessary, change the script elements src attribute to match the location of the page tag script (ntpagetag.js). If the page tag script is on the same server as your Web site content, you can use a relative path. Otherwise, use an absolute path. 3. If necessary, change the img elements src attribute to match the location of the page tagging image (ntpagetag.gif). 4. Copy and paste the page tag into each page on your site you want to track with Unica NetInsight. If you want to track the entire site, paste the page tag into the master template or a global include file, such as a footer. 5. Copy your tagged web pages or the updated master template or include file to the Web server. If you don't need to make more advanced customizations (such as modifying tags on a page-by-page basis or using tags to track events or retail activity) you are finished configuring your web site to use page tags. Next you should verify that your page tags are working. For instructions on viewing the data you are collecting in Unica NetInsight reports see the Unica NetInsight Reports User's Guide.
N4E0001
Verifying that the page tags are working

You can verify that the page tags are working by ensuring that the page tag servers log files contain requests for the Unica page tag image (ntpagetag.gif). The log files should contain one line for each request for the ntpagetag.gif image, which is caused by a visitor loading a tagged page or executing a tagged event. Lines may be similar to the following example:
192.168.0.64 - - [25/Jul/2004:07:30:49 -0400] "GET /images/ntpagetag.gif?js=1&ts=1089199849489.408&lc=http%3A //testserver/sample.html&rf=http%3A //testserver/&rs=1280x1024&cd=24&ln=en&tz=GMT%20-04%3A00&jv=0 HTTP/1.1" 200 85 "http://testserver/sample.html" "Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.3.1) Gecko/20030425".
N2D0001
To enable page tags

1. View the profile in which you want to analyze data collected from page tags. 2. Click the Options tab. 3. In the Options panel, select Main > Page Tagging Tagging. 4. In the Page tags are list, select the mode that matches the data collection mechanism you want to use.
Version 8.2.1 89
5. Click Save Options and then click Continue Continue. If you selected Not used you do not need to continue with the remaining steps. used, 6. Specify the images used to collect page tag data: a. To add an image, click Add enter a filter that describes the image, and click Add again. b. To edit a filter, select the filter in the list, click Edit, make your changes and click Save Changes. c. To delete an image, select the image and click Delete. When you import data into Unica NetInsight from now on, Unica NetInsight will analyze the data collected by the page tag images that match the current filters. 7. If this is what you want or if you have additional changes to make to the list of filters, click Continue Continue. If you want Unica NetInsight to use the current image list on data you have already imported, you need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
N4F0002
What to do when JavaScript is disabled

Because page tagging relies on JavaScript, JavaScript must be enabled in your visitors' browsers in order for you to track them with the page tag. For visitors with JavaScript disabled, you can include an HTML <noscript> tag that requests the page tag image directly. You can pass other information with that request, as desired. For example: However, because robots and spiders cannot execute JavaScript, you may find that tracking only the visitors with JavaScript enabled is an effective way to separate human from non-human visitors.
N500001
Using page tagging with secure pages

The security of the page tag request is determined by the protocol used to call the page tag image and the page tag script. The page tag script contains calls for the page tag image using both HTTP and HTTPS. The script will automatically use the correct variable to match the protocol of the page from which the request is sent. If you specify a relative path to the page tag script in your page tags, your visitors browsers will automatically use the correct protocol.
90
Adding dimensions to tags
If you will be tagging pages that are all secure or all not secure, use the appropriate protocol for the page tag script. If you will be tagging a mix of pages that are secure and pages that are not secure place the page tag script on the same server as your Web site content and in your page tags use a relative path to the script location.
N510002
To normalize query string parameter values

The administrative option Normalize lc query-string parameters enables you to convert all lc query string parameter values to lowercase. If the option is selected, Unica NetInsight converts the values to lowercase. If the option is cleared, the lc query string parameter values are unchanged unless you use URL Search and Replace rules to modify them. This option applies only to lc parameter values that include the protocol and host.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Main > Advanced Advanced. The Advanced options screen opens. 4. Select Normalize lc query-string parameters to convert all query string parameter values to lowercase.
N3F0002
).

N3F0009
About adding dimensions to tags Default dimensions Standard dimensions Unica NetInsight recognizes automatically About using custom dimensions Adding a dimension to a tag
About adding dimensions to tags

A dimension is an item of content you want to measure. Dimension values determine the rows in a Unica NetInsight report. For example, Entry Page and Referrer are dimensions. There are three categories of dimensions: Default dimensions for which basic page tags automatically collect data. Standard dimensions that Unica NetInsight recognizes automatically when you add them to the tag Custom dimensions that Unica NetInsight must be configured to recognize when you add them to the tag
Version 8.2.1
91
Direct tags do not have default dimensions because they do not call the page tag script.
N520002
Default dimensions
For basic page tags and event tags, the default dimensions are determined by the page tag script (ntpagetag.js). You can edit the script to disable some of the default dimensions, although Unica does not recommend it. For details, see documentation on the NTPT_FIELDS variable. Direct tags do not have default dimensions because they do not call the page tag script.
N530002
Standard dimensions Unica NetInsight recognizes automatically

Unica NetInsight automatically recognizes information passed via the following standard dimensions. Unica NetInsight reports on their values without the need to first configure parameters for them.
Name ets Description Unique floating pointer used by your visitors' browsers to help avoid cached page tag requests. The page tag script sets the value for this dimension automatically. Type of event Value / Example Number
ev lk
Any text value
Code that tells Unica NetInsight to count the 1 page tag request as a link to an external site. lk=1 Code that determines whether or not Unica NetInsight counts the page tag request as a page view. A value of 0 does not count the request as a view. A value of 1 counts the request as a view. Use pv=0 when using a page tag to send visit-level data. When using page tagging to augment log files with additional data, use pv=1 to count the request as a view. When using page tagging instead of log files, you do not need to specify pv=1 because counting the page tag image request as a page view is the default behavior in this mode. 0, 1
pv
rta
Products added to the shopping cart on the current page
List of product SKUs, quantities, and values separated by semi-colons
92
Adding dimensions to tags Name rtc Description Products purchased Value / Example List of product SKUs, quantities, and values separated by semi-colons String List of product SKUs, quantities, and values separated by semi-colons Number List of product SKUs separated by semicolons Number sc=404 String
rti rtr
Order ID associated with the current page Products removed from the shopping cart on the current page Revenue associated with the current page Products viewed on the current page
rtt rtv
sc
Status of the request (HTTP status code). Unica NetInsight uses this dimension to determine which requests are errors. Name of the site (used to filter data into profiles) Unique floating point identifier used by your visitors' browsers to help avoid cached page tag requests. The page tag script sets the value for this dimension automatically. Populates values for Unica NetInsight's user dimension. Visit cost (the amount of money spent to drive a visitor to your site for this visit). The value must be a float value and cannot include a currency sign or commas.
site
ts
Number
un
String
vc
Number
Additional standard dimensions for use in direct tags

The dimensions in this table are default dimensions in basic page tags and event tags, and Unica NetInsight recognizes them automatically when you use them in direct tags. Some of these dimensions are commonly used in direct tags and others are rarely used.
Name cd Description Color depth of the visitor's web browser Value / Example Number cd=32
Version 8.2.1
93
5 - Working with Page Tags Name ck Description Cookies and values. The list of cookie namevalue pairs must be delimited using semicolons and the entire list must be URL encoded. Value / Example String ck=UnicaNIODID%3Dti05RwsKyD6V50cKhL %BSessionID%3D9816106-8172
lc
Requested page (including query string). The Any URL value must be in the form of a URL and must lc=http%3A%2F%2Fblog.company.com%2Fp be URL encoded. age.html Language of the visitor's web browser String ln=en
ln
rf
Referrer to the page
A URL-encoded URL rf=http%3A%2F%2Fwww.google.com%2Fse arch
rs
Screen resolutions of the visitor's web brows- NumberxNumber er, expressed in width times height. rs=1280x800 Time zone of the visitor's web browser URL-encoded time zone value tz=GMT%20-04%3AOO
tz
N570002
Example: site dimension

In Unica NetInsight, profiles are typically configured to filter data based on the site parameter. You give each site you want to analyze a unique site parameter value and then create one profile per site. Filtering based on the site parameter is preferred to filtering based on the URL (page) for the following key reasons: Unlike URLs, the site dimension values are unaffected by translation services or caching servers. (The URL of a page that is viewed through a translation service or caching server may no longer contain the originating domain name, and thus will not be filtered appropriately.) Using the site dimension ensures the filtering will work even if the URLs change over time.
If you want to analyze multiple sites in a combined profile, use a common prefix in the site dimension values for those sites (for example, the name of your organization for production servers or test for test servers). This enables you to write a simple filter for the combined profile.
N540002
94
About using custom dimensions

You can configure your tags to collect data about custom dimensions and send the data to Unica NetInsight. You insert custom dimension data into the page tag using name-value pairs (also called parameters). Then, you configure the appropriate profiles to recognize the parameter. For example, if you want to analyze which content authors create the most popular content, you can create an author parameter and use it in the page tag query string for all page views. Once you have configured your profiles, the profiles contain a report that shows which authors have the most popular content. You can also use the author custom dimension to filter other reports.
N580002
Constructing the dimension name-value pair

The custom dimension parameter name must meet the following requirements: It must use alphanumeric characters only. It must be unique. (Be sure you are not using the name of a default or standard dimension, even if that dimension is not currently used in your tags.)
The custom dimension parameter value must be URL encoded using the encodeURIComponent() JavaScript function. You can either define the appropriate value for the dimension each time you add the dimension's parameter to a tag, or you can set the dimension parameter to the value of an existing variable on your page. (Setting the dimension to a variable may not be possible for all sites or applications. The exact method to use depends on the scripting language used by the site or application.)
N590002
Passing multiple values

Generally, the value in a name-value pair is a single value (for example, a single video title). However, you may want to pass multiple values instead (for example, a list of all ads displayed during the page view). You can use a list of separated values. To include multiple values in the name-value pair: Use a separator to indicate where one value ends and another begins. A comma is the default separator, but you can also use a pipe, colon, or semi-colon. Configure the appropriate profiles to recognize the custom dimension parameter.
Example:
<script language="Javascript"> var NTPT_PGEXTRA='ads=abchotel,discounttheater,acmecar'; </script>
N5A0002
Version 8.2.1
95
Planning your custom dimensions

Every custom dimension must have a corresponding parameter defined in Unica NetInsight. You should carefully consider your reporting needs and plan out the dimensions you need before you start creating them. There is a limit to the number of parameters your profiles can contain. (The exact limit is defined during the account startup process.) Because of this limit, whenever possible you should create parameters that you can use in multiple scenarios. You can use filters to focus your reports on particular values, as in the following example.
Example: Video and audio content

Suppose your site contains video and audio content and you use event tags to track when visitors start a video or audio file. Because you want to analyze video and audio content separately, you create two event types (ev=videostart and ev=audiostart). You also want to analyze the title of the file that was started, and you can do that with a custom dimension. Your first thought might be to create one dimension for videos and one for audio files, but you will have more reporting options and keep the number of parameters lower if you use one dimension for both video and audio titles (for example, title). If you create a title dimension, you can create the following reports: Report showing all pages on which visitors started a video and which videos they started (Page Summary with title dimension added and a filter of ev=videostart) Report showing all pages on which visitors started an audio file and which audio files they started (Page Summary with title dimension added and a filter of ev=audiostart) Report showing the most popular video and audio content (Parameter Summary for title; if you use title for other event types also, such as banner ads, add filters ev=videostart and ev=audiostart) Report showing the most popular video content (Parameter Summary for title with filter ev=videostart) Report showing the most popular audio content (Parameter Summary for title with filter ev=audiostart)

N550002
Adding a dimension to a tag

Before adding a custom dimension, see if the data is already being collected. For example, the referrer value or the page URL may already contain the information. In that case, you do not need to modify the tag. In most cases, you need to insert the dimension data into the tag using the dimension's parameter. How you add the parameter depends on the type of tag.
96
Basic page tagsglobal dimensions tags

If the dimension is one that applies to every page, add the dimension's parameter to the NTPT_GLBLEXTRA variable in the tag script (ntpagetag.js). Separate name-value pairs with ampersands. Example: This example adds the site dimension and the un dimension to every tag. The un dimension is set to the variable userName. (The exact method for setting dimensions to variables depends on the scripting language used by your site.)
var NTPT_GLBLEXTRA = 'site=dailyherald&un=' + userName;
Basic page tagslocal dimensions tags

If the dimension applies to some pages only, you must set the parameter for the dimension to the appropriate value on each page, using the NTPT_PGEXTRA variable. Separate name-value pairs with ampersands. Make sure NTPT_PGEXTRA is in a position where it will be parsed before the page tag script is called. Example:
<script language="JavaScript"> var NTPT_PGEXTRA='author=JohnSmith'; </script>
Event tags
In the JavaScript event handler or Flash ActionScript for the event being tagged, do one of the following: Use ntptAddPair to define the dimension before the ntptEventTag, ntptLinkTag, or ntptSubmitTag function is called. Use the querymod argument of the ntptEventTag, ntptLinkTag, or ntptSubmitTag function to define the dimension.
Example: In this example, the onclick JavaScript event handler calls the ntptEventTag function and uses the querymod argument to add the ev standard dimension and the evdetail custom dimension.
<a href="go.asp" onclick="ntptEventTag('ev=buttonclick&evdetail=go');">
Direct tags
Include the name-value pair for the dimension in the list of name-value pairs after the question mark (?) in each direct tag to which the dimension applies. Example:
Version 8.2.1
97
This example adds the site dimension and the visitor identification cookie.
http://pt001.unica.com/ntpagetag.gif?lc=http%3A%2F%2Fapplication%2Fsta rt&site=application&ck=UnicaNIODID%3DcookieValue
N400002
Including cookie data in page tag requests

N40000C
About including cookie data in page tag requests About visitor identification cookies To capture data from additional cookies
About including cookie data in page tag requests

The Unica NetInsight page tag script automatically sets a visitor identification cookie and includes the cookie data in the page tag request. If your web site sets other cookies, you can configure the page tag script to include the data from those cookies in the page tag request as well.
N5B0002
About visitor identification cookies

By default, the Unica NetInsight page tag script assigns a cookie to visitors. Unica NetInsight uses this cookie for visitor identification and parameter analysis. The visitor identification cookie is set when the page tagging script loads. Because the cookie is set through JavaScript, visitors must have JavaScript enabled in their browser in order to be tracked. (Users who do not have JavaScript enabled appear in the unique visitor count but no page tag data is collected for them.) You can edit the page tag script (ntpagetag.js) to add parameters to the script element that sets variables for the imodTag.js script that make the following changes to the visitor identification cookie:
N5C0001
Stop setting visitor identification cookies Change the visitor identification cookie name (not recommended if you are already collecting data) Change the expiration period for the visitor identification cookie Declare a domain visitor identification cookie to track visitors across subdomains
To capture data from additional cookies

If desired, you can capture data from cookies set by your web site and then run reports on that data in Unica NetInsight. You can capture cookie data globally (this is, on each page load) or for specific pages only. Cookie names are specified as an array. To capture your cookie data via page tags:
Tagging events
1. In the page tagging script (ntpagetag.js), set NTPT_FLDS.ck to true. This enables collection of cookie data. Ensure that no variables used in your page tags at either the global or page level have their value set to ck as this would prevent collection of cookie data (for example, NTPT_GLBLEXTRA="ck=somevalue"). For the same reason, do not use tagging functions (for example, ntptAddPair, ntptEventTag) to add a ck parameter or modify the existing ck parameter. 2. Declare the cookie name variable. Specify the names of the cookies you want to capture as an array. a. To capture cookies globally, declare the NTPT_GLBLCOOKIES variable in the page tagging script. b. To capture cookies on specific pages, declare the NTPT_PGCOOKIES variable on those pages where you want to capture cookie data. Examples:
NTPT_GLBLCOOKIES= ["cookie1", "cookie2"]; NTPT_PGCOOKIES= ["cookie1", "cookie2"];
N410001
Tagging events

N410007
What is an event? About event tagging Tracking an event as a page view Ensuring link and submit page tag requests are submitted before the page unloads To tag JavaScript or AJAX events To tag events in Flash 8 or greater Flash page tagging examples Marking link tags as links to an external site Sending visit-level data when an event occurs
What is an event?
An event is any on-page action other than loading a page on your site. Events include but are not limited to the following: Changing a field on a form Selecting an option in a drop-down list box Submitting a form Clicking a link to display a page on another site Starting a video
99
Version 8.2.1
Viewing a PDF document Checking an option (such as sound on/off)
Events are plentiful in RIAs such as Flash or AJAX applications. The Unica page tag script includes special functions to use when tagging events.
N5D0002
About event tagging

Unlike a basic page tag, which sends a request when a page loads, an event tag sends a request when an event occurs on a page. Another difference is that a basic page tag calls the entire page tagging script and an event tag calls a specific function in the script. There are three main event tagging functions: ntptEventTag ntptLinkTag ntptSubmitTag
Every event you want to track must call one of these functions in its JavaScript event handler or Flash ActionScript. Events may also call ntptAddPair and ntptDropPair in conjunction with one of the main functions.
Counting events as events and not page views

Unica NetInsight considers every call to the page tagging script a page view, even if the call is to one of the event tagging functions. To cause an event to count as an event and not a page view, set the field-value pair ev=eventtype using the query modifier of the ntptEventTag, ntptLinkTag, or ntptSubmitTag function.
Before you tag events

Unica NetInsight analyzes events that occur on tagged pages only. A visitor must have at least one tagged page view in the visit before Unica NetInsight tracks events for that visitor. A tagged event is tracked only if the previous page view for the visitor matches the page on which the event occurred. (If you are using direct tags, the lc parameter for the event must match the lc parameter for the previous page view.)
N5E0002
Tracking an event as a page view

Some events should be tracked as page views. For example, opening a PDF file is technically an event because clicking the link that opens the PDF is an interaction with a page. Opening a PDF can not be tracked with the basic page tag, since a basic tag must be embedded in an HTML page. However, usually what you want to analyze about the PDF view is the content, not the act of opening the PDF. Even though you must tag opening the PDF using the event tagging functions, you can have Unica NetInsight track it as a page view instead of an event.
Tagging events
When to track an event as a page view

The main question to ask when deciding if something should be a page view or an event is this: do you want to analyze this content in path reports? If the answer is yes, Unica NetInsight must track it as a page view.
How to track an event as a page view

To track an event as a page view, do the following: Do not set a value for the ev dimension. When the ev dimension is missing, the action does not count as an event. Either set the pv dimension to 1 (pv=1) or remove it altogether, but do not set pv to 0. When pv=0, the action does not count as a page view. Use the href as the value of the lc dimension, but be sure to use URL encoding for the value (of the href) so it does not conflict with the page tag request.
Example
<a href="article1.pdf" onclick="ntptEventTag('lc=' + encodeURIComponent(this.href) );" target="_blank">
N5F0001
Ensuring link and submit page tag requests are submitted before the page unloads
Following a link or submitting a form ultimately leads to the unloading of the page that contains the link or the form. To ensure that the request is sent before the page is unloaded, the page tag script introduces a small delay when tagging links and submissions. This delay is the maximum amount of time that will elapse before the page is unloaded; if the request returns before the specified time has elapsed, the page will be unloaded immediately, without waiting for the rest of the time. You can configure this delay globally by setting the NTPT_MAXTAGWAIT variable. You can adjust the wait for an individual link or submission by using the maxtagwait argument for ntptLinkTag or ntptSubmitTag. The NTPT_MAXTAGWAIT variable does not introduce a delay for tags created using ntptEventTag. If you need a delay, use ntptLinkTag or ntptSubmitTag. The default wait is one second, which is usually indiscernible to the user and is usually sufficient to effectively capture all tagged links and form submissions.
N600001
Version 8.2.1
101
To tag JavaScript or AJAX events

1. Ensure that each page that contains an event you want to track has been tagged with the Unica page tag, either directly on the page or through a common include file. 2. Customize the page tagging as needed for each page, using the optional pagespecific variables. 3. Create a JavaScript event handler for every event you want to track. Each event handler should call the appropriate event-tagging functions provided by Unica. (See the Reference chapter for details.) 4. Copy your tagged HTML pages to the Web server or your content management system. The example below shows three different ways to call the Unica event-tagging functions. The first instance uses the onchange attribute of the <input> HTML element to call the ntptEventTag function directly. The second instance uses the onchange attribute of the <input> HTML element to call the ntptEventTag function and pass additional information. In this case, the value of the text box is passed to the page tag request. The final instance uses a custom event handler named MyEventHandler to call the ntptAddPair and ntptEventTag functions in a JavaScript function.
<form> <input type="checkbox" name="mybox" onchange="ntptEventTag();"> <input type="text" name="mytext" onchange="ntptEventTag('ev=myevent&mytext=' + encodeURIComponent( this.value ) );"> <script language="JavaScript"> function MyEventHandler() { ntptAddPair( "color", "red" ); ntptEventTag( "ev=myevent" ); } </script> </form>
N610001
To tag events in Flash 8 or greater

1. Add the following function to the bottom of ntpagetag.js Or place it in its own file ntpagetag.js. and, in the page whose Flash you want to track, call the file after you call ntpagetag.js ntpagetag.js. unicaFunctions is a handler that parses name/value pairs returned by your tagged Flash and communicates them to the ntpagetag script
function unicaFunctions(command, args) { if (null == args) { return; } var tmpargs = args.split(","); 102 Unica NetInsight - Administrator's Guide
Tagging events
if (command == "ntptEventTag") { (0 == tmpargs[0].length) ? ntptEventTag() : ntptEventTag(tmpargs[0]); } else if (command == "ntptAddPair") { if ( 2 != tmpargs.length ) { return; } else { ntptAddPair(tmpargs[0], tmpargs[1]); } } else if (command == "ntptDropPair") { if ( 1 != tmpargs.length ) { return; } else { ntptDropPair(tmpargs[0]); } } }
2. On the page whose Flash you want to track, add this function to your Flash ActionScript. It serves as a bridge to ExternalInterface.call which calls unicaFunctions. You can name the function anything.
function FlashTracking(func, args) { ExternalInterface.call("unicaFunctions", func, args); }
3. In the page's ActionScript, use the function you just added to specify name/value pairs to pass to ntptEventTag. See the next section for examples.
N620001
Flash page tagging examples

In this example, the string "ev=videoaction&video=myvideo&videoaction=rewind" is passed to ntptEventTag. Unica NetInsight reports will show that the visitor initiated a "rewind" "videoaction" event for "myvideo."
// visitor is rewinding movie this.FlashTracking( "ntptEventTag", "ev=videoaction&video=myvideo&videoaction=rewind" );
Using ntptAddPair to add information

If you need to add information to an event's attributes prior to firing the event, you can call the Unica NetInsight ntptAddPair helper function.
// Visitor sets interior color to red and adds the sunroof option this.FlashTracking( "ntptAddPair", "color,red" ); Version 8.2.1 103
5 - Working with Page Tags this.FlashTracking( "ntptAddPair", "sunroof,true" ); this.FlashTracking( "ntptEventTag", "ev=PersonalizeCar" );
This example will result in an event tag equivalent to:

this.FlashTracking( "ntptEventTag", "ev=PersonalizeCar&color=red&sunroof=true" );
Using ntptDropPair to remove information

While arguments specified in ntptEventTag are bound to just that call, name/value pairs set with ntptAddPair are stored in the JavaScript of the containing page. These pairs remain until a new page is viewed (which is effectively the length of the Flash application). To remove them use ntptDropPair. Building on the previous example, if the next set of ActionScript calls are:
// Visitor removed the this.FlashTracking( this.FlashTracking( this.FlashTracking( sunroof option and added ABS "ntptDropPair", "sunroof" ); "ntptAddPair", "ABS,true" ); "ntptEventTag", "ev=PersonalizeCar" );
... this will result in an event tag equivalent to:

this.FlashTracking( "ntptEventTag", "ev=PersonalizeCar&color=red&ABS=true" );
The "color=red" pair came from the original calls. The "sunroof=true" is no longer there because it was dropped by the ntptDropPair call. The "ABS=true" pair comes from the most recent ntptAddPair.
Tagging Flash to track links

In the following example a mouse down event on button_1 reports the event "clickedlink" to the external site unica.com.
button_1.addEventListener(MouseEvent.MOUSE_DOWN,mouseDownHandler); function mouseDownHandler(event:MouseEvent):void { navigateToURL(new URLRequest("http://www.unica.com/")); this.FlashTracking("ntptAddPair", "gone,page"); this.FlashTracking("ntptEventTag", "lc=http://www.unica.com/" + "&ev=clickedlink"); }
N630001
104
Tagging retail activity
Marking link tags as links to an external site

In Unica NetInsight, links to external sites can be analyzed in the Link Summary. You can mark a link page tag request as a link to an external site by including the namevalue pair lk=1 in the page tag requests query string. You can pass the lk=1 namevalue pair into the query string by including it in the querymod argument for ntptLinkTag or by using ntptAddPair to add it before you call ntptLinkTag. When you use lk=1, clicking the link is not tracked as a page view or an event, and Unica NetInsight does not store the page on which the visitor clicked the link.
N640002
Sending visit-level data when an event occurs

Sometimes you need to send information when an event occurs, but you do not want the information associated with the event in your reports. For example, when a visitor uses a specific search tool for the first time or becomes a customer (not just a visitor) for the first time, you want to associate those changes in status with the visit, not with a particular event. You can send visit-level data by using an event tag with both of the following conditions: The tag does not contain ev= event tag. The tag contains pv=0.
The first condition keeps Unica NetInsight from registering the tag as an event. The second keeps Unica NetInsight from registering it as a page view.
N420001

N420007
About retail activity Tagging product views Tagging additions to a shopping cart Tagging removals from a shopping cart Tagging the checkout process Retail page tag parameters summary Retail metrics
About retail activity

You can use page tags to track these retail activities: Product views Shopping cart adds Shopping cart removes Checkouts
Version 8.2.1
105
You can tag or not tag individual retail activities, depending on your reporting needs. For example, if you require checkout data only, or if your site does not use a shopping cart, you can implement checkout tags without tagging cart adds, cart removes, or product views. Similarly, if your site is a product review site and not a retail site, you can use product view tags without tagging cart adds, cart removes, or checkouts.
N650002
Tagging product views

To track how often a product is viewed, use the rtv ("retail view") parameter to pass the product's identifier. You can pass the rtv parameter in a page tag (through NTPT_PGEXTRA) or in an event tag (through the querymod argument of ntptEventTag, ntptLinkTag, or ntptSubmitTag). If a page contains multiple products, you can pass multiple values to the rtv parameter. Separate multiple values with semi-colons.
Example: Passing multiple static product identifiers

In this example several product identifiers are passed as static values:
var NTPT_PGEXTRA="rtv=prod1234;prod3456;prod5678";
Example: Passing a product identifier written by a script

In this example, the product SKU is written by a script (in this case, PHP):
var NTPT_PGEXTRA = "rtv=<?php echo $row_current_row['sku']; ?>";
Example: Appending rtv to an existing NTPT_PGEXTRA value

In this example, the rtv parameter is appended to the pre-existing value of NTPT_PGEXTRA:
NTPT_PGEXTRA +="&rtv=prod1234;prod3456;prod5678";
Ensuring product views are not counted twice

If you pass the rtv parameter value through NTPT_PGEXTRA and the product view page contains event tags, you must clear the rtv parameter value before the event. Otherwise, two product views are logged: the first when the page loads and the second when the event tag is sent. If NTPT_PGEXTRA passes only the rtv parameter, you can clear the value as follows:
NTPT_PGEXTRA="rtv="
106
However, typically NTPT_PGEXTRA passes additional information, such as authenticated user names, that you do not want to clear. In these cases, use the ntptDropPair function to clear the rtv parameter value without clearing the other parameters passed in NTPT_PGEXTRA. Call ntptDropPair before the event tagging function.
ntptDropPair(rtv);ntptEventTa('ev=cartadd&rta='sProduct + ';' + iQuantity + ';' + fPrice);
Another method of ensuring product views are not counted twice is to store the original NTPT_PGEXTRA variable prior to calling the page tagging script (ntpagetag.js) and then reset the variable after the page tag image request is sent. This is particularly useful in situations where there might be multiple events on the product view page (and therefore multiple places where you would need to add ntptDropPair). The following example assumes that NTPT_PGEXTRA is already passing the authUser variable as the un parameter value (see the first line of the script):
<script language="JavaScript"> var NTPT_PGEXTRA = "un=" + authUser; var NTPT_PGEXTRA_ORIGINAL = NTPT_PGEXTRA; NTPT_PGEXTRA +="rtv=prod1234;prod3456;prod5678"; </script>  <script language="JavaScript src="/scripts/ntpagetag.js"></script>  <script language="JavaScript"> NTPT_PGEXTRA=NTPT_PGEXTRA_ORIGINAL; </script>
N660001
Tagging additions to a shopping cart

When a product is added to a shopping cart, pass its identifier, quantity, and unit price in that order through the rta ("retail add") parameter. You can pass the rta parameter in a page tag (through NTPT_PGEXTRA) or in an event tag (through the querymod argument of ntptEventTag, ntptLinkTag, or ntptSubmitTag).
ntptEventTag('ev=cartadd&rta='sProduct + ';' + iQuantity + ';' + fPrice );
The product identifier, quantity, and price are all required in order for Unica NetInsight to track the cart addition. Example: In this example, the values for a single product are passed:
ntptEventTag('ev=cartadd&rta='prod1234 + ';' + 1 + ';' + 10.00 );
The unit price must be a float value. It must not include a currency sign or commas. Including a currency sign will result in a unit price of zero within Unica NetInsight.
Version 8.2.1
107
Information for multiple products can be passed in a single call. The first three values must represent the identifier, quantity, and unit price of the first product, the next three values the ID, quantity, and unit price of the second product, and so on. Example: This example passes values for two products:
ntptEventTag('ev=cartadd&rta='prod1234 + ';' + 1 + ';' + 10.00 + ';' + 'prod5678 + ';' + 5 + ';' + 5.00 );
N670001
Tagging removals from a shopping cart

When a product is removed from a shopping cart, pass the same information that you sent when it was added. Pass the removed product's identifier, quantity, and unit price in that order through the rtr ("retail remove") parameter.
ntptEventTag('ev=cartremove&rtr='prod1234 + ';' + 1 + ';' + 10.00 );
As with adds, information for multiple products can be passed in a single call. The unit price must be a float value. It must not include a currency sign or commas.
N680001
Tagging the checkout process

Tagging the checkout process allows Unica NetInsight to report which products a visitor purchased, the price and quantity at which they were purchased, and the total revenue for the order. You tag the checkout process by passing the appropriate parameters via the order confirmation (or similar) page served at the end of the checkout process. You can pass the checkout parameters in a page tag (thought NTPT_PGEXTRA) or in an event tag (through the querymod argument of ntptEventTag, ntptLinkTag, or ntptSubmitTag). These are the checkout parameters: rti ("retail order number"): The order identification number. Including the rti parameter is optional. However, if it is left out Unica NetInsight will not store the revenue for this checkout separately. Instead it will add it to the revenue of any other checkouts completed during the visit. rtt ("retail total revenue"): The total revenue for this order. rtc ("retail checkout"): The product ID, quantity, and unit price of each product purchased.
Syntax Syntax:
var NTPT_PGEXTRA = "rti=sOrderID&rtt=fTotalRevenue&rtc=sProduct;iQuantity;fPrice" ;
Example This example shows an order ABC1234 that totals $199.99 and consists of Example: two products costing $150 and $49.99 respectively.
108
Tagging retail activity var NTPT_PGEXTRA = "rti=ABC1234&rtt=199.99&rtc=prod1234;1;150;prod3456;1;49.99" ;

N690001
Retail page tag parameters summary

Page Tag Value rtv What It Reports Format / Example
retail (product) view
rtv=sProduct NTPT_PGEXTRA="rtv=product1;product2;product3";
rta
retail (cart) add
rta=sProduct;iQuantity;fPrice ntptEventTag('ev=cartadd&rta='prod1234 + ';' + 1 + ';' + 10.00 );
rtr
retail (cart) remove
rtr=sProduct;iQuantity;fPrice ntptEventTag('ev=cartremove&rtr='prod1234 + ';' + 1 + ';' + 10.00 );
rtc
retail (cart) check- rtc=sProduct1;iQuantity1;fPrice1;sProduct2;iQuantity2;fPrice2 out NTPT_PGEXTRA="rtc=prod1234;1;5.00;prod3456;3;19.95"; retail total revenue rtt=float rtt=210.54
rtt
rti
retail order number
rti=string rti=8318
vc
visit cost
vc=float vc=20.00
N6A0002
Retail metrics
This table lists the retail metrics that are available in Unica NetInsight reports and provides the corresponding parameter and a description for each one.
Metric Abandoned Carts Parameter rta Description The number of visits that have shopping carts that did not complete the checkout process.
Version 8.2.1
109
5 - Working with Page Tags Metric Abandoned Revenue Parameter rta Description The total value of all shopping carts that did not complete the checkout process. The amount of money (on average) spent on each order. The percentage of visits that have shopping carts that did not complete the checkout process. The number of times visitors placed a product in their shopping carts. The number of times visitors deleted a product from their shopping carts. The percentage of visits with shopping cart activity that completed the checkout process. The number of times the checkout process was completed. The total value of the cart contents at checkout time. This is independent of the rtt parameter. The number of times visitors viewed a product. The total number of units in abandoned carts. The total number of units added to a cart. The total number of units purchased. The total number of units removed from a cart. The total order revenue, used to populate the standard revenue metric. It may include revenue (such as shipping charges and taxes) not associated with a product. The Revenue metric includes only revenue from completed web site sessions, as determined by the Number of minutes between visits setting in the Visitor > Sessionization section on the Profile Options screen. If Unica NetInsight identifies that a session may not be complete, it does not include revenue from the session in the Revenue metric.
Average Order Value
rtt
Cart Abandonment Rate Cart Adds
rta
rta
Cart Removes
rtr
Checkout Rate
rtc/rtt
Checkouts
rtc/rtt
Product Revenue
rtc
Product Views Quantity Abandoned Quantity Added Quantity Purchased Quantity Removed Revenue
rtv rta rta rtc rtr rtt
N6B0002
110
Tagging applications and widgets
Differences between Product Revenue and Revenue

The Product Revenue metric is the result of multiplying the quantity for each purchased product (passed by the rtc parameter) by the price for each product (also passed by the rtc parameter). The Revenue metric is the value passed by the rtt parameter. If your order totals (passed by the rtt parameter) include shipping charges, taxes, or other fees that are not defined as products, the Revenue metric total and Product Revenue metric total will be different. If you want to report on shipping charges, taxes, or other fees, Unica recommends that you add those charges to the checkout tag as products passed by the rtc parameter.
N430002

N430009
About tagging applications and widgets Anatomy of a direct tag Best practices for direct tags About the lc parameter When NOT to pass the lc parameter Where to place your direct tags Minimizing the number of tags
About tagging applications and widgets

In order to track an application or widget using basic page tags, the following conditions must both be true: The application or widget must support JavaScript. You can place the page tag script on the application or widget pages.
If you cannot use basic page tags, you can use direct tags to send usage data from the application or widget to Unica NetInsight. Direct tags and page tags are built using the same set of page tag parameters. Like page tags, direct tags can contain data for custom dimensions. Direct tags (sometimes called web beacons) bypass the page tag script (ntpagetag.js) and request the page tag image directly from the server. Because direct tags bypass the script, there is no default direct tag. You must define in the direct tag each item of information you want Unica NetInsight to receive. Unlike page tags, direct tags work in situations where JavaScript rendering is not possible.
N6C0002
Version 8.2.1
111
Anatomy of a direct tag

There are two parts to a direct tag: The URL for the page tag image on the Unica NetInsight server. This is the same for every tag you set. A query string that contains the information you want sent to Unica NetInsight.
Simple Example
This direct tag requests pt001.unica.com/ntpagetag.gif and passes information using the lc, site, and ck parameters:
http://pt001.unica.com/ntpagetag.gif?lc=http%3A%2F%2Fapplication%2Fsta rt&site=application&ck=UnicaNIODID%3DcookieValue
The request shows up in Unica NetInsight as a page view of http://application/start, and the page view is included in any profile that contains site=application.
Example with Custom Dimensions

This direct tag passes information using the lc, site, ck, and un parameters and the custom parameters version and layout:
http://pt001.unica.com/ntpagetag.gif?lc=http%3A%2F%2Fapplication.compa ny.com%2Fproducts%2Fproduct001&site=application&ck=UnicaNIODID%3Dcooki eValue&un=UnicaUser&version=1.0&layout=3A
N6D0002
Best practices for direct tags

Thoroughly test your direct tags in a data validation profile to ensure they are sending the data you need. Because you build direct tags from the ground up, testing is especially important. Include the site parameter in all direct tags. Include at least one visitor identification parameter. If the application or widget might be placed on a secure page or site, reference the page tag via the secure URL.

N6E0002
About the lc parameter

The value of the lc parameter indicates the page being viewed or the page on which the event occurred. The value must be in the form of a URL (for example, http://application) and must be encoded.
112
The lc parameter should include a descriptive page name, including as much detail as possible about what is going on within the application at the time the page tag image is requested. Typically, content categorization can be derived directly from the value of the lc parameter. For example, the following image request tells us that the visitor was in the products section of the application because the lc parameter value uses a directory structure to indication content hierarchy:
http://pt001.unica.com/ntpagetag.gif?lc=http%3A%2F%2Fapplication%2Fpro ducts%2F&site=application
N6F0002
When NOT to pass the lc parameter

You can leave the lc parameter out of the direct tag if both of the following conditions are true: You are tagging a web-based application, widget, or viral video. Your primary concern is the sites on which your content is installed and how many times it is loaded on any given page or site.
When the lc parameter is missing, Unica NetInsight reads the referring URL from the headers of the request and treats the referring URL as the page being viewed. If you must track events or interactions within the application, pass the lc parameter and parse the referring URL as a parameter. Direct tags sent from applications that are not web-based must contain an lc parameter.
N700002
Where to place your direct tags

The best location for a direct tag depends on the application or widget you are tagging. In general, you can place a direct tag in any location where you can place an image request.
N710002
Minimizing the number of tags

You should not tag events unnecessarily. If an action results in loading a new page and you can pass the information about the event in the tag for the page view, you may not need to tag the event. For example, if a user clicked a Hot Products article link from an application's start page, the tag for the subsequent product detail page could pass a click referral parameter (clickref) that specifies which link was clicked. The tag would look like the following:
Version 8.2.1
113
5 - Working with Page Tags http://pt001.unica.com/ntpagetag.gif?lc=http%3A%2F%2Fapplication.compa ny.com%2Fproducts%2Fproduct001&site=application&ck=UnicaNIODID%3D81759 178198560&un=UnicaUser&version=1.0.2&layout=3A&clickref=starthotproducts

N440001
Reference

N44000A
Introduction Required variables Optional global variables Page-specific variables Event tagging functions
Introduction
This section provides reference information on the functions, variables, and fields available through page tags.
N720001
Required variables

N72000A
About required variables NTPT_IMGSRC NTPT_SET_SESSION_COOKIE NTPT_FIELDS NTPT_MAXTAGWAIT
About required variables

Required page tagging variables are defined in the page tag script (ntpagetag.js).
N760001
NTPT_IMGSRC
A string variable that contains the URL of the page tag image. If the page tag image and the page tag script are on the same Web server as the pages you are tagging, you can omit the protocol and server. However, if the page tag script is on a different server than the Web pages you are tracking, you must specify the fully qualified URL to the page tag image, even if the page tag image and page tag script are located on the same server. Syntax
var NTPT_IMGSRC = URL;
Example (without protocol and server)
114
Reference var NTPT_IMGSRC = '/images/ntpagetag.gif';
Example (fully qualified)

var NTPT_IMGSRC = 'http://mysite.com/images/ntpagetag.gif';
N770002
NTPT_SET_SESSION_COOKIE
Checks for the session cookie and sets it if it does not exist. The default session cookie name is NetInsightSessionID. You can specify a different cookie name using the NTPT_SESSION_COOKIE_NAME variable. If you do not set this variable, it defaults to false. Syntax
var NTPT_SET_SESSION_COOKIE = [true,false];
Example
var NTPT_SET_SESSION_COOKIE = true;

N560001
NTPT_FIELDS
An object variable that specifies the fields that will be included in the default page tag. Fields set to true will be included in the page tag. Fields set to false will not be included. In most cases, you should use the default field settings. Every page tag should include the lc field. Syntax
var NTPT_FLDS = new Object(); NTPT_FLDS.lc = [true,false]; // NTPT_FLDS.rf = [true,false]; // NTPT_FLDS.rs = [true,false]; // NTPT_FLDS.cd = [true,false]; // NTPT_FLDS.ln = [true,false]; // NTPT_FLDS.tz = [true,false]; // NTPT_FLDS.jv = [true,false]; // NTPT_FLDS.iv = [true,false]; // NTPT_FLDS.ck = [true,false]; //
Document location Document referrer User's screen resolution User's color depth Browser language User's timezone Browser's Java support Initial view Allow capture of cookie values
Example
var NTPT_FLDS = new Object(); NTPT_FLDS.lc = true; // Document location NTPT_FLDS.rf = true; // Document referrer NTPT_FLDS.rs = true; // User's screen resolution NTPT_FLDS.cd = true; // User's color depth NTPT_FLDS.ln = true; // Browser language Version 8.2.1 115
5 - Working with Page Tags NTPT_FLDS.tz NTPT_FLDS.jv NTPT_FLDS.iv NTPT_FLDS.ck

N780001
= = = =
true; // User's timezone true; // Browser's Java support false; // Initial view true; // Allow capture of cookie values
NTPT_MAXTAGWAIT
The maximum number of seconds that a call to ntptLinkTag() or ntptSubmitTag() will wait before following the link or submitting the form. The delay is intended to ensure that the page tag request is sent before the tagged page is unloaded. The event will be executed when the page tag request is returned or the specified number of seconds has elapsed, whichever happens first. Syntax
var NTPT_MAXTAGWAIT = number;
Possible values
Value Any number greater than 0 Description The number of seconds to wait before following the link or form submission Execute the event immediately, without waiting
-1
Examples
var var var var
N730001
NTPT_MAXTAGWAIT NTPT_MAXTAGWAIT NTPT_MAXTAGWAIT NTPT_MAXTAGWAIT
= = = =
1; // one second 2.5; // two and a half seconds 0.1; // a tenth of a second -1; // no delay
Optional global variables

N73000A
About optional global variables NTPT_HTTPSIMGSRC NTPT_GLBLEXTRA NTPT_GLBLREFTOP NTPT_GLBLCOOKIES NTPT_SET_IDCOOKIE NTPT_IDCOOKIE_NAME NTPT_IDCOOKIE_EXPIRE NTPT_IDCOOKIE_DOMAIN NTPT_SESSION_COOKIE_NAME NTPT_SET_SESSION_COOKIE
116
Reference
About optional global variables

Optional global variables can be specified in the page tag script (ntpagetag.js).
N790001
NTPT_HTTPSIMGSRC
The URL of the page tag image to use when the tagged page is accessed using the https: protocol. Syntax
var NTPT_HTTPSIMGSRC = 'image';
Example
var NTPT_HTTPSIMGSRC = 'https://mysite.com/images/ntpagetag.gif';
N7A0001
NTPT_GLBLEXTRA
A query modifier that will be applied to every page tag and event tag. The query modifier should contain the key-value pairs you want to add to or delete from the query string for your tags. Syntax
var NTPT_GLBLEXTRA = 'key=value';
Example
// Append the 'sitetheme=blue' pair to every page tag. var NTPT_GLBLEXTRA = 'sitetheme=blue';
N7B0001
NTPT_GLBLREFTOP
Retrieve the referrer (the value for the rf field) from the top (that is, the most containing) frame of the current page. Otherwise, the referrer is retrieved from the current page. If you do not set this variable, it defaults to false. Syntax
var NTPT_GLBLREFTOP = [true,false];
Example
var NTPT_GLBLREFTOP = true;
N7C0001
Version 8.2.1
117
NTPT_GLBLCOOKIES
An array of customer-set cookies set globally to be captured by the page tagging script. Syntax
var NTPT_GLBLCOOKIES = [ ];
Example
var NTPT_GLBLCOOKIES = ["cookie1", "cookie2"];
N7D0001
NTPT_SET_IDCOOKIE
Tells the page tagging script to set the visitor identification cookie. Syntax
var NTPT_SET_IDCOOKIE = [true, false];
Example
var NTPT_SET_IDCOOKIE = true;
N7E0001
NTPT_IDCOOKIE_NAME
Sets the name of the visitor identification cookie. Syntax
var NTPT_IDCOOKIE_NAME = "";
Example
var NTPT_IDCOOKIE_NAME = "unique_visitor";
N7F0001
NTPT_IDCOOKIE_EXPIRE
The expiration time (in seconds) of the visitor identification cookie. If not specified the value defaults to 155520000 (60 months). Syntax
var NTPT_IDCOOKIE_EXPIRE = number;
Possible values
118
Reference Value Any number Description The number of seconds until the cookie expires
Examples
var NTPT_IDCOOKIE_EXPIRE = 315360000; // 10 years
N800001
NTPT_IDCOOKIE_DOMAIN
Specifies the domain suffix for the visitor identification cookie. This allows customers with more than one site within the same domain to use a single version of the visitor identifaction cookie, allowing you to track cross-site visits/visitors. For example, if your site uses the subdomains www.mydomain.com, info.mydomain.com, and support.mydomain.com, you can ensure they use the same identification cookie by specifying an NTPT_IDCOOKIE_DOMAIN value of ".mydomain.com" Syntax
var NTPT_IDCOOKIE_DOMAIN = "";
The domain suffix specified as the value must include at least two periods (see example). The domain suffix must be the same domain that sends the cookie. For example, you may not set a cookie for abc.com if your server's domain is mydomain.com.
Example
var NTPT_IDCOOKIE_DOMAIN = ".mydomain.com";
N810002
NTPT_SESSION_COOKIE_NAME
Sets the name of the session cookie. If this variable is not set, the name of the cookie defaults to NetInsightSessionID. Syntax
var NTPT_SESSION_COOKIE_NAME = " ";
Example
var NTPT_SESSION_COOKIE_NAME = "SessionID";

N770002
Version 8.2.1
119
NTPT_SET_SESSION_COOKIE
Checks for the session cookie and sets it if it does not exist. The default session cookie name is NetInsightSessionID. You can specify a different cookie name using the NTPT_SESSION_COOKIE_NAME variable. If you do not set this variable, it defaults to false. Syntax
var NTPT_SET_SESSION_COOKIE = [true,false];
Example
var NTPT_SET_SESSION_COOKIE = true;

N740001
Page-specific variables

N74000A
About page-specific variables Where to put page-specific variables NTPT_PGEXTRA NTPT_PGREFTOP NTPT_NOINITIALTAG NTPT_PGCOOKIES
About page-specific variables

Page-specific variables are optional variables that you can use to override the default page tag settings for the page on which the page-specific variables are used. The variables are not included in the page tag script (ntpagetag.js).
N820001
Where to put page-specific variables

Page-specific variables must be defined in the page to which you want them applied. They should be defined before the Unica page tag is loaded so they can modify the page tag request before it is sent. Because the <head> element for the page is processed first, it is often a good place to define the page-specific variables.
N830001
NTPT_PGEXTRA
A list of field-value pairs that will be applied to the page tag for the current page. To delete a field from the page tag, set it to an empty value. Although you can add any field-value pair, some fields are recognized automatically by Unica NetInsight and do not require you to create a parameter in order for them to appear in Unica NetInsight reports. Syntax
120
Reference var NTPT_PGEXTRA = 'field=value&field=value&field=value[...]';
Example
// Append the 'pagetheme=red' pair. Drop the 'rf' field. var NTPT_PGEXTRA = 'pagetheme=blue&rf='; // Treat this page as a 404 (Not Found) error. var NTPT_PGEXTRA = 'sc=404';
N840001
NTPT_PGREFTOP
Retrieve the referrer (the value for the rf field) from the top (that is, the most containing) frame of the current page. Otherwise, the referrer is retrieved from the current page. Syntax
var NTPT_PGREFTOP = [true,false];
Example
var NTPT_PGREFTOP = true;
N850001
NTPT_NOINITIALTAG
This variable can be set at both the global and page level. Its default is false. When set to true at the global level, it stops the page tag script from collecting initial page load data for all pages. When set to true at the page level, it stops the page tag script from collecting initial page load data for the current page. For On Premise deployments, preventing the page tag script from collecting initial page load data is useful in augment mode (where data is collected from both page tags and logs) as it prevents duplicate data from being collected. Event tags for pages will still be sent. Syntax
var NTPT_NOINITIALTAG = [true,false];
Example
var NTPT_NOINITIALTAG = false;
N860001
NTPT_PGCOOKIES
An array of customer-set cookies for a specific page to be captured by the page tagging script. Syntax
Version 8.2.1
121
5 - Working with Page Tags var NTPT_PGCOOKIES = [ ];
Example
var NTPT_PGCOOKIES = ["cookie1", "cookie2"];
N750001
Event tagging functions

N75000A
ntptAddPair ntptDropPair ntptEventTag ntptLinkTag ntptSubmitTag
ntptAddPair
Add the specified key-value pair to the query string of the next event tag to fire. If the key already exists in the query string, the value will be replaced. If the value is empty (), the key will be dropped. Syntax
ntptAddPair( key, value ) Argument key value Description The name of a name-value pair to add to the next event tag to fire. The value of a name-value pair to add to the next event tag to fire.
Example
ntptAddPair( "color", "red" );
N870001
ntptDropPair
Drop the specified key-value pair from the query string of the next event tag to fire. Syntax
ntptDropPair ( key )
Argument key
Description The name of a name-value pair to drop from the next event tag to fire.
122
Reference
Example
ntptDropPair( tmpargs[0] );
N880001
ntptEventTag
Fires an event tag using the working query string. This function should be called from a document elements event handler. Syntax
ntptEventTag ( [querymod] )
Argument querymod
Description A query modifier for the event tag. It modifies the working query string for the page tag.
Example
ntptEventTag( "ev=pickcolor" );
N890001
ntptLinkTag
Tags a link that would otherwise not be accessible to page tagging. These links include downloads, non-HTML pages, and pages on other Web sites. This function must be called from the onclick attribute of a link and should return the value of the function to the onclick handler. Link tags are not modified by the NTPT_PGEXTRA variable. Syntax
ntptLinkTag ( linkobj [, querymod [, maxtagwait]] )
Argument linkobj
Description A link object. The keyword "this" tells the function to follow the link after tagging it. A query modifier for the link tag. It modifies the working query string for the page tag. The maximum number of seconds that the call will wait before following the link. This overrides the global wait time specified by NTPT_MAXTAGWAIT.
querymod
maxtagwait
Example
Version 8.2.1 123
5 - Working with Page Tags onclick="return ntptLinkTag( this );"

N8A0001
ntptSubmitTag
Tags form submissions. This function must be called from the onsubmit attribute of a form and must return the value of the function to the onsubmit handler. Syntax
ntptSubmitTag( formobj [, querymod [, maxtagwait]] )
Argument formobj
Description A form object. The keyword this tells the function to submit the form after tagging it. A query modifier for the submit tag. It modifies the working query string for the page tag. The maximum number of seconds that the call will wait before submitting the form. This overrides the global wait time specified by NTPT_MAXTAGWAIT.
querymod
maxtagwait
Example
return ntptSubmitTag( document.myform );
124
N10370
6 Configuring Reporting Options

N8B0001
About reporting options Specifying auto-updated reports Creating custom metrics Extending the data model Creating filter groups Accessing geographic data Configuring integration models Specifying the date range of pre-generated reports Specifying reportability of dimensions Specifying the sample size
About reporting options

The reporting options apply to all the reports in the profile. They enable you to create custom metrics for use on any report in the profile, create filter groups, specify the time period for which reports will be automatically generated during profile updates, and control which dimensions are reportable.
N8C0001
Specifying auto-updated reports

N8C0007
About auto-updating To specify which reports auto-update
Version 8.2.1
125
6 - Configuring Reporting Options
About auto-updating
Auto-updating reports are generated every time the profile is updated. In general, you want a report to update automatically if all of the following are true: You are frequently importing data for the report's time frame into the profile. You need to see the report on a regular basis. You would like the report to be available instantly.
Reports with relative time frames (for example, yesterday or current month) should generally be set to update automatically. You can save time by not auto-updating the report if either of the following are true: The report is for a fixed time frame in the past for which all the data has been imported. You need to see the report infrequently and can run it ad-hoc.
All of the reports that appear in the Available Reports list on the Reports tab by default are set to update automatically. Reports you create only update automatically if you select one of the auto-update check boxes when you save the report. You can manage which reports are auto-updated at the Auto-Updated Reports option screen. (This screen is only available at the profile options. You cannot access it from the default profile options.)
Privileges related to auto-updating

You can only access the Auto-Updated Reports screen if you have the Options: Reporting: Auto-Updated Reports privilege.
Reporting mode and auto-updating

If sampling is enabled for a profile, the Auto-Updated Reports option screen allows you to change the report lists for both Full mode and Sample mode, regardless of your reporting mode privileges. In general, updates are faster if there are fewer auto-updated reports in Full mode. You should consider auto-updating in Full mode only those reports you need to meet your reporting requirements and using Sample mode to auto-update reports identifying overall trends.
N950001
To specify which reports auto-update

1. View the profile whose reports you want to manage. 2. Click the Options tab. 3. From the Options panel select Reporting > Auto-Updated Reports Reports. The Auto-Updated Reports option screen opens. 4. As desired, select and move reports between the two lists to specify which reports auto-update.
Creating custom metrics
5. If sampling is enabled for the profile, the initial set of lists controls auto-updating for Full reporting mode. To specify auto-updating for reports running in Sampled mode, click Edit Sample Reports Reports.
N8D0001

N8D0007
About custom metrics To create a custom filtered metric To create a multiple input custom metric To edit a custom filtered metric To edit a multiple input custom metric To delete a custom metric
About custom metrics

You can create metrics that will be available for use on any report in the profile. You can create two types of custom metrics: Metrics based on existing metrics, but with added filters Metrics that are derived from mathematically combining two existing metrics. Once you create a custom metric, it can be used to build other custom metrics, so it is possible to build more complex computations using multiple variables by nesting custom metrics.
N960001
To create a custom filtered metric

If you are adding filter groups to the custom filtered metric, you must define the filter group before performing this task. 1. While working with the profile, click Options Options. 2. In the left panel, under Reporting click Custom Metrics Reporting, Metrics. The Custom metric definitions screen opens. 3. Click Add Add. The Custom metric type screen opens. 4. In the Select custom metric type list, select Filtered Metric Metric. 5. Click Continue Continue. The Custom metric definition screen opens. 6. In the Name field, enter a name for the metric. The name is used internally. The name must be a single word, with only alphanumeric characters, and the first character must be a letter. 7. In the Title field, enter a title for the metric.
Version 8.2.1 127
The title appears in lists of metrics. It is also the basis for the title of the column containing the metric data. 8. In the Description field, enter a description for the metric. The description is the explanation of the metric's column that appears in the page help for the report. 9. From the Base metric list, select the metric that provides the data to be filtered for the current metric. 10. Check the Graphable field to have the data from this metric to be available for graphing in the report graph. 11. Check the Display percentage of total field to have a percentage to display in the column as well as a number. 12. From the Alignment list, select how the values are aligned in the report column. The options are Center, Left, and Right. 13. In the Minimum twips field, enter the minimum number of twips for the metric's column in reports. A twip equals 1/1440 of an inch. This option affects only those reports that are exported in RTF format (usually for use in Microsoft Word). 14. In the Recommended twips field, enter the recommended number of twips for the metric's column in reports. Unica NetInsight tries to make the column the recommended width. 15. Click Continue Continue. The Filters for . . screen opens. 16. Add one or more filters or filter groups to the custom metric. a. Click Add Add. The Available filters screen opens. b. Select a dimension, or to add a defined filter group, select Filter Group Group. c. Click Continue Continue. If you select a dimension, the Filter description screen opens. If you select Filter Group a list of defined filter groups open. Group, d. Complete the screen as required: If you selected a string dimension, select that or that do not from the first list. Then select a matching type from the second list. Then enter a string in the field, or select a value from the Or select from this menu list.
128
If you selected a numeric dimension, select a value from the list. If you selected Filter Group select the filter group to use. Group,
Click Add as Group to add the complete filter group, so you are not able to remove individual filters from the custom metric. Or click Add as Filters to add all filters from the group individually, so you can delete filters from the custom metric. e. Click Continue Continue. f. Repeat steps a through e until you have added all required filters.
g. Click Continue Continue. The custom metric is now available on the Metrics page of the Custom Report Wizard Wizard. To make the custom metric available on the Discovery Panel you must add it to a Panel, group in one or more metrics lists.
N970001
To create a multiple input custom metric

1. While working with the profile, click Options Options. 2. In the left panel, under Reporting click Custom Metrics Reporting, Metrics. The Custom metric definitions screen opens. 3. Click Add Add. The Custom metric type screen opens. 4. In the Select custom metric type list, select Multiple Input Metric Metric. 5. Click Continue Continue. The Custom metric definition screen opens. 6. In the Name field, enter a name for the metric. The name is used internally. The name must be a single word, with only alphanumeric characters, and the first character must be a letter. 7. In the Title field, enter a title for the metric. The title appears in lists of metrics. It is also the basis for the title of the column containing the metric data. 8. In the Description field, enter a description for the metric. The description is the explanation of the metric's column that appears in the page help for the report. 9. From the Metric 1 list, select the first metric to combine. If you are dividing metric values, Metric 1 is the number that is divided. 10. From the Metric 2 list, select the second metric to combine. If you are dividing metric values, Metric 2 is the number that is divided by
Version 8.2.1
129
11. From the Operation list, select the operation you want to use to combine the two metrics. 12. If you selected a floating point operation, select the number of decimal places to use from the Precision list. 13. Check the Graphable field to have the data from this metric to be available for graphing in the report graph. 14. Check the Display percentage of total field to have a percentage to display in the column as well as a number. 15. From the Alignment list, select how the values are aligned in the report column. The options are Center Left and Right Center, Left, Right. 16. In the Minimum twips field, enter the minimum number of twips for the metric's column in reports. A twip equals 1/1440 of an inch. This option only affects reports that are exported in RTF format (usually for use in Microsoft Word). 17. In the Recommended twips field, enter the recommended number of twips for the metric's column in reports. Unica NetInsight tries to make the column the recommended width. 18. Click Continue Continue. The custom metric is now available on the Metrics page of the Custom Report Wizard Wizard. To make the custom metric available on the Discovery Panel you must add it to a Panel, group in one or more metrics lists.
N980001
To edit a custom filtered metric

If you are adding filter groups to the custom filtered metric, you must define the filter group before performing this task. 1. While working with the profile, click Options Options. 2. In the left panel, under Reporting click Custom Metrics Reporting, Metrics. The Custom metric definitions screen opens. 3. Select the custom filtered metric to edit. 4. Click Edit Edit. The Custom metric type screen opens. 5. In the Title field, edit a title for the metric. The title appears in lists of metrics. It is also the basis for the title of the column containing the metric data. 6. In the Description field, edit a description for the metric.
130
The description is the explanation of the metrics column that appears in the page help for the report. 7. From the Base metric list, select the metric that provides the data to be filtered for the current metric. 8. Check the Graphable field to have the data from this metric to be available for graphing in the report graph. 9. Check the Display percentage of total field to have a percentage to display in the column as well as a number. 10. From the Alignment list, select how the values are aligned in the report column. The options are Center, Left, and Right. 11. In the Minimum twips field, enter the minimum number of twips for the metric's column in reports. A twip equals 1/1440 of an inch. This option affects only reports that are exported in RTF format (usually for use in Microsoft Word). 12. In the Recommended twips field, enter the recommended number of twips for the metric's column in reports. Unica NetInsight tries to make the column the recommended width. 13. Click Continue Continue. The Filters for . . screen opens. 14. Add one or more filters or filter groups to the custom metric as necessary. a. Click Add Add. The Available filters screen opens. b. Select a dimension, or to add a defined filter group, select Filter Group Group. c. Click Continue Continue. If you select a dimension, the Filter description screen opens. If you select Filter Group a list of defined filter groups open. Group, d. Complete the screen as required: If you selected a string dimension, select that or that do not from the first list. Then select a matching type from the second list. Then enter a string in the field, or select a value from the Or select from this menu list. If you selected a numeric dimension, select a value from the list. If you selected Filter Group select the filter group to use. Group, Click Add as Group to add the complete filter group, so you are not able to remove individual filters from the custom metric. Or click Add as Filters to add all filters from the group individually, so you can delete filters from the custom metric.
Version 8.2.1 131
e. Click Continue Continue. f. Repeat steps a through e until you have added all required filters.
g. Click Continue Continue. 15. Edit filters or filter groups as necessary. a. Select the filter or filter group to edit. b. Click Edit Edit. If you select a dimension, the Filter description screen opens. If you select Filter Group a list of defined filter groups open. Group, c. Complete the screen as required: If you selected a string dimension, select that or that do not from the first list. Then select a matching type from the second list. Then enter a string in the field, or select a value from the Or select from this menu list. If you selected a numeric dimension, select a value from the list. If you selected Filter Group select the filter group to use. Group, Click Add as Group to add the complete filter group, so you are not able to remove individual filters from the custom metric. Or click Add as Filters to add all filters from the group individually, so you can delete filters from the custom metric. d. Click Continue Continue. e. Repeat steps a through e until you have edited all required filters. f. Click Continue Continue.
16. Delete filters or filter groups as necessary. a. Select the filter or filter group to delete. b. Click Delete Delete. 17. Click Continue Continue. The updated custom metric is now available on the Metrics page of the Custom Report Wizard Wizard. To make the custom metric available on the Discovery Panel you must add it to a Panel, group in one or more metrics lists.
N990001
To edit a multiple input custom metric

1. While working with the profile, click Options Options. 2. In the left panel, under Reporting click Custom Metrics Reporting, Metrics. The Custom metric definitions screen opens.
3. Select the multiple input custom metric to edit. 4. Click Edit Edit. The Custom metric definition screen opens. 5. In the Title field, edit a title for the metric. The title appears in lists of metrics. It is also the basis for the title of the column containing the metric data. 6. In the Description field, edit the description for the metric. The description is the explanation of the metrics column that appears in the page help for the report. 7. From the Metric 1 list, select the first metric to combine. If you are dividing metric values, Metric 1 is the number that is divided. 8. From the Metric 2 list, select the second metric to combine. If you are dividing metric values, Metric 2 is the number that is divided by 9. From the Operation list, select the operation you want to use to combine the two metrics. 10. If you selected a floating point operation, select the number of decimal places to use from the Precision list. 11. Check the Graphable field to have the data from this metric to be available for graphing in the report graph. 12. Check the Display percentage of total field to have a percentage to display in the column as well as a number. 13. From the Alignment list, select how the values are aligned in the report column. The options are Center Left and Right Center, Left, Right. 14. In the Minimum twips field, enter the minimum number of twips for the metric's column in reports. A twip equals 1/1440 of an inch. This option only affects reports that are exported in RTF format (usually for use in Microsoft Word). 15. In the Recommended twips field, enter the recommended number of twips for the metric's column in reports. Unica NetInsight tries to make the column the recommended width. 16. Click Continue Continue. The custom metric is now available on the Metrics page of the Custom Report Wizard Wizard. To make the custom metric available on the Discovery Panel you must add it to a Panel, group in one or more metrics lists.
N9A0001
Version 8.2.1
133
To delete a custom metric

1. While working with the profile, click Options Options. 2. In the left panel, under Reporting click Custom Metrics Reporting, Metrics. The Custom metric definitions screen opens. 3. Select the custom metric to delete. 4. Click Delete Delete. The Custom metric definition screen opens. 5. Click Continue Continue. The custom metric is no longer available.
N8E0001
Extending the data model

N8E000A
About the data model About extending the data model To add a data model extension package About deleting or editing data model extension packages
About the data model

The Unica NetInsight data model describes the tables, or entities, in the Unica NetInsight database and the relationships between them. These entity definitions can then be used to define the variables, dimensions, and metricsthe report componentsthat are available to the user when defining and using Unica NetInsight reports.
N9B0001
About extending the data model

You can install packages that extend the default Unica NetInsight data model to include new entities, variables, dimensions, and metrics. Data model extension packages are usually created to facilitate bringing data from an external data source into Unica NetInsight. Data model extension packages include two XML filesa data model extensions file and an output formatting extensions file. The data model extensions file defines the entities and report components. The output formatting extensions file provides formatting information for the new dimensions and metrics. Once you have copied the XML files to the location indicated by the package creator, you need to tell Unica NetInsight to use the files.
N9C0001
134
Creating filter groups
To add a data model extension package

1. View the profile for which you want to extend the data model. 2. Click the Options tab. 3. In the Options panel, select Reporting > Data Model Extensions Extensions. 4. Click Add Add. 5. In the Name box, enter a unique name for the extension package. 6. In the Data model extension path box, enter the path and filename of the data model extensions file. 7. In the Output formatting extension path box, enter the path and filename of the output formatting extension file. 8. Click Save Options and then click Continue Continue.
N9D0001
About deleting or editing data model extension packages

You can make changes to the list of data model extension packages. If you delete a data model extension package from a profile and the dimensions, metrics, or filters in the package are used on any of the reports in the profile, the profile will be unusable. You will be unable to update the profile. You should be sure to remove all of the packages dimensions, metrics, and filters from all reports in the profile before deleting the package. If you have any questions, contact technical support.
N8F0001

N8F000A
About filter groups To create a filter group To edit a filter group To edit filters for a filter group To delete a filter group
About filter groups

When users create multiple reports, they may often need to apply the same filters repeatedly. Filter groups enable you to specify a set of filters (including custom filters) once and then apply it to many reports. When a user applies a filter group containing multiple filters, the user can choose to apply the filter as a single group or as the individual filters within the group. If the filters are applied as a group, the filters can only be removed as a single unit. If the filters are added as individual filters, the user can independently select and remove specific filters, while keeping others.
Version 8.2.1 135

N9E0001
To create a filter group

1. While working with the profile, click Options Options. 2. In the left panel, under Reporting click Filter Groups Reporting, Groups. The Filter group definitions screen opens. 3. Click Add Add. The Filter group description screen opens. 4. In the Name of filter group field, enter a one-word name. The name is used internally. You can use only alphanumeric characters. Once the filter group is created, you cannot change the name. 5. In the Title of filter group field, enter a title. The title appears in the list of filters. 6. Click Save Options then click Continue Options, Continue. The Filters that belong to screen opens. 7. Add one or more filters or other filter groups to the filter group. a. Click Add Filter Filter. The Available filters screen opens. b. Select a dimension, or to add a defined filter group, select Filter Group Group. c. Click Continue Continue. If you select a dimension, the Filter description screen opens. If you select Filter Group a list of defined filter groups open. Group, d. Complete the screen as required: If you selected a string dimension, select that or that do not from the first list. Then select a matching type from the second list. Then enter a string in the field, or select a value from the Or select from this menu list. If you selected a numeric dimension, select a value from the list. If you selected Filter Group select the filter group to use. Group, Click Add as Group to add the complete filter group, so you are not able to remove individual filters from the custom metric. Or click Add as Filters to add all filters from the group individually, so you can delete filters from the custom metric. e. Click Continue Continue. f. Repeat steps a through e until you have added all required filters.
136
g. Click Save Filters Filters. 8. Click Continue Continue. You must now apply the filter group to a report.
N9F0001
To edit a filter group

These instructions describe how to change the filter group's title. You can also edit the filters included with the filter group. 1. While working with the profile, click Options Options. 2. In the left panel, under Reporting click Filter Groups Reporting, Groups. The Filter group definitions screen opens. 3. Select the filter group to edit. 4. Click Edit Edit. The Filter group description screen opens. 5. In the Title of filter group field, enter a title. The title appears in the list of filters. 6. Click Save Options then click Continue Options, Continue.
NA00001
To edit filters for a filter group

1. While working with the profile, click Options Options. 2. In the left panel, under Reporting click Filter Groups Reporting, Groups. The Filter group definitions screen opens. 3. Select the filter group for which you want to edit filters. 4. Click Filters Filters. The Filters that belong to screen opens. 5. Add one or more filters or defined filter groups to the filter group as necessary. a. Click Add Filter Filter. The Available filters screen opens. b. Select a dimension, or to add a defined filter group, select Filter Group Group. c. Click Continue Continue. If you select a dimension, the Filter description screen opens. If you select Filter Group a list of defined filter groups opens. Group, d. Complete the screen as required:
Version 8.2.1
If you selected a string dimension, select that or that do not from the first list.
137
Then select a matching type from the second list. Then enter a string in the field, or select a value from the Or select from this menu list. If you selected a numeric dimension, select a value from the list. If you selected Filter Group select the filter group to use. Group, Click Add as Group to add the complete filter group, so you are not able to remove individual filters from the custom metric. Or click Add as Filters to add all filters from the group individually, so you can delete filters from the custom metric. e. Click Continue Continue. f. Repeat steps a through e until you have added all required filters.
g. Click Continue Continue. 6. Edit filters or filter groups as necessary. a. Select the filter or filter group to edit. b. Click Edit Filter Filter. If you select a dimension, the Filter description screen opens. If you select Filter Group a list of defined filter groups opens. Group, c. Complete the screen as required: If you selected a string dimension, select that or that do not from the first list. Then select a matching type from the second list. Then enter a string in the field, or select a value from the Or select from this menu list. If you selected a numeric dimension, select a value from the list. If you selected Filter Group select the filter group to use. Group, Click Add as Group to add the complete filter group, so you are not able to remove individual filters from the custom metric. Or click Add as Filters to add all filters from the group individually, so you can delete filters from the custom metric. d. Click Continue Continue. e. Repeat steps a through e until you have edited all required filters. f. Click Continue Continue.
7. Delete filters or filter groups as necessary. a. Select the filter or filter group to delete. b. Click Delete Filter Filter. 8. Click Back to Filter Groups Groups.
NA10001
138
Accessing geographic data
To delete a filter group

Deleting a filter group impacts all reports and custom metrics to which you added the filter group as a group, as well as any saved reports that use the report or custom metric. 1. While working with the profile, click Options Options. 2. In the Options panel, select Reporting > Filter Groups Groups. The Filter group definitions screen opens. 3. Select the filter group to delete. 4. Click Delete Delete. The Filter group description screen opens. 5. Click Continue Continue.
N900002
Accessing geographic data

N900009
About the NetInsight geographic database To configure a profile to use the geographic database
About the NetInsight geographic database

Unica NetInsight provides access to reports that show geographic distribution of data via color-coded maps. Map regions are clickable, allowing users to drill up and down to different reports. To access the geographic reports, you must download the geographic database from Unica and configure your profiles to use it. Download the NetInsight Geographic Database from the Product Download Center on Unica Customer Central and save it to a location that is accessible to your Unica NetInsight installation.
NA20002
To configure a profile to use the geographic database

Download the NetInsight Geographic Database from Unica before completing this task. 1. With the profile you want to configure displayed, select Options > Reporting > Integrations Integrations. 2. In the Geographic data section of the Integrations page, enter the path to the geographic database file (including the file name) in the field. 3. Click Save Options Options. If you want to generate geographic reports for data you have already imported, you must delete all the data in your profile and reimport your log files. (Note: If you do not have all the log files you have imported into this profile, you lose data permanently by choosing this option.) To delete your profile data, click Delete Profile Data Data.
Version 8.2.1 139
After you update your profile, select Reports > Geographic Analysis to access the geographic reports. If you do not have the correct version of the geographic database for your version of NetInsight, you will receive an error when you attempt to update the profile. See the NetInsight Geographic Database page on Unica Customer Central for the latest version.
N910001
Configuring integration models

N91000A
About integrations To configure a profile to use an integration module To edit an integration module To delete an integration module Paid search integration fields Privileges for integrations
About integrations
Integration modules enable you to incorporate data from another source into NetInsight using a commercially available module (as opposed to a lookup or rewrite data conduit, which you must create). Your Unica NetInsight license must be enabled for an integration module before you can use it. An integration module must be configured in each profile in which you want to use it.
NA30001
To configure a profile to use an integration module

Your Unica NetInsight license must be enabled for an integration module before you can configure a profile to use it. 1. Open the profile in which you want to use the integration module. 2. Click the Options tab. 3. In the Options panel, select Reporting > Integrations Integrations. 4. Click Add Add. 5. Select an integration from the list of available integrations and click Continue Continue. The integrations that have already been configured for this profile do not appear in the list. If an integration is listed in gray, your Unica NetInsight license is not enabled for this integration. The screen that appears depends on the integration module you are adding. 6. Enter the requested information. To return all fields to their default values, click Reset Options Options.
Configuring integration models
7. Click Save Options Options. If you have entered connection information, Unica NetInsight contacts the appropriate server to validate your information.
NA40001
To edit an integration module

1. Open the profile in which you want to edit the integration module. 2. Click the Options tab. 3. In the Options panel, select Reporting > Integrations Integrations. 4. Select an integration module and click Edit Edit. The screen that appears depends on the integration module you are editing. 5. Edit the information. To return all fields to their previously defined values, click Reset Options Options. 6. Click Save Options Options. Unica NetInsight contacts the appropriate server to validate your information.
NA50001
To delete an integration module

1. Open the profile in which you want to delete the integration module. 2. Click the Options tab. 3. In the Options panel, select Reporting > Integrations Integrations. 4. Select the integration module you want to delete and click Delete Delete.
NA60001
Paid search integration fields

Field Enable import check box Description Select the check box to enable importing of the paid search integration data. Clear the check box to disable the importing of paid search integration data. Select the check box to enable the paid search integration reports, dimensions, metrics, and filters. Clear the check box to make paid search integration dimensions, metrics, and filters unavailable for use and to prevent reports based on these dimensions or metrics from being pre-generated. User name for your company's Unica paid search integration account
Enable reporting check box
Username
Version 8.2.1
141
6 - Configuring Reporting Options Field Password Description Password for your company's Unica paid search integration account Password for your company's Unica paid search integration account
Re-enter password
NA70001
Privileges for integrations

The following new privilege has been added to control access to integration module configuration:
Privilege Options: Reporting: Integrations
N920002
Option Integrations options screens
Specifying the date range of pre-generated reports

N92000B
About report generation options About aggregate data To edit dates for which reports are pre-calculated To edit dates for which aggregate data is generated
About report generation options

By default, when you update a profile, Unica NetInsight pre-generates reports for the latest three months for which it has data. You can shorten the date range for which reports are pre-calculated. This will speed up the update process, especially for profiles with large data sets. You can still view reports for dates outside the new range, but data in those reports will not be calculated at the time of the request. Conversely, you can lengthen the date range for pre-calculated reports. This will slow updates but speed up the rendering of older reports. Administrators can also set default report generation options to apply to each new profile users create.
NA80002
142
Specifying the date range of pre-generated reports
About aggregate data

Aggregate data allows Unica NetInsight to generate dynamic, date-based reports more quickly. It consists of totals calculated from the data stored in other tables. The calculations are run when a profile is updated, and the data written to special aggregate tables. For example, the views table contains each page view found in your log files, and the aggviews table contains the total number of views and visits for each page on your site, grouped by a specific date. The date range for which aggregate data is calculated and retained is configurable (the default is three months). When an update is run on a profile , any new data that is now within the aggregate range is added to the aggregate tables. Any existing data that is falls outside of the range is deleted. If there is new log data for the current day, any existing aggregate data for that day is dropped and replaced. One way to view aggregates is as the trading of disk space for faster report generation. However, the calculations required to compile aggregates can also impact the time it takes updates to run. Thus for optimal performance it's preferable to only generate aggregates for the time frame that constitutes the bulk or your reporting needs. This should be a range identical to the largest potential period for which you pre-generate reports. For example, if you pre-generate reports for the latest year, quarter, and month, the largest potential range for which you will have pre-generated reports is 365 days. (Note that because report pre-generation settings are calendar-based, the range could also be much shorter than that. For example, on January 1 the latest year, quarter, and month will each contain only one day's worth of data.) For more information on tuning aggregate data generation, see the Unica NetInsight Tuning Guide.
NA90002
To edit dates for which reports are pre-calculated

1. In Profile Options, select Reporting > Report Generation Generation.
Or, to set defaults for all new profiles, select the Administration icon ( )> Options tab, then from the Unica NetInsight options drop-down menu, select Edit Default Web Server Options Options. 2. For Generate reports for select one or more of the following in any combination: To pre-calculate reports for all months, check All Months Months. To pre-calculate reports for a specific time period (for example years, months, weeks) check its box and enter a value.
Latest is relative to the last date for which the profile contains data, not the current date.
NAA0002
Version 8.2.1
143
To edit dates for which aggregate data is generated

1. In Profile Options, select Reporting > Report Generation Generation.
Or, to set defaults for all new profiles, select the Administration icon ( )> Options tab, then from the Unica NetInsight options drop-down menu, select Edit Default Web Server Options Options. 2. For Generate aggregates for select None All Data or specify a time period. None, Data, Unless you have a specific performance reason to do otherwise, a general rule is to generate aggregates for the same time frame that you pre-generate reports. Latest is relative to the last date for which the profile contains data, not the current date.
N930001
Specifying reportability of dimensions

N93000A
About reportable dimensions To change reportable dimensions
About reportable dimensions

A reportable dimension is a dimension that can be used by profile reports. A reportable dimension is one that is supported by the profile option or one that is assumed to be present and valid. For example, the Host dimension is reportable because Unica NetInsight assumes the log file contains host data. The Banner Ad dimension is only reportable when one or more banner ads have been defined in the profile options. For some dimensions, there is no way to determine based on the profile options whether data for those dimensions is present in the log files or not. You can classify a dimension as reportable or non-reportable. By default, almost all dimensions are classified as reportable. A non-reportable dimension does not have a corresponding pre-generated report and is not listed in the Discovery Panel Panel.
NAB0001
To change reportable dimensions

If you make a dimension non-reportable: The dimension still appears in the Custom Report Wizard. No warning or error occurs if a user includes it in a report using the Custom Report Wizard. While the report can be run and saved, it will not appear in any report list. Any existing report containing the non-reportable dimension no longer appears in any report list (for example, the default pre-generated report for that dimension no longer appears in the Available Reports list). Any report containing the nonreportable dimension is still visible and accessible and can be run through the Custom Report Wizard.
144
Specifying the sample size
Making a non-reportable dimension reportable again will automatically enable any reports that did not previously display in a report list, if that report now contains only reportable dimensions. You can make some, but not all, dimensions in a dimension hierarchy nonreportable, as doing so can cause errors when users view reports for the dimension hierarchy. 1. While working with the profile, click Options Options. 2. In the Options panel, under Reporting click Reportable Dimensions Reporting, Dimensions. The Dimensions to be reported screen opens. 3. To make a currently reportable dimension non-reportable, in the Reportable Dimensions list, select the dimension and click Add dimension (the left-pointing arrow). The dimension moves to the Available dimensions list. 4. To make a currently non-reportable dimension reportable, in the Available Dimensions list, select the dimension and click Add dimension (the right-pointing arrow). The dimension moves to the Reportable dimensions list. 5. Click Save Options then Continue Options, Continue.
N940001

N940007
About data samples To specify the sample size Permissions for sampling features
About data samples

You can allow users to work with reports that display projections based on a random sample of the profile data. Working with a profile's full data set may be more timeconsuming than is practical for ad-hoc analysis. Some tasks, such as exploring data or creating reports, can be accomplished more quickly using a subset of the data with the calculations extrapolated to the full data set. You can enable the sample reporting mode by specifying a non-zero sample size in the profile options. The sample size is defined as a percentage of visitors. When a profile with a non-zero sample size specified is updated, Unica NetInsight does the following: Takes a random sample of the specified size of all new visitors in the data imported during this update and stores all data associated with these visitors in sample tables in the profile's database. For example, if the sample size were 5% and there were 100 new visitors imported during the update, Unica NetInsight would randomly select 5 of the new visitors and store their data in the sample tables.
145
Version 8.2.1
Looks for any new visits by visitors already in the sample and adds information about those visits to the sample tables.
Spider and robot visitors also are sampled at the specified percentage. After you specify a profile's visitor sample percentage for the first time, update the profile to make sample reports available. If you are changing an existing non-zero sample percentage, run the - resample command-line option followed by the recalc -sampleonly command-line option to update the sample tables and reports.
About the sample size

The sample size is defined as a percentage of visitors in the full data set. You may enter a numeric value between 0 and 100 with precision up to three decimal places to the right of the decimal point. If you know you want the sample of visitors to include a specific count of a certain database entity (such as visits, events, or views), you can use the -samplecalc command-line option to estimate the percentage of visitors to use to return a sample with the desired entity count.
Changing the sample size

Each time you change the visitor sample percentage option, you should clear the sample tables and resample the profile data. You can do this without disturbing your non-sample tables by running the -resample command-line option followed by the recalc -sampleonly option. If you do not run -resample, when you update the profile, new data is sampled at the new percentage. This results in a sample set that contains the previous percentage of old data and the new percentage of new data. You can fix this by running -resample followed by -recalc -sampleonly.
Changing the sample data

You can also change the data in the sample while leaving the sample size the same. Unica NetInsight uses a random number generator to select new visitors for the sample. The random number generator algorithm is determined by a seed value. A given seed selects the same set of visitors every time from a fixed set of data. If you would like to see a different sample, run the -reseed command-line option to change the seed and then run the -resample command-line option to clear and repopulate the sample tables followed by the -recalc -sampleonly option to generate the reports.
NAC0001
To specify the sample size

1. View the profile. 2. Click the Options tab. 3. Under Reporting click Sampling Reporting, Sampling. The Sampling options screen appears. 4. In the Visitor sample percentage field, enter the percentage of visitors in the full data set you want in the sample.
146
You can specify up to three decimal places to the right of the decimal point. Use a value of zero to disable sampling (not generate any sample tables or reports). 5. Click Save Options Options. If this is the first time a sample size has been entered for the profile, you must update the profile before users can select a reporting mode. If you have changed an existing sample value, you must run the -resample command-line option followed by the recalc -sampleonly option to use the new sample size. Any previous sample data is used until the profile is resampled.
NAD0001
Permissions for sampling features

You can prevent users from changing the sample size through the interface. You can also remove the Reporting Mode option to prevent users from changing the reporting mode and limit them to their default mode for each profile. You can also prevent users from saving reports to be automatically generated in Full mode or Sample mode. The following new privileges have been added to control access to sampling:
Privilege Options: Reporting: Sampling Interface: Icon: Reporting Mode Option Visitor sample percentage option Reporting Mode option on Reports and Custom tabs Reporting mode option on Email and Export options screens Automatically update sample report option
Interface: Sampling: Email/Export Change Level
Interface: Custom Report Wizard: Auto Update Sample Report Interface: Custom Report Wizard: Auto Update Full Report
Automatically update full report option
Version 8.2.1
147
N1044C
7 Creating Reports CreatingReports

NAE0001
About creating reports To create a standard report Creating a crosstab report To create a trend report Creating a custom dashboard Creating a path summary Creating a scenario report Specifying a time frame Specifying dimensions Specifying metrics Creating an A/B report Creating a comparative report To save a customized report Changing the content of a report
About creating reports

Unica NetInsight provides you with a number of useful pre-defined reports. Sometimes, however, you need to analyze your information in a way not available in a pre-defined report. Fortunately, Unica NetInsight enables you to create reports. Some reports might be needed for onetime use. Others you will want to save and have updated whenever the profile is updated. Either way, you can email and archive the reports you create. You can create several types of reports:
148
Standard reports (including crosstab reports and Path Summaries to, from, and between specific pages) Custom dashboards Scenario reports
To create a standard report
Trend reports
You can create reports using one of several methods: Customizing an existing report Defining a new report
The instructions for creating the reports vary depending on the method you are using and the type of report you are creating. However, regardless of type, Unica NetInsight displays the Report Summary page where you can edit, filter, run, save, export, and archive the report.
NAF0001
To create a standard report

You can create a standard report for the profile you are viewing. 1. Begin creating the report in one of two ways: Through the Custom tab, or by basing the new report on an existing report through the Report Designer. a. Click the Custom tab. The Managing Reports screen opens. b. Click Create Report Report. c. Select Define New Report then Standard Report Report, Report. d. Continue with the steps below.
a. Click the Report Designer icon ( The Report Summary opens. b. Click Edit Edit. c. Continue with the steps below. At step 5, enter a new Report title title.
).
2. If you want to create a report for a fixed time frame, click the Calendar icon to display the calendar and specify the time frame whose data you want included in the report. a. To keep the results grouped by the specified time period even when the time period of the calendar changes, check Retain grouping when calendar changes changes. 3. Select the dimensions you want included in the report, then click Continue Continue. To create a crosstab report, select two or more dimensions. 4. Select the metrics you want included in the report, then click Continue Continue. You must have at least one metric.
Version 8.2.1
149
7 - Creating Reports
5. Enter the general report information, then click Continue Continue. The Filters screen opens. 6. Specify any filters you want applied to the report, then click Continue Continue. If you want to create a report for a relative time frame, create a date filter that specifies the time frame. The A/B Groups screen opens. 7. If you want to apply two sets of filters and compare the results, enter the two groups of filters, then click Continue Continue. The Report Summary page opens. You may now Run this report.
NB00002
Creating a crosstab report

NB0000B
About crosstab reports To create a crosstab report
About crosstab reports

A crosstab report is a standard report with two or more dimensions that lets you to analyze the relationships between those dimensions. When multiple dimensions are included in a report, Unica NetInsight creates a full permutation across the dimensions. That is, each unique value in the first dimension is paired with each unique value of each other dimension. You can include up to five dimensions per report--the application prevents you from adding more than that. Crosstab reports can be set up to display their results as either ungrouped or grouped. The default is grouped, meaning the values for each successive dimension are nested (indented) under the previous dimension's value. Dimensions can be nested up to five levels deep. When a report is set up as ungrouped, each distinct combination of of values appears in its own row. The report's title bar lists each dimension in the order it appears in the report. (Due to space limitations, nested values may not line up exactly with their dimension name in the title bar.) The first dimension value is expanded by default. Other dimensions must be expanded manually. To change the order of dimensions in a crosstab report, drag and drop them within the title bar. To sort dimensions in ascending or descending order, click the column label of the primary dimension. Values for nested dimensions are automatically sorted in the same manner as the primary dimension.
150
Creating a crosstab report
When you create a crosstab report, you can view path charts, 3-D bar charts, and stacked bar charts that display the primary and secondary dimensions and one metric. By default, the left-most metric in the report is displayed but you can choose any metric in the report to graph.
NBC0002
To create a crosstab report

To create a crosstab report: 1. On the Custom tab, click Create Report > Define New Report > Standard Report > Continue Or... Continue.
Click the Report Designer icon (
> Edit
2. If you want to create a report for a fixed time frame, click the Calendar icon and use the calendar to specify the time frame. 3. Select the dimensions you want then click Continue You can add up to five Continue. dimensions. The dimension at the top of the list is the primary dimension for the report. 4. Select the metrics you want then click Continue You must select at least one Continue. metric. 5. Select the method by which you want to group the results in the report.
Version 8.2.1
151
Select All Dimensions with Totals to rank entries by the primary dimension value. (Secondary dimensions are ranked within each primary dimension value.) For each metric, a value is displayed for each secondary dimension; a total is shown for each primary dimension. Select All Dimensions to rank entries by the primary dimension value. (Seconday dimensions are ranked within each primary dimension value.) For each metric, a value is displayed for secondary dimensions but not for the primary. Select No Grouping to rank entries by each primary/secondary value combination. (Different secondary values for the same primary value may not appear next to each other on the report.)
The remaining options depend on whether you chose to group results. If you selected one of the grouping options, select the number of primary values per report page and secondary values per primary value. If you selected No Grouping select the number of rows you want per report Grouping, page.
6. Click Continue Continue. 7. Specify any filters you want on the report. If you want to create a report for a relative time frame, create an appropriate date filter. Click Continue Continue. 8. If you want to apply two sets of filters and compare the resulting reports, enter the two groups of filters, then click Continue Continue. The Report Summary page opens. You can now run or save the report.
NB10001
To create a trend report

You can create a trend report for the profile you are viewing. 1. Click the Custom tab. The Managing Reports screen opens. 2. Click Create Report Report. 3. Select Define New Report then Trend report Report, report. 4. Click Continue Continue. 5. If you are creating a report for a fixed time frame, click the Calendar icon and use the calendar to specify the time frame. 6. Select the metrics you want included in the report, then click Continue Continue. You must select at least one metric. 7. Enter the general report information.
152
In the Group results by list, select the time period to group results by. To keep the results grouped by the specified time period even when the time period of the calendar changes, check Retain grouping when calendar changes changes.
Creating a custom dashboard
8. Click Continue Continue. The Filters screen opens. 9. Specify any filters you want applied to the report, then click Continue Continue. If you want to create a report for a relative time frame, create a date filter that specifies the time frame. The A/B Groups screen opens. 10. If you want to apply two sets of filters and compare the resulting reports, enter the two groups of filters, then click Continue Continue. The Report Summary page opens. You can now Run this trend report.
NB20001

NB20007
About dashboards To create a dashboard To create a graph dashboard section To create a text dashboard section To create a table dashboard section
About dashboards
Dashboards allow you to collect together relevant, key charts and textual data that can help you better monitor and understand your business on an ongoing basis. You can create an unlimited number of focused, subject-area reports displaying your key performance indicators (KPIs). You can create separate dashboards for different individuals or roles within your organization. You can filter dashboards to report only on the data that is relevant for the viewer. You can create and manage dashboards, which are collections of charts and data from reports within your profile. Profiles containing the dashboards can then be scheduled to update on a regular, periodic basis to consistently deliver up-to-date information. You can set up email tasks to automatically email dashboard reports to interested parties. You can also configure email alerts to send email to the appropriate people when a KPI exceeds some threshold.
About dashboard sections

Dashboards are composed of sections. A section can be one of three types: graph, text, or table. Graph sections contain a chart displaying a metric from one of the reports in the profile. Text sections contain one or more data fields. A data field displays a dimension value or an aggregate metric. A single text section can contain data from multiple reports in the profile.
Version 8.2.1 153
Data fields in text sections can be one of the following types: AverageDisplays the average value for the specified metric for the specified time period. TotalDisplays the sum of all values for the specified metric. TopDisplays the dimension value from the specified dimension with the highest value for the specified metric. BottomDisplays the dimension value from the specified dimension with the lowest value for the specified metric.
Table sections contain an entire report in tabular format, consisting of one dimension and one metric. You can use any report, including a crosstab report, as the data source for the table section; however, only the primary dimension of a crosstab report will be displayed in the table section.
NBD0001
To create a dashboard
You can create a dashboard within the profile you are viewing. 1. Click the Custom tab. The Managing Reports screen opens. 2. Click Create Report Report. 3. Select Define a new report then Dashboard report, Dashboard. 4. Click Continue Continue. 5. If you want to create a report for a fixed time frame, click the Calendar icon and use the calendar to specify the time frame. You can specify a relative time frame using date filters later in the process. 6. Specify each section in the dashboard by doing one of the following: You can edit a section by selecting it and clicking Edit You can delete a section by Edit. selecting it and clicking Delete Delete. a. Create a graph dashboard section b. Create a text dashboard section c. Create a table dashboard section d. Use a dashboard section from an existing dashboard 7. Arrange the sections the way you want them to appear in the dashboard, then click Continue Continue. Select a section and use the up and down arrow keys to move it up and down in the current column, and use the left and right arrows to move the section from one column to another. 8. Enter a report title, then click Continue Continue.
154
9. Specify any filters you want applied to the report, then click Continue Continue. If you want to create a report for a relative time frame, create a date filter that specifies the time frame. The A/B Groups screen opens. 10. If you want to apply two sets of filters and compare the resulting reports, enter the two groups of filters, then click Continue Continue. By default, the two groups are named Group A and Group B. You can change the names. The Report Summary page opens. You can now Run Save Email Archive or Export this dashboard report. Run, Save, Email, Archive,
NBE0001
To create a graph dashboard section

1. At the Designing the Dashboard screen, click Add Add. The Adding a Section screen opens. 2. In the Section title field, enter the text you want to label this section in the dashboard. If you leave this field blank, Unica NetInsight will use the name of the report entered in the Data source field as the section title. 3. In the Section type list, select Graph Graph. 4. In the Data source list, select the report to serve as the source of the data for the dashboard section. The default values of the other options on this screen may change, depending on the data source you select. 5. In the Type of graph list, select the type of graph that will be used to display the data in this section 6. In the Graph data set list, select the data set in the selected data source to provide the data for the dashboard section. 7. In the Values in graph list, select the number of values (1, 2, 3, 4, 5, 10, 15, 20, 25, 50, 75, or 100) that will appear in the graph for this dashboard section. An All data option is available for some data sources. You can also choose to use the default setting for the profile. 8. Clear the Hide axis title check box if you want the dashboard to display X,Y axis labels for this section. On pie charts, the Graph data set label will be displayed. 9. Click Continue Continue.
NBF0001
To create a text dashboard section

1. At the Designing the Dashboard screen, click Add Add.
Version 8.2.1 155
The Adding a Section screen opens. 2. In the Section title field, enter the text you want to label this section in the dashboard. If you leave this field blank, Unica NetInsight will use the name of the report entered in the Section links field as the section title. 3. In the Section type list, select Text Text. The remaining options on the page change. 4. In the Section links field, select the report to display when users click the section heading on the dashboard. Now you need to add the fields you want in the section. 5. Click Add Add. The Adding a Field screen appears. 6. In the Field title box, enter a title for the field. If you leave this field blank, Unica NetInsight uses the name of the report entered in the Report link field as the name of the field title. 7. In the Field type box, select a field type. The remaining options on the page may change depending on the field type you select. 8. Specify how to determine the value for the field using the options below that are appropriate for the field type: a. Time period (Average fields)the time period to use to determine the average. b. Metric (Total, Average and Top fields)the metric to supply the value for the field. c. Dimension (Top and Bottom fields)the dimension to supply the value. d. Order by (Top and Bottom fields)the metric to use to determine the top or bottom value for the specified dimension. 9. In the Report link box, select the report to display when users click the fields value in the dashboard. 10. Click Continue to add the field to the section. 11. Continue creating fields until you have created all the fields you want for this section. Fields appear in the dashboard section in the order they appear in the Fields list. You can use the Move Up and Move Down arrows to arrange the fields in the desired order. You can edit or delete a field by selecting it in the Fields list and clicking Edit or Delete Delete. 12. When the Fields list is complete, click Continue Continue.
NC00002
156
Creating a path summary
To create a table dashboard section

Use a table section to display an entire report in tabular format. A table section consists of only one dimension and one metric. If you want to display all columns of the report, you must use a Graph dashboard section and select line or bar chart. You can use any report, including a crosstab report, as the data source for the table section; however, only the primary dimension of a crosstab report will be displayed in the table section. 1. At the Designing the Dashboard screen, click Add Add. The Adding a Section screen opens. 2. In the Section title field, enter the text you want to label this section in the dashboard. If you leave this field blank, Unica NetInsight will use the data source name as the section title. 3. In the Section type list, select Table Table. The remaining options on the page change. 4. In the Data source field, select the report to serve as the source of the data for the dashboard section. a. If you select an A/B report as the data source, the Group to graph field displays. Select either a group, the delta, or the comparison to display in the dashboard section. 5. In the Dimension field, select a dimension to display in the table. 6. In the Metric field, select a metric to display in the table. 7. In the Rows field, select the number of rows you want to display in the dashboard section. The Rows field does not display if your selected data source is a scenario report. 8. Click Continue Continue.
NB30001

NB3000A
To create a Path Summary between two specific pages To create a Path Summary from a specific page To create a Path Summary to a specific page
Version 8.2.1
157
To create a Path Summary between two specific pages

A Path Summary between two specific pages report enables you to analyze the most common paths visitors travel on your site between any two specified pages. 1. View the profile in which you want to create the custom report. 2. Click the Custom tab. 3. Click Create Report Report. 4. Click Define a new report click Path Summary between two specific pages and report, pages, click Continue Continue. The Specifying the Page page appears. 5. If you are creating a report for a fixed time frame, use the calendar to select the time frame whose data you want included in the report. 6. In the Paths start on box, enter the page on which the paths you want to track originated. Or, you can select a page from the list of the most popular pages on the site. Click Continue Continue. 7. In the Paths end on box, enter the page at which the paths you want to track concluded. Or, you can select a page from the list of the most popular pages on the site. Click Continue Continue. The Dimensions page appears with the Path between dimension in the Selected dimensions list. 8. Click Continue Continue. 9. Select the metrics you want in the report and click Continue Continue. 10. In the Report title box, enter the title you want for this report. The title appears at the top of the report and in report lists. 11. In the Number of rows per page list, select the number of rows you want per page of the report. 12. In the Maximum length of path list, select the maximum number of pages that can be in the paths you track. Paths will be truncated to fit this maximum. This option is not available if the Style of report option is set to Tree view view. 13. In the Column to sort by list, select the name of the column by which you want to rank items in the report. 14. In the Sort order list, select either Ascending or Descending Descending. 15. In the Type of graph list, select the graph format you want to use.
16. In the Graph data set list, select the type of data you want to display in the graph. 17. In the Page help box, enter the text you want to use as the introduction paragraph to the page help for the report. 18. Click Continue The Filters page appears. Continue. 19. Specify any filters you want applied to the report. 20. If you are creating a report for a relative time period, specify a date filter that defines the time period. 21. Click Continue Continue. The A/B Groups page appears. 22. If you want to see the report data for two sets of filters, specify the filter sets. 23. Click Continue Continue. The Report Summary page appears.
NC20001
To create a Path Summary from a specific page

A Path Summary from a specific page report enables you to analyze the most common paths visitors travel on your site away from a given starting page. For example, you can create a report showing where visitors usually go after they view your home page. 1. View the profile in which you want to create the custom report. 2. Click the Custom tab. 3. Click Create Report Report. 4. Click Define a new report click Path Summary from a specific page, and click report, Continue Continue. The Specifying the Page page appears. 5. If you are creating a report for a fixed time frame, use the calendar to select the time frame whose data you want included in the report. 6. Enter the page on which the paths you want to track originated. Or, you can select a page from the list of the most popular pages on the site Click Continue Continue. The Dimensions page appears with the Path from dimension in the Selected dimensions list. 7. Click Continue Continue. 8. Select the metrics you want in the report. Click Continue Continue. 9. In the Report title box, enter the title you want for this report. The title appears at the top of the report and in report lists.
Version 8.2.1 159
10. In the Style of report list, select an option. Select Linear view to create a report that lists each path away from the origination page from start to finish. Paths are sorted according to the metric values for the path as a whole. Select Tree view to create a report that lists the first page in each path away from the origination page. You can expand each row to show the most popular second pages in paths that started on the origination page and went through the first-level page listed in the row. It is called a tree view because the origination page can be pictured as a tree trunk with the first-level pages as primary branches and the second-level pages as secondary branches.
11. In the Number of rows per page list, select the number of rows you want per page of the report. 12. In the Number of pages per row list, select the number of second-level pages that will be listed for each first-level page listed in the report. This option is not available if the Style of report option is set to Linear View View. 13. In the Maximum length of path list, select the maximum number of pages that can be in the paths you track. Paths will be truncated to fit this maximum. (This option is not available if the Style of report option is set to Tree view view.) 14. In the Column to sort by list, select the name of the column by which you want to rank items in the report. 15. In the Sort order list, select either Ascending or Descending Descending. 16. In the Type of graph list, select the graph format you want to use. If the Style of report option is set to Tree view the Type of graph list will contain the view, additional graph type Path chart chart. 17. In the Graph data set list, select the type of data you want to display in the graph. 18. In the Page help box, enter the text you want to use as the introduction paragraph to the page help for the report. 19. Click Continue Continue. The Filters page appears. 20. Specify any filters you want applied to the report. 21. If you are creating a report for a relative time period, specify a date filter that defines the time period. 22. Click Continue Continue. The A/B Groups page appears. 23. If you want to see the report data for two sets of filters, specify the filter sets. 24. Click Continue Continue. The Report Summary page appears.

NC30001
To create a Path Summary to a specific page

A Path Summary to a specific page report enables you to analyze how visitors usually arrive at a given page on your Web site. For example, you could analyze which pages visitors usually view right before they view your order form. 1. View the profile in which you want to create the custom report. 2. Click the Custom tab. 3. Click Create Report Report. 4. Click Define a new report click Path Summary to a specific page, and click report, Continue Continue. The Specifying the Page page appears. 5. If you are creating a report for a fixed time frame, use the calendar to select the time frame whose data you want included in the report. 6. Enter the page on which the paths you want to track concluded. Or, you can select a page from the list of the most popular pages on the site. Click Continue Continue. 7. The Dimensions page appears with the Path to dimension in the Selected dimensions list. 8. Click Continue Continue. 9. Select the metrics you want in the report. Click Continue Continue. 10. In the Report title box, enter the title you want for this report. 11. In the Style of report list, select an option. Select Linear view to create a report that lists each path toward the concluding page from start to finish (given the maximum length of the path). Paths are sorted according to the metric values for the path as a whole. Select Tree view to create a report that lists each next-to-last page in paths that end at the specified concluding page. You can expand each row to show the most popular second-to-last pages in paths that went through the next-to-last page and ended at the concluding page.
12. In the Number of rows per page list, select the number of rows you want per page of the report. 13. In the Number of pages per row list, select the number of second-to-last pages to be listed for each next-to-last page listed in the report. This option is not available if the Style of report option is set to Linear View View. 14. In the Maximum length of path list, select the maximum number of pages that can be in the paths you track.
Version 8.2.1 161
Paths will be truncated to fit this maximum. (This option is not available if the Style of report option is set to Tree view view.) 15. In the Column to sort by list, select the name of the column by which you want to rank items in the report. 16. In the Sort order list, select either Ascending or Descending Descending. 17. In the Type of graph list, select the graph format you want to use. If the Style of report option is set to Tree view the Type of graph list will contain the view, additional graph format Path chart chart. 18. In the Graph data set list, select the type of data you want to display in the graph. 19. In the Page help box, enter the text you want to use as the introduction paragraph to the page help for the report. 20. Click Continue The Filters page appears. Continue. 21. Specify any filters you want applied to the report. 22. If you are creating a report for a relative time period, specify a date filter that defines the time period. 23. Click Continue Continue. The A/B Groups page appears. 24. If you want to see the report data for two sets of filters, specify the filter sets. 25. Click Continue Continue. The Report Summary page appears.
NB40002
Creating a scenario report

NB4000B
To create a scenario report About scenario reports
To create a scenario report

Each step in a scenario report must be defined by either a one or more page filters or by a unique visitor profile. If you are going to use visitor profiles to define report steps, you must create them prior to creating the report. To create a scenario report: 1. View the profile in which you want to create the scenario report. 2. Click the Custom tab > Create Report > Define a new report > Scenario report report. 3. If you want to create a report for a fixed time frame, use the calendar to select the range. If you plan to save the report and want it to retain the time frame, use a date filter rather than the calendar. (Calendar settings are not retained in saved reports.) You'll have the opportunity to add filters after you define the report steps.
4. For each step in the report, add either a single visitor profile or one or more pages or page filters. To add a visitor profile to a step: a. Click the Visitor Profiles tab. b. Click the visitor profile you want to add. c. Click a step to select it. d. Click Click Add to Selected Step Step. To add a single page to a step: a. Click the Search Pages tab. b. Enter search criteria for the page you want to apply and click Search Search. c. From the Results list, select the page you want. d. Click a step to select it. e. Click Add to Selected Step Step. To add a page filter to a step: a. Click the Page tab. b. Select a matching criteria (for example, that starts with, that do not contain). c. Enter a matching string or make a selection from the Select a Page list. d. Click a step to select it. e. Click Add to Selected Step Step. When you add multiple page filters to a step, those with identical settings for both that/that do not AND match type are logically ORed together. If their settings are not identical they are logically ANDed. For example, the filters that match mypage.htm and that match yourpage.htm will be logically ORed. The filters that start with mypage and that contain yourpage will be logically ANDed. Pages added using the Search Pages tab function as positive exact matches and therefore are logically ORed. 5. If necessary, you can reorganize your steps as follows: To re-order a step, click its Arrow button and drag it to a new position. To delete a step, click its X button. To reset all steps to their value as of the last save, click Reset Steps Steps. To clear all steps of values, click Clear Clear.
6. Optionally, you can require that each step in the report must be completed in a single visit. 7. Click Continue Continue.
Version 8.2.1 163
8. In Report description description: Enter a unique title for the report. Select the type of graph you want (funnel is a common format for scenario reports). Select which report metric you want the graph to display. The list contains all of the report's "graphable" metrics. To use All Columns the graph type must be a bar or line chart. Optionally, In Page help enter explanatory text. It will display below the report help, when it is viewed.
9. Click Continue At this point you can save, run, email, or perform other actions on Continue. the report. You can also add filters, metrics, apply A/B filters, or change any of the options you selected in previous steps.
NC40002
About scenario reports

Scenario reports (often called funnel reports) let you see how many visitors and visits are performing each step in a series of defined steps. Typically they're used to track behavior towards a specific goal, such as making a purchase, finding resolution to an issue, or completing a form. They can help you identify where (and hopefully why) dropoffs occur along the way. They also allow you to track visitor behavior across multiple visits. Each step in a scenario report must be defined by either one or more page views or by a visitor profile--a set of filter criteria that defines a group of visitors. For example, you might create a visitor profile that selects visitors referred by certain internet search phrase they used to find your site. In the scenario report shown here, visits are tracked from a site's index (home) page, to a page that lists coffees for sale, to a page where an individual coffee can be viewed and added to a shopping cart, and finally to a thank you page that displays after an order is placed. Each step's visitor drop-off and conversion percentage is relative to the previous step in the report. Each steps visitor and visit percentage is relative to the total number of visitors and visits to the site in the report's time frame.
164
Note that scenario reports do not track the actual order in which visitors perform steps. For each step, they simply report how many visitors performed both that step and all preceding steps within the report's date range. So a visitor who performs a third step before a second will still be counted in the scenario report as long as the step was performed in the correct time frame.
Graph types for scenario reports

Scenario reports are typically displayed as funnel graphs (hence their alternate name) but you can display them using any graph type you choose.
Using filters with scenario reports

You can apply filters to scenario reports just as you can to any other report type. However, to pick the appropriate filters it is important to understand how Unica NetInsight determines visitor and visit counts for scenario reports. And at what point in the process filters are applied. Here's how NetInsight calculates the visitor and visit counts for each step in a scenario report:
To determine visitor count: 1. First NetInsight finds all visitors who match the report's filters. If a date filter has been applied, to be included visitors must have completed each step in the scenario within that time period. 2. Next, of the visitors who matched the filters, NetInsight finds those who completed this step and all preceding steps. To determine visit count: 1. NetInsight finds all of the visits from those visitors that match the report's filters. 2. Next NetInsight counts the number of visits in which those visitors completed the current step. 165
Version 8.2.1
If you see unexpected results It is possible to have a report with visit counts that increase from step to step rather than decrease as expected. This can occur when a higher percentage of visits match the filters for the later steps (something especially likely with view-based filters). It is also possible for visitor counts to change based on the current calendar setting. For example, suppose your scenario has two steps and you use the calendar to display the data for July, then August. Joe completes step one in July and step two in August. Joe will be included in the July report because he completed step one in that time frame. But he but will not be included in the August report because he only completed step two in that time period, not both as required. If you were to restore the calendar view to View All you would see Joe included in the report for both steps.
NB50001
Specifying a time frame

NB5000A
About time frames To specify a fixed time frame using the calendar To specify a relative or fixed time frame using a date filter
About time frames

Time frames can be fixed or relative. A fixed time frame will not change. For example, if you create a report for October 2009, it will always display data from October 2009. A relative time frame changes over time. For example, if on January 1, 2009, you create a report for the time frame Today, it will display data for January 1, 2009. If you save the report and display it again the next day, it will display data for January 2, 2009. You can specify a fixed time frame for a report using the calendar or using a date filter. You specify a relative time frame using a date filter. If you want to save the report and have the saved report keep the fixed time frame, specify the fixed time frame using a date filter. The calendar setting is not preserved in saved reports.
NC50001
To specify a fixed time frame using the calendar

1. From the calendar, select the time period whose data you want to analyze. To display: Data for a single day, click the day. (If a month is not displayed in the calendar, first click View Month Month.) Data for multiple non-consecutive days in the month, hold down the Ctrl key while you click the days you want to display. (If a month is not displayed in the calendar, first click View Month Month.)
166
Specifying a time frame
Data for a range of days in the month, click the first date in the range, press the Shift key and hold it down while you click the last date in the range. (If a month is not displayed in the calendar, first click View Month Month.) Data for an entire week, click the arrow to the right of the week. (If a month is not displayed in the calendar, first click View Month Month.) Data for a range of days that includes dates in multiple months, click View Custom enter a From and a To date, and click Apply Calendar (Note: You must Custom, Calendar. Note: enter dates in the form mm/dd/yyyy. The year must have four digits.) Data for all dates on the currently visible calendar that fall on a certain day of the week (for example, all the Mondays), click the column header for that day of the week. (If a month is not displayed in the calendar, first click View Month Month.) Data for multiple days of the week (for example, all the Sundays and all the Saturdays in the currently visible calendar), hold down the Ctrl key (Option key Option on a Macintosh) while clicking the column headers for the days of the week you want. (If a month is not displayed in the calendar, click View Month Month.) Data for the entire month, click View Month Month. Data for the quarter, click View Quarter Quarter. Data for the year, click View Year Year. All the data, click View All All. A different month in the calendar, click the arrows to either side of the month name. (If a month is not displayed in the calendar, first click View Month Or, Month.) click the name of the month to display a list of months. A different quarter, click View Quarter and then click the arrows to either side of the quarter name. Or, click the name of the quarter to display a list of quarters. A different year, click View Year and use the arrows to either side of the year. Or, click the year to display a list of years.
2. Click Apply Calendar Calendar. If you have unapplied report changes in the queue, your report changes are applied when you click Apply Calendar Calendar.
NC60001
To specify a relative or fixed time frame using a date filter

1. Display the Filters page. The Filters page displays automatically as part of the Custom Report Wizard. You can also display it manually by clicking Filters on the Report Summary page. 2. Click Add Add. 3. Select Date and click Continue Continue. 4. Specify the time frame you want to use for this report.
Version 8.2.1 167
To include todays date, select Today Today. To include yesterdays day, select Yesterday Yesterday. To include data from a specified number of the specified time period units, starting with the current unit and counting back, select Current 2 days enter the days, desired number of units in the first box, and select a time period unit (days, weeks, months, quarters, or years) from the drop-down list. Current 2 days will include data from today and yesterday. To include data from a specified number of the specified time period units, starting with the previous unit and counting back, select Previous 2 days enter days, the desired number of units in the first box, and select a time period unit (days, weeks, months, quarters, or years) from the drop-down list. Previous 2 days will include data from yesterday and the day before yesterday. To include data from the current specified time period unit (other than day), select Current week and then select the desired time period unit (week, month, quarter, or year) from the drop-down list. To include data from the previous specified time period unit (other than day), select Previous week and then select the desired time period unit (week, month, quarter, or year) from the drop-down list. To include data from a fixed time frame, select Dates from and then select the start and end dates of the desired time frame from the drop-down lists.
5. When you have specified the time period you want, click Continue Continue.
NB60001
Specifying dimensions

NB6000A
About dimensions To specify dimensions for a report in the Custom Report Wizard
About dimensions
A dimension is a component that displays data from the log file without performing an operation on it first. In all reports except crosstab reports, only one column displays a dimension. For example, in the Browser Summary, the Browser column displays a dimension. In reports, the dimension is in the column next to the row number.
NC70001
To specify dimensions for a report in the Custom Report Wizard

In the Custom Report Wizard, you specify dimensions for a report on the Dimensions page. 1. Display the Dimensions page by doing one of the following: a. Create a report using the Define a new report option. The Dimensions page will appear during the report creation process.
Specifying metrics
b. Display the Report Summaries page for a report and click Dimensions Dimensions. 2. To add a dimension: a. Select a dimension in the Available dimensions list. b. Click Add dimension (the arrow button that points to the right). The dimension appears in the Selected dimensions list. 3. To remove a dimension: a. Select the dimension in the Selected dimensions list. b. Click Remove dimension (the arrow button pointing to the left). The dimension disappears from the Selected dimensions list and appears in the Available dimensions list. 4. To reorder dimensions, select one or more dimensions and click Move Up or Move Down Down. The first dimension in the report is the primary dimension.
NB70001
Specifying metrics

NB7000A
About metrics To specify metrics for a report in the Custom Report Wizard To add a metric through the Discovery Panel
About metrics
A metric is a numeric or date variable in which a mathematical operation has been performed. Most of the data on a Unica NetInsight report are supplied by metrics. You can add metrics to a report at the Metrics page in the Custom Report Wizard or by using the Discovery Panel. By default, Unica NetInsight has many metrics. You can also create metrics in the profile options for use on any report in the profile or in the Custom Report Wizard for use on the current report only.
NC80001
To specify metrics for a report in the Custom Report Wizard

In the Custom Report Wizard, you specify metrics for a report on the Metrics page. The Metrics page includes every metric in the profile, including custom metrics created in the profile options. If you don't see the metric you want, you can create it here. However, metrics created from the Custom Report Wizard are only available for the current report. 1. Display the Metrics page by doing one of the following: a. Create a report using the Define a new report option. The Metrics page will appear during the report creation process.
Version 8.2.1 169
b. Display the Report Summaries page for a report and click Metrics Metrics. 2. To add an existing metric: a. Select a metric in the Available metrics list. b. Click Add metric (the arrow button that points to the right). The metric appears in the Selected metrics list. 3. To create and add a metric, click Add custom metric metric. 4. To edit a metric: a. Select the metric in the Selected metrics list. b. Click Edit metric metric. The Customizing a metric screen appears. When you are finished editing the metric, click Continue to save your changes and return to the Metrics page. 5. To remove a metric: a. Select the metric in the Selected metrics list. b. Click Remove metric (the arrow button pointing to the left). The metric disappears from the Selected metrics list . If the metric was not created in the Custom Report Wizard, it appears in the Available metrics list. If the metric was created in the Custom Report Wizard, it is deleted. 6. To reorder metrics, select one or more metrics and click Move Up or Move Down Down. Metrics appear in the report from left to right in the order they are listed in the Selected metrics list.
NC90002
To add a metric through the Discovery Panel

1. Open the Discovery Panel. The Available Metrics panel appear under the Available Filters panel. Your administrator may have created custom folders and/or re-organized the metrics from the default settings. 2. Expand the folder that contains the metric to add using the plus sign icon ( ). 3. Click the metric to add it to the report or drag it anywhere onto the report. You can drag and drop a metric onto the report title bar to control the location of the metric. The metric appears in the report when you see two red triangles indicating the insertion location. You also can drag a metric after it appears to re-order it. All metric columns must appear to the right of all dimensions. You can add additional metrics as needed. You can sort by any metric by clicking on the metric column label in the report title bar. An up or down triangle appears showing which column is currently used to sort the report and the sort direction (ascending or descending).
NB80001
170
Creating an A/B report

NB80008
About A/B reports To create an A/B report through the Discovery Panel To create an A/B report using the Custom Report Wizard
About A/B reports

An A/B report enables you to see and compare data for two different groups in the same report. Each group is defined by a set of filters. This is a powerful report for comparing the behavior of two different sets across various dimensions and metrics. For each dimension value in the report, there are four rows: The dimension value The metric values and percentages for the first group, defined by the first set of filters The metric values and percentages for the second group, defined by the second set of filters The percentage change, which is calculated as:
(Group2Value - Group1Value) / Group1Value
When the first group's value is greater than the second, the percentage change is negative (displayed in parentheses) and shown with a red down arrow. When the second group's value is greater than the first, the percentage change is positive and shown with a green up arrow. You can create an A/B report using the Discovery Panel or the Custom Report Wizard Wizard. You can choose which metric to display in the graph of an A/B report. For each metric in the report, you can graph the value for Group A, Group B, the Delta, or the Comparison. The Comparison is shown by default. The only chart types available for the comparison graph are bar and line charts.
Version 8.2.1
171
172
NCA0001
To create an A/B report through the Discovery Panel

You define the two groups for an A/B report using filters. You can create A/B reports interactively using the Discovery Panel or using the Custom Report Wizard. 1. View the report for which you want to create an A/B report.
Version 8.2.1
173
2. Click the A/B Testing icon (
).
The A/B Report panel opens above the chart:
If Multi-Edit mode is off, the Go button displays in the middle of the panel:
The A/B Testing icon remains selected to indicate that A/B testing is activated. The A/B Testing panel remains open until you close it. However, if you change reports, all currently defined filters for the two groups are lost. 3. Optionally, rename the two groups by clicking Group A and Group B and entering new titles. 4. In the Discovery Panel drag the filter you want onto the appropriate filter area for Panel, Group A or Group B. 5. Repeat step 4 for every filter you want to add to either filter set. 6. When you are through defining Group A and Group B, click the Go icon ( ) located in-between the two group definitions (if Multi-Edit mode is off) or click Run Report (if Multi-Edit mode is on). The A/B testing report is computed for the two group definitions. By default, the dimension values in the report are sorted in descending order, by the value for group A, and the data for both group A and group B appear in the chart. You can change the sort order of the report by clicking on the desired metric's or primary dimension's column label in the report title bar. To turn off A/B testing, click the A/B testing icon in the report toolbar again.
NCB0001
To create an A/B report using the Custom Report Wizard

You define the two groups for an A/B report using filters. You can create A/B reports interactively using the Discovery Panel or using the Custom Report Wizard. 1. Display the A/B Groups page by doing one of the following: a. Create a report using the Define a new report option. The A/B Groups page will appear during the report creation process.
174
Creating a comparative report
b. Display the Report Summary page for a report and click A/B Groups Groups. 2. In the text box on the left side of the page, enter the title you want to appear in the report for the first group. 3. Click Add and specify a filter for this group. 4. When you are through defining the filter, the A/B Groups page displays again with the filter listed in the list box. Click Add to add another filter. 5. When you have added all the filters for this group, repeat step 2 through step 4 on the right side of the page for the second filter group. 6. Click Continue Continue. 7. At the Report Summary page, click Sort order to display the General page. 8. In the Group to sort by list, select the group by which the report should be sorted. a. To order the dimension values in the report by the value for group A, select the title of group A. b. To order the dimension values in the report by the value for group B, select the title of group B. c. To order the dimension values in the report according to how much difference there is between the value for group A and the value for group B, select Delta. 9. In the Group to graph list, select the group whose data should appear in the report graph. a. To display the data for group A, select the title of group A. b. To display the data for group B, select the title of group B. c. To display the difference between the data for group A and the data for group B, select Delta. d. To display the data for both group A and B, select Comparison. 10. Click Continue to return to the Report Summary page. 11. Click Run to see the report.
NB90001
Creating a comparative report

NB90007
About comparative reports To create a comparative report
About comparative reports

A comparative report enables you to see and compare data for two different time periods in the same report. Comparison reports are useful for analyzing potential changes in customer behavior before and after a specific event. For each dimension value in a comparative report, there are four rows:
Version 8.2.1 175
The dimension value The metric values and percentages for the first time period The metric values for the second time period The percentage change, which is calculated as:
(TimePeriod2Value - TimePeriod1Value) / TimePeriod1Value
When the first time period's value is greater than the second, the percentage change is negative (displayed in parentheses) and shown with a red down arrow. When the second time period's value is greater than the first, the percentage change is positive and shown with a green up arrow.
You create reports using the Comparative Reports icon ( ), which is available on the toolbar on the Reports tab. You then filter the report by date, once for each time period. After you click the Comparative Reports icon and specify the two time periods, every report you subsequently view is a comparative report until you click the icon again to turn comparative reports off.
NCC0001
To create a comparative report

You create comparative reports at the Reports tab. Comparative reports cannot be created using the Custom Report Wizard. 1. View the report you want to make a comparative report. 2. Click the Comparative Reports icon. A second calendar appears below the first on the left side of your screen. 3. Using the top calendar, specify the first time period whose data you want to view for this report. 4. Using the bottom calendar, specify the second time period whose data you want to view for this report. 5. Click the Apply Calendar button on either calendar. The comparative report appears. Every report you view after this will be a comparative report until you click the icon again to turn comparative reports off and either select a new report or select a new time period from the calendar.
NBA0001
To save a customized report

If you want the saved report to keep the time period specified in the calendar, you must specify the time period using date filters created using the Custom Report Wizard or the Discovery Panel. The calendar setting is not preserved in saved reports.
Changing the content of a report
When you customize a report, either by using the Custom Report Wizard or by modifying an existing report using the Report Designer, you can save your new or modified report from the Report Summary screen. If Multi-Edit mode is on and you have unapplied report changes in the queue, the saved report reflects the report as it will look after you click Run Report Report. 1. Click Save Save. 2. Provide a name for your report in the Report title field. If you are editing an existing report from the Custom tab, you can overwrite the report with your changes. If you are editing a pre-existing report from the Report Designer, you must specify a new name to save your modified report. 3. If you have custom help written for this report, you can specify the URL of the web page to display in the Help topic URL field. 4. Enable Save as new report report. As a best practice, you should save all reports as new reports. If you overwrite pre-generated reports, your changes will be lost when the profile is updated. 5. Enable Display filters on report to display any applied filters at the top of the report. 6. Enable Automatically update full report to automatically update the report for Full reporting mode when the profile is updated. 7. Enable Automatically update sample report to automatically update the report for Sample reporting mode when the profile is updated. 8. Enable Automatically archive report to preserve a copy of the report each time the profile is updated, instead of having newer versions saved on top of older ones. This option is only available if the report has a relative date filter (Yesterday Today Yesterday, Today, Previous week etc.). week, You cannot drill down into archived reports. Archived reports have no links. 9. Choose a folder from the Save report to folder drop-down list. 10. Click Continue Continue. Your custom report has been saved. You may need to refresh your report list for the report to be visible in the list.
NBB0001
Changing the content of a report

NBB000A
To edit a report using the Report Summary page To display axis labels for dashboard reports
Version 8.2.1
177
To edit a report using the Report Summary page

You can make any change to a report at the Report Summary page. 1. View the report you want to edit. 2. Click the Report Designer icon. The Report Summary page appears. 3. Make your changes. To see your changes, click Run To save your report, click Save Run. Save. You can also use the Discovery Panel to add or remove filters, metrics, or dimensions while viewing the report.
NCD0001
To display axis labels for dashboard reports

By default, Unica NetInsight does not display X,Y axis labels for reports displayed in a dashboard. You can enable axis labels for a dashboard report as described below. X,Y axis labels pertain to bar and line charts only. For pie charts, rather than an axis label, the Graph data set label is displayed.
1. With the desired dashboard displayed, click the Report Designer icon ( The Report Summary page opens. 2. In the Report description dialog, click the Left column or Right column link. 3. In the Dashboard sections dialog, select the desired report and click Edit Edit. 4. In the Section description dialog, uncheck Hide axis titles titles. 5. Save the report. Axis labels for the report are displayed the next time the profile is updated.
).
178
N10510
8 Archiving, Emailing, and Exporting Reports ExportingReports

NCE0001
About archiving reports To archive a report To view archived reports To remove archived reports Emailing reports To export a report as a file Working with portlets Working with group selections
About archiving reports

Because you can generate a report at any time, there is generally no need to archive a separate copy of a report for record keeping. However, archived reports provide a static snapshot of data and use fewer database resources, so you may wish to archive reports to make better use of your resources or to preserve a view of data at a particular point in time. You can view, export, and print archived reports. Unica NetInsight always archives reports using Full mode, regardless of the reporting mode you are currently using in the profile. You cannot drill down into archived reports. An archived report has no links.
NCF0001
To archive a report
1. View the Profile that contains the report you want to archive.
Version 8.2.1 179
8 - Archiving, Emailing, and Exporting Reports
2. Display the Report Summary page for the report you want to archive. You can open the Report Summary page by clicking the Report Designer icon ( ), or by selecting the report in the Custom tab and clicking Edit Report Report.
3. Click Archive Archive. 4. In the Report title field, modify the name of the report as needed. 5. If you want the filters to be listed on the report, select the Display filters on report check box. 6. Click Continue Continue. The report is archived.
ND00001
To view archived reports

1. View the profile that contains the archived report you want to view. 2. Click the Archive tab. You cannot interact with static reports (that is, they are not drillable, sortable, or otherwise modifiable). Archived reports always display in Full reporting mode. 3. From the Report to Display drop-down list, select the archived report you want to view. The report is displayed. You can now save or print the report.
ND10001
To remove archived reports

1. View the profile that contains the archived report you want to remove. 2. Click the Options tab. 3. In the Unica NetInsight Options drop-down list at the top of the screen, select Remove Archived Reports Reports. The Archived reports screen opens, listing the archived reports 4. Do one of the following to remove the reports. To remove only some of the archived reports, select them in the list and click Remove Selected Reports Reports. To remove all the reports, click Remove All Reports Reports.
The selected reports are permanently removed from the archive.

ND20001
180
Emailing reports
Emailing reports

ND20008
About emailing reports To email a report To create an email task To execute an email task To create an email alert To execute an email alert About scheduling email tasks and email alerts
About emailing reports

Unica NetInsight enables you to email reports to others. If you routinely send the same reports to the same people, you can create one or more email tasks, which specify which reports should go to which recipients and in which format. You can also create an email alert that will execute an email task if the value of a specified metric meets the criteria you specify for the alert. When you email a report using the Email icon on the toolbar, you can choose to email the full version of the report or the sample version. When you email a report from the Report Summary page, you do not have a Reporting mode option. The report is emailed according to the reporting mode currently specified for the profile. Reports sent as part of an email task or email alert always are sent in Full mode. When emailing a report in .csv format, you can choose to email only the data currently displayed on the report page, or the maximum amount of data allowed for your system. For all other report formats, only the data displayed on the report page is included in the emailed report. You can execute an email task or email alert manually from either the Unica NetInsight interface or the command line, or you can schedule the task or alert to execute automatically.
ND60001
To email a report
Before you can email a report, an email server must be configured for use with Unica NetInsight. You can email any report while viewing it. 1. Display the report you want to email.
2. Click the Email icon (
).
3. In the From address field, enter the email address from which this report is to be mailed. Any email messages returned as undeliverable are returned to this address.
Version 8.2.1 181
4. In the To address field, enter the email address to which you want to send the report. Separate multiple email addresses with commas or semicolons. 5. In the Subject of email field, enter the subject of this email message. 6. In the Format of report list, select the report format you want to use. 7. In the Reporting mode list, select the reporting mode in which you want to export the report. The Reporting mode option only appears if sampling is enabled and you have the privilege for changing the export reporting mode. 8. If you are emailing a report in .csv format, select one of the options from the Data to e-mail drop-down list. To email only the data currently displayed on the report page, select Just this report If the report is not currently displayed, the email will contain only the first report. page of data, up to the number of rows per page specified in the Report Designer. To email the maximum amount of data returned in the report up to the limit defined for your system, select Maximum data allowed allowed.
9. In the Additional text field, enter the text you want to include in the body of the email message that contains the report and chart. 10. Click Continue Continue.
ND70001
To create an email task

ND70008
To create an email task To add or edit reports for an email task To add or edit recipients for an email task To test an email task To edit an email task To delete an email task
To create an email task

1. While working with a profile containing the reports you want to email, click Options Options. 2. In the left panel, under Email click Email Tasks Email, Tasks. The Available email tasks screen opens. 3. Click Add Add. The Email task description screen opens. 4. In the Name of task field, enter the name you want displayed for this email task in the Available email tasks list. Use a name that clearly identifies the task.
Emailing reports
5. In the From address field, enter the email address from which the reports in this email task will be mailed to users. Any email messages returned as undeliverable, as well as any replies sent by recipients, are sent to this address. If you do not enter an address, Unica NetInsight uses the email address specified for the From address option in the administrative options. 6. In the Subject of email field, enter the text you want to appear in the subject line of the email the recipients receive. 7. In the Format of reports list, select the report format you want to use. 8. If you are emailing a report in .csv format, select one of the options from the Data to e-mail drop-down list. To email only the first page of data, up to the number of rows per page specified in the Report Designer, select Just this report report. To email the maximum amount of data returned in the report up to the limit defined for your system, select Maximum data allowed allowed.
9. In the Time period list select the time period for which the metric will be calculated. list, 10. If you have scheduled the -email command-line option to automatically execute all the email tasks for this profile but you do not want this email task executed with the group, select the Exclude from batch execution check box. This email task is then executed only when you use the -emailtask command-line option or select the task in the Available email tasks list and click Execute Execute. This option is especially useful when most of your email tasks are executed daily and you want to create a task that executes weekly, monthly, or quarterly. 11. In the Additional text field, enter the text you want to include in the body of the email message that contains the reports and graphs. For example, you could include descriptions of the data contained in each report. 12. Click Save Options and then click Continue Continue. Before the email task is functional, you must:
NDC0001
Add one or more reports to the email task Add one or more recipients to the email task
To add or edit reports for an email task

You must create the email task to add reports to before completing the instructions below. When you execute an email task, Unica NetInsight includes all the reports in the email task in one email message. You can specify the order in which you want the reports to appear when you add reports to the email task.
Version 8.2.1 183
1. While working with the profile, click Options Options. 2. In the Options panel, under Email click Email Tasks Email, Tasks. The Available email tasks screen opens. 3. Select the email task to add reports to. 4. Click Reports Reports. The Reports to be sent for profile screen opens. 5. Select reports in the Available reports list and use the right arrow button to move reports you want to send to the Selected reports list. You can use the left arrow button to remove any reports you do not want to send. 6. Select reports in the Selected reports list and use the up and down buttons to adjust the order of reports to be included. 7. When all the reports you want to include are in the Selected reports list and in the desired order, click Save Options and then click Continue Continue.
NDD0001
To add or edit recipients for an email task

You must create the email task to add recipients to before completing the instructions below. If the list of recipients is particularly long, you may want to contact your email administrator about creating an alias for multiple email addresses on your mail server. Using this method allows you to avoid entering a long list of email recipients. You can then mail the reports to the alias and all the recipients will receive them. 1. While working with the profile, click Options Options. 2. In the left panel, under Email click Email Tasks Email, Tasks. The Available email tasks screen opens. 3. Select the appropriate email task. 4. Click Recipients Recipients. The Recipients of reports for profile screen opens. 5. Click Add Add. The Email address field appears. 6. Enter the email address of one person who should receive the reports and click Add Add. 7. Click Continue Continue.
NDE0001
184
Emailing reports
To test an email task

You can test an email task to ensure that the resulting email is what you want without sending it to everyone on the recipient list. You can specify a test email account to receive the reports for verification purposes. You can also use this feature to send the reports in an email task to a list of recipients that is different than the list specified in the email task. Unica NetInsight does not display errors it encounters while executing the email task when you are testing. If you need to troubleshoot an email task, execute it from the nettracker.exe command line using the -emailtask option. You can use the recipients option to send the reports to a different list of recipients. 1. While working with the profile, click Options Options. 2. In the left panel, under Email click Email Tasks Email, Tasks. The Available email tasks screen opens. 3. Select the email task to test. 4. Click Test Test. The Test email task screen opens. 5. In the Email address field, enter the list of email addresses to which you want the reports in the email task sent. Separate multiple addresses with commas or semicolons. (Spaces before or after the commas are ignored.) 6. Click Execute Execute.
NDF0001
To edit an email task

1. While working with the profile, click Options Options. 2. In the left panel, under Email click Email Tasks Email, Tasks. The Available email tasks screen opens. 3. Select the appropriate email task. 4. Click Edit Edit. The Email task description screen opens. 5. Edit values as desired and click Save Save. You can now:
NE00001
Add reports to an email task Add recipients to an email task
Version 8.2.1
185
To delete an email task

When you delete an email task, all email alerts that use the email task are automatically deleted as well. 1. While working with the profile, click Options Options. 2. In the Options panel, select Email > Email Tasks Tasks. The Available email tasks screen opens. 3. Select the email task to delete. 4. Click Delete Delete. The email task is deleted. 5. Click Continue Continue.
ND80001
To execute an email task

ND8000A
To execute an email task To execute an email task from the command line To execute all email tasks from the command line
To execute an email task

You must do the following before executing an email task: Create the email task Add reports to an email task Add recipients to an email task
When you execute an email task, Unica NetInsight includes all the reports in the email task in one email message and sends it to the specified recipients. 1. While working with the profile, click Options Options. 2. In the left panel, under Email click Email Tasks Email, Tasks. The Available email tasks screen opens. 3. Select the email task to execute. 4. Click Execute Execute.
NE10002
To execute an email task from the command line

You must do the following before executing an email task:
186
Create the email task Add reports to an email task Add recipients to an email task
Emailing reports
When you execute an email task, Unica NetInsight includes all the reports in the email task in one email message. You can specify the order in which you want the reports to appear when you add reports to the email task. Executing an email task from the command line allows you to easily automate delivery of reports by scheduling email task execution using a scheduler. Executing an email task from the command line also enables you to see any errors encountered while executing the task. 1. Open a command prompt or terminal. 2. Change to the Unica NetInsight program directory. (The default program directory on UNIX is /usr/local/netinsight. The default Unica NetInsight program directory on Windows is C:\Program Files\NetInsight. 3. Run the following command: where short_profile_name is the short name of the profile containing the email task you want to execute and taskname is the name of the email task. Short profile names appear in parentheses in the Profile Manager. You can also run the command Nettracker admin -list to see a list of all the short profile names. You can also use the -recipients command-line option to specify recipients other than those specified in the email task. nettracker short_profile_name -emailtask taskname
NE20002
To execute all email tasks from the command line

You must do the following before executing all email tasks: Create the email task Add reports to an email task Add recipients to an email task
When you execute an email task, Unica NetInsight includes all the reports in the email task in one email message. You can specify the order in which you want the reports to appear when you add reports to the email task. You can use one command to execute all of the email tasks in any profile. However, any tasks that have the Exclude from batch execution check box selected are not executed. 1. Open a command prompt or terminal. 2. Change to the Unica NetInsight program directory. (The default program directory on UNIX is /usr/local/netinsight. The default Unica NetInsight program directory on Windows is C:\Program Files\NetInsight.) 3. Run the following command:
Version 8.2.1 187
where short_profile_name is the short name of the profile containing the email tasks you want to execute. Short profile names appear in parentheses in the Profile Manager. You can also run the command Nettracker admin -list to see a list of all the short profile names. You can also use the -recipients command-line option to specify recipients other than those specified in the email task. nettracker short_profile_name -email
ND90001
To create an email alert

ND9000A
To create an email alert To modify filters for an email alert To test an email alert To edit an email alert To delete an email alert
To create an email alert

You must create at least one fully-configured email task before you can create an email alert. 1. While working with the profile containing the email task that should be executed, click Options Options. 2. In the left panel, under Email click Email Alerts Email, Alerts. The Available email alerts screen opens. 3. Click Add Add. The Email alert description screen opens. 4. In the Name of alert field, enter the name you want displayed for this alert in the Available email alerts list list. Use a name that will clearly identify the alert. 5. In the Email task list, select the email task to be executed if the criteria you specify for the alert are met. 6. In the Time period list, select the time period for which the metric will be calculated. To include data from a specified number of the specified time period units, starting with the current unit and counting back, select Current enter the desired Current, number of units in the first field, and select a time period unit from the drop-down list. For example, specifying Current 2 days includes data from today and yesterday.
188
Emailing reports
To include data from a specified number of the specified time period units, starting with the previous unit and counting back, select Previous enter the Previous, desired number of units in the first box, and select a time period unit from the drop-down list. For example, specifying Previous 2 days includes data from yesterday and the day before yesterday.
7. In the Metric list, select the metric for which you want to calculate a value. 8. In the Execute if calculated value is list, select the comparison type to use to compare the calculated value to the threshold value. 9. Enter a number for the threshold value in the next field to the right. 10. Click Save Options then click Continue Options, Continue. You can now add filters to the alert.
NE30001
To modify filters for an email alert

1. While working with the profile, click Options Options. 2. In the left panel, under Email click Email Alerts Email, Alerts. The Available email alerts screen opens. 3. Select the email alert to modify filters for. 4. Click Filters Filters. The Filters that belong to email alert screen opens. 5. To add a filter: a. Click Add Filter Filter. The Available filters screen opens. b. Select a filter and click Continue Continue. The Filter description screen opens. c. Select one or more bins for the filter and click Continue For a string variable, fill Continue. in the Filter Description screen. 6. To edit a filter: a. Select the filter to edit. b. Click Edit Filter Filter. The Available filters screen opens. c. Edit the filter as desired and click Continue Continue. 7. To delete a filter: a. Select the filter to delete. b. Click Delete Filter Filter. The filter is deleted.
Version 8.2.1 189
8. Repeat steps 5 through 7 until the filter list is complete. 9. Click Save Filters Filters.
NE40001
To test an email alert

Before you execute an email alert, you should test it to troubleshoot the criteria you specified for the alert. When you test an email alert, a message displays the calculated value of the metric values that match the filters you specified, whether this calculated value meets the threshold value, and whether or not the alert would have been executed. 1. While working with the profile, click Options Options. 2. In the left panel, under Email click Email Alerts Email, Alerts. The Available email alerts screen opens. 3. Select the email alert to test. 4. Click Test Test. The Test email alert screen opens, showing the results of the test.
NE50001
To edit an email alert

1. While working with the profiles, click Options Options. 2. In the left panel, under Email click Email Alerts Email, Alerts. The Available email alerts screen opens. 3. Select the email alert to edit. 4. Click Edit Edit. The Email alert description screen opens. 5. Edit the fields on this screen as desired and click Save Save. You now add filters to the alert.
NE60001
To delete an email alert

1. While working with the profile, click Options Options. 2. In the Options panel, select Email > Email Alerts Alerts. The Available email alerts screen opens. 3. Select the email alert to delete. 4. Click Delete Delete. The email alert is deleted. 5. Click Continue Continue.
NDA0001
190
Emailing reports
To execute an email alert

NDA000A
To execute an email alert To execute an email alert from the command line To execute all email alerts from the command line
To execute an email alert

You must do the following before executing an email alert: Create an email task containing one or more reports Create the email alert Optionally add filters to the email alert
1. While working with the profile, click Options Options. 2. In the left panel, under Email click Email Alerts Email, Alerts. The Available email alerts screen opens. 3. Select the email alert to execute. 4. Click Execute Execute.
NE70001
To execute an email alert from the command line

You must do the following before executing an email alert: Create an email task containing one or more reports Optionally create the email alert Add filters to the email alert
1. Open a command prompt or terminal. 2. Change to the Unica NetInsight program directory. (The default program directory on UNIX is /usr/local/ Unica NetInsight. The default Unica NetInsight program directory on Windows is C:\Program Files\Unica NetInsight.) 3. Run the following command: where profile_name is the short name of the profile containing the email alert you want to execute and alertname is the name of the email alert. Short profile names appear in parentheses in the Profile Manager. You can also run the command Nettracker admin -list to see a list of all the short profile names. nettracker profile_name -alerttask alertname
NE80001
To execute all email alerts from the command line

You must do the following before executing an email alert: Create an email task containing one or more reports
191
Version 8.2.1
Create the email alert Add filters to the email alert
1. Open a command prompt or terminal. 2. Change to the Unica NetInsight program directory. (The default program directory on UNIX is /usr/local/Unica NetInsight. The default Unica NetInsight program directory on Windows is C:\Program Files\Unica NetInsight.) 3. Run the following command: where profile_name is the short name of the profile containing the email alert you want to execute. Short profile names appear in parentheses in the Profile Manager. You can also run the command Nettracker admin -list to see a list of all the short profile names. nettracker profile_name -alert
NDB0001
About scheduling email tasks and email alerts

You can schedule the execution of email tasks and email alerts through the Task Scheduler on a Windows system or through cron on a UNIX system. You may want to schedule the sending of emailed reports along with an update so that updated reports are mailed to your users as soon as an update has successfully completed. Reports sent as a result of an email task or email alert will always use Full mode, not Sample mode. Unica NetInsight email options must be properly configured for scheduled email tasks to execute successfully.
Scheduling all email tasks and email alerts on a Windows system

To schedule all email tasks and email alerts in a profile on a Windows system, you use the AT command. For example:
AT 11:05PM /every:m,t,w,th,f,sa,su "C:\Program Files\Unica NetInsight\nettracker.exe" all -quiet -update -email -alert -dir "C:\Program Files\Unica NetInsight"
Assuming that Unica NetInsight is installed in C:\Program Files\Unica NetInsight, this command updates your profiles, emails summaries to your users, and executes any email alerts that have been specified every night; the process starts at 11:05 PM. The -dir option specifies the Unica NetInsight program directory so the nettracker executable can find the profile files.
Scheduling all email tasks and email alerts on a UNIX system

To schedule all email tasks and email alerts in a profile on a UNIX system, add this entry (all one line) to your crontab:
To export a report as a file
0 0 * * * /usr/local/Unica NetInsight/nettracker all -quiet -update -email alert -dir /usr/local/Unica NetInsight
Assuming that Unica NetInsight is installed in /usr/local/Unica NetInsight, this command runs an update on Unica NetInsight at midnight every night, emails reports to your users, and executes any email alerts that have been specified. The -dir option specifies the Unica NetInsight program directory so the nettracker executable can find the profile files.
ND30001
To export a report as a file

You can export the data in a report to a spreadsheet, word processor, Web browser, or to XML. This topic provides instructions on exporting data in a spreadsheet, word processor, or HTML file. For instructions on exporting a report to a Portlet URL, see To export a report as a portlet. To export a report, you must set your browser to allow pop-up windows. You may choose to export just the data shown on the current page or all available data in the report, if it appears across multiple pages. If sampling is enabled and you have the corresponding privilege, you can choose to export the report in Full or Sample mode. If Multi-Edit mode is on and you have unapplied report changes in the queue, the exported report reflects the report as it will look after you click Run Report Report. 1. Display the report.
2. Click the Export icon (
) located in the toolbar.
The Export options window opens. 3. From Report Type select File Type, File. 4. Select the appropriate option from the Format of report drop-down list. Select Spreadsheet (.csv) to create a text file that can be saved or imported into most spreadsheet and database applications. (For example, Microsoft Excel can open .csv files.) You can then manipulate, format, and analyze the data using the tools provided in the spreadsheet or database application. The chart is not exported as part of this format, though once you import data into a spreadsheet application, you can create a chart from the data. Select Web browser (.html) to create an HTML file that you can save or post on your Web site for viewing by others.
Version 8.2.1
193
Select Word Processor (.rtf) to create a Rich Text File that can be saved or imported directly by Microsoft Word and many other word processors. You can open the file in a word processor, edit it, and then print it for distribution.
5. From the Data to export drop-down list, select one of the options. To export just the data that appears in the current page of the report, select Just this screen screen. To export all the data in the report, select Maximum data allowed allowed.
6. From the Reporting mode drop-down list, select one of the options. The Reporting mode option only appears if sampling is enabled and you have the privilege for changing the export reporting mode. 7. Click Export Export. Depending on the Web browser you are using and the export format that you selected, either a Save As window opens or the exported report opens in a new window or tab. If it appears as though nothing has happened, ensure that your browser settings allow pop-up windows. 8. If a Save As window opens, select the drive and directory where the file is to be saved, enter a filename, and click Save Save. The report is saved in the format you selected.
ND40001
Working with portlets

ND40007
About portlets To export a report as a portlet
About portlets
You can export any report that auto-updates as a portlet, a pluggable user interface component that can be displayed in web pages, web-based applications, or other applications that can render HTML or parse XML data. Uses for portlets include: Display the report as a web page, or within an inline frame on a web page or web application. Convert the portlet to a widget using a vehicle like Google Gadgets. Parse the XML for rendering in a table or other format, or pass the data to another application for use.
Subsequent changes to the report in Unica NetInsight (for example, updates, new filters applied) are reflected in the portlet the next time it is accessed by a user. Users viewing a portlet can change the graph type just as they can in Unica NetInsight. Clicking a portlet rendered in HTML launches the report in Unica NetInsight.
194
Working with portlets
Requirements and limitations for portlets

Only graph reports and dashboards that auto-update can be exported as portlets. When you export a dashboard, only the top-left report is exported and html is the only export option. The server where a portlet is deployed must be able to access your Unica NetInsight server. There is no indication in Unica NetInsight that a particular report is in use as a portlet. Deleting a report in use as a portlet will result in missing data where the portlet is used (for example, a 404 error on a web page or missing data in an XML application). Width is the only size dimension that can be specified for a portlet; height is adjusted automatically. Path reports adjust their width automatically. Stacked bar reports automatically increase the specified width by 30%.
Authentication requirements for viewing portlets

If Unica NetInsight is configured to require a login, users attempting to view a portlet in a web page will be presented with login fields which they must complete before the portlet will display. If a portlet is displayed in another Unica application that shares Unica Marketing Platform authentication with Unica NetInsight , users will still need to provide their Unica NetInsight credentials to view the portlet.
NE90001
To export a report as a portlet

You can export any graph report or dashboard that auto-updates as a portlet: a pluggable user interface component than can be displayed in web pages, web-based applications, or other applications that can render HTML or parse XML data. 1. Display the report you want to export. If you export from a dashboard, only the top-left report on the dashboard will be exported and HTML is the only portlet format option.
2. Click the Export icon (
) located in the toolbar to the upper-right of the report.
The Export options window opens. 3. From Export Type select Portlet URL. Type, 4. From Format of Report select Web Browser or XML. 5. If you selected Web Browser, specify: a. The number of values to include in the report. b. The width of the report graphic, in pixels. Note that Path reports self-adjust their size, regardless of the width you specify. Stacked bar reports will automatically increase the width you specify by 30%.
Version 8.2.1 195
c. Optionally, you can choose to hide the report header. 6. Click Export Export. 7. Copy the URL for the report.
ND50001
Working with group selections

ND50007
About group selections To open or close the Selected Groups panel To add groups to a group selection To modify a group selection To save a group selection To use a group selection in Unica Campaign
About group selections

A group selection is a collection of visitors selected from one or more rows of one or more profile reports. Data on these visitors can be exported to a .csv file or saved as a SQL query in the Unica NetInsight database for further processing in other applications. For example, if you have a customer database with a table capable of mapping Unica NetInsight visitors to customer IDs, you could use group selection to ultimately generate an email list for use in an email campaign. Or, if your site requires users to log in, you could use group selection to map a particular set of Unica NetInsight visitors to stored user information via the login ID. You create a group selection by selecting a report metric representing visitors and dragging it onto the Selected Groups panel. To access the Selected Groups panel and export selection data you must have been assigned the necessary Unica NetInsight privileges. While the visitors in a particular group selection can come from different reports, they must be chosen using the same base metric: for example, visits or views or unique visitors. You cannot select dimension rows. Each metric row dragged onto the Selected Groups panel is treated as a separate group within that selection. For selections containing multiple groups, the panel displays an estimated count of the total visitors across all groups. Because of the potential overlap between visitors in different groups, the estimated count may not accurately reflect the number of unique visitors you have selected. The Selected Groups panel includes a command that lets you calculate the actual number of unique visitors in your selection.
Group selections exported as .csv

The visitor data exported to the csv file consists of: A Unica NetInsight visitor ID. Because this ID is transient and can change from session to session for the same visitor, it's value is limited.
196
A visitor identification string. For example, in the case of a URL request, the string would be an IP address and user agent such as 93.158.148.31:Yandex/1.01.001 (compatible; Win16; I).
Group selections exported as SQL

Group selections exported as SQL are written to two NetInsight system tables. UNI_Selection stores the metadata for each saved selection including the selection name, its optional description, associated profile, the user name of the user(s) who created and/or updated it, and its creation and update dates. UNI_Selection_SQL stores the actual SQL statement that selects the visitors from the profile source data. For example:
SELECT DISTINCT myprofile_VisitorID.VisitorID, myprofile_VisitorID.Visitor FROM myprofile_VisitorID WHERE (( myprofile_VisitorID.VisitorID IN (SELECT VisitorID FROM myprofile_Visits WHERE (myprofile_Visits.FirstViewDate >= 2454833 AND myprofile_Visits.FirstViewDate <= 2455197) ) AND myprofile_VisitorID.VisitorID IN ( SELECT VisitorID FROM myprofile_Visits WHERE (FirstViewDate >= 2454833 AND FirstViewDate <= 2455197) AND PlatformID IN (SELECT PlatformID FROM myprofile_PlatformID WHERE myprofile_PlatformID.Platform = 'Windows XP' ) ) ) )
NEA0001
To open or close the Selected Groups panel

Before you can make and save group selections, you must open the Selected Groups panel. 1. Open the report.
2. In the upper-right toolbar, click the Selected Groups icon (
).
The Selected Groups panel opens in the bottom-left of the screen:
You can now begin making and saving selections. To hide the Selected Groups panel, click on the Selected Groups icon again.
NEB0001
Version 8.2.1
197
To add groups to a group selection

Before you can create a group selection you must open the Selected Groups panel. 1. In the desired report, click the cell of the metric you want to add to a group. Use Shift + click or Ctrl + click to select multiple rows. The selected cell is highlighted yellow, and the yellow Highlighted row beneath the report shows the sum of selected metrics.
2. Drag and drop the selection into the Selected Groups panel, or in the Highlighted row, click Add as Group Group. All of the count metric cells you highlighted are added to the selection as a single group.
3. As desired, repeat the previous steps to add more groups to the selection. Multiple groups added to the Selected Groups panel are logically OR-ed together. While a group selection can consist of different dimensions, it cannot consist of different metrics (for example views and visits).
NEC0001
To modify a group selection

Prior to saving a group selection you can modify it as follows.
198
Working with group selections To View the report from which any single group in a group was selected Remove a single group from a selection Remove all groups from a selection In the Selected Groups Panel Right-click the group and select View Group Report Use Notes
Right-click the group and select Delete Delete. Click the Clear icon ( ). All selections are permanently removed from the group. Click on its name and edit the displayed text
You cannot undo a group removal.
Change the name of a group,
By default, the name of a group is the sum of its members and the name of its metric. ) The Estimated Count displayed in the Selected Groups panel gives the total visitors across all groups in a selection. Because of the potential overlap between members in different groups, this may not accurately reflect the number of unique members in a selection. Use Actual Count to calculate the number of unique members. You can view a bulleted list of the dimension criteria from which a group's members were selected.
Calculate the number of unique members in a group selection
Click the Actual Count icon (
View the selection criteria for a group
Right-click the group and select View Filter Groups
NED0001
To save a group selection

When you have selected all the desired metrics for a group, you can save and download the group as a comma separated values file.
1. In the Group Selection panel, click the Export icon (
).
You can also export a group by selecting the desired metric in a report, rightclicking, and selecting Export Export. The Save Selection dialog box opens. 2. Click the download selection link.
NEE0001
Version 8.2.1
199
To use a group selection in Unica Campaign

To use group selections in Unica Campaign, you must map the UNI_Selection and UNI_Selection_SQL tables in the Unica NetInsight system database. For instructions, see the Unica Campaign Administrator's Guide. You can then use the group selections you made in Unica NetInsight as the input to a Select process in a Unica Campaign flowchart. The instructions below assume that you are editing a flowchart in Unica Campaign. 1. Add a Select process to the flowchart as the top-level and open it. The Select Process Configuration window opens. The Input drop-down list has Unica NetInsight Selection as an option:
This option only appears if the Select process is a top-level process; it cannot have an input cell from a previous process. 2. Select Unica NetInsight Selection Selection. The Unica NetInsight Selections window opens, listing the selections you have saved in Unica NetInsight. You can sort any column by clicking on the column header. To view all selections, including those made by other users, check Show selections from all users users. 3. Select the row for the selection you want and click OK OK. The selection is listed in the Input drop-down list.
200
When you use an Unica NetInsight selection as input, you cannot refine the selection by adding additional SQL statements. You can, however, use a Select or Segment process following the top-level Select process. For example, you can configure the Segment process to segment the input IDs by query, to treat segments of the Unica NetInsight selection differently . 4. Complete the flowchart as required. For more information about using flowcharts, see the Unica Campaign User's Guide.
Version 8.2.1
201
N105DE
9 Analyzing Content AnalyzingContent

NEF0001
About analyzing content Analyzing banner ads Analyzing content groups Analyzing indexes Analyzing links Analyzing keywords To include specific redirection scripts in the reports
About analyzing content

By default, Unica NetInsight analyzes content by page. However, sometimes you may want to analyze content by groups of pages. The Content options enable you to group content in various ways so Unica NetInsight can analyze the groups. The Content options also gather information needed to analyze your content (such as the directory index you use if it is not one Unica NetInsight checks by default). If you earn money from banner ads on your site, you can track the traffic through the ads to show clients why they should advertise with you.
NF00001
Analyzing banner ads

NF00007
About analyzing banner ads About moving ntadtrack.cgi or ntadtrack.exe to a CGI-accessible directory To redirect all banner ads To configure banner ad options
202
Analyzing banner ads
About analyzing banner ads

You can use Unica NetInsight to track the traffic through banner ads on your Web site, which can be useful when persuading clients to advertise on your site. To prepare Unica NetInsight to analyze banner ads you must: 1. Move ntadtrack.cgi or ntadtrack.exe to a CGI or scripts directory. 2. Redirect all of the banner ads that you would like to track through ntadtrack.cgi. 3. Configure the banner ad options.
NF60001
About moving ntadtrack.cgi or ntadtrack.exe to a CGIaccessible directory

When you install Unica NetInsight, a custom redirect program called ntadtrack.cgi (UNIX) or ntadtrack.exe (Windows) is placed in the NetInsight program directory. (The default location for the Unica NetInsight program directory is /usr/local/Unica NetInsight for UNIX and C:\Program Files\Unica NetInsight for Windows.) You need to copy the program from the Unica NetInsight program directory into a CGI or scripts directory on your Web site (for example, /usr/local/apache/cgi-bin for UNIX or C:\Inetpub\scripts\ for Windows). Be sure to remember the directory to which you copied ntadtrack, as you will need to enter this directory later. Note: If the Web server whose log files you are analyzing is on a different platform than the computer on which you have Unica NetInsight installed, you will need to contact technical support to get the correct version of ntadtrack.cgi or ntadtrack.exe for your Web server's platform.
NF70001
To redirect all banner ads

You need to redirect all the banner ads through the custom redirect program ntadtrack.cgi (UNIX) or ntadtrack.exe (Windows). The redirect program writes information to the log file that enables Unica NetInsight to identify banner ad entries in the log file data. 1. Open the HTML document that contains the banner ad. 2. Edit the HREF statement that contains the banner ad so that ntadtrack.cgi or ntadtrack.exe is the target of the link and the page visitors will go to when they click the banner ad is the query string. In the example above, the URL located immediately after the question mark is the URL to which users will go when they click the banner ad. This must be the exact URL. For example, if users will go to http://www.unica.com/index.html, enter that full path, not just http://www.unica.com. Note this URL, as you will need to enter it later. For example,
Version 8.2.1 203
9 - Analyzing Content <a href="/cgi-bin/ntadtrack.cgi?http://www.unica.com/products/">
<img src="/ads/NetInsight.gif"></a>
NF80001
To configure banner ad options

You need to configure the banner ad options to tell Unica NetInsight the location of ntadtrack and which banner ads to track. 1. View the profile in which you want to track the banner ads. 2. Click the Options tab. 3. In the Options panel, select Content > Banner Ads Ads. 4. In the Full path of ntadtrack box, enter the path to ntadtrack.cgi (UNIX) or ntadtrack.exe (Windows). This is the path from the document root of your Web site, not the path to the file on the computer on which Unica NetInsight is installed. For example, if ntadtrack.cgi is located in /usr/local/apache/cgi-bin/ but on your Web site it is accessible as http://yourdomain.com/cgibin/ntadtrack.cgi, you should enter /cgibin/ntadtrack.cgi. In Windows, if ntadtrack.exe is located in C:\Inetpub\scripts\ but on your Web site this directory is accessible as http://yourdomain.com/scripts/ntadtrack.exe, you should enter /scripts/ntadtrack.exe. If the log files come from servers clustered for multiple sites, enter the full URL (for example, http://yourdomain.com/scripts/ntlinktrack.exe).
If you are using Windows with IIS, you need to allow the anonymous Web user Read and Execute permission through NTFS for the directory containing ntadtrack and for the file itself and Execute permission for Scripts and Executables through the IIS management console. 5. Click Save Options and then click Continue Continue. 6. Click Add Add. 7. In the Name of banner ad box, enter the name you want to use for the ad in the Unica NetInsight reports. 8. In the Full path of graphic box, enter the path to the banner ad graphic. This will be the path from the document root of your Web site, not the full path on the system you are using. This will be the same path used for the image file in the HTML document. For example, if the HTML document contains:
img src="/ads/NetInsight.gif"
204
Analyzing content groups
you would enter:

/ads/NetInsight.gif
9. In the URL to link to box, enter the destination that users will go to when they click the ad.
<a href="/cgi-bin/ntadtrack.cgi?http:// www.unica.com/products/">
you would enter:

http://www.unica.com/products/
10. Click Save Options Options. Your banner ad statistics will be tracked for all new data you import from now on. 11. If this is what you want or if you have other banner ads to enter at this time, click Continue Continue. If you happen to have already imported data that contains banner ads that have been redirected through ntadtrack, you can analyze banner ad statistics in data you have already imported by deleting all the data in your profile and reimporting your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
NF10001
Analyzing content groups

NF1000A
About analyzing content groups To create a content group About determining the content group for files that fit multiple groups
About analyzing content groups

Unica NetInsight lets you track the popularity of different types of content on your Web site. For example, you could track how many visitors are viewing information on particular products. To track different types of content, you need to divide the files that contain the content for your Web site into content groups. The content group statistics appear on the Content Summary.
NF90001
Version 8.2.1
205
9 - Analyzing Content
To create a content group

1. View the profile in which you want to create the content group. 2. Click the Options tab. 3. In the Options panel, select Content > Content Groups Groups. 4. Click Add Add. 5. Enter a name for the content group, click Save Options and then click Continue Continue. 6. Select the content group and click Pages Pages. 7. Click Add Add. 8. Enter a filter that describes the files you want to include in this content group. 9. Click Add Add. Your content group statistics will be tracked for all new data you import from now on. 10. If this is what you want or if you have additional filters or content groups to enter at this time, click Continue Continue. If you want to analyze this content group in data you have already imported, you will need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data. 11. To add another filter to this content group, click Add To return to the list of content Add. groups, click Back to Content Groups Groups.
NFA0001
About determining the content group for files that fit multiple groups
A file can only belong to one content group. If you have a file that meets the criteria for more than one group, Unica NetInsight will include the file in the first content group to which it can belong. You can use the Move Up and Move Down buttons to change the order of the content groups in the Content groups to be analyzed list.
NF20001
Analyzing indexes

NF2000A
About specifying directory indexes To add a directory index
206
Analyzing indexes
About specifying directory indexes

When a visitor enters into a Web browser a URL that does not end in a page (for example, www.unica.com/, the Web server that delivers the pages on that Web site knows to display the index page (the default page) for that directory (for example, www.unica.com/index.html). The page the Web server appends to the URL is the directory index (in this case, index.html). Even though the content that the visitor sees is the same for www.unica.com/ and www.unica.com/index.html, the two requests are logged differently in the Web server log files. Unica NetInsight attempts to combine the statistics for both ways of accessing the page. When Unica NetInsight encounters a log file entry for a request whose page matches an entry in its list of directory indexes, Unica NetInsight deletes the file name from the request. By default, Unica NetInsight uses /index.html, /default.asp, and /default.htm as directory indexes. If your Web site uses a directory index (for example, /index.asp) that Unica NetInsight does not try by default, you should specify it in Unica NetInsight. Otherwise, requests that end in a directory and requests for the directory index will be two separate entries in your Unica NetInsight reports. If you use /index.html, /default.asp, or /default.html as page names for pages that are not directory indexes, you should delete that page from Unica NetInsight's list of indexes. Likewise, if you want to see the file name of the directory index as part of the page entry in Unica NetInsight, delete the directory index from the list.
NFB0001
To add a directory index

1. View the profile in which you want to add a directory index. 2. Click the Options tab. 3. In the Options panel, select Content > Directory Indexes Indexes. 4. Click Add Add. 5. Enter the directory index (file name) in the text box and click Add Add. The new directory index will be used in new data you import. 6. If this is what you want or if you have more directory indexes to add at this time, click Continue Continue. If you want the new directory index to be used in log data you have already imported, you will need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
NF30001
Version 8.2.1
207
Analyzing links

NF3000A
About analyzing links About analyzing links using a redirect program About moving ntlinktrack to a CGI-accessible directory To redirect all external links About analyzing links using page tags About enabling the link summary To configure link options
About analyzing links

Unica NetInsight enables you to track how many times visitors are using your Web sites links to other Web sites. The link statistics appear on the Link Summary. You can analyze links using a redirect program or using page tags.
NFC0001
About analyzing links using a redirect program

Several steps are involved in preparing Unica NetInsight to analyze links using a redirect program: 1. Moving ntlinktrack.cgi (UNIX) or ntlinktrack.exe (Windows) to a CGI or scripts directory. 2. Redirecting all of the links you would like to track through ntlinktrack.cgi or ntlinktrack.exe. 3. Configuring the link options, which include the path to ntlinktrack.cgi or ntlinktrack.exe and the maximum number of characters to be displayed for a link. 4. Enabling the Link Summary.
NFD0001
About moving ntlinktrack to a CGI-accessible directory

When you install Unica NetInsight, a custom redirect program called ntlinktrack.cgi (UNIX) or ntlinktrack.exe (Windows) is placed in the Unica NetInsight program directory. (The default location for the Unica NetInsight program directory is /usr/local/NetInsight for UNIX and C:\Program Files\NetInsight for Windows.) Copy the program from the Unica NetInsight program directory into a CGI or scripts directory on your site (for example, /usr/local/apache/cgi-bin for UNIX or C:\Inetpub\scripts\ for Windows). Be sure to remember the directory to which you copied ntlinktrack, as you will need to enter this directory later.
208
Analyzing links
If the Web server whose log files you are analyzing is on a different platform than the computer on which you have Unica NetInsight installed, you will need to contact technical support to get the correct version of ntlinktrack.cgi or ntlinktrack.exe for your Web servers platform.
NFE0001
To redirect all external links

You will need to redirect the external links through the custom redirect program ntlinktrack.cgi (UNIX) or ntlinktrack.exe (Windows). The redirect program writes information to the log file that enables Unica NetInsight to identify external link entries in the log file data. 1. Open the HTML document that contains the link. 2. Edit the HREF statement that contains the link so that ntlinktrack.cgi or ntlinktrack.exe is the target of the link and the page that visitors will go to is the query string. For example,
<a href="/cgibin/ ntlinktrack.cgi?http://www.unica.com/products/NetInsight">
Unica NetInsight Home Page</a>

NFF0001
About analyzing links using page tags

To analyze links using page tag you must: 1. Configure your web site to tag links to external sites. Install and configure the page tag and page tag script. Then tag each link you want to track using the ntptLinkTag function. To mark a link as external, pass the namevalue pair lk=1 in the page tag. For more information, see the Unica NetInsight Administrator's Guide . 2. Configure the profile to use page tags, either in place of or to augment web server log files. 3. Configure the link options. (optional) 4. Enable the Link Summary report. The Link Summary report does not appear by default in the report list. To have it appear, you must first make the link dimension reportable and then update the profile.
N1000001
Version 8.2.1
209
About enabling the link summary

By default, the Link Summary does not appear in the list of reports. You need to enable the Link Summary by making the link dimension reportable. After the profile is updated, view the Link Summary to see your link statistics.
N1010001
To configure link options

The link options tell Unica NetInsight where to find ntlinktrack.cgi or ntlinktrack.exe and set the maximum display length for links. 1. View the profile in which you want to track links. 2. Click the Options tab. 3. In the Options panel, select Content > Links Links. 4. Enter the path to ntlinktrack.cgi (UNIX) or ntlinktrack.exe (Windows). This is the path from the document root of your Web site, not the path to the file on the computer on which Unica NetInsight is installed. For example, in a UNIX environment, if ntlinktrack.cgi is located in /usr/local/apache/cgi-bin/ but on your Web site it is accessible as http://yourdomain.com/cgi-bin/ntlinktrack.cgi, you should enter /cgi-bin/ntlinktrack.cgi. In Windows, if ntlinktrack.exe is located in C:\Inetpub\scripts\ but on your Web site it is accessible as http://yourdomain.com/scripts/ntlinktrack.exe, you should enter /scripts/ntlinktrack.exe. If the log files come from servers clustered for multiple sites, enter the full URL (for example, http://yourdomain.com/scripts/ntlinktrack.exe).
If you are using Windows with IIS, you need to allow the anonymous Web user Read and Execute permission through NTFS for the directory containing ntlinktrack.exe and for the file itself and Execute permission for Scripts and Executables through the IIS management console. 5. In the Link display length list, select the maximum number of characters to be displayed for a link on the Link Summary. You can select a number from 10 to 100, or you can select Unlimited Unlimited. 6. Click Save Options Options. Your link statistics will be tracked for all new data you import from now on. 7. If this is what you want, click Continue Continue. If you happen to have already imported data that contains link entries that have been redirected through ntlinktrack, you can analyze link statistics in data you have already imported by deleting all the data in your profile and reimporting your log files.
Analyzing keywords
If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
NF40001
Analyzing keywords

NF4000A
About analyzing local keywords To configure local keyword options
About analyzing local keywords

Unica NetInsight enables you to track which local keywords visitors are using on your Web site. A local keyword is a word visitors use in the search engine located on your Web site to search for content on your Web site. Analyzing which local keywords visitors are using can help you figure out what content users are trying to find on your Web site. The local keyword statistics appear on the Local Keyword Summary.
N1020001
To configure local keyword options

Before you can track local keywords, you need to tell Unica NetInsight the name of the parameter that contains the keywords and which pages or scripts Unica NetInsight should check for the parameter. 1. View the profile in which you want to track local keywords. 2. Click the Options tab. 3. In the Options panel, select Content > Keywords Keywords. 4. In the Local keyword parameter box, enter the name of the parameter that contains the local search engine keywords. If you leave this box empty, Unica NetInsight uses the parameters defined for the (Auto detect) rule in the Keywords option. 5. Click Save Options and then click Continue Continue. 6. Click Add Add. 7. Enter a filter that describes a page or script you want Unica NetInsight to search for local keywords. 8. Click Add Add. The local keywords from this page or script will be tracked for all new log file data you import from now on.
Version 8.2.1
211
9. If this is what you want or if you have other pages or scripts to enter at this time, click Continue Continue. If you want to analyze local keywords from this page or script in data you have already imported, you will need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
NF50001
To include specific redirection scripts in the reports

By default, Unica NetInsight excludes all hits resulting in an HTTP redirection status code (codes 301 and 302). In some cases you may wish to include in the reports certain pages or scripts that return a redirection code. 1. View the profile in which you want to include redirection scripts. 2. Click the Options tab. 3. In the Options panel, select Content > Redirection Scripts Scripts. 4. Click Add Add. 5. Enter a filter that describes the script you want to include and click Add Add. The statistics for this script will be included in all new log file data you import from now on. 6. If this is what you want or if you have additional scripts to enter at this time, click Continue Continue. If you want to include this script in data you have already imported, you will need to delete all the data in your profile and re-import your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
212
N1065B
10 Analyzing Dynamic Content

N1030001
About data conduits To configure Unica NetInsight to use a data conduit Adding dynamic pages Analyzing events Analyzing parameters Replacing or deleting characters in URLs
About data conduits

Data conduits enable you to pull data from external databases into Unica NetInsight reports. For example, using a data conduit you can directly view each visitor's name, company, address, phone number, and the names of the products he or she viewed in Unica NetInsight reports. You can also create data conduits to work with your external databases. (See the data conduit documentation that matches your database type for more information.) Unica NetInsight supports data conduits that work with the following database types: MySQL Oracle PostgreSQL DB2 Any ODBC data source
Once the data conduit is installed and configured, you need to configure Unica NetInsight to use the data conduit.
Version 8.2.1
213
10 - Analyzing Dynamic Content
Conduit tasks
Data conduits can perform a variety of tasks. When you configure Unica NetInsight to use the data conduit, you must specify which tasks the data conduit performs. The available data conduit tasks are: Cookie Lookup Replaces each visitor's unique cookie ID on reports with data (such as the visitor's name and phone number) retrieved from an external database. Department Lookup Determines department groupings using an external database (such as a corporate directory). The value that Unica NetInsight provides to the data conduit is determined by the value selected for the Department defined primarily by option in the profile options. Retrieves file data (such as a version number) from an external database, and replaces the file name stored in the Unica NetInsight database with the data retrieved from the external database. The file data stored in the Unica NetInsight database appears on the reports. Host Lookup Replaces each host name on reports with host data retrieved from an external database. Page Rewrite Retrieves the titles of pages from an external database, and replaces the directory paths and file names stored in the Unica NetInsight database with the titles retrieved from the external database. The titles stored in the Unica NetInsight database appear on the reports. Page Title Lookup Replaces the directory paths and file names of the pages on reports with the titles of pages retrieved from an external database. Page Value Rewrite (parameter name) Retrieves parameter value data (such as product names from an online catalog) from an external database, and replaces the parameter values stored in the Unica NetInsight database with the data retrieved from the external database. The data stored in the Unica NetInsight database appears on the reports. Product Lookup Replaces product SKUs on reports with product names retrieved from an external database. Product Rewrite Retrieves product names from an external database, and replaces the product SKUs stored in the NetInsight database with the names retrieved from the external database. The names stored in the Unica NetInsight database appear on the reports.
To configure Unica NetInsight to use a data conduit
User Lookup Replaces user names on reports with user data retrieved from an external database.
Visitor Lookup Replaces visitor names on reports with visitor data retrieved from an external database.
N1040001
To configure Unica NetInsight to use a data conduit

The data conduits you want Unica NetInsight to use must be configured and installed before you can configure Unica NetInsight to use them. You need to know the full path of the .dll or .so file for the conduit and the full path to the configuration file for the conduit. You need to enter these paths when configuring Unica NetInsight to use the data conduit. If you are using a parameter conduit task, you must define the parameter in Unica NetInsight before you can configure Unica NetInsight to use the data conduit. 1. View the profile in which you want to use the data conduit. 2. Click the Options tab. 3. In the Options panel, select Dynamic Content > Data Conduits Conduits. 4. Click Add Add. 5. In the Name of data conduit box, enter the name you want to use for the data conduit in the list of data conduits. 6. In the Full path to conduit box, enter the full path (including the file name) to the .dll (Windows) or .so (UNIX) file for the conduit. 7. In the Full path to conduit config box, enter the full path (including the file name) to the configuration file for the conduit. 8. In the Conduit tasks box, select the tasks for which you are using this data conduit. To select multiple adjacent tasks, select the first task and then hold down the Shift key while clicking the last task. To select multiple nonadjacent tasks, click the first task and then hold down the Ctrl key while clicking the other tasks. 9. When all the tasks you want are selected, click Save Options Options. 10. Do one of the following: a. If you have other data conduits you want to specify at this time, click Continue Continue. b. If the new data conduit performs only lookup tasks, click Continue Continue. c. If the data conduit task affects the Unica NetInsight database and you only want Unica NetInsight to use the conduit on new data you import from now on, click Continue Continue.
Version 8.2.1 215
d. If the data conduit task affects the Unica NetInsight database and you want to pull data from an external database for data you have already imported, you need to delete all the data in your profile and reimport your log files. (Note: If you Note: do not have all the log files you have imported into this profile, you lose data permanently by choosing this option.) To delete your profile data, click Delete Profile Data Data. Unica NetInsight begins using the data conduit as soon as the profile is updated.
N1050001
Adding dynamic pages

N105000A
About dynamic pages To add dynamic pages To delete a dynamic page To edit a dynamic page filter
About dynamic pages

When Unica NetInsight analyzes which pages on your Web site were viewed, by default it looks only at the page portion of the request. This method works well for static Web pages. However, for dynamically generated pages it is necessary to look at the query string to identify the content that was viewed. If you specify which pages are dynamically generated, Unica NetInsight looks at both the page and the query string when analyzing requests for these pages. You can also include a static Web page in the list of dynamic pages to cause Unica NetInsight to keep the query string and the page together.
N1090001
To add dynamic pages

1. View the profile in which you want to add dynamic pages. 2. Click the Options tab. 3. In the Options panel, select Dynamic Content > Dynamic Pages Pages. 4. Click Add Add. 5. Enter a filter that describes the pages for which the query string should not be separated from the pages and click Add Add. When you import data into Unica NetInsight from now on, query strings will be retained for these pages. 6. If this is what you want or if you have additional pages to enter at this time, click Continue Continue. If you want to retain query strings for pages in the data you have already imported, you need to delete all the data in your profile and reimport your log files.
216
Analyzing events
If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
N10A0001
To delete a dynamic page

1. View the profile in which you want to delete a dynamic page. 2. Click the Options tab. 3. In the Options panel, select Dynamic Content > Dynamic Pages Pages. 4. Select the filter that describes the page you want to delete from the list of dynamic pages and click Delete Delete.
N10B0001
To edit a dynamic page filter

1. View the profile in which you want to edit a dynamic page filter. 2. Click the Options tab. 3. In the Options panel, select Dynamic Content > Dynamic Pages Pages. 4. Select the filter you want to edit and click Edit Edit.
N1060001
Analyzing events

N1060007
About events Configuring Unica NetInsight to track events To define an event title To edit an event title To delete an event title
About events
An event is any action on your Web site other than loading a page. Events include, but are not limited to, the following: Changing a field on a form Selecting an option in a drop-down list box Submitting a form
Events are plentiful in Rich Internet Applications (RIAs) such as Flash or AJAX presentations.
N10C0001
Version 8.2.1
217
Configuring Unica NetInsight to track events

Before you can analyze events in Unica NetInsight, you must first tag the events on your site using Unica page tags and configure the Unica NetInsight profile to analyze page tags. See the Unica NetInsight Administrator's Guide for details on tagging pages. Any page tag request that contains the optional name-value pair ev=value will be considered an event by Unica NetInsight and will appear in the Event Summary.
N10D0001
To define an event title

By default, an event will be listed in a report using the value for the ev field that appears in the page tag request. Statistics for all events with the same value will appear in the same row of the report. You can specify a more user-friendly title for an event that will display in the reports instead of the request value. 1. View the profile in which you want to analyze events. 2. Click the Options tab. 3. In the Options panel, select Dynamic Content > Events Events. 4. Click Add Add. 5. In the Value of event field box, enter the value used for the ev field in the page tag requests for this event. 6. In the Title of event box, enter the text you want to appear in the report instead of the event field value. 7. Check the Create filtered metric check box if you want Unica NetInsight to create a filtered metric based on this event. 8. Click Save Options and then click Continue Continue. Unica NetInsight will begin using the new event titles the next time reports are generated.
N10E0001
To edit an event title

1. View the profile that contains the event title you want to edit. 2. Click the Options tab. 3. In the Options panel, select Dynamic Content > Events Events. 4. Select the event title and click Edit Edit.
N10F0001
To delete an event title

When you delete the event title for an event, Unica NetInsight will use the event field value in reports.
218
Analyzing parameters
Filtered metrics based on events cannot be deleted from the Events option pages. You must delete the custom metrics from the Custom Metrics option pages. 1. View the profile that contains the event whose title you want to delete. 2. Click the Options tab. 3. In the Options panel, select Dynamic Content > Events Events. 4. Select the event title you want to delete and click Delete Delete.
N1070001

N1070007
About parameters About parameter types To define a parameter To delete a parameter To edit a parameter
About parameters
A parameter is an item of information that is passed to a server by a user or another program. One example of a parameter is the visitor identifier in a cookie. Another example of a parameter is a product name that is passed in a query string to dynamically generate a page in a catalog. Unica NetInsight enables you to track the values that are being passed in query strings cookies pages page tags referrers any field in a log file
You can configure the parameter to track multiple values. You can also combine previously defined parameters of different types (such as page and query string) into a meta parameter. Parameter value statistics appear in a Parameter Summary. You create separate Parameter Summaries for each parameter whose values you want to track.
Associating parameters with views, visits, or events

When you define a parameter in Unica NetInsight, you indicate whether a separate parameter value will be passed for every view or event, or whether a single value will be used for the entire visit.
Version 8.2.1
219
If you want to use the parameter to determine sessionization or as a source parameter for a meta parameter, associate it with a view. You cannot use event or visit parameters for sessionization or as sources for meta parameters.
About storing the parameter values

For each parameter you define, you can choose whether or not to store the parsed parameter values in the NetInsight database. If you do not store the parameter values: Unica NetInsight does not automatically create a Parameter Summary for this parameter. The parameter is not available for use as a filter for a report. The parameter is not available as an option if you choose to use the value of a parameter to determine sessionization.
About parameter order

By default, parameters are listed in the order in which they were created. The order shown on the Parameter options page is the same order that is used in parameter lists and in breakdowns on which the parameters appear. You change the order using the Move Up and Move Down buttons.
About parameter value casing

You can specify how you want NetInsight to treat the case of parameter values. Values can remain as they are parsed from the log file (mixed-case) or converted to uppercase or lowercase. Use the uppercase or lowercase option to prevent duplicate entries from being stored in the database. The uppercase and lowercase options apply the operation to the parameter value when it is parsed from the log file before any other manipulation, such as import filters or search-and-replace rules, are applied. When you choose a casing option, it is applied only to new data; any data that is already stored in the database is not affected.
N1100001
About parameter types

When you define a parameter in NetInsight, you select a parameter type based on the field in the log file in which the parameter appears.
Query string parameters

Query string parameters are parameters in: the query string field in the log file the query string portion of the lc parameter in a page tag request
The query string is everything after and including the question mark (?) in a URL.
220
For example, if you had the following URL (all one line)
http://www.yoursite.com/catalog/products/show.cgi?product=product_name
the query string field would contain ?product=product_name and you could track the product_name values. If you want to track parameters in query strings, make sure your server is logging the query strings. Use GET requests, not POST requests, when executing your scripts.
Cookie parameters
Cookie parameters are parameters in the cookie field in the log file. For example, if you set cookies in the form
name=xxxx;age=yy
where xxxx is the user's login to your site and yy is the user's age in years, you could track the values passed to the name parameter, the age parameter, or both. You can parse parameters from cookies that contain multiple name/value pairs separated by ampersands (for example, YourID=First=John&Last=Doe&Number=123). You can set up a cookie parameter for just one of the cookie fragments (for example, just the ID number). Follow the steps for creating a regular cookie parameter, with one change. In the Parameter text box, enter the name of the cookie, an equal sign, and the name of the cookie fragment (for example, YourID=Number).
Field parameters
Field parameters are parameters in an arbitrary field in the log file. Use a field parameter to parse a parameter in a field for which there is not a designated parameter type. You can parse parameters from any field in a log file as long as the log file is in one of the following formats: Netscape Flexible W3C Any format defined in the Custom Log Formats section of the administrative options. You can describe NCSA log files with a custom log format in order to parse parameters from a field. For example, if you had a Netscape Flexible log file (in which each cookie has its own field) that contained the cookie field %Req->vars.cookie%, you could parse the cookie and have NetInsight sessionize based on that parameter.
Version 8.2.1
221
The value of parameters parsed from arbitrary fields is the entire value of the given field. If you want to manipulate the value, use the URL Search and Replace feature. The field must appear in either the log file's format header or the custom log format specification. If it does not, NetInsight can not parse or store the parameter values.
Page parameters
Page parameters are parameters in the URLs of Web pages the page portion of the lc parameter in page tag requests.
For example, if the URLs of your catalog of items are in the format
/catalog/item_name.html
you could track the values passed to item_name. Clip parameters are parameters associated with clips that visitors download from your streaming media server. For example, if the URLs of your catalog of clips are in the format
/catalog/artist_name.rm
you could track the values passed to artist_name. You need to use a regular expression to define a page parameter. Instead of entering the name of the log file field from which the parameter should be parsed, you use the regular expression to describe the parameter in the page. The section of the parameter in parentheses will be retained by NetInsight and used as the parameter value.
Page tag parameters

Page tag parameters are parameters in data that is passed by the Unica page tag script. For example, if the NTPT_FLDS.jv (browsers Java support) field in the ntpagetag.js file is set to true (to include the jv field in the initial page tag), you could track the values parsed from the jv field. (For details about configuring page tag fields, refer to the Unica NetInsight Administrator's Guide .) Use a page tag parameter to parse a parameter in the page tag for which there is not a designated parameter type. For example, if you place a tag on page /mydynamicpage?MyParameter=product, the record of a view of this page will look similar to the following (all one line):
lc=http%3A//localhost/pt/sample1.html%3F MyParameter%3Dsomething&rs=1024x768&cd=32& ln=en...&jv=1
222
To track MyParameter values, configure MyParameter as a query string parameter because MyParameter is part of the query string portion of the lc field. However, to track values for the jv parameter, configure jv as a page tag parameter.
Referrer parameters
Referrer parameters are parameters in either of the following: referrer field in the log file rf portion of the page tag request
For example, if you had a referrer URL like this:

http://www.google.com/search?hl=en&ie=UTF8&q=access+log+analyzer&btnG=Google+Search
You could track the value of the ie parameter to find out the character set of the search string. To track a parameter that appears in the referrer URL, you will need to use a regular expression. Instead of entering the name of the log file field from which the parameter should be parsed, you use the regular expression to describe the parameter in the referrer. The section of the parameter in parentheses will be retained by NetInsight and used as the parameter value.
Meta parameters
Meta parameters are parameters whose value is the value of the first parameter in an ordered group of parameters that has a value for an individual view. You can use this type of parameter to combine previously defined parameters of different types (such as page and query string) into a single parameter based on the availability of the parameters in the group. One use for this type of parameter is sessionization by the session ID used by Java application servers, which store the session ID value in the cookie when possible but otherwise store it in the page itself. You define a meta parameter by specifying a comma-delimited list of the names of other, previously defined parameters from which the value of the meta parameter will be taken. Only parameters associated with views can be source parameters for a meta parameter. Parameters associated with events or visits can not be used.
N1110001
To define a parameter
If you are creating a meta parameter, you must first create all the parameters that you want to be part of the meta parameter. 1. View the profile in which you want to track parameters. 2. Click the Options tab.
Version 8.2.1 223
3. In the Options panel, select Dynamic Content > Parameters Parameters. 4. Click Add Add. 5. In the Name box, enter the name you want to use for this parameter in the Parameter Summary. Use only alphanumeric characters. Do not use any spaces. 6. In the Type of parameter list, select the parameter type. 7. In the Parameter box, enter the parameter you want to track. For page and referrer parameters, you must use a regular expression to identify the parameter. For field parameters, enter the name of the field exactly as it appears in the log file's format header, excluding any field delimiters or literal formatting characters. For meta parameters, enter a comma-delimited list of the names of other, previously defined parameters from which the value of the meta parameter comes. Unica NetInsight ignores the case of the names, any spaces before or after the commas, and any parameter that has not been previously defined in the profile options. You can not use parameters associated with visits as source parameters for a meta parameter. 8. Specify how you want to handle the case of parameter values by selecting an option from the Parameter value casing drop-down list. The options are As parsed (mixed-cased), uppercase, or lowercase. 9. If you want to specify a column title for the column containing the parameter values for this parameter (for example, in the Parameter Summary), enter the title you want in the Column title box. If you do not specify a title, Unica NetInsight uses the parameter name as the column name. 10. If you want to specify a graph title to be used when the parameter data is ranked in ascending order, enter the title you want in the Graph title (Ascending) box. If you do not specify a title, Unica NetInsight uses the title Least Popular Parameter Values for parameter. 11. If you want to specify a graph title to be used when the parameter data is ranked in descending order, enter the title you want in the Graph title (Descending) box. If you do not specify a title, Unica NetInsight uses the title Most Popular Parameter Values for parameter. 12. If you want to link the parameter values with other data in another database, specify a CGI script in the Parameter lookup URL box. When users click a parameter value in the Parameter Summary, the value is appended to the URL and the script is executed. 13. In the Associate parameter value with list, select with what the parameter values are associated.
224
14. Select the Store parsed parameter value check box if you want Unica NetInsight to store the values in the NetInsight database. 15. Select the Allow multiple values check box If you want to track multiple values for this parameter. The default value separator is a comma. You can change the separator to a pipe, semicolon, or colon by editing the parameter after it is saved. 16. Select the Create report check box if you would like Unica NetInsight to automatically create a Parameter Summary for this parameter the next time the profile is updated. The summary is listed under Parameter Analysis on the Reports tab. 17. Select the Create dimension check box if you would like the parameter value to be available as a dimension on the Discovery Panel and in the Custom Report Wizard. The parameter is listed under Parameter Analysis. 18. Select the Create filter check box if you would like the parameter value to be available as a filter on the Discovery Panel and in the Custom Report Wizard. The parameter is listed under Parameter Analysis. 19. In the Page Help box, enter the text that should appear in the report's page help for the column containing the parameter values for this parameter. 20. Click Save Options and then click Continue Continue. 21. Select the parameter and click Requests Requests. 22. Click Add Add. 23. Enter a filter that describes the request that Unica NetInsight should check for this parameter. 24. Click Add Add. The requests described by this filter will be searched for this parameter in all new data you import from now on. 25. If this is what you want or if you have additional filters to enter at this time, click Continue Continue. If you want to search the requests described by this filter in the data you have already imported, you need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
N1120001
To delete a parameter
1. View the profile that contains the parameter you want to delete.
Version 8.2.1 225
2. Click the Options tab. 3. In the Options panel, select Dynamic Content > Parameters Parameters. 4. Select the parameter you want to delete and click Delete Delete.
N1130001
To edit a parameter
1. View the profile that contains the parameter you want to edit. 2. Click the Options tab. 3. In the Options panel, select Dynamic Content > Parameters Parameters. 4. Select the parameter you want to edit. 5. To change the parameter properties, click Edit Edit. 6. If you configured the parameter to allow multiple values, you can change the default separator from a comma to a pipe, semicolon, or colon. To change the separator, select the separator you want from the Value separator drop-down list. 7. To change the requests that Unica NetInsight checks for the parameter, do the following: a. Click Requests Requests. Unica NetInsight displays the list of filters that define the requests, pages, files or clips that Unica NetInsight checks for the parameter. b. To delete a filter, select it and click Delete Delete. c. To edit a filter, select it and click Edit Edit.
N1080002
Replacing or deleting characters in URLs

N1080008
About replacing or deleting characters in URLs To replace or delete characters in the URLs in your reports To delete a search and replace rule To edit a search and replace rule Examples
About replacing or deleting characters in URLs

Unica NetInsight enables you to manipulate the URLs in your log files so they will display in a more meaningful way in your Unica NetInsight reports. You modify the URLs using the URL search and replace rules. You can specify for each rule the URLs to which it should be applied.
226
When to change URLs in your reports

Sometimes URLs contain information that needs to be deleted or changed in order for the pages to display in a meaningful way in Unica NetInsight reports. The following are some scenarios in which you might want to replace or delete characters in URLs: Your URLs contain session IDs that cause the same content to appear as a different page in each log file entry. Your URLs contain product IDs, but product names would be more helpful in the report. You need to ensure that a parameter's values have a uniform case so that the capitalized value and the lowercase value are not considered two different values. You want to use only parts of the URL in your report. You want to use the parts of the URL in a different order.
Resolving page titles and using URL rules

Unica NetInsight applies URL search and replace rules before resolving page titles. If applying the URL search and replace rules results in pages that do not match pages on the server, page titles can not be resolved.
About the search rule

The search rule is a regular expression that specifies the text for which Unica NetInsight should search in the URLs. The search rule must contain one set of parentheses that encloses the part of the URL you want to replace or delete. Before Unica NetInsight applies URL search and replace rules to a URL, it decodes any CGI-encoded elements of the URL. Because browsers display URLs in their CGI-encoded form, you should be careful about using the URL as it appears in your browser to help you write the search rule. If you want to use part of the text that matches the search rule as all or part of the replacement value (either with the same capitalization as in the search rule or in a different case), you must identify the parts of the text to reuse by enclosing them within parentheses. The first set of parentheses (reading from left to right) indicates the portion of the input value to be replaced. Subsequent sets of parentheses identify re-usable portions of the text.
About the replacement value

The replacement value is the text that will replace all the text described by the portion of the search rule expression in the first set of parentheses. If you want to delete the text in parentheses, leave the Replacement value box empty. If you want to use part of the search rule text in the replacement value, you must Mark the text you want to use by enclosing it in parentheses in the search rule.
227
Version 8.2.1
Use tokens to indicate which portion of the text you want to use.
The text enclosed by the nth set of parentheses in the search rule The text enclosed by the nth set of parentheses in the search rule, converted to lowercase The text enclosed by the nth set of parentheses in the search rule, converted to uppercase
%VALUEn%
%LOWERn%
%UPPERn%
Parameters and search and replace rules

Query string rules, page rules, and entire request rules do not affect parameters that are parsed from the query string or page. Unica NetInsight will parse the parameter values as they appeared before these rules were applied.
Rule types
The rule type indicates the part of the URL that Unica NetInsight should search. The following types are possible: Entire Request The page plus the query string. Page The part of a URL that appears in the Page Summary when you do not resolve page titles. For non-clustered log files and log files that are clustered for a single site, this is everything after the domain name but before the "?" marking the beginning of parameters passed to a script. For log files clustered for multiple sites, this is everything before the "?" marking the beginning of parameters passed to a script. Query String The part of the URL after and including the "?" marking the beginning of parameters that are passed to a script on your Web site. Referrer Any URL that appears as a referrer for a view. Parameter Value for (parameter name) The value of the specified parameter. Event Event name. You can use regular expressions to replace event text; changes are shown in the Event Summary report.
N1140001
228
To replace or delete characters in the URLs in your reports

1. View the profile in which you want to modify the URLs. 2. Click the Options tab. 3. In the Options panel, select Dynamic Content > URL Search and Replace Replace. 4. Click Add Add. 5. In the Description box, enter a name you want Unica NetInsight to use to refer to the search and replace rule. 6. In the Search rule box, enter the regular expression that describes the text for which Unica NetInsight should search. 7. In the Replacement value box, enter the text that will replace all text described by the regular expression that you entered in the Search rule box. To delete the text instead of replacing it, leave the Replacement value box empty. 8. In the Replacement scope box, select an option to indicate whether only the first occurrence or all occurrences of the search rule in the text to be searched should be replaced. a. Select All matches to have Unica NetInsight search the text to be searched for all occurrences of text matching the search rule and replace each occurrence with the replacement value. (NetInsight will search only the original text to be searched. A replacement value that also matches the search rule will not cause Unica NetInsight to make recursive replacements within the replacement value.) b. Select Only first match to have Unica NetInsight find only the first occurrence of text matching the search rule in the text to be searched and replace it with the replacement value. 9. In the Type of rule box, select the option that describes the part of the URL that Unica NetInsight should search using the regular expression. 10. Click Save Options Options. Note: In the next steps, you specify which requests Unica NetInsight should attempt to match to the regular expression. If this search and replace rule is four a parameter value, Unica NetInsight will automatically list the pages you specified to search when you created the parameter. If you have no changes to make to the list, skip to 16. 11. Click Continue Continue. 12. Select the search and replace rule and click URLs URLs. 13. Click Add Add. 14. Enter a filter that describes the requests that Unica NetInsight should attempt to match to the regular expression you entered in the Search rule box. 15. Click Add Add.
Version 8.2.1
229
Unica NetInsight will use the search and replace rule on all new data that you import from now on. 16. If this is what you want, or if you have additional filters to add at this time, click Continue Continue. If you want the search and replace rule to be used on data you have already imported, you will need to delete all of the profile data and reimport your log files. If you do not still have every log file you have imported into this profile, you will lose data by choosing this option. To delete profile data, click Delete Profile Data Data.
N1150001
To delete a search and replace rule

1. View the profile that contains the parameter you want to delete. 2. Click the Options tab. 3. In the Options panel, select Dynamic Content > Search and Replace Replace. 4. Select the rule you want to delete and click Delete Delete.
N1160001
To edit a search and replace rule

1. View the profile that contains the search and replace rule you want to edit. 2. Click the Options tab. 3. In the Options panel, select Dynamic Content > Search and Replace Replace. 4. Select the rule you want to edit. 5. To change the rule properties, click Edit Edit. 6. To change the requests that Unica NetInsight attempts to match to the regular expression, do the following: a. Click URLs URLs. Unica NetInsight displays the list of filters that define the requests that Unica NetInsight attempts to match to the regular expression. b. To delete a filter, select it and click Delete Delete. c. To edit a filter, select it and click Edit Edit.
N1170001
230
Examples
Example 1: Deleting Session IDs
If the URLs on your site consistently have a session ID embedded in them, you can use a URL search and replace rule to delete the session IDs. If the session ID is the last part of the URL, the URLs might have the following format:
/directory_one/page_name.html-sessionid
To delete the session ID, enter the following regular expression in the Search rule box:
\ .html(-.*)$
The part of the URL that is described by the part of the regular expression in parentheses is the part that will be replaced. Leave the Replacement value box blank and select Page as the rule type. Because this session ID appears on every page of your site, when you are creating the filter for the pages that Unica NetInsight should attempt to match the regular expression against, enter the following:
That contains /
You will then need to create a second search and replace rule, identical to the first except with Referrer as the rule type. (Without this second rule, the session IDs will continue to appear in Referrer Breakdowns.)
Example 2: Replacing a Product ID with a Product Name

If your URLs have product ID numbers in them, you can replace the product ID with a product name to make the URLs easier to read in the Unica NetInsight reports. For example, if the product ID was the last part of the URL, the URLs would have the following format:
/directory_one/specific_product_ID.html
If the product ID for a bicycle is 7654, the URL for the bicycle page would be as follows:
/directory_one/7654.html
To replace the product ID with the word bicycle, you would enter the following regular expression in the Search rule box:
/.*/(7654)\.html
Version 8.2.1
231
You would enter bicycle in the Replacement value box. Because this product ID appears only in pages that start with /directory_one, when you specify the pages that Unica NetInsight should attempt to match the regular expression against, you would use the following filter:
That starts with /directory_one/
Example 3: Ensuring Uniform Case for Parameter Values

If you want the values for a parameter to always use the same case, you can use subpatterns to identify the values and translate them into a uniform case. For example, the URL has the following format (the parameter you are parsing is category):
/directory_one/catalog.html?category=value
If the product is shoes, one time the URL might be

/directory_one/catalog.html?category=shoes
and another time it might be

/directory_one/catalog.html?category=Shoes
To cause the category to show up as shoes every time (so it is counted as one category in the reports), enter the following in the Search rule box for a parameter URL search and replace rule:
(.*)
In the Replacement value box, enter the following:

%LOWER1%
Using Parts of the URL in a Different Order

If you want the information in the URL to be displayed in the report in a different order, you can use subpatterns to identify the pieces you want to use in the replacement value. For example, the URL has the following format:
/directory_one/catalog.html?product=value&color=value
If the product is red shoes, the URL would be as follows:

/directory_one/catalog.html?product=shoes&color=red
To get the result product=red-shoes in the report, enter the following in the Search rule box for a query string URL search and replace rule:
product=((.*)&color=(.*))
In the Replacement value box, enter the following:

%VALUE3%-%VALUE2%
When you specify the pages that Unica NetInsight should attempt to match the regular expression against, use the following filter:
That match /directory_one/catalog.html
Version 8.2.1
233
N106DC
11 Analyzing Marketing Efforts

N1180001
About analyzing marketing efforts Analyzing campaigns Analyzing keywords Analyzing referrers Analyzing visits from indexing agents Analyzing visit cost
About analyzing marketing efforts

Unica NetInsight allows you to track the effectiveness of the marketing efforts that relate to your Web site. Using Unica NetInsight you can:
N1190001
Analyze the performance of various campaigns Analyze visit cost and paid search ROI See which sites are referring the most visitors to your site Track which search engines and directories are indexing your site
Analyzing campaigns

234
About campaigns About dynamic and static campaigns About campaign channels About campaign segments About entry pages for campaign segments
Analyzing campaigns

N119000A
To create a campaign in NetInsight To specify campaign channels To specify campaign segments To specify entry pages Configuring paid search campaigns
About campaigns
A campaign is messaging created by a marketing department to drive traffic to your Web site. A campaign is typically run through multiple channels (banner ads, email, Internet search, print ads, etc.) and a channel may contain multiple segments (the ad variation within a channel). Optionally, a campaign can include specific entry pages on your Web site that associate a visit with that campaign. In Unica NetInsight, campaign statistics are listed in the Campaign Summary report. The following diagram shows the relationships between campaigns, channels, segments, and paid keywords in two sample static campaigns.
N11E0001
Version 8.2.1
235
11 - Analyzing Marketing Efforts
About dynamic and static campaigns
N11E0007

Campaigns can be defined in Unica NetInsight as either dynamic or static. Dynamic campaigns attribute visits based on parameter values passed in a query string. Static campaigns attribute visits based on entry page definitions in the campaign's channel segments.
About dynamic campaigns

Dynamic campaigns allow you to define a campaign matching pattern only once in Unica NetInsight, instead of having to define each campaign manually. This is especially useful with online channels whose channel and segment definitions may alter regularly over time. You create dynamic campaigns by specifying a campaign parameter identifier in Unica NetInsight. This identifier is used to match a campaign parameter identifier in the URLs visitors use to access your site. At data import, Unica NetInsight parses the parameter strings. When a match is made between a query string parameter ID and one defined in Unica NetInsight, Unica NetInsight examines the value of the parameter. It then attributes that visit to an existing campaign (if a value match is found) or automatically creates and assigns that visit to a new campaign (if a value match is not found). The name of each campaign in Unica NetInsight is the value of the parameter. The channels and segments belonging to a campaign can also be defined as dynamic, thus you can use a single campaign, channel, and segment matching pattern to process all visit attributions to your campaigns. While dynamic campaigns can use parameter values alone to attribute visits, you can include entry page definitions as well if you want target specific pages only in a campaign. For example, suppose you define a dynamic campaign whose parameter identifier is nicam. Under that you define a dynamic channel whose parameter identifier is nichn. And under that you define a dynamic segment whose parameter identifier is niseg. Three unique visitors enter your site at these URLs: http://www.mysite.com?nicam=Clearance&nichn=Email&niseg=Specia lOffer http://www.mysite.com?nicam=Clearance&nichn=Twitter&niseg=Spec ialOffer http://www.mysite.com?nicam=SpringSale&nichn=Email&niseg=SaleA lert
The first two visits will both be attributed to the Clearance campaign, different channels, but to the same SpecialOffer segment. The third visit will be attributed to the SpringSale campaign, Email channel, and SaleAlert segment. If any of these campaigns, channels, or segments do not already exist in Unica NetInsight they will be created automatically.
236
Analyzing campaigns
In Unica NetInsight reports, in addition to comparing the traffic generated by the two campaigns, you can also compare traffic generated across campaigns by different channels (Email versus Twitter) and segments (SpecialOffer versus SaleAlert).
About Static campaigns

Static campaigns attribute visits based on entry page definitions in the campaign's channel segments. While less flexible than dynamic campaigns, static campaigns are useful if you are not parameterizing URLs, or if you deploy only a few campaigns whose channels and segments alter little or not at all over time. Static campaigns could be a good choice for print media, since you know the URL well in advance of the traffic coming to your site. For example, suppose you were running several magazine ads to launch a new product. The campaign segment for the first ad might look like this:
Campaign Name: Extreme Widget Channel Name: Print Media Segment Name: Ad1 Entry Page: www.site.com/ExtremeWidgetAd1
Every visit whose entry page is www.site.com/ExtremeWidgetAd1 will be associated with the Ad1 segment of the Extreme Widget campaign.
Which to use, dynamic or static?

For most situations dynamic campaigns are superior to static. They are easier to set up, more adaptive to change, and much easier to maintain. In static campaigns, each time new channels segments are added to your marketing campaign they must be manually added to Unica NetInsight. Dynamic campaigns automate this process and require editing only if parameter identifiers themselves change. A simple deployment model would be to create a single dynamic campaign with dynamic channels and segments. If you want the ability to compare campaign-driven visits to organics visits, below the dynamic camapign you could create a single static campaign with static channels and segments and no entry pages. This static campaign would catch any and all visits not matched and attributed by the dynamic campaign. Note that as it suits your needs you can also use a hybrid of static and dynamic behavior at different levels in a campaign definition. For example, you could create a static campaign whose channels and segments are dynamic.
Ordering campaigns for desired attribution

A visit can be attributed to only one campaign. If a visit meets the criteria for multiple campaigns, Unica NetInsight attributes it to the first campaign whose criteria it meets. The order of attribution is determined by the order in which campaigns are listed on the Campaign Options screen.
Version 8.2.1
237
It is important to consider the order in which you want visits attributed and then order your campaigns accordingly. As a rule of thumb, you should position campaigns with the most-specific matching criteria at the top. A static campaign with static channels and segments and no entry page definition will match all visits. If such a campaign were positioned at the top of the list no other campaigns would receive attribution. Use the up and down buttons to the right of the list to change the order of the campaigns. These ordering considerations and guidelines apply to channels and segments as well.
Allowing default substitutions for dynamic channels and segments

When you create dynamic channels and segments, you can specify whether to allow a default value to be used if the parameter identifier specified in Unica NetInsight is not found in the parameter string, or if a parameter value is an empty string. If you allow the default to be used, "None" will be substituted for missing parameter identifiers and/or values. If you do not allow the default to be used, Unica NetInsight will search other channels and campaigns and attempt to make a parameter identifier match. If a match is made, attribution for that visit is assigned accordingly. If a match cannot be made, no visit attribution is assigned. If the parameter value is missing, no attribution is made.
N11F0001
About campaign channels

A campaign channel is the content source (such as a Web site, print publication, or newsletter) through which you are running a campaign that sends visitors to your Web site. Campaign channel statistics appear on the Campaign Channel Summary. If campaign channels in separate campaigns share a name, you can analyze the combined traffic for the channels in the Campaign Channel Summary. In the Campaign Channel Summary unfiltered by a campaign, there is one row per unique channel name that shows the combined traffic for all channels with that name. In the Campaign Channel Summary filtered by a campaign, the row with the shared channel name shows only traffic for the channel in the specified campaign. You must specify one of the following types for each campaign channel: Affiliate Web site that sells the products of other Web sites, called "affiliates." Banner ad Advertisement in the form of a graphic image on a Web page or located in a space reserved for ads, linking to an advertisers Web site. Direct mail Marketing communications delivered directly to a prospective purchaser via a postal service or private delivery company. Email Email message that contains information or advertising. Instant messaging Service that alerts users when friends or colleagues are online, and enables them to communicate in real time through private online chat areas.
238
Analyzing campaigns
Newsletter Printed or online report that provides news or information of interest to a special group. Paid listing Guarantee of a ranking in a search listing for the terms of your choice; can be placed on a site other than a search engine. Print media Medium that distributes printed matter, such as a newspaper, magazine, or book. Rich media ad Advertisement that usually includes richer graphics than a banner ad and includes audio or video within the advertisement. Search engine (PPC/CPM) Pay-per-click or cost per thousand views advertising (or both) on a search engine. (Other) A channel type not listed above.
Campaign channel type statistics appear on the Campaign Channel Type Summary. For search engine (PPC/CPM) channels, you can analyze the performance of the various paid keywords. Paid keyword statistics appear on the Paid Keyword Summary.
N1200001
About campaign segments

A campaign segment is the ad variation or group within each campaign channel. Campaign segment statistics appear on the Campaign Segment Summary. Like campaigns and channels, segments can be dynamic or static. Optionally, segments can have one or more associated entry pages. Entry pages can be defined using the page's file name or by a query string filter. Visitors who access a site via a segment's defined entry pages will be attributed to that segment, and their visit will ultimately be attributed to the segment's campaign. While Unica NetInsight does not require you to define entry pages, whether you should or not depends on the type of campaign you are creating and whether you want only select entry pages attributed to your campaigns. Dynamic campaigns (with dynamic channels and segments) can attribute visits to campaigns based on parameter strings alone. Define entry pages only if you want specific points of entry attributed to your dynamic campaign. Static campaigns (with static channels and segments) can only attribute visits based on entry page. So, while not required by Unica NetInsight, practically speaking, static campaigns require entry page definitions if they are to accurately attribute visits to different campaigns. A static campaign with no entry pages defined will match every visit to your site.
If campaign segments in separate channels share a name, you can analyze the combined traffic for the segments in the Campaign Segment Summary. In the Campaign Segment Summary unfiltered by a channel, there is one row per unique segment name that shows the combined traffic for all segments with that name. In the Campaign Segment Summary filtered by a channel, the row with the shared segment name shows only traffic for the segment in the specified channel.
N1210001
Version 8.2.1
239
About entry pages for campaign segments

For any campaign segment you can specify the URL of an entry page to your Web site. Visitors arriving on this page will be attributed to this segment. URLs for entry pages must be unique for each segment. You can achieve unique URLs in the following ways: Create a separate entry page for each campaign segment. Use query string parameters to create multiple unique URLs for the same entry page.
Do not use your home page as the entry page unless you are using query strings to define the entry page. If you are not using query strings and you use your home page as the entry page for the campaign, all traffic to your home page appears in the campaign analysis. To figure out what percentage of the traffic to your home page resulted from your campaign, you must drill repeatedly into the Campaign Summary. Query strings can contain other parameters besides the ones used to identify the campaign segment. These parameters can be analyzed in Unica NetInsight as well.
About entry page matching rules

Unica NetInsight applies entry page matching rules defined for a campaign segment as follows: If a question mark is not present in the value specified for the entry page rule, the entire value that is specified is compared to the entry page according to the rule definition. If a question mark is present in the value specified for the entry page rule, the part of the rule to the left of the question mark (the page portion) is compared to the entry page according to the rule definition. If the page part of the rule matches, the part to the right of the question mark (the query string portion) is compared to the query string associated with the entry page as follows: If the first character of the query string part of the rule is a percent sign, it will be considered to be a regular expression and will be compared to the query string part of the entry page using a that match the regular expression filter. If the first character of the query string part of the rule is not a percent sign and the query string part of the rule contains one or more equal signs, it will be considered to be a collection of name/value pairs that Unica NetInsight should search for in the query string associated with the entry page. The query string part of the entry page will be considered a match if each name/value pair present in the rule definition is also present in the query string. The order and case of the name/value pairs entered in the rule definition is not significant. If the first character of the query string part of the rule is not a percent sign and the query string part of the rule does not contain an equal sign, it will be compared to the query string part of the entry page using a that match filter.
Following are some examples of entry page rules and the pages that will and will not match the rule.
Analyzing campaigns
Example 1
If the entry pages of a campaign segment are defined by the filter that contain ad? %referrer=google.* visitors entering the Web site through the following pages would be %referrer=google.*, attributed to the given campaign, channel, and segment:/ad.cgi?referrer=google /ad.cgi?thereferrer=google /ad.cgi?keywords=red&referrer=google /scripts/ad.cgi?referrer=google&keywords=red /googlead.cgi?referrer=googlegroups&keywords=red Visitors entering through these entry pages would not be attributed to the given campaign, channel, and segment:/ad.cgi?referrer=yahoo /referral.cgi?referrer=google
Example 2
If the entry pages of a campaign are defined by the filter that match /ad.cgi?referrer=google visitors entering the Web site through the following pages /ad.cgi?referrer=google, would be attributed to the given campaign, channel, and segment:/ad.cgi?referrer=google /ad.cgi?referrer=google&keywords=red /ad.cgi?keywords=red&referrer=google Visitors entering through these pages would not be attributed to the given campaign, channel, and segment:/ad.cgi?referrer=google-groups /ad.cgi?thereferrer=google
Example 3
If the entry pages of a campaign are defined by the filter that end with ad.cgi?google ad.cgi?google, visitors entering the Web site through the following page would be attributed to the given campaign, channel, and segment:/ad.cgi?google Visitors entering through these pages would not be attributed to the given campaign, channel, and segment:/ad.cgi?google-groups /scripts/ad.cgi?referrer=google
N1220001
To create a campaign in NetInsight

1. View the profile in which you want to create a campaign. 2. Click the Options tab. 3. Under Options select Marketing > Campaigns Campaigns. 4. Click Add Add. 5. Enter a name for the campaign. In static campaigns, this is the name that will appear in reports. In dynamic campaigns, the campaign name in reports is the value returned by the campaign parameter. 6. Specify whether the campaign is static or dynamic. 7. Enter the parameter whose value will be used to define unique campaigns. The parameter ID is case-insensitive. 8. Click Save Options > Continue Continue.
Version 8.2.1
241
Next you must specify the channels through which you are running this campaign.
N1230001
To specify campaign channels

If you are specifying channels for a campaign immediately after creating the campaign, begin with step 4 below. Otherwise, begin with step 1. 1. View the profile that contains the campaign for which you are defining channels. 2. Click the Options tab. 3. Under Options select Marketing > Campaigns Campaigns. 4. Select the campaign and click Channels > Add Add. 5. Enter a name for the channel. In static channels, this is the name that will appear in reports. In dynamic channels, the channel name in reports is the value returned by the channel parameter. 6. Select the channel type that best describes the content source through which you are running this campaign. If you select: a. Search engine (PPC/CPM), enter the parameter from which paid keywords will be parsed. The parameter ID is case-insensitive. b. Other, enter a description of the channel type. 7. Specify whether this channel is static or dynamic. For dynamic channels: a. Enter the parameter whose value will be used to define channels in this campaign. The parameter ID is case-insensitive. b. Specify whether to assign a visit to the default channel "None" if the parameter identifier is not found in a parameter string. If left unchecked, Unica NetInsight will search other campaigns and attempt to make a match for attribution. 8. Click Save Options > Continue Continue. Next you must specify the campaign segments for this campaign channel.
N1240001
To specify campaign segments

If you are specifying segments for a campaign channel immediately after creating the channel, begin with step 4 below. Otherwise, begin with step 1. 1. View the profile that contains the campaign for which you are defining segments. 2. Click the Options tab. 3. Under Options select Marketing > Campaigns Campaigns. 4. Select the campaign and click Channels Channels. 5. Select the channel and click Segments > Add Add. 6. Enter a name for the segment.
Analyzing campaigns
In static segments, this is the name that will appear in reports. In dynamic segments, the segment name in reports is the value returned by the segment parameter. 7. Specify whether this channel is static or dynamic. For dynamic channels: a. Enter the parameter whose value will be used to define segments in this channel. The parameter ID is case-insensitive. b. Specify whether to assign a visit to the default segment "None" if the parameter identifier is not found in a parameter string. If left unchecked, Unica NetInsight will search other channels and attempt to make a match for attribution. 8. Click Save Options > Continue Continue. Next, you can optionally specify entry pages associated with this campaign segment. If you choose not to specify entry pages for a dynamic campaign, Unica NetInsight will use parameter values alone to attribute visits to the campaign. Note if you choose not to specify entry pages for a static campaign, all visits will be attributed to the segment's campaign.
N1250001
To specify entry pages

If you are specifying entry pages for a campaign segment immediately after creating the segment, begin with step 6 below. Otherwise, begin with step 1. Specifying an entry page is an optional step in defining a NetInsight campaign. If you choose not to specify entry pages for a dynamic campaign, NetInsight will use parameter values alone to attribute visits to the campaign. If you choose not to specify entry pages for a static campaign, all visits will be attributed to this the campaign. 1. View the profile that contains the campaign for which you are defining entry pages. 2. Click the Options tab. 3. Under Options select Marketing > Campaigns Campaigns. 4. Select the campaign and click Channels Channels. 5. Select the channel and click Segments Segments. 6. Select the segment and click Entry Pages > Add Add. 7. Enter a filter that specifies the page(s) visitors responding to your campaign use to access your site. For example, if you are tracking a banner ad campaign, specify the page visitors go to after clicking the ad. If you are tracking a print ad campaign, specify the Web site address given in the print ad. You can also use query strings to define your campaign. 8. Click Add Add.
Version 8.2.1
243
Statistics for this campaign will now be tracked in all subsequently imported data. To track this campaign in data that has already been imported you must delete your profile data and re-import the log files. Note that if you no longer have all previously imported log files, deleting profile data will result in data loss.
N1260001
Configuring paid search campaigns

N1260007
About paid search data To analyze paid search data without the integration module Creating paid search campaigns to analyze in Unica NetInsight Creating a paid search campaign in Unica NetInsight
About paid search data

If you bid on paid search terms at one or more search engines, you can configure Unica NetInsight to analyze traffic driven to your site by paid search terms. This enables you to analyze activity on a search term across search engines and attribute future activity on your site to the paid search terms. There are two methods of configuring Unica NetInsight to analyze paid search data.
Method Use the Paid Search Integration module Advantages Brings additional data into the system NetInsight campaign created automatically Works with smaller vendors No added cost Disadvantages Added cost May not support all the paid search vendors
Manually configure campaigns in search engines and NetInsight

N1270001
Less data than with the integration module Greater chance of error during manual campaign creation
To analyze paid search data without the integration module

To analyze paid search data in Unica NetInsight without the integration module, you must complete the following tasks: 1. Create a paid search campaign at one or more of the supported search engines. 2. Create one or more paid search campaigns in Unica NetInsight. 3. Update the profile.
N1280001
Creating paid search campaigns to analyze in Unica NetInsight

You can make it easier to track your paid search campaigns in Unica NetInsight by following Unica's recommended best practices when you create the campaigns in the search engines.
244
Analyzing campaigns
Every paid search campaign you create in a search engine must be associated with a campaign in your profile in order for you to analyze the data in your profiles. The Unica NetInsight campaign must be created before the paid search data is imported into your profile. To simplify your profile configuration and ensure the campaign is always created before the data arrives, Unica recommends using one dynamic campaign in Unica NetInsight to analyze all of your paid search campaigns. In order for your paid search campaign data to be automatically associated with the dynamic campaign, you must define the destination URL using exactly the same parameters and format for all your paid search campaigns.
Paid search keyword parameter

Use the same parameter for all campaigns in all search engines. Unica recommends using nipkw nipkw.
Destination URL
Use parameters in the query string of the destination URL to indicate the campaign, search engine, search term, and ad group. Use exactly the same parameters in all campaigns in all search engines. Unica recommends the following parameters:
Parameter nicam nichn nipkw niseg Value Campaign name Search engine name Search term Ad group name
The resulting URL will look like this:

http://www.unicaware.com?nicam=Copiers&nichn=Google&nipkw=search%20ter m&niseg=colorcopiers
You can use additional query string parameters to enable Unica NetInsight to analyze other information about your paid search campaigns. For example, this URL uses the variation parameter to track the ad variation:
http://www.unicaware.com?nicam=Copiers&nichn=Google&nipkw=search%20ter m&niseg=colorcopiers&variation=2
If you use additional parameters, you must define them in Unica NetInsight in order to analyze the data.
Version 8.2.1
245
If you must use static campaigns in Unica NetInsight

Make a note of the campaign and ad group names you use in the search engine. You must enter this exact text when creating the Unica NetInsight campaigns.
N1290001
Creating a paid search campaign in Unica NetInsight

When you create a paid search campaign in Unica NetInsight, the text you enter in certain fields must match exactly the text you entered when you created the campaigns in the search engines. If you are using a dynamic campaign, the parameters must match exactly. If you are using a static campaign, the campaign name, paid keyword parameter, segment name, and destination URL must match exactly.
Unica NetInsight campaign field Value
Name of campaign
Name of the search engine campaign.
Campaign identifier parameter Parameter in the destination URL for the campaign name (for example, nicam). This option is available only in dynamic campaigns. Name of campaign channel Name of the search engine, (for example, Google, Yahoo, or MSN). Parameter in the destination URL for the channel name (for example, nichn). This option is available only in dynamic campaigns. Search engine (PPC/CPM). Keyword parameter you specified in the search (for example, nipkw). engine Name of the ad group in the search engine. Parameter in the destination URL for the ad group (for example, niseg). This option is available only in dynamic campaigns. Destination URL for the ad the in the search engine. (This is required for static campaigns and optional for dynamic campaigns.)
Channel identifier parameter
Type of channel Paid keyword parameter
Name of campaign segment Segment identifier parameter
Group entry pages
N11A0001
Analyzing keywords
246
About analyzing keywords

Analyzing keywords

N11A000A
About character sets and keywords To create a keywords parsing rule To specify keyword parameters for a keyword rule To specify referrers for a rule To specify an excluded URL for a keyword rule To specify a character set parameter for the keyword rule Keyword parsing example
About analyzing keywords

Unica NetInsight enables you to specify the rules it will use to track the keywords that visitors used in search engines to find your Web site. Unica NetInsight can parse keywords from the query string of the referring page or from the referring page itself. When Unica NetInsight parses keywords from the referring page itself, it ignores the query string; instead, it uses the page value of the referrer as the keywords for the request. Keyword statistics appear on the Keyword Summary. Unica NetInsight contains pre-configured keywords that use regular expressions. You should not modify the pre-configured keywords unless you have a particular need to do so after you review your log files. If you want Unica NetInsight to search all referrers for a specific parameter, you should add that parameter to the (Auto detect) keyword parsing rule, instead of creating a new keyword parsing rule.
N12A0001
About character sets and keywords

The character set a search engine uses to encode the keywords affects Unica NetInsight's ability to analyze the keyword. If the keyword is encoded using a different character set than the profile uses, Unica NetInsight may not be able to correctly import the keyword. Since the UTF-8 character set can import a wide variety of characters, if the profile character set is UTF-8 Unica NetInsight can import keywords encoded in other character sets and store and display them correctly in UTF-8. However, you need to tell Unica NetInsight what character set to expect. Some search engines identify the character set used to encode the keywords by passing the character set name as the value of a parameter. You can specify this character set parameter for the keyword rule. You can also specify a default character set for a keyword rule.
N12B0001
To create a keywords parsing rule

1. View the profile in which you want to create the keyword parsing rule. 2. Click the Options tab.
Version 8.2.1 247
3. In the Options panel, select Marketing > Keywords Keywords. 4. Click Add Add. 5. In the Description box, enter a description of the rule. 6. In the Type of rule list, select an option. To parse keywords from the query string of the referring page, select Query String String. To parse keywords from the referring page itself, select Page Page.
7. In the Default character set box, select the character set Unica NetInsight should assume the search engine used to encode the keyword in the query string or page. This option only applies to profiles whose character set is UTF-8. 8. Click Save Options and then click Continue Continue. If you selected a keyword parsing rule of type "query string," you now need to specify the keyword parameters that should belong to this keyword rule. If you selected a keyword parsing rule of type "page," the text that appears after the last slash in the page will be used as the keywords. If you want to limit the pages that are parsed for keywords by more than just the referrer, you can configure Unica NetInsight to only parse pages that contain at least one of a set of text strings you specify.
N12C0001
To specify keyword parameters for a keyword rule

If you are specifying keyword parameters immediately after creating the keyword parsing rule, continue with 4. Otherwise, start with 1. 1. View the profile that contains the keyword parsing rule. 2. Click the Options tab. 3. In the Options panel, select Marketing > Keywords Keywords. 4. Select the keyword rule and click Keyword Parameters Parameters. 5. Click Add Add. 6. For a keyword parsing rule of type "query string," enter the name of a parameter that contains keyword values. For a keyword parsing rule of type "page," enter a literal string found within the referring page that identifies the pages from which keywords should be parsed. Click Add Add. 7. The parameter you entered will be used to look for keywords in all new data you import from now on.
248
Analyzing keywords
If this is what you want or if you want to add more parameters at this time, click Continue If you want the parameter to be used to look for keywords in data you Continue. have already imported, you will need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data. Now you need to specify which referrers should be searched using the keyword rule.
N12D0001
To specify referrers for a rule

If you are specifying referrers or sites immediately after specifying keyword parameters, continue with 4. Otherwise, start with 1. 1. View the profile that contains the keyword parsing rule. 2. Click the Options tab. 3. In the Options panel, select Marketing > Keywords Keywords. 4. Select the keyword and click Included Referrers Referrers. 5. Click Add Add. 6. Enter a filter that describes a referrer or site to whom this keyword rule should be applied and click Add Add. 7. The keyword rule will be applied to this referrer in all new data you import from now on. If this is what you want or if you have more referrers to add at this time, click Continue If you want the keyword rule to be applied to this referrer in data you have Continue. already imported, you will need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
N12E0001
To specify an excluded URL for a keyword rule

You can specify URLs within the included referrer that you do not want to be searched using the keyword rule. If you are specifying an excluded URL immediately after specifying referrers, continue with 4. Otherwise, start with 1. 1. View the profile that contains the keyword parsing rule. 2. Click the Options tab.
Version 8.2.1 249
3. In the Options panel, select Marketing > Keywords Keywords. 4. Select the keyword rule and click Excluded URLs URLs. 5. Click Add Add. 6. Enter a filter that describes a URL that should not be searched using the keyword rule and click Add Add. This URL will not be searched using the keyword rule in all new data you import from now on. 7. If this is what you want or if you have more URLs to add at this time, click Continue. If you want this URL to not be searched using the keyword rule in data you have already imported, you will need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
N12F0001
To specify a character set parameter for the keyword rule

If you are specifying a character set parameter immediately after specifying keyword parameters, referrers, or excluded URLs, continue with 4. Otherwise, start with 1. 1. View the profile that contains the keyword parsing rule. 2. Click the Options tab. 3. In the Options panel, select Marketing > Keywords Keywords. 4. Select the keyword rule and click Character Set Parameters Parameters. 5. Click Add Add. 6. Enter the name of the parameter that contains the name of the character set used to encode the keyword values and click Add Add. The parameter you entered will be used to determine the keyword character set in all new data you import from now on. 7. If this is what you want or if you want to add more parameters at this time, click Continue Continue. If you want the parameter to be used to determine the keyword character set in data you have already imported, you will need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option.
250
Analyzing referrers
To delete your profile data, click Delete Profile Data Data.

N1300001
Keyword parsing example

In summary, to specify the rules Unica NetInsight uses to track the keywords that visitors used to find your Web site, you need to: 1. Create a keyword parsing rule. 2. Specify the parameters that will belong to this rule. 3. Identify the referrers that will be searched for keywords using the keyword parsing rule. For example, to track keywords from a search site located at example.com where the example.com, URLs are in the format:http://www.example.com/mysearch.cgi?searchterms=saints and the parameter where search terms appear is searchterms you would need to: searchterms, 1. Create a new keyword parsing rule named Example Example. 2. Specify a parameter named searchterms This instructs Unica NetInsight to search searchterms. query strings in referrals from example.com for the parameter searchterms and searchterms, extract the parameters value as a keyword. 3. Add example.com as a referrer using the filter that contain example.com This example.com. instructs Unica NetInsight to search for keywords in referrals from example.com.
N11B0001
Analyzing referrers

N11B000A
About analyzing referrers To create a referrer group To add referrers to a referrer group Determining the group for referrers that fit multiple groups
About analyzing referrers

Unica NetInsight enables you to track which referrers are sending the most visitors to your Web site. The referrer statistics appear on the Referrer Summary. You can group traffic from multiple referrers into a single referrer group. This enables you to group the traffic from major search engines into recognizable names. For example, you could display the AOL Search search engine as AOL Search instead of search.aol.com. By default, Unica NetInsight is configured to group traffic from the most common search engines. If the Referrer Summary is blank, your server is probably not logging the referrer field.
N1310001
Version 8.2.1
251
To create a referrer group

1. View the profile in which you want to create the referrer group. 2. Click the Options tab. 3. In the Options panel, select Marketing > Referrer Groups Groups. 4. Click Add Add. 5. In the Name of referrer group box, enter the name you want to have displayed for the referrer group. 6. Click Save Options Options. 7. Click Continue Continue. Now you need to specify which referrers you want to be part of this referrer group.
N1320001
To add referrers to a referrer group

If you are adding referrers immediately after creating the referrer group, start with 4. Otherwise, start with 1. 1. View the profile that contains the referrer group. 2. Click the Options tab. 3. In the Options panel, select Marketing > Referrer Groups Groups. 4. Select the referrer group and click Referrers Referrers. 5. Click Add Add. 6. Enter a filter that describes the referrer you want to add to this referrer group and click Add Add. The referrer you entered will be part of this referrer group in all new data you import from now on. 7. If this is what you want or if you have more referrers to add at this time, click Continue Continue. If you want the referrer to belong to the referrer group in data you have already imported, you will need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
N1330001
252
Analyzing visits from indexing agents
Determining the group for referrers that fit multiple groups

A referrer can only belong to one referrer group. If you have a referrer that meets the criteria for more than one group, Unica NetInsight will include the referrer in the first referrer group it can belong to in the list of referrer groups. You can use the Move Up and Move Down buttons to the right of the list to change the order of the referrer groups.
N11C0001
Analyzing visits from indexing agents

N11C000A
About analyzing visits from indexing agents To classify a host, user agent, or referrer as a robot or spider To add visitors to a robot/spider group Determining the group for visitors that fit multiple groups
About analyzing visits from indexing agents

You can classify specific hosts, user agents, and referrers as robots or spiders. (A spider is a nonhuman agent that visits Web sites in order to index them for its search engine or directory. A robot is a nonhuman agent that visits Web sites for any purpose. For example, a robot could check pages for updates or check to ensure a site is still on the Internet.) This enables you to separate robots and spiders from regular Web site traffic. Robot and spider traffic appears separately in the Robot/Spider Summary and is not counted in the normal visit statistics but it is counted in the number of hits. By default, Unica NetInsight is configured with the most common robots and spiders.
N1340001
To classify a host, user agent, or referrer as a robot or spider

1. View the profile in which you want to classify the indexing agent as a robot or spider. 2. Click the Options tab tab. 3. In the Options panel, select Marketing > Robots/Spiders Robots/Spiders. 4. Click Add Add. 5. In the Name of spider box, enter the name you want to have displayed for the robot/spider group. 6. Click Save Options and then click Continue Continue.
N1350001
Version 8.2.1
253
To add visitors to a robot/spider group

If you are adding visitors to the robot/spider group immediately after creating it, start with 4. Otherwise, start with 1. 1. View the profile that contains the robot/spider group. 2. Click the Options tab. 3. In the Options panel, select Marketing > Robots/Spiders Robots/Spiders. 4. Select the robot/spider group and click Visitors Visitors. 5. Click Add Add. 6. Enter a filter that describes the host, user agent, or referrer you want to classify as a robot or spider, and click Add (For details on filters, see Filtering a Unica Add. NetInsight Option.) The statistics for this host, user agent, or referrer will be classified as a robot or spider in all new log file data you import from now on. 7. If this is what you want or if you have additional hosts, user agents, or referrers to enter at this time, click Continue Continue. If you want to classify this host, user agent, or referrer as a robot or spider in data you have already imported, you will need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option.To delete your profile data, click Delete Profile Data Data.
N1360001
Determining the group for visitors that fit multiple groups

A host, user agent, or referrer can only belong to one robot/spider group. If you have a visitor that meets the criteria for more than one group, Unica NetInsight will include the visitor in the first robot/spider group it can belong to in the list of robot/spider groups. You can use the Move Up and Move Down buttons to change the order of the robot/spider groups in the list.
N11D0001
Analyzing visit cost

N11D000A
About visit cost About collecting visit cost data About including visit cost data in Unica NetInsight reports
254
Analyzing visit cost
About visit cost

Visit cost is the amount of advertising money spent to drive a visitor to your site for a particular visit.
N1370001
About collecting visit cost data

Visit cost data is not contained in log files by default. If you want Unica NetInsight to report on and analyze visit cost data, you will need to do one of two things: Configure your Web site to use page tags and pass the visit cost data in the page tag image request using the name-value pair vc=value. (For details, see the Unica NetInsight Administrator's Guide .) Then, configure your Unica NetInsight profile to use page tags. Import visit cost data into the Visit Cost table in the NetInsight database. (For details on the Visit Cost table, see the Unica NetInsight Database Schema.)
N1380001
About including visit cost data in Unica NetInsight reports

The Cost metric and Average Cost metric report on visit cost data. These metrics are available on the Discovery Panel and in the Custom Report Wizard and can be added to any report.
Version 8.2.1
255
N107A8
12 Analyzing Page Titles

N1390001
About analyzing page titles Resolving page titles To edit page title mappings To limit the pages whose titles Unica NetInsight should resolve To add pages whose titles Unica NetInsight should not resolve Security realms
About analyzing page titles

You can configure Unica NetInsight to resolve page titles. If you configure Unica NetInsight to resolve page titles, the titles of pages appear on reports instead of the pages' directory paths and file names. You can then choose to change the title that appears for some or all of the pages. In addition, you can specify the pages for which titles should be resolved, and the pages for which titles should not be resolved. For Web servers that require a user name and password for access, you can define security realms that enable Unica NetInsight to successfully resolve the titles of pages on Web servers that require authentication.
N13A0001
Resolving page titles

N13A000A
About resolving page titles To resolve page titles To resolve page titles through a proxy server
256
Resolving page titles
About resolving page titles

By default, Unica NetInsight presents the directory paths and file names of the pages in the Unica NetInsight reports. (In profiles whose log files are clustered for multiple sites, the URL of the server will precede the directory path.) If you would rather see the titles of the pages, you can configure Unica NetInsight to resolve page titles. To resolve page titles, Unica NetInsight needs to connect to the Web server. If your log files are not clustered or are clustered for a single site, Unica NetInsight uses the URL entered in the URL of the site being analyzed box on the General Options page. If your log files are clustered for multiple sites, Unica NetInsight uses the URL entered in the URL of server box in the description for each server. If the URL is not correct, page titles are not resolved.
Character sets and page titles

The character set your Web server uses to encode the page titles affects the ability to resolve the page titles. By default, Unica NetInsight assumes the Web server uses the same character set as the profile. If the page titles are encoded using a different character set than the profile uses, Unica NetInsight may not be able to correctly resolve the page titles. Since the UTF-8 character set can recognize a wide variety of characters, if the profile character set is UTF-8, Unica NetInsight can resolve page titles encoded in other character sets and store and display them correctly in UTF-8. However, Unica NetInsight needs to know which character set the Web server used to encode the page titles in order to import them properly. If the profile character set is UTF-8, Unica NetInsight checks the metatag of the pages to see if the character set is specified. If it is, Unica NetInsight uses that character set to resolve the page titles. If the character set is not specified, Unica NetInsight uses UTF-8 to resolve the page titles.
N13F0001
To resolve page titles

URL search and replace rules are applied before page titles are resolved. If the URLs modified by the search and replace rules do not match pages on the server, the page titles are not resolved. 1. View the profile in which you want to resolve page titles. 2. Click the Options tab. The General page appears. 3. Select the Resolve page titles check box. 4. Click Save Options Options. Page titles that are included in profile data you import are resolved from now on. 5. If this is what you want, click Continue Continue. If you want to resolve page titles that only appear in log file data you have already imported, you must delete your profile data and reimport your log files.
Version 8.2.1 257
12 - Analyzing Page Titles
If you do not still have every log file you have imported into this profile, you will lose data by choosing this option. To delete your profile data, click Delete Profile Data Data.
N1400001
To resolve page titles through a proxy server

If you use a proxy server for Web access, you may need to specify some additional information about your proxy server in order for Unica NetInsight to be able to resolve page titles. Unica NetInsight can not resolve page titles through a proxy server that requires authentication.
1. Click the Administration icon ( 2. Click the Options tab. The Email page appears.
) to display the Profile Manager.
3. In the Options panel, select Network > Proxies Proxies. 4. In the HTTP proxy server box, enter the host name or IP address of your proxy server. 5. In the HTTP proxy server port box, enter the port on which the proxy server is accessible. 6. Click Save Options and then click Continue Continue.
N13B0001
To edit page title mappings

If you tell Unica NetInsight to resolve page titles, it shows page titles instead of file names in reports. You can change the title that appears for some or all of the pages. Editing page title mappings has no effect unless you are resolving page titles for this profile. 1. View the profile in which you want to edit page title mappings. 2. Click the Options tab. 3. In the Options panel, select Page Titles > Page Title Mappings Mappings. 4. Click Add Add. 5. In the Page box, enter the file name and the complete path to the file of the page whose title you want to change. 6. In the Page title box, enter the title you want to use for this page.
To limit the pages whose titles Unica NetInsight should resolve
7. Click Save Options and then click Continue Continue. The changes take effect the next time the profile is updated.
N13C0001
To limit the pages whose titles Unica NetInsight should resolve

You can limit the pages whose titles you want Unica NetInsight to resolve. For example, you may want to resolve only the titles of pages in a certain section on your Web site. If you are collecting data from page tag images, you could use this feature to resolve the titles of pages on only your Web site. 1. View the profile in which you want to add pages. 2. Click the Options tab. 3. In the Options panel, select Page Titles > Resolved Page Titles Titles. 4. Click Add Add. 5. Enter a filter that describes a page or pages whose titles Unica NetInsight should resolve. 6. Click Add Add. Unica NetInsight resolves page titles only for pages that match these filters in data you import from now on. 7. If this is what you want, or if you have additional filters you want to add at this time, click Continue Continue. To resolve page titles only for pages that match these filters in data you have already imported, you must delete your profile data and reimport your log files. If you do not still have every log file that you have imported into this profile, you will lose data by choosing this option. To delete profile data, click Delete Profile Data Data.
N13D0001
To add pages whose titles Unica NetInsight should not resolve

In general, Unica NetInsight should not attempt to resolve the page titles of executable files such as those files located in a directory containing CGI (Common Gateway Interface) scripts. If Unica NetInsight attempts to resolve page titles for executable files, new CGI processes will be initiated that mimic those originally called by visitors to the Web site. This process imitates user traffic and may adversely affect your Web server and any applications it may use.
Version 8.2.1
259
12 - Analyzing Page Titles
Unica NetInsight is initially configured to not attempt to resolve the titles of pages that contain /cgibin/ or /scripts/ or that end with .cgi or .exe. You can specify additional pages whose titles Unica NetInsight should not resolve. 1. View the profile in which you want to add pages. 2. Click the Options tab. 3. In the Options panel, select Page Titles > Unresolved Page Titles Titles. 4. Click Add Add. 5. Enter a filter that describes a page or pages whose titles Unica NetInsight should not resolve. 6. Click Add Add. Unica NetInsight does not resolve page titles for pages that match these filters in data you import from now on. 7. If this is what you want, or if you have additional filters you want to add at this time, click Continue Continue. If you want Unica NetInsight to not resolve page titles for pages that match these filters in data you have already imported, you must delete your profile data and reimport your log files. If you do not still have every log file that you have imported into this profile, you will lose data by choosing this option. To delete profile data, click Delete Profile Data Data.
N13E0001
Security realms

N13E000A
About adding security realms To create a security realm About determining the security realm for pages that fit multiple realms
About adding security realms

You can define security realms that will enable Unica NetInsight to successfully resolve the titles of pages on Web servers that require a user name and password for access. When Unica NetInsight performs page title resolution for a certain page, it checks the security realms to find a realm to which the page belongs. If a matching realm exists, Unica NetInsight provides the Web server with the user name and password you defined for that realm. This functionality only applies to basic HTTP authentication.
N1410001
260
Security realms
To create a security realm

1. View the profile in which you want to create the security realm. 2. Click the Options tab. 3. In the Options panel, select Page Titles > Security Realms Realms. 4. Click Add Add. 5. In the Realm name box, enter the name of the security realm. 6. In the User name box, enter the user name for the security realm. 7. In the Password box, enter the user's password. 8. In the Password (again) box, enter the same password that you entered in 7. 9. Click Save Options and then click Continue Continue. 10. Select the security realm and click Pages Pages. 11. Click Add Add. 12. Enter a filter that describes the pages for which the user name and password will be provided. 13. Click Add Add. The user name and password are provided for these pages from now on. 14. If this is what you want or if you have additional pages to enter at this time, click Continue Continue. If you want to provide the user name and password for pages in data you have already imported, you can use the - resolvetitles command-line option to immediately resolve page titles for all known pages. 15. To add another filter to this security realm, click Add To return to the list of security Add. realms, click Back to Security Realms Realms.
N1420001
About determining the security realm for pages that fit multiple realms
A page can belong to only one security realm. If you have a page that meets the criteria for more than one realm, NetInsight includes the page in the first realm to which it can belong. You can use the Move Up and Move Down buttons to change the order of the security realms in the Security realms for page title resolution list.
Version 8.2.1
261
N107E6
13 Analyzing Retail Activity

N1430001
About retail activity How Unica NetInsight gathers retail data What retail data Unica NetInsight can gather Retail reports
About retail activity

Retail activity consists of visitors viewing products and interacting with a shopping cart on your site.It includes:
N1440001
Viewing products Adding products to a shopping cart Removing products from a shopping cart Completing the checkout process
How Unica NetInsight gathers retail data

Unica NetInsight gathers retail data through page tags. For details on configuring page tags for your site, see the Unica NetInsight Administrator's Guide . You also need to configure the Unica NetInsight profile to use data from page tags either in place of or to augment your Web server's log files.
N1450001
What retail data Unica NetInsight can gather

Unica NetInsight can gather the following retail data:
262
Products viewed (SKU, quantity, and unit price)

Retail reports

N1460001
Products added to a shopping cart (SKU, quantity, and unit price) Products removed from a shopping cart (SKU, quantity, and unit price) Revenue associated with a shopping cart Order number Products purchased (SKU, quantity, and unit price) Pay-per-click revenue
Retail reports

N1460007
About retail reports About enabling retail reports
About retail reports

The following retail reports are available: Cart Activity Trend Product Abandonment Summary Product Action Summary Product Conversion Summary Retail Dashboard Revenue Trend
In addition, retail metrics, dimensions, and filters can be added to other NetInsight summaries.
N1470001
About enabling retail reports

In order for retail reports to be available in a profile, the following must be true: Page tagging must be enabled for the profile. Retail dimensions (Product, Retail Action, Revenue Range, and Unit Price Range) must be marked reportable.
Version 8.2.1
263
N10805
14 Analyzing Visitors or Users

N1480001
About analyzing visitors Analyzing visitors or users by browser Analyzing visitors or users by department Analyzing visitors by host Analyzing visitors or users by platform To change the number of minutes between visits To specify an opt-out cookie value To use the sessionization parameter value for visitor identification To change how Unica NetInsight sessionizes traffic About using visitor identification cookies Analyzing visitor profiles
About analyzing visitors

Unica NetInsight enables you to group your visitors according to a variety of factors (browser, department, host, and platform) and analyze the behavior of the group. You can also link the visitor information in Unica NetInsight with information in external databases, and you can control how Unica NetInsight groups traffic into visits.
N1490001
Analyzing visitors or users by browser

264
About analyzing visitors by browser To create a browser To add user agents to a browser About determining the browser for user agents that fit multiple browsers
Analyzing visitors or users by browser

N149000A
About analyzing visitors by browser

Unica NetInsight enables you to track which browsers are used by the visitors to your site. Browser statistics appear on the Browser Summary. If the Browser Summary is blank, your server is probably not logging the user agent field.You can configure how browsers are reported. However, because Unica NetInsight comes preconfigured to recognize most major browsers in use today, it is usually unnecessary to change any of the browser groupings. If you do decide to change browser groupings, review these instructions carefully. If you are not familiar with regular expressions, you may want to review the regular expressions tutorial. User agent descriptions make heavy use of regular expressions.
N1530001
To create a browser
1. View the profile in which you want to create the browser. 2. Click the Options tab. 3. In the Options panel, select Visitors > Browsers Browsers. 4. Click Add Add. 5. In the Name of browser box, enter the name you want to have displayed for the browser. 6. If you want each major version of the browser to be reported separately, select the Append the version number check box. You will have to use the regular expression (\d+\.) in the definition of the user agents of the browser so Unica NetInsight will retain the version information when it imports your log. 7. Click Save Options and then click Continue Continue. Now you need to specify which user agents you want to be part of this browser.
N1540001
To add user agents to a browser

If you just created the browser group, start with 4. Otherwise, start with 1. For browser grouping to work correctly, the value you enter for the user agent must match the way the user agent is recorded in your log files. You may want to review a sample log file before changing this option to ensure that you are familiar with the way user agents are recorded in your log files. 1. View the profile that contains the browser. 2. Click the Options tab. 3. In the Options panel, select Visitors > Browsers Browsers.
Version 8.2.1 265
14 - Analyzing Visitors or Users
4. Select the browser and click User Agents Agents. 5. Click Add Add. 6. Enter a filter that describes the user agent you want to add to this browser and click Add Add. The user agent you entered will be part of this browser in all new data you import from now on. 7. If this is what you want or if you have more user agents to add at this time, click Continue Continue. If you want the user agent to belong to the browser in data you have already imported, you will need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
N1550001
About determining the browser for user agents that fit multiple browsers
A user agent can only belong to one browser. If you have a user agent that meets the criteria for more than one browser, Unica NetInsight includes the user agent in the first browser it can belong to in the list of browsers. You can use the Move Up and Move Down buttons to change the order of the browsers in the list.
N14A0001
Analyzing visitors or users by department

N14A000A
About analyzing visitors by department To create a department To add hosts and users to a department About determining the department for hosts and users that fit multiple departments
About analyzing visitors by department

Unica NetInsight lets you track which departments are using your Web site most often. A department is a group of related hosts or users (such as the finance department on a corporate intranet). To track different departments, you must specify which users or hosts belong to which departments. The department statistics appear on the Department Summary.
266
Analyzing visitors or users by department
You can configure Unica NetInsight to determine department groupings using an external database (such as a corporate directory).
N1560001
To create a department
1. View the profile in which you want to create the department. 2. Click the Options tab. 3. In the Options panel, select Visitors > Departments Departments. 4. Specify what Unica NetInsight should display when you click the department name in the Department Summary. To display the host names/IP addresses, click Hosts Hosts. To display the user names, click Users Users.
5. Click Save Options and then click Continue Continue. 6. Click Add Add. 7. Enter the name you want displayed for this department. 8. Click Save Options and then click Continue Continue. Now you need to specify which hosts and users you want to be part of this department.
N1570001
To add hosts and users to a department

If you have just created the department, start with 4. Otherwise, start with 1. 1. View the profile that contains the department. 2. Click the Options tab. 3. In the Options panel, select Visitors > Departments Departments. 4. Select the department and click Hosts or Users (depending on how you chose to define the department). 5. Click Add Add. 6. Enter a filter that describes the user or host you want to add to this department and click Add Add. The user or host you entered will be part of this department in all new data you import from now on. 7. If this is what you want or if you have other users or hosts that you wish to add to the department at this time, click Continue Continue. If you want the user or host to belong to the department in data you have already imported, you will need to delete all the data in your profile and reimport your log files.
Version 8.2.1 267
If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option.To delete your profile data, click Delete Profile Data Data.
N1580001
About determining the department for hosts and users that fit multiple departments
A host or user can only belong to one department. If you have a host or user that meets the criteria for more than one department, Unica NetInsight includes the host or user in the first department it can belong to in the list of departments. You can use the Move Up and Move Down buttons to change the order of the departments in the list.
N14B0001
Analyzing visitors by host

N14B000A
About analyzing visitors by host To create a host group To add hosts to a host group About determining the host group for hosts that fit multiple groups
About analyzing visitors by host

Unica NetInsight enables you to track which hosts are responsible for the most traffic to your site. The host statistics appear on the Host Summary. You can group traffic from multiple hosts into a single host group. This enables you to group the traffic from major online service providers or large corporations whose traffic to your site comes through multiple proxy servers. For example, if someone from America Online is browsing your Web site, each hit to your site could come through a different proxy server (host), thus showing up as multiple hosts. If you group all hosts that end with .aol.com as America Online, you can improve sessionization. By default Unica NetInsight is configured to group traffic from America Online, CompuServe, Prodigy, and WebTV. In the reports, you cannot drill down on a host group to display details.
N1590001
To create a host group

1. View the profile in which you want to group hosts. 2. Click the Options tab. 3. In the Options panel, select Visitors > Host Groups Groups. 4. Click Add Add.
268
Analyzing visitors by host
5. In the Name of host group box, enter the name you want to have displayed for the host group. 6. In the Domain of host group box, enter the domain in which you want to have the group included in the Domain Summary. For example, to have the host group included in Commercial (.com) enter Commercial (.com) (.com). 7. If you do not want to have cookies used when sessionizing for hosts in this host group, select the Ignore cookies from this host group check box. For example, some online services do not consistently pass the same cookie for each view in a visit. This can reduce the accuracy of results if cookies are utilized in the visit calculations. In this case, you should select the check box. 8. If you do not want Unica NetInsight to consider the host group a single unit when sessionizing, clear the Use modified host for sessionization check box. 9. Click Save Options and then click Continue Continue. Now you need to specify which hosts you want to be part of this host group.
N15A0001
To add hosts to a host group

If you have just created the host group, start with 4. Otherwise, start with 1. 1. View the profile that contains the host group. 2. Click the Options tab. 3. In the Options panel, select Visitors > Host Groups Groups. 4. Select the host group and click Hosts Hosts. 5. Click Add Add. 6. Enter a filter that describes the host you want to add to this host group and click Add Add. The host you entered will be part of this host group in all new data you import from now on. 7. If this is what you want or if you have other hosts that you wish to add to the group at this time, click Continue Continue. If you want the host to belong to the host group in data you have already imported, you will need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
N15B0001
Version 8.2.1
269
About determining the host group for hosts that fit multiple groups
A host can only belong to one host group. If you have a host that meets the criteria for more than one group, Unica NetInsight includes the host in the first host group it can belong to in the list of host groups. You can use the Move Up and Move Down buttons to change the order of the host groups in the list.
N14C0001
Analyzing visitors or users by platform

N14C000A
About analyzing visitors by platform To create a platform To add user agents to a platform About determining the platform for user agents that fit multiple platforms
About analyzing visitors by platform

Unica NetInsight enables you to track which platforms are used by the visitors to your site. Platform statistics appear on the Platform Summary. You can configure how platforms are reported. However, since Unica NetInsight comes preconfigured to recognize most major platforms in use today, it is usually unnecessary to change any of the platform groupings. If you do decide to change platform groupings, review these instructions carefully. If you are not familiar with regular expressions, you may want to review the regular expressions tutorial. User agent descriptions make heavy use of regular expressions. If the Platform Summary is blank, your server is probably not logging the user agent field.
N15C0001
To create a platform
1. View the profile in which you want to group platforms. 2. Click the Options tab. 3. In the Options panel, select Visitors > Plaftorms Plaftorms. 4. Click Add Add. 5. In the Name of platform box, enter the name you want to have displayed for the platform. 6. If you want each major version of the platform to be reported separately, select the Append the version number check box.
270
Analyzing visitors or users by platform
You will have to use the regular expression (\d+\.) in the definition of the user agents of the platform so Unica NetInsight will retain the version information when it imports your log. 7. Click Save Options and then click Continue Continue. Now you need to specify which user agents you want to be part of this platform.
N15D0001
To add user agents to a platform

If you have just created the platform, start with 4. Otherwise, start with 1. For platform grouping to work correctly, the value you enter for the user agent must match the way the user agent is recorded in your log files. You may want to review a sample log before changing this option to ensure that you are familiar with the way user agents are recorded in your log files. 1. View the profile that contains the platform. 2. Click the Options tab. 3. In the Options panel, select Visitors > Platforms Platforms. 4. Select the platform and click User Agents Agents. 5. Click Add Add. 6. Enter a filter that describes the user agent you want to add to this platform and click Add Add. The user agent you entered is part of this platform in all new data you import from now on. 7. If this is what you want or if you have more user agents to add at this time, click Continue Continue. If you want the user agent to belong to the platform in data you have already imported, you will need to delete all the data in your profile and reimport your log files. If you do not still have all the log files you have imported into this profile, you will lose data permanently by choosing this option. To delete your profile data, click Delete Profile Data Data.
N15E0001
About determining the platform for user agents that fit multiple platforms
A user agent can only belong to one platform. If you have a user agent that meets the criteria for more than one platform, Unica NetInsight includes the user agent in the first platform it can belong to in the list of platforms. You can use the Move Up and Move Down buttons to change the order of the platforms in the list.
N14D0001
Version 8.2.1
271
To change the number of minutes between visits

By default, if 30 minutes elapse without a new page view, Unica NetInsight considers the next page view from a given user to be part of the next visit. For example, if a visitor comes to your Web site, leaves, and comes back within 30 minutes, Unica NetInsight considers the visitor's return as part of the same visit. Also, if a visitor stays on one page on your Web site without clicking on another link for 30 minutes, the visit will time out, and Unica NetInsight sees the next page the visitor views while on your site as part of a different visit. If your site contains large amounts of text, you may want to increase the number of minutes between visits. If your site has small amounts of text, you may want to decrease the number of minutes between visits. 1. View the profile in which you want to change the number of minutes between visits. 2. Click the Options tab. 3. In the Options panel, select Visitors > Sessionization . 4. In the Number of minutes between visits box, enter the maximum number of minutes that can elapse between two consecutive page views by the same visitor and still be classified as the same visit. 5. Click Save Options Options. Unica NetInsight will use the new time value to sessionize traffic in all new data that you import from now on. 6. If this is what you want, click Continue Continue. If you want Unica NetInsight to use the new time value to sessionize traffic in data you have already imported, you will need to delete your profile data and reimport your log files. If you do not still have every log file that you have imported into this profile, you will lose profile data by choosing this option. To delete profile data, click Delete Profile Data Data.
N14E0001
To specify an opt-out cookie value

Some Web sites allow visitors to "opt out" of receiving persistent cookies from the Web site in the future. If the visitor chooses to opt out, the site assigns a persistent "blank" cookie containing a non-unique value (usually "OPT_OUT") to the visitor to indicate that the cookie cannot be used for identification.
272
To use the sessionization parameter value for visitor identification
You can configure Unica NetInsight to recognize an opt-out cookie value. A cookie whose value matches the value you specify is not used for sessionization and is not assigned a cookie ID. The cookie value for the corresponding visits and views will appear as None in reports. 1. View the profile in which you want to specify an opt-out cookie value. 2. Click the Options tab. 3. In the Options panel, select Visitors > Sessionization Sessionization. 4. In the Opt-out cookie value box, enter the opt-out cookie value. This value is casesensitive. 5. Click Save Options Options. Unica NetInsight will use the opt-out cookie value in all new data that you import from now on. 6. If this is what you want, click Continue Continue. If you want Unica NetInsight to use the opt-out cookie value in data you have already imported, you will need to delete your profile data and reimport your log files. If you do not still have every log file that you have imported into this profile, you will lose profile data by choosing this option. To delete profile data, click Delete Profile Data Data.
N14F0001
To use the sessionization parameter value for visitor identification

If Unica NetInsight is set up to use the value of a parameter to determine sessionization, you can specify whether Unica NetInsight should also use that value to identify visitors. This option is useful if your sessionization parameters remain the same between visits by the same visitor. 1. View the profile in which you want to use the sessionization parameter value for visitor identification. 2. Click the Options tab. 3. In the Options panel, select Visitors > Sessionization Sessionization. 4. Select the Use parameter value for visitor identification check box. This check box will only appear if you have previously defined parameters for this profile. 5. Click Save Options Options.
Version 8.2.1
273
Unica NetInsight uses this parameter value for visitor identification in all new data that you import from now on. 6. If this is what you want, click Continue Continue. If you want Unica NetInsight to use this parameter value for visitor identification in data you have already imported, you will need to delete your profile data and reimport your log files. If you do not still have every log file that you have imported into this profile, you will lose profile data by choosing this option. To delete profile data, click Delete Profile Data Data.
N1500001
To change how Unica NetInsight sessionizes traffic

When Unica NetInsight analyzes your log file data, it groups together all the activity by an individual during one visit (for example, all the pages viewed by a visitor during one visit to your Web site). This grouping of page views into visits is called sessionization. To sessionize, Unica NetInsight must match user information from one page view entry in the log file with another page view entry. There are several possible methods for sessionization. You can specify for each profile which methods you want to use. If your Unica NetInsight installation is configured to use page tagging, you can specify how cookies will be used for sessionization for each profile. You can choose to use either the cookie(s) specified in the page tag request, the third-party cookies in the cookie field of the log file, or both. Unica NetInsight uses the sessionization methods that you have selected in the order they appear. If Unica NetInsight is unable to sessionize using any of the selected methods, it sessionizes using a combination of the host name/IP address and user agent. 1. View the profile in which you want to determine sessionization. 2. Click the Options tab. 3. In the Options panel, select Visitors > Sessionization Sessionization. 4. If you want Unica NetInsight to use the value of a parameter to determine sessionization, select the Parameter value for check box. Then select the parameter from the list of parameters defined in the profile. This check box appears only if you have previously defined parameters for this profile.
Parameters whose values are not being stored in the Unica NetInsight database do not appear in the list of parameters.
274
About using visitor identification cookies
5. If you want Unica NetInsight to use the authenticated user name to determine sessionization, select the Authenticated user name check box. 6. If you want Unica NetInsight to use a visitor identification cookie to determine sessionization, select the Visitor identification cookie check box. Then enter the name of the cookie. If you are using the Unica Web Server Plug-in, leave the cookie name set to the default. 7. If your Unica NetInsight installation is configured to use page tagging, select an option in the Cookie Source field to determine which page tags will be used for sessionization. AUTO Use this option if you want to include cookies from both the ck AUTOM parameter in the page tag request and the cookie field in the log file. FIELD Use this option if you want to include only cookies from the cookie field FIELDM in the log file. PAGETAG Use this option if you want to include only the cookie(s) specified PAGETAGM by the ck parameter of the page tag request. The cookie source options are available only if you have set page tagging options for the profile to Used instead of log files to collect data for a single site or Used instead of log files to collect data for multiple sites sites. 8. Click Save Options Options. Unica NetInsight will sessionize traffic according to your specifications for all new data that you import into this profile. 9. If this is what you want, click Continue Continue. If you want Unica NetInsight to use your specifications to sessionize log file data you have already imported, you will need to delete your profile data and reimport your log files. If you do not still have every log file that you have imported into this profile, you will lose profile data by choosing this option. To delete profile data, click Delete Profile Data Data.
N1510001
About using visitor identification cookies

If you are using software other than the Unica Web Server Plug-in to set visitor identification cookies, you can configure Unica NetInsight to use those cookies to track visitors across your site. To do this, your cookie must be recorded in the Web log in the format CookieID=CookieValue. For example, if your cookies were being recorded as ASPID=114567, enter ASPID in the Visitor identification cookie box.
Version 8.2.1
275
If your cookie contains multiple name/value pairs separated by ampersands (for example, YourID=First=John&Last=Doe&Number=123), enter the cookie name, an equal sign, and the name of the cookie fragment that contains the information on which you want to sessionize. (In the example above, you would enter YourID=Number if you want to sessionize by the Number parameter.) For the data that Unica NetInsight generates to be accurate using your own cookie rather than the default SaneID, you also need to be setting cookies in the same manner as the Unica Web Server Plug-in. On a visitor's first request for a page from the Web site, you must set a cookie in the visitor's browser (if the visitor does not already have one). For each subsequent request to the Web site during this first visit and any other visits made to the Web site, the server must read this cookie and record it in the Web log in its cookie field. To prevent visitors who have cookies turned off from getting a new cookie for every new page view, ensure you are logging the cookie received by the Web server and not the cookie sent by the Web server.
N1520001
Analyzing visitor profiles

N152000A
About analyzing visitor profiles To create a visitor profile About changing the order of visitor profiles
About analyzing visitor profiles

Unica NetInsight enables you to track how often the members of various visitor profiles are coming to your Web site. A visitor profile is a group of visitors that you have defined on the Visitor Profile page of your Web server profile. You can sort visitors into groups based on any of a large number of filters, including visit type (repeat or new), visit duration, pages viewed, initial referrer, or content group. A visit is considered a member of every profile whose filters it matches. Visitor profiles can be used to gain a deeper understanding of exactly how visitors arrive at your site and what interests them most during a visit. Visitor profile statistics appear on the Visitor Profile Summary. Visitor profiles are used in scenario reports to track visitor behavior across multiple visits.
N15F0001
To create a visitor profile

1. View the profile in which you want to create a visitor profile. 2. Click the Options tab. 3. In the Options panel, select Visitors > Visitor Profiles Profiles. 4. Click Add Add. 5. Enter a name for the profile.
Analyzing visitor profiles
6. Click Save Options and then click Continue Continue. 7. Select the visitor profile and click Visitors Visitors. 8. Click Add Filter Filter. 9. Select a filter type from the list and click Continue Continue. 10. Enter the values for the filter. 11. Click Continue Continue. 12. Repeat 8 through 11 until you have entered all the filters you want for the visitor profile. 13. Click Save Filters and then click Continue Continue. You cannot add a filter group that contains a visitor profile to a visitor profile. Your visitor profiles will be in effect the next time you run an update.
N1600001
About changing the order of visitor profiles

You can use the Move Up and Move Down buttons to change the order of the visitor profiles in the list. However, unlike some other options, changing the order has no affect on the reports.
Version 8.2.1
277
N108A0
15 NetInsight System Administration

N1610001
About database sessions Administering the Inbox About NetInsight options Configuring main options Configuring network options Configuring security Configuring roles and users About customizing the NetInsight interface Working with views Working with roles and views Working with report lists Working with dimension lists Working with filter lists Working with metric lists About default profile options Data and license administration Troubleshooting NetInsight
About database sessions

If you are using an Oracle or DB2 database you can specify certain database parameters that are used each time connects to your database. Setting this option can aid in tuning the performance of your database under certain limited circumstances. In general, the default values for this option should not be changed without consulting Unica technical support.
Administering the Inbox

N1620002
Administering the Inbox

You can always access your own reports in the Inbox. If you are an Inbox administrator (your default role contains the Administrator : Administration : Inbox privilege), you can switch between two views: user and admin. The admin view shows all the queued, running, and failed reports in the system, regardless of who requested them. By default, the NetInsight Administrator role has the Inbox administration privilege. Inbox administrators can cancel reports requested by other users and can sort and filter by owner in addition to the other sorting and filtering options. For Linux environments: The user running Apache requires write permission to the reportinbox.dat file and the nt_scheduler_lock.lck file. If the Apache user does not have these permissions, the report scheduler will fail to start. This may occur if these files are owned by a user other than the Apache user and your Linux environment has umasks set. If the report scheduler fails, check the permissions on these files and, if necessary, change them to allow read/write (666) access permissions.
N1610001
About NetInsight options

N161000A
About database sessions About custom log file formats About environment variables About Unica NetInsight email options About locale options About Unica options About DNS options About proxy servers About authentication options About Unica Marketing Platform authentication About restricting access to the Profile Manager About roles About user managers About user configuration
About database sessions

If you are using an Oracle or DB2 database you can specify certain database parameters that are used each time connects to your database. Setting this option can aid in tuning the performance of your database under certain limited circumstances. In general, the default values for this option should not be changed without consulting Unica technical support.
N1710001
Version 8.2.1
279
15 - NetInsight System Administration
About custom log file formats

Unica NetInsight automatically recognizes most log formats. For example, it can read IIS Standard/Extended, NCSA Common/Combined, Netscape Flexible, and W3C Extended formats, among others. However, some log files are in a nonstandard format that Unica NetInsight cannot read by default. If your log files are in a nonstandard format, you can specify the log format manually so that Unica NetInsight can read the log files.
N1720001
About environment variables

You can specify the environment variables that are needed for to work properly with your setup. For example, you could use the time zone variable to change the times in your reports to GMT. The environment variables you specify are in effect for the life of the process.
N1730001
About Unica NetInsight email options

Unica NetInsight can email reports to users. To enable this functionality, you must provide the information Unica NetInsight needs to send messages: Mail server (SMTP) The host name or IP address of your mail server. (SMTP). Mail server port The port on which your mail server is installed. The default value is port. 25. From address The email address from which all reports are emailed. Any email address. messages that are returned as undeliverable are returned to this address. Administrator's address The email addresses of the people who should be notified address. when Unica NetInsight encounters an error. Separate multiple addresses by commas.
N1740001
About locale options

Locale options include the following settings:
N1750001
Display time as You select whether you want NetInsight to display times using the as. 12-hour clock or the 24-hour clock. Display date as You select the date format you want NetInsight to use. The date as. and time settings primarily affect the footer on the Profile Manager pages. Character set You select the character set that NetInsight uses to display text in the set. Profile Manager. Language You select the language that NetInsight uses to display text. The Language. languages available depend on which Language Packs you have installed.
280
About Unica options

When deployed as part of the Unica Marketing suite, Unica NetInsight must make a connection to the Unica Marketing Platform. You specify the Unica Marketing Platform URL during installation. If necessary, after installation you can change this value in the Unica NetInsight administrative options.
N1760001
About DNS options

Any application that resolves host names needs to know the address of a DNS server. Usually, Unica NetInsight can retrieve the address automatically. However, sometimes this information is impossible to retrieve on some systems and must be entered manually.
Number of IP Addresses to resolve at one time

When Unica NetInsight resolves host names in your log files, a number of requests for host name resolution can be pending at once. You can change how many pending requests are allowed. Because each pending request uses both memory and network resources, lowering this value can lower Unica NetInsight memory use and network resource use when Unica NetInsight is set to resolve host names. In general, you should not alter the number without consulting technical support.
Time to allow for a reverse DNS lookup

By default, when Unica NetInsight performs reverse DNS lookups (to resolve host names), it stops a lookup if it has not been completed after 3 seconds. For users with slower connections, a 3-second timeout may result in some reverse DNS lookups being stopped prematurely. This results in less than accurate sessionization, particularly when dealing with hosts that should be affected by host grouping. However, you can increase the number of seconds you want Unica NetInsight to wait before stopping a DNS lookup.
How many times to retry a DNS lookup

By default, when resolving host names, Unica NetInsight makes four retries to resolve a given IP address. However, sometimes the DNS lookup process stops because it times out, resulting in an IP address never being resolved even though resolution may be possible. You can increase the number of times that Unica NetInsight should try to resolve a host name. (There is always one attempt; if it fails, it is retried a specified number times.)
How many times to retry a DNS lookup

If you use a proxy server for Web access, there are some additional settings you need to enter before Unica NetInsight can resolve page titles.
N1770001
Version 8.2.1
281
About proxy servers

If you use a proxy server for Web access, you must configure Unica NetInsight to use the proxy server in order to resolve page titles.
N1780001
About authentication options

You can set up user authentication in these ways: Internal database Users are authenticated through Unica NetInsight database. Unica Marketing Platform Users are authenticated through the Unica Marketing Platform. Platform. External database The LDAP data conduit is used to verify that the user name and database. password the user enters are valid. Web server Users are verified by the password protection built into the Web server. server. Therefore, the user does not need to enter an user name and password to log in.
While using LDAP or Web server authentication directly is available, it is recommended that you integrate your LDAP or Web server users through the Unica Marketing Platform, and select Unica Marketing Platform authentication. Regardless of the authentication method you select, you must create users in the internal user database with the same user names as assigned in the Unica Marketing Platform, LDAP, or the Web server, so that you can associate them with roles and views for particular profiles.
N1790001
About Unica Marketing Platform authentication

When Unica NetInsight uses the Unica Marketing Platform for authentication, you must manually enter users in both the Unica Marketing Platform and Unica NetInsight. These user names must match exactly, and are case-sensitive. You enter passwords only in the Unica Marketing Platform. In the Unica Marketing Platform, there is an application access object called Unica NetInsight This setting is currently ignored by Unica NetInsight. User access to NetInsight. Unica NetInsight is not controlled by the Unica Marketing Platform's application access feature. Instead, all authorization functions are performed within Unica NetInsight. After authenticating with the Unica Marketing Platform, if the same user name exists in Unica NetInsight's internal database, then the user is allowed access to Unica NetInsight based on the assigned role and permissions. When users first log into Unica NetInsight and are authenticated against the Unica Marketing Platform, they must change their passwords. Users cannot change their passwords through Unica NetInsight; they must open the Unica Marketing Platform, log in, and change their passwords.
282
Disabling and Deleting Unica Users

If a user's browser has cookies set never to expire, and you disable or delete that user in the Unica Marketing Platform, the user is still able to log in to Unica NetInsight. Therefore it is highly recommended that you: 1. Require Unica NetInsight users to set cookies to expire every time the browser closes. 2. Delete Unica NetInsight users when they are disabled or deleted in the Unica Marketing Platform.
N17A0001
About restricting access to the Profile Manager

As necessary, you can restrict access to the Profile Manager. If you do not restrict access, the Profile Manager is available to both authenticated and unauthenticated users. For security reasons, Unica highly recommends that you restrict access. You use the Profile Manager to view, create, edit, and remove profiles, as well as set administrative options, such as defining user roles and privileges. When you select to restrict access to the Profile Manager, only users whose default role includes the Administrator: Administration: Profile Manager privilege are able to view the Profile Manager. If users are based on a role that does not include this privilege, or if they are not logged in, they are redirected to the Unica NetInsight Homepage Homepage. You determine whether to restrict access to the Profile Manager when you set the authentication method.
N17B0001
About roles
A role is a collection of privileges. Roles control which icons and options appear to users. For example, if the role does not include the Interface : Icon : Export privilege, the Export icon is not displayed in the toolbar. You do not need to use roles. However, roles are useful in restricting access to certain features. While roles hide certain features by not including links to those pages in the interface, a motivated user can still access those pages through a Web browser by directly typing in the appropriate URL. To prevent access to such pages, use your Web server's security features. Several roles are defined by default. You can modify these as well as create new roles.
N17C0001
Version 8.2.1
283
About user managers

User managers have the ability to create and edit non-administrator user accounts, but do not have access to other administration functionality. When user managers click the Administration icon [ page page. ], they are taken directly to the Administrative Options: Users
About using the Administrator only setting with user manager roles
When you create a user manager role, you have the option of whether or not to select the Administrator only setting for that role. If the Administrator only setting:
Is selected, the user managers can create other user managers. They can also change the role assigned for their own accounts.
Typically, you would want to enable this setting for all roles with administration privileges. You may also want to enable it for certain non-administration roles. For example, if your company has site-specific roles (for example, "Boston Average User," "Paris Average User") you may want to create user managers that can only create and edit users for a specific site.
N17D0001
Is not selected, the user managers cannot create other user managers or change the role assigned for their own accounts.
About user configuration

You can assign each user a role, a default view, and a default reporting mode for each profile. You can also assign a default role and reporting mode to be used for all profiles for which a specific role and reporting mode are not defined for the user. You can prohibit a user from accessing specific profiles through the Unica NetInsight interface.
N1630001
Configuring main options

N1630007
To specify database sessions To define a custom log file format To add an environment variable To edit an environment variable To delete an environment variable To change the time format To change the date format To change the character set To change the language used Inbox options
284
To specify database sessions

This task is applicable if you are using an Oracle or DB2 database.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Main > Advanced Advanced. The Advanced options screen opens.
).
4. In the Database session options field, enter the parameters that should use when connecting to the database. For example, if you are using Oracle, you can enter the follow code to produce a trace file for each report, to aid in troubleshooting problems:
SQL_TRACE=TRUE
5. Click Save Options then click Continue Options, Continue.

N330001
To define a custom log file format

1. On the toolbar, click the Administration icon. 2. Click the Options tab. 3. In the Options panel, select Main > Custom Log Formats Formats. 4. Click Add Add. 5. Enter a name for the log file format. 6. Enter the log file format. 7. Click Save Options Options. After you specify a custom log format, it appears in the Format of log file(s) list when you add or edit log files. Custom log formats cannot be automatically detected, so you must specify the format for each log file that uses it.
N17E0001
To add an environment variable

1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Main > Environment Variables Variables. The Environment variables to be defined screen opens. ).
Version 8.2.1
285
4. Click Add Add. The Environment variables definition screen opens. 5. Enter a value in the Name of variable field. 6. Enter a value in the Value of variable field. 7. Click Save Options then click Continue Options, Continue. The environment variables is now available for use.
N17F0001
To edit an environment variable

1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Main > Environment Variables Variables. The Environment variables to be defined screen opens. 4. Select the environment variable to edit. 5. Click Edit Edit. The Environment variables definition screen opens. 6. Modify the value in the Name of variable field as necessary. 7. Modify the value in the Value of variable field as necessary. 8. Click Save Options then click Continue Options, Continue. The environment variable is now edited and available for use.
N1800001
).
To delete an environment variable

1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Main > GEnvironment Variables Variables. The Environment variables to be defined screen opens. 4. Select the environment variable to delete. There is no chance to reverse your decision after the next step. Proceed with caution. 5. Click Delete Delete. 6. Click Continue Continue.
).
The environment variable is deleted.

N1810001
To change the time format

You can modify how Unica NetInsight displays time, to use either the 12- or 24-hour format.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Main > Locale Locale. The Locale Options screen opens. 4. In the Display time as drop-down list, select the format to use. You can select: 12 hour clock 24 hour clock
).
5. Click Save Options then click Continue Options, Continue. Changes to the time format are saved and take effect immediately.
N1820001
To change the date format

1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Main > Locale Locale. The Locale Options screen opens. 4. In the Display date as drop-down list, select the format to use. You can select: mm/dd/yyyy (the default) dd/mm/yyyy yyyy/mm/dd ).
5. Click Save Options then click Continue Options, Continue. Changes to the date format are saved and take effect immediately.
N1830001
Version 8.2.1
287
To change the character set

You can modify the character set uses. However, you should not modify this setting after you have started using .
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Main > Locale Locale. The Locale Options screen opens. 4. In the Character drop-down list, select the character set to use. 5. Click Save Options then click Continue Options, Continue.
N1840001
).
To change the language used

You must install the language pack for the language you want to use prior to modifying the language setting in Unica CustomerInsight.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Main > Locale Locale. The Locale Options screen opens. 4. In the Language drop-down list, select the language to use. 5. Click Save Options then click Continue Options, Continue.
).
If you change the language, for the complete translated interface to appear, you must use the command line option admin -regen.
N1850002
Inbox options
Use the following options to configure the Inbox for your Unica NetInsight installation.
Option Max Running Reports Per User Global Max Running Description The maximum number of reports with the status Running that a user can have. The default is 5. A value of 0 means there is no limit. The maximum number of reports with the status Running that can be in the system, regardless of which user requested them. The default is 200. A value of 0 means there is no limit.
288
Configuring network options Option Description
Completed Reports The maximum number of reports with a status of Canceled by Admin, Completed, Stored per User or Failed that a user is allowed to retain in the Inbox. The default is 100. When this limit is reached, Unica NetInsight deletes reports. Run Queued Reports Clearing this checkbox turns off report generation. Any reports waiting to be generated and any new report requests will stay in the queue until this option is enabled. Typically you would clear this checkbox only if you were performing maintenance on your system.
N1640001
Configuring network options

N164000A
To modify Unica options To specify DNS options To modify Unica NetInsight email options
To modify Unica options

Unica options include the complete URL for Unica Marketing Platform, which you set during installation. You can change Unica options through the interface, as described below.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, under Network click Unica Network, Unica. The Unica Options screen opens. 4. Edit the Unica Marketing Platform URL as needed.
).
If you enter the incorrect Unica Marketing Platform URL users are not able to URL, log in. The error message states that the login failed, but does not specify that Unica Marketing Platform was not reachable. 5. Click Save Options then click Continue Options, Continue. Changes to the Unica options are saved.
N1860001
To specify DNS options

1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab.
Version 8.2.1 289
).
3. In the Options panel, select Network > DNS DNS. The DNS Options screen opens. 4. In the DNS server address field, enter the host name or IP address of a DNS server. 5. In the Maximum simultaneous DNS requests field, enter the number of IP addresses Unica NetInsight should attempt to resolve at once. The default is 2000. 6. In the Reverse DNS timeout field, enter the number of seconds you want Unica NetInsight to wait before stopping a DNS lookup (to resolve host names). The slower your connection, the larger your timeout setting should be. Enter a number from 2 to 120. The default is 3. 7. In the Reverse DNS retries field, enter the number of times that Unica NetInsight should try to resolve a given IP address. Enter a number from 0 to 100. The default is 4. 8. Click Save Options and then click Continue Continue.
N1870001
To modify Unica NetInsight email options

You can modify the email options Unica NetInsight uses to email reports to users. You can set these options during installation, or change them through the administrator interface, as described below.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Network > Email Email. The Email Options screen opens. 4. Edit the email options as needed.
).
a. In the Mail server (SMTP) field, enter the name of a valid SMTP email server to deliver emailed reports. b. Enter a valid port number in the Mail Server Port field (the default port for SMTP is port 25). c. Enter a valid email address in the From address field. Any undeliverable reports are returned here by default. This address can be overridden in configured email tasks. d. Enter a valid email address in the Administrator's address field. Any errors are reported to this address. 5. Click Save Options then click Continue Options, Continue.
Configuring security
Changes to the email options are saved and take effect immediately.
N1650001

N165000A
To specify the internal database as the authentication method To specify the Unica Marketing Platform as the authentication method To specify LDAP as the authentication method To specify the Web Server as the authentication method
To specify the internal database as the authentication method

You can choose to use the internal database as the authentication method for users.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Users > Authentication Authentication. The Authentication options screen opens. 4. In the Authenticate using list, select Internal database database. 5. In the Logins expire list, select how you want users to be logged out.
).
To have authenticated users stay logged on until they manually log out, select Never Never. To have users' logins expire when their browsers close, select When the browser is closed closed.
6. Set password requirements as needed. Enter the Minimum length for user's passwords. Enter the Minimum number of numeric characters for user's passwords. Enter the Minimum number of uppercase or special characters for user's passwords.
7. Optionally, to prevent users not based on a role with the Administrator: Administration: Profile Manager privilege from access the Profile Manager, check Restrict Access to Profile Manager Manager. For security reasons, it is highly recommended that you check this option. 8. Click Save Options then click Continue Options, Continue.
N1880001
Version 8.2.1
291
To specify the Unica Marketing Platform as the authentication method

1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Users > Authentication Authentication. The Authentication options screen opens. 4. In the Authenticate using list, select Unica Marketing Platform Platform. 5. In the Logins expire list, select how you want users to be logged out. To have authenticated users stay logged on until they manually log out, select Never Never. To have users' logins expire when their browsers close, select When the browser is closed This is the more secure option and is highly recommended. closed. ).
6. Optionally, to prevent users not based on a role with the Administrator: Administration: Profile Manager privilege from accessing the Profile Manager, check Restrict Access to Profile Manager Manager. If you do not restrict access to the Profile Manager, it is available to both authenticated and unauthenticated users. For security reasons, Unica highly recommends that you restrict access to the profile manager. 7. Click Save Options then click Continue Options, Continue. You can now create users in Unica NetInsight and Unica Marketing Platform.
N1890001
To specify LDAP as the authentication method

To use LDAP for authentication, you must set up the LDAP data conduit. You can choose to use LDAP as the authentication method for users. Unica Marketing Platform is the recommended authentication method.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Users > Authentication Authentication. The Authentication options screen opens. 4. In the Authenticate using list, select External database database. Fields in which to identify the data conduit appear on the screen.
292
).
5. In the Logins expire list, select how you want users to be logged out. To have authenticated users stay logged in until they manually log out, select Never Never. To have users' logins expire when their browsers close, select When the browser is closed This is the more secure option and is highly recommended. closed.
6. In the Full path to conduit field, enter the full path (including the filename) to the .dll (Windows) or .so (UNIX) file for the conduit. 7. In the Full path to conduit config field, enter the full path (including the filename) to the configuration file for the conduit. 8. Optionally, to prevent users not based on a role with the Administrator: Administration: Profile Manager privilege from access the Profile Manager, check Restrict Access to Profile Manager Manager. For security reasons, it is highly recommended that you check this option. 9. Click Save Options then click Continue Options, Continue.
N18A0001
To specify the Web Server as the authentication method

You can choose to use the Web server as the authentication method for users. Unica Marketing Platform is the recommended authentication method.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Users > Authentication Authentication. The Authentication options screen opens. 4. In the Authenticate using list, select Web server server. Fields in which to identify the data conduit appear on the screen. 5. In the Full path to conduit field, enter the full path (including the filename) to the .dll (Windows) or .so (UNIX) file for the conduit.
).
6. In the Full path to conduit config field, enter the full path (including the filename) to the configuration file for the conduit. 7. Optionally, to prevent users not based on a role with the Administrator: Administration: Profile Manager privilege from access the Profile Manager, check Restrict Access to Profile Manager Manager. For security reasons, it is highly recommended that you check this option.
Version 8.2.1
293

N1660001
Configuring roles and users

N166000A
To create a role To copy a role To assign or edit privileges for a role To edit a role To delete a role To create a user manager To create a user To modify a user To specify a user's profile settings To delete a user
To create a role
When you first create a role, that role has no privileges associated with it. If you want to create a role that shares many of the same privileges as an existing role, you can copy the existing role. You can then change only those privileges for the new role that must be different.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, under Users click Roles Users, Roles. The Role definitions screen opens. 4. Click Add Add. The Role description screen opens. 5. Enter the name and title of the role.
).
6. Optionally, check the Administrator only box to prevent user managers from adding or editing user accounts associated with this role. 7. Click Save Options then click Continue Options, Continue. After you create a new role, you must assign it privileges.
N18B0001
294
To copy a role
When you copy a role, its defined privileges are copied into the new role. Therefore, when you want to create a new role that is to have most, but not all, of the same privileges, you can copy a role and makes changes to its assigned privileges.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Users > Roles Roles. The Role definitions screen opens. 4. Select the role that you want to copy. 5. Click Copy Copy. The Role description screen opens. 6. Enter a new, unique name in the Role name field. 7. Edit the value in the Title of role field. 8. Click Save Options then click Continue Options, Continue.
N18C0001
).
To assign or edit privileges for a role

The privileges you assign to a role control what users based on that role see in the Web interface.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, select Users > Roles Roles. The Role definitions screen opens. 4. Select the role for which you want to assign or edit privileges. 5. Click Privileges Privileges. The Privileges granted to role screen opens. 6. Modify privileges as needed. Privileges already associated with the role are in the Granted privileges list. Privileges in the system that are not associated with the role are in the Available privileges list.
).
Select list items and use the arrow keys to move them between lists as necessary. 7. Click Save Options then click Continue Options, Continue.
N18D0001
Version 8.2.1
295
To edit a role
You can change the title of an existing role and the Administrator only setting. You cannot change the name of an existing role. The title of the role appears in the list of roles. The name of the role is used internally.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, under Users click Roles Users, Roles. The Role definitions screen opens. 4. Select the role that you want to edit. 5. Click Edit Edit. The Role description screen opens. 6. Edit the value in the Title of role field.
).
7. Optionally, check or clear the Administrator only box to prevent user managers from adding or editing user accounts associated with this role. 8. Click Save Options then click Continue Options, Continue.
N18E0001
To delete a role
When you delete a role that is associated with users, those users are then not associated with any role. When you delete a role, there is no confirmation step before the role is removed. Be sure that you want to delete the role before proceeding.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. In the Options panel, under Users click Roles Users, Roles. The Role definitions screen opens. 4. Select the role that you want to delete. 5. Click Delete Delete. The role is deleted. 6. Click Continue Continue.
N18F0001
).
296
To create a user manager

1. Ensure that Restrict access to Profile Manager has been enabled for your installation. 2. Create a new role for user managers. When creating the role: To prevent user managers from creating or editing other user managers, check Administrator only only. Assign the Administrator : Administration : User Manager privilege to the roll, along with whatever other interface, options, and removal privileges you want. Do not assign the Administration : Administration : Profile Manager privilege to the role as this gives it full administration privileges.
3. For each role that should not be editable by user managers, ensure that the Administrator only setting is selected. This makes the role (and its associated user accounts) exempt from editing by user managers. Typically you would want to enable this setting for all roles with administration privileges. You may also want to enable it for certain non-administration roles. For example, if your company has site-specific roles (for example, "Boston Average User," "Paris Average User") you may want to create user managers that can only create and edit users for a specific site. 4. Assign users to the user manager role as desired.
N1900001
To create a user
When you create a user, you base the user's privileges on a role. You can use the roles delivered with Unica NetInsight or create custom roles. If you are using the Unica Marketing Platform for authentication, the User name you enter must match the user name created in the Unica Marketing Platform
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. Under Options select Users > Users Options, Users. The NetInsight users screen opens. 4. Click Add Add. The User description screen opens. 5. Fill in the user information.
).
Version 8.2.1
297
Note the following: The User name value is case-insensitive. The Full name value appears in the welcome message located in the upper-right corner of the Unica NetInsight home page. The Full name Email address and Password fields only appear if Unica name, address, NetInsight is configured to authenticate users through its internal database. If Unica NetInsight is configured to authenticate users through the Unica Marketing Platform, an external database or a Web server, you do not enter this information. The Default role list contains all the defined roles. The default role you specify controls the interface for all profiles except those in which a specific role has been specified for this user or the default role for the profile is (No Access). It also controls whether the user has the right to change the password or the default view for each profile, among other privileges. The Default reporting mode list contains two options: Full and Sample The Sample. default mode you specify controls the reporting mode for all profiles except those in which a specific default reporting mode has been specified for this user.
6. Click Save Options then click Continue Options, Continue. If you are using the Unica Marketing Platform for authentication, you must now create users in the Unica Marketing Platform with the same user names you entered in Unica NetInsight. When users first log into Unica NetInsight and are authenticated against the Unica Marketing Platform, they must change their passwords. Users cannot change their passwords through Unica NetInsight; they must open the Unica Marketing Platform, log in, and change their passwords. After you create a user account, instruct the user to log on to his or her Unica NetInsight home page at http://NetInsight_URL/index.html.
N1910001
To modify a user
Follow these instructions to modify a user's full name, email address, password, default role, and default reporting mode.
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. Under Options select Users > Users Options, Users. The NetInsight users screen opens. 4. Select the user to edit. 5. Click Edit Edit.
).
298
The User description screen opens. 6. Fill in the user information. Note the following: The Full name value appears in the welcome message located in the upper-right corner of the Unica NetInsight home page. The Full name Email address and Password fields appear only if Unica name, address, NetInsight is configured to authenticate users through its internal database. If Unica NetInsight is configured to authenticate users through Unica Marketing Platform, an external database or a Web server, you do not enter this information. The Default role list contains all the defined roles. The default role you specify controls the interface for all profiles except those in which a specific role has been specified for this user or the default role for the profile is (No Access). It also controls whether the user has the right to change the password or the default view for each profile, among other privileges. The Default reporting mode list contains two options: Full and Sample The Sample. default mode you specify controls the reporting mode for all profiles except those in which a specific default reporting mode has been specified for this user.

N1920002
To specify a user's profile settings user'

1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. Under Options select Users > Users Options, Users. The NetInsight users screen opens. 4. Select the user for whom you want to specify profiles and click Profiles . All of your profiles are listed. Those for which a default role or view has been specified for this user are listed first and have an asterisk next to them. 5. Select the profile for which you want to edit settings for this user and click Continue Continue. 6. As desired, set the user's role, default view, and default reporting view for this profile. For role: Select (None) to not define a role. Unica NetInsight uses the user's default role (if defined) or the profile's default role (if defined), in that order. If neither is defined, the user will be able to access the profile with all privileges. Select (No Access) to prevent this user from accessing this profile. For default view: Select (None) to allow the user to use the default view specified in the profile options, if any. ).
Version 8.2.1
299
This does not prevent the user from changing to another view or restrict access to any view. The default view makes it easier for users to see a relevant view of the data when they first access the profile. It is not a means of enforcement to prevent a user from accessing specific reports, dimensions, filters, or metrics. For default reporting mode, select the mode you want to be the default for this user in this profile. This does not prevent the user from changing to a different reporting mode. It determines the reporting mode when the user first accesses the profile.

N1930001
To delete a user
1. Open the administration home page by clicking on the Administration icon ( 2. Click the Options tab. 3. Under Options select Users > Users Options, Users. The NetInsight users screen opens. 4. Select the user to delete. 5. Click Delete Delete. The user is permanently deleted from the internal database and that user can no longer access Unica NetInsight, even if the user account still exists within Unica Marketing Platform.
N1670001
).
About customizing the NetInsight interface

N1670007
About profile views About dimension lists About filter lists About metric lists About the profile default role, view, and reporting mode About role default view settings
About profile views

A profile view is a set of lists:
300
Dimension list Metric list Filter list

About customizing the NetInsight interface
Report list
You can create profile views to make it more convenient for users who want to view only a subset of, or to provide convenient access to, customized dimensions, filters, metrics, and reports. Views also allow you to group the dimensions, filters, metrics, and reports into folders that may be more intuitive or convenient for your users. You can combine profile views with user authentication to block some users from viewing some reports. A default profile view is automatically generated when a profile is created and initially contains all available dimensions, filters, metrics, and reports. Before you create a profile view, you need to create the dimension list, filter list, metric list, and report list you want to use in the profile and populate those lists with the desired dimensions, filters, metrics, and reports.
N1940001
About dimension lists

If you need to customize the list of dimensions available to users working with the profile, you can use a dimension list. A dimension list appears in the Discovery Panel and in the Drill to Dimension pop-up menu. The default dimension list contains all possible dimensions. You can create other dimension lists and assign them to views. Each view can contain one dimension list. Setting up different views with different dimension lists can provide easier access to the relevant data for different users/roles. For example, it may be easier for a campaign designer to use visual selection for targeting with a subset of available dimensions.
N1950001
About filter lists

If you need to customize the list of filters available to users working with an profile, you can use a filter list. A filter list appears on the Discovery Panel The default filter list Panel. contains all possible filters. You can create other filter lists and assign them to views. Each view can contain one filter list. Setting up different views with different filter lists can provide easier access to the relevant filters for different users/roles. For example, sales representatives in the Northeast could have custom filter groups that narrow the prospects to their particular region and sub-regions. Sales representatives in the Southeast would have a different set of filters pertinent to their geography.
N1960001
About metric lists

If you need to customize the list of metrics available to users working with the profile, you can use a metric list. A metric list appears on the Discovery Panel The default Panel. metric list contains all possible metrics. You can create other metric lists and assign them to views. Each view can contain one metric list. For example, you could create a metric list for power users that contains all possible metrics and a simplified metric list for other users that eliminate uncommon metrics (for example, removing min and max purchases, but leaving sum and average purchase metrics).
N1970001
Version 8.2.1
301
About the profile default role, view, and reporting mode

You can change the default role, default view, and default reporting mode for a profile. (The initial values are specified using the system-wide default role, view, and reporting mode settings specified by your administrator for profiles of this type.) The default role, view, and reporting mode are used for all users who do not have an explicit role, default view, or reporting mode specified in the administrative options. The default role, view, and reporting mode also affect users who have not logged on before accessing the profile. Administrators can also set the default role, view, and reporting mode to apply to each new profile users create. If you specify the default role of (No Access) for the profile, it is used for all users who do not have a role for this profile specifically assigned in the profile settings for the user. The user's default role is not used. Select (No Access) to limit access to this profile to those users who have a role for this profile specified in the administrative options and who are logged on. Users must log on to access the profile. If you select Sample as the default reporting mode and a sample size has not been specified for the profile, Unica NetInsight uses the Full reporting mode. If a user does not have permission to view full reports, the user sees an error when no sample size is specified.
N1980001
About role default view settings

You can assign each role a default view for each profile. The default view is for users who have that role for the profile, but who do not have an assigned default view for the profile.
N1680001
Working with views

N168000A
To create a profile view To edit a profile view To copy a profile view To delete a profile view To change to another profile view About accessing a profile view through a URL
To create a profile view

Before you create a profile view, you need to create the dimension list, filter list, metric list, and report list you want to use. 1. While working with the profile, click Options Options.
Working with views
2. In the left panel, under Interface click Views Interface, Views. The View definitions screen opens. 3. Click Add Add. The View description screen opens. 4. In the Name of view (one word) field, enter a name for the view. The name is used both internally and as a shortcut to access the view directly from a browser. You may use only alphanumeric characters and hyphens, and the first character must be a letter. Once the view is created, you cannot change the name. 5. In the Title of view field, enter a title for the view. The title appears in the list of views. 6. From the Time period list, select the time period to be used by the calendar when you first open Unica NetInsight . 7. From the Report list list, select the report list to use for the view. 8. From the Dimension list list, select the dimension list to use for the view. 9. From the Filter list list, select the filter list to use for the view. 10. From the Metric list list, select the metric list to use for the view. 11. Click Save Options then click Continue Options, Continue.
N1990001
To edit a profile view

1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Views Interface, Views. The View definitions screen opens. 3. Select the view to edit. 4. Click Edit Edit. The View description screen opens. 5. In the Title of view field, enter a title for the view. The title appears in the list of views. 6. From the Time period list, select the time period to be used by the calendar when you first open Unica NetInsight . 7. From the Report list list, select the report list to use for the view. 8. From the Dimension list list, select the dimension list to use for the view. 9. From the Filter list list, select the filter list to use for the view. 10. From the Metric list list, select the metric list to use for the view. 11. Click Save Options then click Continue Options, Continue.
Version 8.2.1 303

N19A0001
To copy a profile view

You can copy an existing profile view to create a new one. This may save time as all settings are copied to the new view. 1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Views Interface, Views. The View definitions screen opens. 3. Select the view to copy. 4. Click Copy Copy. The View description screen opens. 5. In the Title of view field, enter a title for the view. The title appears in the list of views. 6. From the Time period list, select the time period to be used by the calendar when you first open Unica NetInsight . 7. From the Report list list, select the report list to use for the view. 8. From the Dimension list list, select the dimension list to use for the view. 9. From the Filter list list, select the filter list to use for the view. 10. From the Metric list list, select the metric list to use for the view. 11. Click Save Options then click Continue Options, Continue.
N19B0001
To delete a profile view

1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Views Interface, Views. The View definitions screen opens. 3. Select the view to delete. 4. Click Delete Delete. 5. Click Continue Continue.
N19C0001
To change to another profile view

If a profile contains multiple views and if you have permission to change your view, you can change views from within the application interface. For example, you can change from the complete profile view (a predefined view that contains all available dimensions, filters, metrics, and reports) to a view that contains a subset of available dimensions, filters, metrics, and reports.
304
Working with roles and views
1. While working with the profile, click the Reports Reportstab. 2. In the Available Reports panel title bar, click the Change View icon. A list of available views appears. 3. Click the view to change to. To return to the current view from the list of available views, click Close in the heading of the list. The list of available views closes and the current view does not change.
N19D0001
About accessing a profile view through a URL

Users can access each view defined in the profile options through a distinct URL: http://server-name/profile-name/view-name/index.html where server-name is the URL that was entered during installation, profile-name is the short profile name, and view-name is the name of the view (not the title). The ability to access a view through a URL is a convenient way for users to view the reports that are of the most interest to them. If an authenticated user who does not have the privilege for changing views attempts to access a view other than the user's default view (and the view the user is trying to access is not restricted by Web server security settings), the application cannot control attempts to access views which are restricted by Web server security settings.
N1690001
Working with roles and views

N169000A
To set the default role, view, and reporting mode for a profile To set a new role default view To edit a role default view setting To delete a role default view setting
To set the default role, view, and reporting mode for a profile
You must create the role and view to use as the default for a profile before completing the instructions below. If you want to use Sample as the default reporting mode, specify a sample size and generate the sample tables and reports. 1. While working with the profile, click Options Options. Or, if you are an administrator setting defaults for all new profiles users create, click the Administration icon ( ). Select the Options tab, then from the Unica NetInsight options drop-down menu, select Edit Default Web Server Options Options. 2. In the left panel, under Interface click profile Defaults Interface, Defaults.
Version 8.2.1
305
The profile defaults screen opens. 3. From the Default role list, select the role you want to be the default for the profile. The list contains all roles defined in the administrative options. Select (None) if there is no default role for the profile. If there is no default role, users who do not have a default role specified in the administrative options or who have not logged on before accessing the profile have all privileges for this profile. 4. From the Default view list, select the view you want to be the default view for this profile. The list contains all views defined in the profile. 5. From the Default reporting mode list, select the reporting mode you want to be the default for the profile. 6. Click Save Options then click Continue Options, Continue.
N19E0001
To set a new role default view

You must create the view to set as the default for the role before completing this task. 1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Role Defaults Interface, Defaults. The Default views for roles screen opens. 3. Click Add Add. The Default views for role screen opens. 4. From the Role list, select the role whose default view you want to set. The list contains all the roles that have been defined in the administrative options but that have not yet had a default view specified in this profile. 5. From the Default view list, select the view you want to be this role's default view for this profile. The list contains all the views that have been defined for this profile. 6. Click Save Options then click Continue Options, Continue.
N19F0001
To edit a role default view setting

1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Role Defaults Interface, Defaults. The Default views for roles screen opens. 3. Select the role default setting you want to edit. 4. Click Edit Edit. The Default views for role screen opens.
Working with report lists
5. From the Default view list, select the view you want to be this role's default view for this profile. The list contains all the views that have been defined for this profile. 6. Click Save Options then click Continue Options, Continue.
N1A00001
To delete a role default view setting

1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Role Defaults Interface, Defaults. The Default views for roles screen opens. 3. Select the role default setting you want to delete. 4. Click Delete Delete. 5. Click Continue Continue.
N16A0001

N16A000A
To create a report list To edit a report list To copy a report list To manage folders for a report list To delete a report list
To create a report list

1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Report Lists Interface, Lists. The Report list definitions screen opens. 3. Click Add Add. The Report list description screen opens. 4. In the Name of report list field, enter the one-word name for the report list. The name is used internally. You may only use alphanumeric characters and hyphens, and the first character must be a letter. Once you have created the report list, you cannot change the name. 5. In the Title of report list field, enter a title for the list. The title appears as the heading of the report list in the left panel of the Reports tab and in the Discovery Panel Panel. 6. Click Save Options then click Continue Options, Continue.
Version 8.2.1 307
You must now create folders for the report list.

N1A10001
To edit a report list

1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Report Lists Interface, Lists. The Report list definition screen opens. 3. Select the report list to edit. 4. Click Edit Edit. The Report list description screen opens. 5. In the Title of report list field, enter a title for the list. The title appears as the heading of the report list in the left panel of the Reports tab and in the Discovery Panel Panel. 6. Click Save Options then click Continue Options, Continue. You can now create folders for the report list.
N1A20001
To copy a report list

You can quickly create a new report list with the same folder and reports definitions as an existing report list by copying it. You can then edit the report list's folders. This may be quicker than creating a new report list. 1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Metric Lists Interface, Lists. The Report list definition screen opens. 3. Select the report list to copy. 4. Click Copy Copy. The Report list description screen opens. 5. In the Name of report list field, enter the one-word name for the report. The name is used internally. You may use only alphanumeric characters and hyphens, and the first character must be a letter. Once you have created the report list, you cannot change the name. 6. In the Title of report list field, modify a title for the list as needed. The title appears as the heading of the report list in the left panel of the Reports tab and in the Discovery Panel Panel. 7. Click Save Options then click Continue Options, Continue. You can now modify folders for the report list.
N1A30001
308
To manage folders for a report list

To modify folders immediately after creating a report list, start with step 5. Otherwise, start with step 1. 1. While working with the profile, click Options Options. 2. In the Options panel, select Interface > Report Lists Lists. The Report list definition screen opens. 3. Select the report list for which to manage folders. 4. Click Folders Folders. The Folder definitions screen opens. 5. To add a folder to the report list: a. Click Add Add. b. In the Title of folder field, enter a title. c. Click Save Options then click Continue Options, Continue. d. Continue with step 8 below. 6. To edit an existing folder name: a. Select the folder. b. Click Edit Edit. c. In the Title of folder field, enter a title. d. Click Save Options then click Continue Options, Continue. e. Continue with step 8 below. 7. To delete an existing folder: a. Select the folder. b. Click Delete Delete. c. Click Continue Continue. 8. To manage reports in the folder: a. Select the folder. b. Click Reports Reports. c. Click Add to add a report. Then select a report from the Report source list, and optionally change the Report title field. Click Save Options then click Continue Options, Continue. d. Select a report and click Delete to remove a report from the group. Then click Continue Continue. e. Select a report and click Edit to modify the report.
Version 8.2.1 309
Then select a report from the Report source list, and optionally change the Report title field. Click Save Options then click Continue Options, Continue. f. Click Save Options then click Continue Options, Continue.
9. Click Back to Groups when finished modifying folders.

N1A40001
To delete a report list

If the report list is currently selected for a view, when you delete the report list, it is removed from the view. 1. While working with the profile, click Options Options. 2. In the Options panel, select Interface > Report Lists Lists. The Report list definition screen opens. 3. Select the report list to delete. 4. Click Delete Delete. 5. Click Continue Continue.
N16B0001
Working with dimension lists

N16B000A
To create a dimension list To edit a dimension list To copy a dimension list To manage groups for a dimension list To delete a dimension list
To create a dimension list

1. While working with the profile, click Options Options. 2. In the Options panel, select Interface > Dimension Lists Lists. The Dimension list definition screen opens. 3. Click Add Add. The Dimension list description screen opens. 4. In the Name of dimension list field, enter the one-word name for the dimension. The name is used internally. You may only use alphanumeric characters and hyphens, and the first character must be a letter. Once you have created the dimension list, you cannot change the name. 5. In the Title of dimension list field, enter a title for the list. The title appears in the list of dimension lists. The title also appears as the heading of the dimension list in the Discovery Panel Panel.
Working with dimension lists
6. Click Save Options then click Continue Options, Continue. You can now create groups for the dimension list.
N1A50001
To edit a dimension list

1. While working with the profile, click Options Options. 2. In the Options panel, select Interface > Dimension Lists Lists. The Dimension list definition screen opens. 3. Select the dimension list to edit. 4. Click Edit Edit. The Dimension list description screen opens. 5. In the Title of dimension list field, enter a title for the list. The title appears in the list of dimension lists. The title also appears as the heading of the dimension list in the Discovery Panel. 6. Click Save Options then click Continue Options, Continue. You can now create groups for the dimension list.
N1A60001
To copy a dimension list

You can quickly create a new dimension list with the same group definitions as an existing dimension list by copying it. You can then edit the dimension list's groups. This may be quicker than creating a new dimension list. 1. While working with the profile, click Options Options. 2. In the Options panel, select Interface > Dimension Lists Lists. The Dimension list definition screen opens. 3. Select the dimension list to copy. 4. Click Copy Copy. The Dimension list description screen opens. 5. In the Name of dimension list field, enter the one-word name for the dimension. The name is used internally. You may only use alphanumeric characters and hyphens, and the first character must be a letter. Once you have created the dimension list, you cannot change the name. 6. In the Title of dimension list field, modify a title for the list as needed. The title appears in the list of dimension lists. The title also appears as the heading of the dimension list in the Discovery Panel. 7. Click Save Options then click Continue Options, Continue. You can now modify groups for the dimension list.
Version 8.2.1 311

N1A70001
To manage groups for a dimension list

Groups organize the dimensions available within each dimension list. Groups appear as expandable folders of dimensions in the dimension list. Groups may not contain other groups. To modify groups immediately after creating a dimension list, start with step 5. Otherwise, start with step 1. 1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Dimension Lists Interface, Lists. The Dimension list definition screen opens. 3. Select the dimension list to add groups to. 4. Click Groups Groups. The Group definitions screen opens. 5. Add, edit, and delete groups as necessary. 6. To manage dimensions in the group: a. Select the group. b. Click Dimensions Dimensions. c. Click Add to add a dimension. Then select a dimension from the Dimension source list, and optionally change the Dimension title field. Click Save Options then click Continue Options, Continue. d. Select a dimension and click Delete to remove a dimension from the group. Then click Continue Continue. e. Select a dimension and click Edit to modify the dimension. Then select a dimension from the Dimension source list, and optionally change the Dimension title field. Click Save Options then click Continue Options, Continue. f. Click Save Options then click Continue Options, Continue.
7. Click Back to Groups when finished modifying dimensions.

N1A80001
To delete a dimension list

If the dimension list is currently selected for a view, when you delete the dimension list, it is removed from the view. 1. While working with the profile, click Options Options. 2. In the Options panel, select Interface > Dimension Lists Lists. The Dimension list definition screen opens. 3. Select the dimension list to delete.
Working with filter lists
4. Click Delete Delete. 5. Click Continue Continue.

N16C0001
Working with filter lists

N16C000A
To create a filter list To edit a filter list To copy a filter list To manage groups for a filter list To delete a filter list
To create a filter list

1. While working with the profile, click Options Options. 2. In the Options panel, select Interface > Filter Lists Lists. The Filter list definition screen opens. 3. Click Add Add. The Filter list description screen opens. 4. In the Name of filter list field, enter the one-word name for the filter. The name is used internally. You may only use alphanumeric characters and hyphens, and the first character must be a letter. Once you have created the filter list, you cannot change the name. 5. In the Title of filter list field, enter a title for the list. The title appears in the list of filters lists. The title also appears as the heading of the filter list in the Discovery Panel Panel. 6. Click Save Options then click Continue Options, Continue. You can now create groups for the filter list.
N1A90001
To edit a filter list

1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Filter Lists Interface, Lists. The Filter list definition screen opens. 3. Select the filter list to edit. 4. Click Edit Edit. The Filter list description screen opens. 5. In the Title of filter list field, enter a title for the list.
Version 8.2.1 313
The title appears in the list of filter lists. The title also appears as the heading of the filter list in the Discovery Panel. 6. Click Save Options then click Continue Options, Continue. You can now create groups for the filter list.
N1AA0001
To copy a filter list

You can quickly create a new filter list with the same group definitions as an existing filter list by copying it. You can then edit the filter list's groups. This may be quicker than creating a new filter list. 1. While working with the profile, click Options Options. 2. In the Options panel, select Interface > Filter Lists Lists. The Filter list definition screen opens. 3. Select the filter list to copy. 4. Click Copy Copy. The Filter list description screen opens. 5. In the Name of filter list field, enter the one-word name for the filter. The name is used internally. You may only use alphanumeric characters and hyphens, and the first character must be a letter. Once you have created the filter list, you cannot change the name. 6. In the Title of filter list field, modify a title for the list as needed. The title appears in the list of filter lists. The title also appears as the heading of the filter list in the Discovery Panel. 7. Click Save Options then click Continue Options, Continue. You can now modify groups for the filter list.
N1AB0001
To manage groups for a filter list

Groups organize the filters available within each filter list. Groups appear as expandable folders of filters in the filter list. Groups may not contain other groups. To modify groups immediately after creating a filter list, start with step 5. Otherwise, start with step 1. 1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Filter Lists Interface, Lists. The Filter list definition screen opens. 3. Select the filter list for which to manage groups. 4. Click Groups Groups.
Working with metric lists
The Group definitions screen opens. 5. Add, edit, and delete groups as necessary. 6. To manage filters in the group: a. Select the group. b. Click Filters Filters. c. Click Add to add a filter. Then select a filter from the Filter source list, and optionally change the Filter title field. Click Save Options then click Continue Options, Continue. d. Select a filter and click Delete to remove a filter from the group. Then click Continue Continue. e. Select a Filter and click Edit to modify the filter. Then select a filter from the Filter source list, and optionally change the Filter title field. Click Save Options then click Continue Options, Continue. f. Click Save Options then click Continue Options, Continue.
7. Click Back to Groups when finished modifying filters..

N1AC0001
To delete a filter list

If the filter list is currently selected for a view, when you delete the filter list, it is removed from the view. 1. While working with the profile, click Options Options. 2. In the Options panel, select Interface > Filter Lists Lists. The Filter list definition screen opens. 3. Select the filter list to delete. 4. Click Delete Delete. 5. Click Continue Continue.
N16D0001

N16D000A
To create a metric list To edit a metric list To copy a metric list To manage groups for a metric list To delete a metric list
Version 8.2.1
315
To create a metric list

1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Metric Lists Interface, Lists. The Metric list definition screen opens. 3. Click Add Add. The Metric list description screen opens. 4. In the Name of metric list field, enter the one-word name for the metric list. The name is used internally. You may use only alphanumeric characters and hyphens, and the first character must be a letter. Once you have created the metric list, you cannot change the name. 5. In the Title of metric list field, enter a title for the list. The title appears in the list of metric lists. The title also appears as the heading of the metric list in the Discovery Panel Panel. 6. Click Save Options then click Continue Options, Continue. You can now create groups for the metric list.
N1AD0001
To edit a metric list

1. While working with the profile, click Options Options. 2. In the Options panel, select Interface > Metric Lists Lists. The Metric list definition screen opens. 3. Select the metric list to edit. 4. Click Edit Edit. The Metric list description screen opens. 5. In the Title of metric list field, enter a title for the list. The title appears in the list of metric lists. The title also appears as the heading of the metric list in the Discovery Panel. 6. Click Save Options then click Continue Options, Continue. You can now create groups for the metric list.
N1AE0001
To copy a metric list

You can quickly create a new metric list with the same group definitions as an existing metric list by copying it. You can then edit the metric list's groups. This may be quicker than creating a new metric list. 1. While working with the profile, click Options Options.
2. In the left panel, under Interface click Metric Lists Interface, Lists. The Metric list definition screen opens. 3. Select the metric list to copy. 4. Click Copy Copy. The Metric list description screen opens. 5. In the Name of metric list field, enter the one-word name for the metric. The name is used internally. You may use only alphanumeric characters and hyphens, and the first character must be a letter. Once you have created the metric list, you cannot change the name. 6. In the Title of metric list field, modify a title for the list as needed. The title appears in the list of metric lists. The title also appears as the heading of the metric list in the Discovery Panel. 7. Click Save Options then click Continue Options, Continue. You can now modify groups for the metric list.
N1AF0001
To manage groups for a metric list

Groups organize the metrics available within each metric list. Groups appear as expandable folders of metrics in the metric list. Groups may not contain other groups. To modify groups immediately after creating a metric list, start with step 5. Otherwise, start with step 1. 1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Metric Lists Interface, Lists. The Metric list definition screen opens. 3. Select the metric list for which to manage groups. 4. Click Groups Groups. The Group definitions screen opens. 5. Add, edit, and delete groups as necessary. 6. To manage metrics in the group: a. Select the group. b. Click Metrics Metrics. c. Click Add to add a metric. Then select a metric from the Metric source list, and optionally change the Metric title field. Click Save Options then click Continue Options, Continue. d. Select a metric and click Delete to remove a metric from the group. Then click Continue Continue.
Version 8.2.1 317
e. Select a metric and click Edit to modify the metric. Then select a metric from the Metric source list, and optionally change the Metric title field. Click Save Options then click Continue Options, Continue. f. Click Save Options then click Continue Options, Continue.
7. Click Back to Groups when finished modifying metrics.

N1B00001
To delete a metric list

If the metric list is currently selected for a view, when you delete the metric list, it is removed from the view. 1. While working with the profile, click Options Options. 2. In the left panel, under Interface click Metric Lists Interface, Lists. The Metric list definition screen opens. 3. Select the metric list to delete. 4. Click Delete Delete. 5. Click Continue Continue.
N16E0001
About default profile options

NetInsight stores default values for the profile options. When you create a new profile, NetInsight uses the default values. You can change the default values, which essentially creates a template for all future profiles.
N16F0001
Data and license administration

N16F000A
To set profile defaults To upgrade your license To back up and restore Unica NetInsight data To move Unica NetInsight to another computer To move Unica NetInsight to another computer without reimporting log file data
To set profile defaults

Changing the default options does not affect any existing profiles. The New password New password (again) and auto-updating option fields do not password, (again), appear in the default options. You must set passwords in the options for each individual profile.
Data and license administration
1. Open the Profile Manager. 2. Click the Options tab. 3. In the Unica NetInsight Options list at the top of the page, select Edit Default Web Server Options Options. 4. Make changes as needed. Be sure to click Save Options before leaving a page that has changes you want to keep. The next profile that you create will use these new defaults.
N1B10001
To upgrade your license

Upgrading does not require you to reinstall Unica NetInsight or reprocess your log files. 1. Open the Profile Manager. 2. Click the Options tab. 3. Select Upgrade License from the Unica NetInsight Options drop-down list. 4. Follow the on-screen instructions. 5. When you have your new activation key, enter it into the Activation Key field and click Upgrade NetInsight NetInsight.
N1B20001
To back up and restore Unica NetInsight data

1. Backup the following: The Unica NetInsight database directory and its subdirectories. This directory data is in the program directory. The default UNIX location is /usr/local/ Unica NetInsight/data. The default Windows location is C:\Program Files\Unica NetInsight\data. If you are using another database for Unica NetInsight, you must back it up. The Unica NetInsight CGI-BIN directory and its subdirectories. This directory is in your Web server's CGI-BIN or scripts directory. The Unica NetInsight HTML directory and its subdirectories. This directory is in your Web site's HTML or wwwroot directory. You must also backup and restore your database. 2. When necessary, take the following steps to restore the data: a. Re-install Unica NetInsight. b. Restore the data directory, replacing the one creates during installation. c. Restore the Unica NetInsight CGI-BIN directory. d. Restore the Unica NetInsight HTML directory.
Version 8.2.1 319
e. Go to the command line and change to the Unica NetInsight program directory. f. Restore the database.
g. Run the following command to regenerate appropriate HTML for all profiles:
nettracker all -regen
N1B30001
To move Unica NetInsight to another computer

1. Install Unica NetInsight on the second computer. 2. Create a new profile on the second computer for every profile on the first computer. If you want to keep your profile configurations, give the new profiles exactly the same names as the old ones. 3. If you want to keep your profile configurations, copy the profilename.cfg files from the first computer to the second computer. The profilename.cfg files are stored in the Unica NetInsight/data/profilename directory, where profilename is the short name of the profile (the one that appears in parentheses on the Profile Manager). 4. If you have created custom reports that you want to keep, copy the report files to the new computer. 5. Reimport your log data. 6. Remove Unica NetInsight from the old computer. For information about moving users, roles, and profiles, please contact Technical Support.
N1B40001
To move Unica NetInsight to another computer without reimporting log file data
Provided the database type is the same, you can copy the database files between two installations of Unica NetInsight even if the installations are running on different architectures (for example, Windows and Linux). 1. Install Unica NetInsight on the second computer. 2. Create empty profiles with the same names as the profiles on the first computer. This is the name that appears in parentheses in the list of profiles in the Profile Manager. You do not need to set any of the configuration options for these profiles. 3. Copy the data directory from the first computer to the second computer.
320
Troubleshooting NetInsight
The data directory is located in the Unica NetInsight program directory. (On Windows the default program directory is C:\Program Files\Unica NetInsight. On UNIX the default program directory is /usr/local/Unica NetInsight.) 4. Copy the database tables from the first computer to the second. 5. Run nettracker all -regen (from the program directory) on the second compute to regenerate the associated HTML files. 6. Remove Unica NetInsight from the first computer. For information about moving users, roles, and profiles, please contact Technical Support.
N1700002

N1700008
About Unica NetInsight system logs To configure Unica NetInsight system logs About the Unica NetInsight process log
About Unica NetInsight system logs

Unica NetInsight includes a set of system logs that you can use to monitor and diagnose issues related to import, report generation, and other functionality affecting performance and data integrity. In most cases you will only need to reference these logs when instructed to by Unica technical support. The system logs are located at <NetInsight _root>\data\<profile_name>\logging. Logs for dynamically generated reports are stored in a subdirectory named adhoc.
Configuring system logs

If you have been given the necessary privilege, you can enable/disable each of the system logs, as well as specify their logging level and how long they are retained. The privilege required to configure system logging is Options > Main > Logging Most logs Logging. are disabled by default and, to preserve disk space, should only be enabled during troubleshooting. Again, in most cases you should only modify these settings when instructed by Unica technical support. While listed as a system log, process logging is not configurable via the Logging Options screen. You enable process logging by including the <processlog/> element processlog/> in nettracker.cfg. (It is enabled by default.)
Available system logs

The following system logs are available:
Version 8.2.1
321
15 - NetInsight System Administration Log ADS ANALYSIS CACHEMEM CHKPOINT CHKPTSTAGES IMPORTSTATS Stores Data On Execution plan for report generation. Time taken for table analysis on the database. ID cache memory used by checkpoint. Basic statistics on checkpoint execution. Checkpoint data broken out by phases. Summary statistics on imports broken out by individual Web log file. How long indexes take to generate. Paid search integration data import. Start and stop times of events associated with major processes. SQL query execution. ID reconciliation. Sampling statistics and timing. Translating temporary IDs to permanent.
INDEX PSI PROCESS
QEXEC RECONCILE SAMPLE TRANSLATE

N1B50001
To configure Unica NetInsight system logs

You must have the necessary privilege (Options > Main > Logging) to access the Options logging configuration screen. Unica NetInsight generates a set of system logs that you can use to diagnose issues related to import, report generation, and other functionality affecting performance and data integrity. Individual system logs can be enabled or disabled and their logging levels specified. You can also specify how long logs are retained. To configure application logs: 1. With the profile whose system logs you want to configure displayed, select Options > Main > Logging Logging. 2. Optionally, specify how many days logs should be retained. Logs older than this will be automatically deleted. This is a global setting affecting all system logs. To prevent logs from being deleted, enter 0.
322
3. To enable or disable a particular log, or to set its logging level, select the log from the list and click Edit Edit. The range of available logging levels for system logs includes the industry-standard FATAL, ERROR, WARNING, INFO, DEBUG and TRACE with FATAL logging only fatal error messages and TRACE logging all available application messages.
N1B60002
About the Unica NetInsight process log

About the Unica NetInsightprocess log
The Unica NetInsight process log lists information on the events associated with major Unica NetInsight processes for each profile. The logs are written in text data format. The data from these logs can be used to monitor processes for performance issues and/or errors. Typically, you will only need to look at these logs at the request of Unica support. A separate log file is generated each time one of the following processes runs: Update Import Recalc Regen Reports Reprofile Resample
Note that when an update is performed it also spawns import, sample, report generation processes. Process logs are stored in netinsight_root\data\profile_name\logging\. The file name convention is process_datetimestamp_process_id.log. For example, process_200903201419_3128.log.
Eanabling and disabling process logging

Process logging is not configurable via the Logging Options screen. You enable it by including the <processlog/> element in nettracker.cfg. Disable it by removing the processlog/> element. Process logging is enabled by default.
About process log contents

Process logs record the following event information: A timestamp showing when the event initiated. The time is determined using the system locale. The logging level of the event information, expressed as Trace, Debug, Info, Warning, Error, or Fatal.
Version 8.2.1
323
The username of the logged-in system user. The event name The event type. Either 0 (instant), 1 (start of a process), or 2 (end of a process). Descriptive text of the event. In the case of an error condition, this includes the Unica NetInsight error text, if any. For example, [2009-03-20 14:19:32] [TRACE] a_user,Checkpoint Phase,1,Spider Retail
About process events

Following is a partial list of events recorded in Process logs, listed by their logging level. It also records three non-events: the Unica NetInsight install directory, the server name, and the user name under which the process was run.
Info Import Start Import End Install Directory Recalc Start Recalc End Reprofile Start Reprofile End Resample Start Resample End Server Debug Aggregate Generation Start Aggregate Generation End Checkpoint n Start Checkpoint n End Quick-pick Generation Start Quick-pick Generation End Report Generation Start Report Generation End Sample Aggregate Generation Start Sample Aggregate Generation End Update Start Update End User Profiling Start Profiling End Sample Quick-pick Generation Start Sample Quick-pick Generation End Sample Report Generation Start Sample Report Generation End Sampling Analyzing Start Sampling Start Sampling End Sampling Analyzing End Sampling Profiling Start Sampling Profiling End Trace Checkpoint Phase Start Checkpoint Phase End
324
N10AB3
16 Working with Data Conduits

N1B70001
About the NetInsight data conduit About deploying a data conduit About lookups versus rewrites To install the data conduit on Windows To install the data conduit on UNIX To set environment variables About the data conduit configuration file Using the APITest utility Using the data conduit Data conduit directives
About the NetInsight data conduit

The NetInsight data conduit allows you to connect NetInsight to an external database and use information from that database in your NetInsight reports. You can also use it to authenticate NetInsight users and to look up user information (such as full name and email address) rather than having to enter that information manually in NetInsight. The external database must be of a type that NetInsight supports; there are separate data conduit packages for each supported database as well as for LDAP. For example, suppose you have a dynamic product page that loads a product based on a product ID passed to the page via a URL parameter when a link for a product is clicked. Assuming that your external database has a product table that associates product IDs with actual product names, you could use the data conduit to create a report showing how often individual products (by name) have been loaded in the page. You could replace each cookie in a Cookie Summary report with a company, contact name, and phone number pulled from a customer database, or each user in a User Summary report with a name and phone number pulled from an LDAP directory.
Version 8.2.1 325
16 - Working with Data Conduits
For user authentication and user information (the user's full name and email address), you specify the data conduit and configuration file on the Authentication page in the administrative options. For all other data, you specify the data conduit and configuration file on the Data Conduits page of the profile options for the NetInsight profile in which you want to use the data. You must set up these data conduits on a profile-by-profile basis. You can use different data conduits with different profiles.
N1B80001
About deploying a data conduit

To deploy and use a data conduit you must: 1. Download and install the data conduit package for your database. The package consists of a program file, a configuration file, and a test utilty that lets you validate your configuration. 2. Create the entities in NetInsight you want to retrieve values for (for example, parameters) and specify the pages for which you want to retrieve database values. Configure the reports that will contain this data (these can be tuned afterwards as well). 3. Configure NetInsight's connection to the data conduit. 4. Edit the data conduit configuration file with the requisite database connection information as well the information pertinent to the data you want to retrieve (for example, table name, column, and value match, and so on). 5. Use the data conduit test utility to test the database connection and ensure the correct data is returned. 6. If you have historical (previously imported) data, you must dump and then re-import profile data so that external database values are returned for the previously imported data.
N1B90001
About lookups versus rewrites

Lookups pull information from an external database or directory into Unica NetInsight reports or profiles. Information resulting from lookups is pulled into reports when the reports are generated. While the lookup values appear in the reports they are not written to the Unica NetInsight database; the database will continue to contain original values imported from log files. You can perform lookups for the following:
326
Cookie data Department data Host data Information about parameter values Page title data
To install the data conduit on Windows
User data Visitor data
Rewrites can be applied to page and parameter data based on data stored in a database or directory. Information resulting from rewrites replace the values originally imported from log files in the Unica NetInsight database.
N1BA0001
To install the data conduit on Windows

1. Download the installer for your database from the Product Downloads section of Unica's Customer Central web site (requires login). 2. Double-click ntdi{database}-{Release-Number}.exe to launch the installer. 3. When prompted for an installation directory, browse to the NetInsight program directory (the default is C:\Program Files\NetInsight). You can now configure the data conduit.
N1BB0001
To install the data conduit on UNIX

1. Download the archive for your database from the Product Downloads section of Unica's Customer Central web site (requires login). 2. Unpack the archive to the NetInsight program directory (the default is /usr/local/NetInsight). 3. Change directories to the NetInsight program directory. The data conduit configuration file (ntdi{database}.conf) will be there but apitest and ntdi{database}.so will be in a subdirectory specific to your platform. Move or copy these two files to the NetInsight program directory. On HP-UX, ensure that ntdi{database].so is executable by the NetInsight user.
N1BC0001
To set environment variables

If you are using a DB2, ODBC, or Oracle data conduit you may need to tell NetInsight to set the required environment variables. You specify environment variable options in the administrative options in NetInsight. The options define the environment variables that should be set when NetInsight is started. Specifically, you may need to set these environment variables: For DB2: For both Windows and UNIX you must set LC_CTYPE environment variable's value to C. For UNIX you must also DB2INSTANCE. (Note that if you are using the DB2 data conduit with NetInsight for DB2 these values are pre-set.)
Version 8.2.1
327
For ODBC: For UNIX, if you are using the iODBC driver, you must set ODBCINI. You may also need to set environment variables if you are using other third-party drivers. For Oracle, if you are not using the Oracle Instant Client, you must set ORACLE_HOME and NLS_LANG (Note that if you are using the Oracle data NLS_LANG. conduit with NetInsight for Oracle these values are pre-set.) If you are using the Oracle Instant Client, you must set the environment variable for your operating system. On Windows systems, also ensure the Oracle Instant Client is in your path. Solaris = LD_LIBRARY_PATH HP-UX = SHLIB_PATH Linux = LD_LIBRARY_PATH
To set environment variables: 1. Open the Unica NetInsight Profile Manager Manager. 2. Click the Options tab. 3. In the left panel, select Main > Environment Variables Variables. 4. Click Add Add. 5. Enter the name of the environment variable you want to set. 6. Enter the value to which the environment variable should be set. DB2 examples:
LC_CTYPE = C
DB2INSTANCE = db2inst1
Oracle examples
ORACLE_HOME = /home/oracle/u01/app/oracle/product/10.1.0
NLS_LANG = AMERICAN_AMERICA.WE8ISO8859P1
7. Click Save Options Options.

N1BD0001
About the data conduit configuration file

The data conduit configuration file is where you specify: 1. The connection information the data conduit needs to connect to a database or LDAP directory server. 2. Directives that instruct the data conduit what data to retrieve for each operation you want the data conduit to perform and (in some cases) how to format it.
328
Using the APITest utility
For example, suppose you want the data conduit to return a product name from a database based on a URL parameter value. In that case you would configure a parameter value lookup directive. In that directive you would specify the name of the URL parameter (as previously defined it in NetInsight), the database table that contains the product name, the column containing the product name, and the column containing the product ID to be matched against the URL parameter value. The configuration file is located in the same directory where you installed the data conduit. It is named ntdidatabase.conf. Each line in the configuration file is composed of a case-sensitive directive followed by the value to be associated with the directive. Note that:
N1BE0001
Lines preceeded by a pound sign (#) are comments. You do not need to use quotation marks to group values that contain spaces. Anything after the directive and before the end of the line is considered the value for the directive.

N1BE000A
To use the APITest utility APITest command-line examples
To use the APITest utility

After installing and configuring a data conduit, use the APITest utility to make sure that the installation and configuration are correct. Always test your configuration prior to importing data after data conduit setup. The APITest utility is a command-line program that calls individual functions you have specified in the data conduit's configuration file and then displays the results returned from the database (or any error messages). You must provide the utility with the following command-line arguments in the order in which they are listed. (For examples, see APITest command-line examples.) 1. Confirm that the data conduit configuration file has been modified correctly for the operation (for example, parameter lookup) that you want to test. Also verify that it includes the correct database connection information. 2. From a command line, navigate to the directory where you installed the data conduit files. 3. Enter the argument for the operation you want to test as follows: <apitest_program_file> <data_conduit_program_file> <data_conduit_configuration_file> <operation_name> <test_values> For example, for a parameter lookup on a Windows system using the MySQL data conduit enter: apitest ntdimysql.dll ntdimysql.conf lookupparam my_parameter test_value
Version 8.2.1 329
For a parameter lookup on a UNIX system using the MySQL data conduit enter: ./apitest ntdimysql.so ntdimysql.conf lookupparam parameter_name test_value When entering the argument note that: The syntax for specifying the APITest program file, the data conduit program and configuration file, and the operation name is constant. The number of test values you must provide vary depending on the operation you are testing. For more information see the examples in the next section. You do not need to specify the extension of the APITest program file.
4. Specify the operation (lookup, rewrite, or user authentication) to be performed by the data conduit, and the values necessary to perform that operation: For a lookup, specify the lookup type and value. The lookup type is the type of data to be retrieved by the data conduit. Following are the possible types and the value to be provided to the data conduit. (The lookup value is the value to be resolved by the data conduit.) The following list shows the lookup types and values: clip: Clip filename as read from the log files cookie: Cookie as read from the log files department: User name or host name as read from the log files host: Host name or IP address as read from the log files email: NetInsight user name lookupparam: Parameter value as read from the log files title: Page as read from the log files user: User name as read from the log files visitor: Visitor name as read from the log files
If the lookup type is lookupparam, you must also supply the name of the parameter. Note that the parameter name must be lowercase to be properly recognized. For a rewrite, specify the rewrite type and value. The rewrite type is the type of data to be rewritten by the data conduit. Following are the possible types and the value to be replaced. rwpage: Page, file, or clip name rwparam: Parameter value
If the rewrite type is rwparam, you must also supply the name of the parameter. Note that the parameter name must be lowercase to be properly recognized. The rewrite value is the value to be rewritten by the data conduit.
330
For user authentication, specify auth followed by the user name and password to be verified.
If an error is returned confirm that:

N1C10001
Your command line syntax is correct and includes correct file names, casesensitivity, and operation values. The operation you are testing is correctly configured in the data conduit configuration file. The database information you entered in the data conduit configuration file is correct and the database is running.
APITest command-line examples

The following command-line examples are based on a MySQL data conduit installed on a Windows operating system. On UNIX the data conduit program file would be named ntdimysql.so. Or if this were a DB2 data conduit installed on Windows the data conduit program and configuration files would be named ntdidb2.dll and ntdidb2.conf respectively. Note that the examples also assume that the data conduit program and configuration files are located in the current directory.
Cookie lookup
Testing a cookie lookup for a cookie whose name-value pair is 24.123.154.115999914303691:
apitest ntdimysql.dll ntdimysql.conf cookie 24.123.154.115-999914303691
Department lookup
Testing a department lookup for a user whose user name is "jane":
apitest ntdimysql.dll ntdimysql.conf department jane
Testing a department lookup for a department named "unica.com":

apitest ntdimysql.dll ntdimysql.conf department unica.com
Host lookup
Testing a host name lookup for a host whose domain name is "junica.com":
apitest ntdimysql.dll ntdimysql.conf host unica.com
NetInsight user information lookup

Testing a user information lookup of an email address for a user named "jane": "/site/store/products/aq-101.html":
Version 8.2.1 331
apitest ntdimysql.dll ntdimysql.conf email jane
Page rewrite
Testing a page rewrite for a page whose path/file name is "/site/store/products/aq101.html":
apitest ntdimysql.dll ntdimysql.conf rwpage /site/store/products/aq101.html
Page title lookup

Testing a lookup on a page title whose path/file name is "/site/store/products/aq101.html":
apitest ntdimysql.dll ntdimysql.conf title /site/store/products/aq-101.html
Parameter lookup
Testing a parameter lookup for a parameter named "product" passing the value 123:
apitest ntdimysql.dll ntdimysql.conf lookupparam product 123
Parameter rewrite
Testing a parameter rewrite a parameter named "product" passing the value 123:
apitest ntdimysql.dll ntdimysql.conf rwparam product 123
User lookup
Testing a user lookup for a user named "jane":
apitest ntdimysql.dll ntdimysql.conf user jane
User authentication
Testing authentication for a user named "janedoe" whose password is "a0s9d8":
apitest ntdimysql.dll ntdimysql.conf auth janedoe a0s9d8
N1BF0001
Using the data conduit

332
To configure NetInsight to use a data conduit for rewrites and lookups To configure Unica NetInsight to use a data conduit for user authentication

N1BF000A
To configure NetInsight to use a data conduit for user information Example: How to configure a parameter lookup To regenerate summaries for a profile Example: How to configure a cookie lookup
To configure NetInsight to use a data conduit for rewrites and lookups

For rewrites and all lookup types except user authentication and NetInsight user information, you configure NetInsight to use the data conduit in the Data Conduits options for the profile in which you want to use external data. If you are tracking a parameter value, you must define the parameter in NetInsight before you can configure NetInsight to use the data conduit for that parameter. 1. View the profile for which you want to use the data conduit. 2. Click the Options tab. 3. In the left panel, select Dynamic Conent Data Conduits Conent> Conduits. 4. Click Add The Data conduit description dialog box opens. Add. 5. Enter a unique, internal name you want to use for the data conduit. 6. Enter the full path (including the filename) to the data conduit program file. Do not place paths that include spaces in parentheses. 7. Enter the full path (including the filename) to the data conduit configuration file. 8. In the Conduit tasks box, select the task(s) for which you want to use this data conduit. 9. Click Save Options Options.
N1C20001
To configure Unica NetInsight to use a data conduit for user authentication

To use a data conduit to authenticate users, you must configure the data conduit in the Authentication options in administrative options. The plug-in configured for user authentication can also retrieve a user's full name and email address; to retrieve this information, you need only configure the user information directive. 1. Display the Profile Manager Manager. 2. Click the Options tab. 3. In the left panel, select Users > Authentication Authentication. 4. Select External database as the authentication type.
Version 8.2.1 333
5. Enter the full path (including the filename) to the data conduit program file. Do not place paths that include spaces in parentheses. 6. Enter the full path (including the filename) to the data conduit configuration file. 7. Click Save Options Options.
N1C30001
To configure NetInsight to use a data conduit for user information

To use a data conduit to look up a user's full name and email address, you must configure NetInsight to use the data conduit via the Authentication options in the administrative options. This plug-in can be used only with external database and Web server authentication. If you are using an external database to authenticate users, no additional configuration is necessary. 1. Display the Profile Manager Manager. 2. Click the Options tab. 3. In the left panel, select Users > Authentication Authentication. 4. In the Authenticate using list, select External database database. If you are using Web server authentication, the Authentication Options window opens. 5. Enter the full path (including the filename) to the data conduit program file. Do not place paths that include spaces in parentheses. 6. Enter the full path (including the filename) to the data conduit configuration file. 7. Click Save Options Options.
N1C40001
Example: How to configure a parameter lookup

The data conduit example in this section looks up a "content type" URL parameter in a database and retrieves the content type name, class, and format. This information appears on a custom Parameter Summary It may also appear on View Breakdowns Summary. Breakdowns, Visit Breakdowns Download Breakdowns Session Breakdowns and crosstab reports. Breakdowns, Breakdowns, Breakdowns, The following figure shows how a portion of the data would appear on the summary before the data conduit is configured. Note that the first column displays the parameter's values:
334
The following figure shows how a portion of the data would appear on the summary after the data conduit is configured. Note that the parameter values in the first column have been replaced with the content type name, class, and format pulled from an external database.
1. Create a database that contains the content type name, class, and format items entered into a lookup table. The table must contain a key column with the same ContentTyp IDs that occur in the URLs of the Web site. For help with creating a database, contact your database administrator. 2. Install the data conduit appropriate for your external database. 3. In NetInsight, view the profile in which you want to look up the product name for the ProductID parameter value. 4. Click the Options tab. 5. In the left panel select Dynamic Content > Parameters Parameters. 6. Click Add Add. 7. Configure the parameter as follows: For the parameter name, enter the parameter name (case-sensitive) exactly as you will later specify it in the data conduit configuration file. The data conduit name does not need to match the parameter name as it appears in your web site URLs. For the parameter value, enter a regular expression that will match the parameter name you entered in the previous step. This field forces your entry to lower case. A case-sensitivity match with the parameter name is not required, but it must match otherwise.
Version 8.2.1
335
8. Click Save Options Options. 9. In the Parameters to be analyzed list, select ContentTyp and then click Requests Requests. 10. Click Add Add. 11. Enter a filter that describes the page(s) whose query strings you want NetInsight to check for this parameter. In this example, you could enter the filter as shown:
12. Click Add Add. 13. Indicate whether you want the query strings that are passed to this page to be searched for the contenttypeid parameter in all new data you import from now on.
If this is what you want, or if you have other pages to enter at this time, click Continue Continue. If you want to search the query strings in this page for the ContentTyp parameter in data you have already imported, you must delete all the data in your profile and re-import your log files. Note If you do not still have all the log files you Note: have imported into this profile, you will lose data permanently by choosing this option.
14. In the Options panel, under Dynamic Content click Data Conduits Content, Conduits. 15. Click Add Add. 16. Configure the data conduit options as shown:
17. Click Save Options then click Continue Options, Continue. 18. Click Update (the left-most icon in the group). 19. If necessary, set environment variables in Unica NetInsight. For example:
20. In a text editor, open ntdi>db_type<.conf. 21. Configure the ConnectString connection directive the data conduit needs to connect to the database. For example:
DBUsername jane DBPassword a0s9d8 DBServiceName testdb1
22. Configure the parameter lookup directives.

Version 8.2.1 337
The example below is wrapped for readability; each directive should appear in the data conduits configuration file on a single line.
ParamDataSource_ContentTyp ContentType, ContentClass, reports_ContentTypeID WHERE ParamDataFormatHTML_ContentTyp %FIELD2%<br>Content class: %FIELD4% ParamDataFormatRTF_ContentTypContent type: class: %FIELD4% ParamDataFormatCSV_ContentTypContent type: ContentTypeID = '%VALUE%' Content type: %FIELD1%, %FIELD3% <br>Content format: %FIELD1%, %FIELD2%\line Content %FIELD3% \line Content format: %FIELD1%, %FIELD2% SELECT ContentTypeID, ContentFormat FROM
ContentTyp the parameter name for the ParamDataSource_paramname directive exactly matches the entry in the Name text box in the profile options for the parameter in Unica NetInsight, including the case. 23. Save your changes to the file. 24. Test the data conduit's configuration. To test the configuration, open a command-line prompt and enter the correct usage. For example, on a Windows system where the data conduit and its configuration file are both in the current directory and you are connecting to an Oracle database enter:
apitest.exe .\ntdiorcl.conf lookupparam ContentTyp 103
If the parameter lookup is successful, the content type name, class, and format will appear. (If the parameter lookup is unsuccessful, an error message will appear. To resolve the error, check your settings for the connection directive and parameter lookup directives in ntdi>db_type<.conf.) 25. For the data from the data conduit to appear on the Parameter Summary you must Summary, regenerate the profile. 26. Do one of the following:
N1C50001
Click the Custom tab and then select the Parameter Summary for ContentTyp report in the list of available reports. To display the summary, click Run Report Report. Click the Reports tab, click Custom Analysis and then select the Parameter Analysis, Summary for ContentTyp report.
To regenerate summaries for a profile

1. Open a command prompt.
2. Change directories to the NetInsight program directory. 3. To regenerate the summaries for a specific profile, execute nettracker short_profile_name -regen The term short_profile_name refers to the profile name that appears in parentheses in the Available profiles list in the Profile Manager. You can also display a list of the short profile names by executing:
N1C60001
Example: How to configure a cookie lookup

If your external database contains one or more tables that map cookie data to customer information (such as name, email, address, and so on) you can use a data conduit to perform a cookie lookup. This lookup can replace cookie IDs with the customer information you choose to retrieve. The information will appear in place of cookie IDs in the Cookie Summary report. In order for this to work: Your Web site must be generating visitor identification cookies that Unica NetInsight can use for sessionization. You can use the Unica Web Server Plug-in to allow your Web server to generate and log visitor identification cookies. Your external database must contain a table (such as shown below) that maps unique cookie values to customer information. A common way to achieve this is though an online form. When visitors complete the form the data they enter is written to the database along with the value of their persistent, unique cookie. Unica NetInsight uses the cookie to identify returning visitors during subsequent visits. The data conduit uses the cookie value to retrieve the correct customer record from the database.
1. Install the data conduit appropriate for your external database. 2. In Unica NetInsight, view the profile in which you want to look up cookie data.
Version 8.2.1 339
3. Enable cookies as a reportable dimension as follows: a. Click the Options tab. b. In the left panel select Reporting > Reportable Dimensions Dimensions. c. Add Cookie to the list of reportable dimensions. d. Click Save Options Options. e. On the toolbar, click Update Update. 4. Configure Unica NetInsight to use the data conduit for Cookie Lookup. 5. On the toolbar, click Update Update. 6. If you are using the data conduit for DB2, ODBC, or Oracle, ensure that any required environment variables have been set. See the Unica NetInsight Installation Guide for more information. 7. Open the data conduit configuration file in the text editor. If the database connection information has not previously been entered, uncomment those rows and enter the connection information now. 8. Configure the cookie lookup directives. An example is shown below. This example includes lines wrapped for readability. In the actual configuration file each directive must be written as a single line.
#Cookie Lookups: CookieDataSource Customers WHERE CookieDataFormatHTML SELECT FirstName, LastName, Email, CustomerID FROM Cookie = '%VALUE%'
%FIELD2%, %FIELD2%<br /> <a class="dataTableRows" href="mailto:%FIELD3%">%FIELD3%</a><br /> ID: %FIELD4% CookieDataFormatRTF CookieDataFormatCSV \sa0\sb120{%FIELD1%\par}\sa0\sb0{%FIELD2%\par} \sa0\sb0{%FIELD3%\par}\sa0\sb0{%FIELD4%\par} %FIELD1% %FIELD2% %FIELD3% %FIELD4%
9. Save the configuration file. 10. Use the APITest utility to test the data conduit configuration. 11. Regenerate the profile to bring the data from the data conduit into the Cookie Summary report. 12. To view the Cookie Summary report in Unica NetInsight, on the Reports tab, select Visitor Analysis > Cookie Summary Summary.
N1C00001
340
Data conduit directives

N1C0000A
About data conduit directives Database and directory server connection string directives About the clip, cookie, host, user, and visitor lookup directives About parameter lookup directives About department lookup directives About page title lookup directives About product directives About rewrite directives User information directive User authentication directives Debug directive Unloadme directive
About data conduit directives

This section describes the directives that can be used in the data conduit configuration file to establish database connections and retrieve and process data.
N1C70001
Database and directory server connection string directives

Use this directive to connect the data conduit to a DB2, MySQL, ODBC, Oracle, or PostgreSQL database or to an LDAP directory server. The connection string examples shown here may be wrapped for readability. In the data conduits configuration file they must appear on a single line.
DB2
ConnectString The connect string necessary to connect to the DB2 database. For example: DRIVER={IBM DB2 ODBC DRIVER}; UID=username;PWD=password;MODE=SHARE; DBALIAS=dbalias;
LDAP
BindDN The Distinguished Name necessary to authenticate with the directory server from which the user desires to retrieve data.
Version 8.2.1
341
BindPassword
The Password necessary to authenticate with the directory server from which the user desires to retrieve data.
Example
BindDN CN=username,OU=people,DC=example,DC=com
To bind anonymously, ensure that the directory server connection directives are commented out.
MySQL
DBUsername The user name to use when connecting to the database. The password for DBUsername. The hostname of the server on which the database resides. The name of the database to which the data conduit should connect. The port on the server through which the database connection should be established.
Password DBHost
DBDatabase
DBPort
ODBC
To connect to a data source using a previously defined Data Source Name:
ConnectString DSN=DSNName;
Example: Windows To connect to a SQL Server database without using a previously defined DSN:
ConnectString DRIVER={SQL Server};UID=db_user;PWD=password;SERVER=server_name;DATABASE=db_name;
To connect to a Microsoft Access database without using a previously defined DSN:

ConnectString DRIVER={Microsoft Access Driver (*.mdb)};DBQ=C:\path\to\db.mdb;
Example: UNIX To connect to a SQL Server database:

ConnectString DRIVER=./libtdsodbc.so;Port=1433;TDS_Version=7.0;UID=db_user;PWD=password;Se rver=server_name;Database=db_name
To connect to a Sybase database:
ConnectString DRIVER=./libtdsodbc.so;Port=5000;TDS_Version=5.0;UID=db_user;PWD=password;Se rver=server_name;Database=db_name
DriverPrompt (for ODBC on Windows only) Use the DriverPrompt directive to specify how you would like to be prompted for database connection information. Valid values are: 1 Prompt for database connection information if no DSN or DRIVER keyword is found in the ConnectString directive. 2 or 3 Prompt for database connection information, using the value of the ConnectString directive for default values. Any other value No prompt, even if the connection fails (default).
Enabling the Debug directive provides a simple way to connect to a database and retrieve the resulting connect string. DriverPrompt. When Debug enabled the data conduit prints the connection string to the console before and after it attempts to connect to the database, thus supplying a value for DriverPrompt. The connect string can in turn be used as the value for the ConnectString directive.
Oracle
DBUsername The user name to use when connecting to the database. The password for DBUsername. The service name to which the data conduit should connect. The service name must have been previously defined using the Oracle client configuration tools.
Password DBServiceNameHost
PostgreSQL
DBUsername The user name to use when connecting to the database. The password for DBUsername.
Password
Version 8.2.1
343
DBHost
The hostname of the server on which the database resides. The name of the database to which the data conduit should connect. The port on the server through which the database connection should be established.
DBDatabase
DBPort
N1C80001
About the clip, cookie, host, user, and visitor lookup directives
In the names of the lookup directives described below, replace {Type} with the lookup type. The possible values for {Type} are: Clip Cookie Host User Visitor Lookup types are case sensitive.
{Type}DataSource (DB2, MySQL, ODBC, Oracle, and PostgreSQL)

The SQL query to be executed to retrieve the desired value. The supplied value should contain the token %VALUE%, which will be replaced by the data conduit during each lookup with the value to be replaced. For example:
HostDataSource SELECT Contact, Name, Phone, EMail FROM HostLookup WHERE Host = '%VALUE%'
In this example, %VALUE% will be replaced with the host name or IP address from the log files.
{Type}DataSource (DB2, MySQL, ODBC, Oracle, and PostgreSQL)

The LDAP URL to be used to retrieve the desired value. The URL should be in the form:
ldap[s]://hostname:port?base_dn?attributes?scope?filter
344
For details about LDAP URLs, refer to your LDAP server documentation. The filter should contain the token %VALUE%, which will be replaced by the data conduit during each lookup with the value to be replaced. For example:
UserDataSource ldap://ldapserver.example.com/OU=people,DC=example,DC=com?displayName, title,telephoneNumber,mail?one?uid=%VALUE%
This example will search for a user with the user ID passed from NetInsight and return the corresponding name, title, telephone number, and address. If an object has two values for an attribute, NetInsight uses the first value. If two objects have the same value for an attribute, NetInsight uses the first object.
{Type}DataFormatHTML
The string to be used to format the values retrieved from the database or LDAP directory when generating reports in HTML. The supplied value should contain the following: Any necessary HTML format strings. The tokens %FIELD1%, %FIELD2%, ..., %FIELDn%, which will be replaced by the data conduit during each lookup with the value of column N contained in the result set retrieved from the database or directory. %FIELDn% tokens may appear in any order, and multiple tokens for a single field may be used multiple times within the same format string. Any links should use the CSS class dataTableRows (see the example below). Otherwise, the links will not be visible in the reports.
Example value value:

HostDataFormatHTML %FIELD1% from %FIELD2%<br> <a class="dataTableRows" href="mailto:%FIELD4%">%FIELD4%</a> or %FIELD3%
Example result:
J. Doe from doe.com<br> <a class="dataTableRows" href "mailto:jane@doe.com">jane@doe.com</a> or 1(800)123-4567
{Type}DataFormatRTF
The string to be used to format the values retrieved from the database or LDAP directory when generating reports in RTF. The supplied value should contain the following: Any necessary RTF format strings.
345
Version 8.2.1
The tokens %FIELD1%, %FIELD2%, ..., %FIELDn%, which will be replaced by the data conduit during each lookup with the value of column N contained in the result set retrieved from the database or directory. %FIELDn% tokens may appear in any order, and multiple tokens for a single field may be used multiple times within the same format string.
Example value value:

HostDataFormatHTML %FIELD1% from %FIELD2%<br> HostDataFormatRTF \sa0\sb120{%FIELD1%\par}\sa0\sb0{%FIELD2%\par} \sa0\sb0{%FIELD4%\par}\sa120\sb0{%FIELD3%}
Example result:
\ sa0\sb120{J. Doe\par}\sa0\sb0{doe.com\par} \sa0\sb0{jane@doe.com\par}\sa120\sb0{1(800)123-4567}7
{Type}DataFormatCSV
The string to be used to format the values retrieved from the database or LDAP directory when generating reports requiring plain text this includes not only reports exported in CSV format, but also graph labels within NetInsight reports. The supplied value should contain the tokens %FIELD1%, %FIELD2%, ..., %FIELDn%, which will be replaced by the data conduit during each lookup with the value of column N contained in the result set retrieved from the database or directory. You do not need to supply enclosing quotes in the CSV format; NetInsight will supply these when the CSV data file is created. %FIELDn% tokens may appear in any order, and multiple tokens for a single field may be used multiple times within the same format string. Example value value:
HostDataFormatCSV %FIELD1% from %FIELD2%
Example result:
J. Doe from doe.com
N1C90001
About parameter lookup directives

To facilitate lookups for multiple parameters, parameter lookup directives are defined on a parameter-by-parameter basis. Lookup directives for parameters begin with the keyword Param.
346
To differentiate between directives for different parameters, the identifiers for parameter lookups should end with an underscore, followed by the name of the parameter exactly as it has been entered in the Name text box on the Parameters page in the NetInsight profile options, including the case. (Do not use the entry in the Parameter text box on the Parameters page.) For example, to configure lookups for the parameter product you would configure the product, following directives: ParamDataSource_product ParamDataFormatHTML_product ParamDataFormatRTF_product ParamDataFormatCSV_product
For example, to configure lookups for the parameter category you would configure the category, following directives: ParamDataSource_category ParamDataFormatHTML_category ParamDataFormatRTF_category ParamDataFormatCSV_category
The directives for looking up data for parameters function the same as the directives for looking up clips, cookies, hosts, users, and visitors.
N1CA0001
About department lookup directives

Following are descriptions of the DepartmentDataSource and DepartmentFallBack directives. Department lookup directives are case sensitive.
DepartmentDataSource
The SQL query or LDAP URL to be executed to determine the department grouping to which a user or host belongs. The supplied value should contain the token %VALUE%, which will be replaced by the data conduit during each lookup with the user name or host name from the log files. If the Departments defined primarily by option in the Departments profile options is set to Hosts NetInsight provides the host name to the data conduit. If the option is Hosts, set to Users NetInsight provides the user name to the data conduit. Users, Examples (DB2, MySQL, ODBC, Oracle, and PostgreSQL) PostgreSQL):
DepartmentDataSource SELECT Department FROM DepartmentLookup WHERE UserName = %VALUE%
Version 8.2.1
347
DepartmentDataSource SELECT Department FROM DepartmentLookup WHERE HostName = %VALUE%
Example (LDAP) (LDAP):

DepartmentDataSource ldap://ldapserver.example.com/CN=Users,DC=example,DC=com?department?one?uid= %VALUE%
DepartmentFallBack
When the DepartmentFallBack directive is set to 1 (the default), NetInsight falls back to the list of departments specified for the Departments profile option to determine a department if the query or URL specified by DepartmentDataSource does not return data. Set DepartmentFallBack to 0 to prevent NetInsight from using the internal list if the query URL or LDAP URL does not return data.
N1CB0001
About page title lookup directives

Following are descriptions of the PageTitleDataSource and PageTitleFallBack directives. Page title lookup directives are case sensitive.
PageTitleDataSource
The SQL query LDAP URL to be executed to retrieve the desired page title. The supplied value should contain the token %VALUE%, which will be replaced by the data conduit during each lookup with the page for which a title is needed. NetInsight will replace %VALUE% with the page that it reads from the log files. Examples Examples:
PageTitleDataSource SELECT PageTitle FROM TitleLookup WHERE PageLocation = %VALUE%okup WHERE UserName = %VALUE%
PageTitle DataSource ldap://ldapserver.example.com/OU=pages,DC=example,DC=com?pageTitle?one?pageL ocation=%VALUE%
348
PageTitleFallBack
When the PageTitleFallBack directive is set to 1 (the default), NetInsight falls back to HTTP to resolve page titles if the query URL specified by PageTitleDataSource does not return data. If NetInsight cannot resolve a page title through the data conduit, it will attempt to retrieve the page title from the actual page. Set PageTitleFallBack to 0 to prevent page title resolution via HTTP if the query LDAP URL does not return data.
N1CC0001
About product directives

Following are descriptions of the ProductLookup and ProductRewrite directives. Product directives are case sensitive.
ProductLookup
The SQL query or LDAP URL to be executed to lookup an SKU and display information in reports. Example (DB2, MySQL, ODBC, Oracle, and PostgreSQL) PostgreSQL):
ProductLookup SELECT ProductName FROM Products WHERE SKU = %VALUE%

ProductLookup ldap://ldapserver.example.com/CN=Users,DC=example,DC=com?ProductName?one?uid =%VALUE%
ProductRewrite
The SQL query or LDAP URL to be executed to lookup a SKU and store information in the database. Example (DB2, MySQL, ODBC, Oracle, and PostgreSQL) PostgreSQL):
ProductLookup SELECT ProductName FROM Products WHERE SKU = %VALUE%

ProductLookup ldap://ldapserver.example.com/CN=Users,DC=example,DC=com?ProductName?one?uid =%VALUE%
N1CD0001
Version 8.2.1
349
About rewrite directives

Following are descriptions of the RewritePageDataSource and RewriteParamDataSource_paramname directives. Rewrite directives are case sensitive.
RewritePageDataSource
The SQL query or LDAP URL to be executed to retrieve the desired page, file, or clip value. The supplied value should contain the token %VALUE%, which will be replaced by the data conduit during each lookup with the page, file, or clip value to be replaced. NetInsight will replace %VALUE% with the page, file, or clip that it reads from the log files. Example (DB2, MySQL, ODBC, Oracle, and PostgreSQL) PostgreSQL):
RewritePageDataSource SELECT NewPageLocation FROM PageRewrite WHERE PageLocation = '%VALUE%'

ldap://ldapserver.example.com/OU=pages,DC=example,DC=com?newPageLocation?one ?pageLocation=%VALUE%
If the %VALUE2% token is present, it will be replaced with the query string associated with the request (if one exists). Example Example:
RewritePageDataSource SELECT NewPageLocation FROM PageRewrite WHERE PageLocation = %VALUE% AND PageQueryString = %VALUE2%
RewriteParamDataSource_paramname
The SQL query or LDAP URL to be executed to rewrite the desired parameter value. To facilitate directives for multiple parameters, parameter rewrite directives are defined on a parameter-by-parameter basis. Rewrite directives for parameters begin with the keyword RewriteParam. To differentiate between directives for different parameters, the identifiers for parameter rewrites should end with an underscore, followed by the name of the parameter exactly as it has been entered in the Name text box on the Parameters page in the NetInsight profile options, including the case. (Do not use the td in the Parameter text box on the Parameters page.) For example, to configure rewrites for two parameters named product and category you category, would configure the following directives: For the product parameter, RewriteParamDataSource_product For the category parameter, RewriteParamDataSource_category
350
The supplied value should contain the token %VALUE%, which will be replaced by the data conduit during each rewrite with the value to be replaced. Example (DB2, MySQL, ODBC, Oracle, and PostgreSQL) PostgreSQL):
RewriteParamDataSource_paramname SELECT NewParamValue FROM ParamLookup WHERE ParamValue = %VALUE%

ldap://ldapserver.example.com/OU=parameters,DC=example,DC=com?newParamValue? one?paramValue=%VALUE%
Differences Between a Parameter Lookup and a Parameter Rewrite

The following table lists the difference between a parameter lookup directive and a parameter rewrite directive.
Parameter lookup directive The external database is queried for the value corresponding to the parameter you specified. Only the value that appears on the reports is replaced. Parameter rewrite directive The external database is queried for the value corresponding to the parameter you specified. The value that is stored in the NetInsight database and the value that appears on the reports are replaced. Using this directive may slow the speed at which a profile updates because each occurrence of the parameter in the log file may result in a query to the database for the replacement value. If you choose to filter a report based on the If you choose to filter a report based on the parameter you specified, you must use the original parameter you specified, you must use the new parameter value as NetInsight read it from your (replaced) parameter value. Web server's log files.
N1CE0001
User information directive

The following is the description of the EmailDataSource directive.
EmailDataSource
The SQL query or LDAP URL to be executed to retrieve a user's full name and email address. The supplied value should contain the token %VALUE%, which is replaced by the data conduit during each lookup with the user's user name. To look up email addresses in Microsoft Active Directory Server, you should use a filter similar to "userPrincipalName=%VALUE%@example.com" # instead of "uid=%VALUE%".
Version 8.2.1
351
Example (DB2, MySQL, ODBC, Oracle, and PostgreSQL)

EmailDataSource SELECT Email, FullName FROM UserAuth WHERE LOWER(UserName) = LOWER('%VALUE%')
Example (LDAP)
EmailDataSource ldap://ldapserver.example.com/ CN=Users,DC=example,DC=com?mail,displayName?one?uid=%VALUE%
N1CF0001
User authentication directives

Following are descriptions of the AuthenticationDataSource, AuthenticateUserSource, and AuthenticateUserDN directives. User authentication directives are case sensitive.
AuthenticationDataSource (DB2, MySQL, ODBC, Oracle, and PostgreSQL)

The SQL query to be executed to authenticate a user. The supplied value should contain the tokens %VALUE% and %VALUE2%, which will be replaced by the data conduit during each lookup with the user name and password entered by the user. The authentication will be considered successful if the query returns one or more rows of data. Example Example:
AuthenticationDataSource SELECT UserName FROM UserAuth WHERE UserName = '%VALUE%' AND Password = '%VALUE2%'
AuthenticateUserSource (LDAP only)

The AuthenticateUserSource directive specifies the URL of the LDAP server to connect to authenticate users. Example Example:
AuthenticateUserSource ldap://ldapserver.example.com/
You can also authenticate against a Microsoft Active Directory server. Example Example:
AuthenticateUserSource ldap://<domainserver address>/
352
where <domain server address> is the URL or IP of your domain controller (such as, domaincontroller.unica.com).
AuthenticateUserDN (LDAP only)

The Distinguished Name to use to connect to the LDAP server specified in the AuthenticateUserSource directive. Example Example:
AuthenticateUserDN CN=%VALUE%,CN=Users,DC=example,DC=com
To authenticate against a Microsoft Active Directory server.

AuthenticateUserDN %VALUE%@<domain name>
where <domain name> is the name of your domain (such as, unica.com). For this directive, the CN and DC fields are not necessary to authenticate against a Microsoft Active Directory.
N1D00001
Debug directive
When the Debug directive is set to 1, the data conduit outputs debugging information. Note that this may be problematic when NetInsight is run through a Web browser. Therefore, this option should be turned on only when you are performing tests through the command-line interface. The Debug directive may be commented out in the data conduit's configuration file. If you want to change the directive's default setting and the directive is commented out, remove the pound sign (#) from the line and change the value if necessary.
N1D10001
Unloadme directive
When the UnloadMe directive is set to 1, NetInsight attempts to unload the data conduit when it is no longer needed. Unloading a dynamically loaded library may cause problems on some systems. If this is the case, set this directive to 0 to instruct NetInsight not to unload the data conduit, leaving it to be unloaded by the system when the process exits. The UnloadMe directive may be commented out in the data conduit's configuration file. If you want to change the directive's default setting and the directive is commented out, remove the pound sign (#) from the line and change the value if necessary.
Version 8.2.1
353
N10B55
17 Working with UserDefined Processes DefinedProcesses

N1D20001
About user-defined processes How Unica NetInsight runs user-defined processes To configure Unica NetInsight to run a user-defined process About the <userdefinedprocesses> and <process> elements Creating generic processes for multiple profiles User-defined process examples User-defined processes and database permissions
About user-defined processes

User-defined processes are procedures you can create to perform additional database tasks when a Unica NetInsight profile is updated. For example, you might create a userdefined process to update visit cost information, populate data model extension tables, or tweak database objects for better reporting performance. You can create multiple user-defined processes for a single profile, allowing users to break down individual tasks into individual user-defined processes. User-defined processes are stored in text files that contain one or more SQL statements. References to the text files are added to the Unica NetInsight profile configuration file in the <userdefinedprocesses> XML elements.
N1D30001
354
How Unica NetInsight runs user-defined processes
How Unica NetInsight runs user-defined processes

Unica NetInsight runs user-defined processes during specified phases of a profile update. After Unica NetInsight imports new data, it checks the profile's configuration file for user-defined processes. It then runs the user-defined processes one at a time in the order they are listed subject to the phase at which they are specified to run (for example, post-import or post-sampling). If no errors are encountered, Unica NetInsight then moves on to visitor profiling. User-defined processes will only run if new data has been imported. If no new data is detected at update, user-defined are not run. If Unica NetInsight encounters an error when running a user-defined process it displays an error message and halts the update. If you want certain errors to be ignored, wrap the user-defined process in a stored procedure with its own error handling capabilities. When an update halts, the profile's reports will not be available until you resolve the error and run the update again. When Unica NetInsight resumes an update after a user-defined process error, it re-runs all user-defined processes, even those that completed successfully during the failed update. If you want a user-defined process to run only once per data import, the process should use transactions and other logic to side-step this behavior. Each profile has a userdefinedprocess.log file that contains the statistics on any userdefined processes. The log file is overwritten during every import.
N1D40001
To configure Unica NetInsight to run a userdefined process

1. Create a text file containing the SQL queries that define the process. The file's content must meet the following formatting criteria: Queries must end in a semi-colon (;). Each line must contain only one query. Queries may span multiple lines, but a line cannot contain two queries. Comment lines must start wtih two hyphens (--). Comment lines will not be executed or appended to a query. Calls to Oracle stored procedures must be wrapped in begin and end statements and cannot be not used in EXECUTE statements. Raw SELECT statements cannot be used. Instead, include SELECT statements in INSERT, UPDATE, CREATE, or DROP statements or in stored procedures. (Raw SELECT statements result in a database error because they open a resultset without telling the database what to do with the results.)
White space lines are allowed and will be skipped.

Version 8.2.1 355
17 - Working with User-Defined Processes
2. Save the file to a location Unica NetInsight can access, such as the Unica NetInsight program directory. 3. For each profile against which you want the process to run, open its configuration file and use the <userdefinedprocesses> and <process> elements to specify when userdefinedprocesses> process> the process should run and the path to its text file. For example:
<userdefinedprocesses> <process phase="postimport" type="sql">postimport.sql</process> <process phase="postupdate" type="sql">postupdate.sql</process> </userdefinedprocesses>
For the value for <process>, specify the path and name of the process's text file. If process> the file is located in the Unica NetInsight program directory you do not need to specify the path.
N1D50002
About the <userdefinedprocesses> and userdefinedprocesses> <process> elements process>

To add user-defined processes to a profile, in the profile's configuration file use the <userdefinedprocesses> element to specify the list of processes. This element has no userdefinedprocesses> attributes or value. Use the child element <process> to specify each process. Processes run in the order process> they are listed, subject to their execution phase. The <process> element has two process> attributes.
Attribute phase Description Possible values
When to execute this process postaggregate: After aggregate reports are generated. postimport: After an -import command runs or Update is run from the NetInsight interface. postsamplinglevel: After the import phase of sampling completes but while NetInsight is still in sampling mode. postupdate: After an -update command runs or Update is run from the NetInsight interface.
type
N1D60001
Type of process
sql
356
Creating generic processes for multiple profiles
Creating generic processes for multiple profiles

To facilitate the creation of processes that work for multiple profiles, Unica NetInsight recognizes the token %PROFILE_ROOT%. When NetInsight encounters this token in a process's SQL, it replaces it with the short profile name of the current profile.
N1D70001
User-defined process examples

A generic user-defined process
This example shows a user-defined process that can be used with any profile. The userdefined process logs the following data for each update into a central repository: Profile root Date Maximum VisitorID Maximum VisitID Maximum ViewID Maximum EventID
With SQL Server To use this user-defined process with SQL Server, you first need to create the ProfileUpdates table using the following specifications:
CREATE TABLE ProfileUpdates ( DateOfUpdate DATETIME NOT NULL, ProfileRoot VARCHAR(255) NOT NULL, VisitorID BIGINT NOT NULL, VisitID BIGINT NOT NULL, ViewID BIGINT NOT NULL, EventID BIGINT NOT NULL );
Next, create a file named UDP_SQL_Server.txt in the Unica NetInsight directory. Place the following text in this file:
BEGIN TRANSACTION; INSERT INTO ProfileUpdates( DateOfUpdate, ProfileRoot, VisitorID, VisitID, ViewID, EventID) SELECT GETDATE(), '%PROFILE_ROOT%', (SELECT ISNULL(MAX(VisitorID), 0) FROM %PROFILE_ROOT%_VisitorID), (SELECT ISNULL(MAX(VisitID), 0) FROM %PROFILE_ROOT%_Visits), (SELECT ISNULL(MAX(ViewID), 0) FROM %PROFILE_ROOT%_Views), (SELECT ISNULL(MAX(EventID), 0) FROM %PROFILE_ROOT%_Events);
Version 8.2.1
357
17 - Working with User-Defined Processes COMMIT TRANSACTION;
Now, add the UDP_SQL_Server.txt file to the profile's configuration file, and Unica NetInsight will start logging information about each update.
With Oracle
To use this user-defined process with Oracle, you first need to create the ProfileUpdates table under the Unica NetInsight user's schema using the following specifications:
CREATE TABLE ProfileUpdates ( DateOfUpdate DATE NOT NULL, ProfileRoot VARCHAR(255) NOT NULL, VisitorID NUMBER NOT NULL, VisitID NUMBER NOT NULL, ViewID NUMBER NOT NULL, EventID NUMBER NOT NULL );
Next, create the following stored procedure under the Unica NetInsight user's schema:
CREATE OR REPLACE PROCEDURE Log_Profile_Update (Profile VARCHAR) IS BEGIN COMMIT; SET TRANSACTION NAME 'ProfileUpdate'; INSERT INTO ProfileUpdates SELECT CURRENT_DATE, 'unica', (SELECT NVL(MAX(VisitorID), 0) FROM unica_VisitorID), (SELECT NVL(MAX(VisitID), 0) FROM unica_Visits), (SELECT NVL(MAX(ViewID), 0) FROM unica_Views), (SELECT NVL(MAX(EventID), 0) FROM unica_Events) FROM DUAL; COMMIT; END;
Finally, create a file named UDP_Oracle.txt in the Unica NetInsight directory. Place the following text in this file:
BEGIN Log_Profile_Update( '%PROFILE_ROOT%' );END;;
Now, add the UDP_Oracle.txt file to the profile's configuration file, and Unica NetInsight will start logging information about each update.
358
User-defined processes and database permissions
A user-defined process to populate the VisitCost table

This user-defined process populates the profile's VisitCost table under the assumption that every view in a visit costs .001 dollars.
INSERT INTO %PROFILE_ROOT%_VisitCost SELECT VisitID, (0.001 * Views), VisitorID, FirstViewDateTime, FirstViewDate FROM %PROFILE_ROOT%_Visits WHERE VisitID NOT IN (select VisitID from %PROFILE_ROOT%_VisitCost );
N1D80001
User-defined processes and database permissions

Depending on what tasks a user-defined process performs, you may need to grant the Unica NetInsight database user account additional database privileges. For example, the Unica NetInsight database user typically does not have "execute stored procedure" privileges. Unica NetInsight does not restrict which tasks can be performed within a user-defined process, so special care should be taken in setting the security permissions on the process's text files. If someone has write access to any of the user-defined process text files, that person can run any database command the Unica NetInsight database user can run. To reduce the possible impact of malicious changes to the user-defined process text files, limit the Unica NetInsight database user account to only those privileges it needs.
Version 8.2.1
359
N10B7A
18 Using Regular Expressions with NetInsight

N1D90002
About regular expressions Basics of regular expressions Metacharacters Metacharacter examples Special characters Special character examples Combining metacharacters Using regular expressions
About regular expressions

You can use regular expressions when setting profile options. Depending on the database you are using, you may also be able to use regular expressions when setting filters for reports. This lets you find specific report data quickly and accurately. The syntax is similar to that used in Perl. If you are unfamiliar with regular expression syntax, there are many tutorials on the Internet.
N1DA0002
360
Basics of regular expressions
Basics of regular expressions

A regular expression is a way of specifying a pattern in a text string. For example, if you specify the pattern somephrase the regular expression rules matching engine finds any instance of the text somephrase in the field you are searching. It matches somephrase, somephrases, abcsomephrase123, and Here is somephrase. To cite a more useful example, you can use regular expressions to generate a report on all requests for HTM and HTML files on your site. In the Included Pages option, enter the filter that match the regular expression htm This gives you a report on any page htm. that has htm in its file name. Assuming you have not used htm as anything other than a file extension, you will get a report on all requests for HTML files. The report will include requests for files ending with html because the string html includes the string htm. This assumes that either all your file names have lowercase extensions or that you have not enabled case-sensitivity in your profile options. (When case-sensitivity is not enabled, all pages, files, clips, and user names are imported as lowercase characters.
N1DB0002
Metacharacters
The real power of regular expressions is in the use of metacharacters. Metacharacters allow you to construct expressions that match specific text patterns in an extremely flexible way. The following table lists and describes the metacharacters.
Metacharacter . (period) ? Meaning Matches any one character no matter what the character is Matches the character immediately before it either zero times or one time Matches the character immediately before it any number of times including zero (the character may not be in the string at all) Matches the character immediately before it one or more times (the character must be in the string at least once) Indicates that the characters which follow are at the start of the string only Indicates that the characters which precede it are at the end of the string Matches any single decimal digit (0-9)
\d
Version 8.2.1
361
18 - Using Regular Expressions with NetInsight Metacharacter \D \s \S \w \W Meaning Matches any character that is not a decimal digit Matches a tab or space character Matches any character that is not a tab or a space Matches any letter, any digit, or the underscore character Matches any character which is not a letter, a digit, or the underscore Escape character allowing the use of any of the metacharacters with their regular keyboard meaning. For example, \. matches a period (.) in a regular expression. (A period (.) without a preceding escape character matches any one character no matter what the character is.)
N1DC0002
Metacharacter examples
The following table shows examples that illustrate the use of metacharacters.
Regular Expression up.own Matches uptown updown up own .exe aexe 123exe 1exejfg \.exe .exe prog.exe Backslash (\) tells the rules matching engine you are looking for a period, not using the period as a metacharacter. Question mark (?) matches both zero instances of b and one instance of b. Period (.) matches any character, even a space. Reason Period (.) matches any character, even a space.
ab?cdef
acdef abcdef abcdefg xyxacdefghij
362
Special characters Regular Expression ntcgi\?johnswift Matches ntcgi?johnswift Reason Backslash (\) tells the rules matching engine you are looking for a question mark, not using the question mark as a metacharacter. Asterisk (*) matches the c zero or more times.
abc*defg
abdefg abcdefg xyzabcdefghij abcccccdefg
abc+defg
abcdefg abccdefg xygabcdefghij abcccdefghij
Plus (+) matches the c one or more times.
free
free freedom innisfree
By default, text is matched wherever it is found in the text string.
^free
free freedom
Caret (^) only matches the beginning of the text string. Dollar sign ($) only matches at the end of the text string.
free$
free innisfree
N1DD0002
Special characters
In addition to metacharacters, you can use four other characters to indicate the relationships between various parts of the regular expression.
Character | Meaning Tells the rules matching engine to match the text to the left of the pipe or the text to the right of the pipe Contains a set of characters and tells the rules matching engine to match any character within that set Indicates that the part of the expression that is within the parentheses is to be considered as one unit
[]
()
Version 8.2.1
363
18 - Using Regular Expressions with NetInsight Character ^ [abc] Meaning Negates the set of characters in brackets so that text must contain a character at that point in the expression but it cannot be any of the characters inside the brackets
N1DE0002
Special character examples

The following table shows examples that illustrate the use of the special characters.
Example Matches Does Not Match Meaning
they (would | should)
they would they should they should have they would have
Parentheses and pipe indicate text must contain at least one instance of either would or should
[cz]one
cone zone
one
Brackets indicate either a c or a z must be present for a match Brackets indicate there must be a character at that point in the expression, but the caret indicates that character cannot be a, b, or c
[^abc]xyz
dxyz mxyz
axyz bxyz cxyz xyz
N1DF0002
Combining metacharacters
You can combine several metacharacters in one regular expression. One of the most common combinations is the period and asterisk (.*) which matches a string of any length including the null string.
Regular Expression .*\.cgi$ Matches any string ending in .cgi Reason The period and asterisk (.*) combination matches any string. The backslash (\) tells the matching rules engine to look for a period, not use the period as a metacharacter.
364
Using regular expressions Regular Expression .*.cgi$ Matches acgi thomcgi file.cgi Reason The second period is not preceded by a backslash (\), so it is being used as a metacharacter to match any one character no matter what the character is. A more compact form of writing the same pattern would be .+cgi.
N1E00002
Using regular expressions

You can use regular expressions when setting many options. Depending on your database type, you can use regular expressions to define filter groups or visitor profiles and when filtering reports. If regular expressions are not available, you can use the special characters for pattern matching supported by your database. For example, Unica NetInsight uses regular expressions heavily in both its browser and platform options. The following regular expression defines which user agents in your log files are classified as the Microsoft Internet Explorer Web browser:
^ Mozilla/.*MSIE (\d+\.)
To see this regular expression: 1) display a profile; 2) click the Options tab; 3) in the Options panel, select Visitors or Users > Browsers > Microsoft Internet Explorer > User Agents Agents. If a user agent in your log file matches the regular expression above, then the browser used by that user will be listed as Microsoft Internet Explorer in your Browser Summary. By breaking down the regular expression, you can see exactly what it is looking for.
Expression ^ Mozilla/ .* MSIE Meaning The string must start with the characters that follow (Mozilla/) The characters that must be at the beginning of the string The string must start with the characters that follow (Mozilla/) The next string of characters that must be present (including a space after the E) The contents of the parentheses are considered a single unit Matches any decimal digit
() \d
Version 8.2.1
365
18 - Using Regular Expressions with NetInsight Expression \. Meaning Modifies the \d so the rules matching engine looks for one or more digits
The above expression will match the following strings:

Mozilla/4.0 (compatible; MSIE 4.01; MSN 2.5; Windows 98) Mozilla/4.0 (compatible; MSIE 4.01; Windows 95) Mozilla/4.0 (compatible; MSIE 5.0; Windows 95; AIT; DigExt)
Because the regular expression includes information about the browser version (\d+\.), if you have selected the Append the version number check box for the browser, the first two strings above appear as Microsoft Internet Explorer 4 and the last string will appear as Microsoft Internet Explorer 5. Depending on your database type you can also use the That match the regular expression filter with a regular expression when filtering a report. For example, you could use the Custom Report Wizard to create a custom Page Summary that only contains data for visitors who were using NetBSD, FreeBSD, or OpenBSD, but not BSDI. You would need to enter That match the regular expression .*BSD$ as the complete platform filter. The period and asterisk (.*) allows a match on any characters that precede BSD in the string, but because of the dollar sign ($), the string must end in BSD. If you are interested in examining your server's performance when it calls CGI programs, you can use the Custom Report Wizard to create a custom Server Performance Summary with the filter That match the regular expression.*\.cgi$ (provided your CGI programs end with that extension). When you run the report, you will see only statistics on how your server performs when a CGI program is called.
366
N10BAA
19 NetInsight CommandLine Options LineOptions

N1E10001
About command-line options About regular expressions with command-line options Profile command-line options Administrative command-line options
About command-line options

Unica NetInsight includes a command-line interface that you can use to perform many functions. The command-line options are useful for automating the update process as well as maintaining profiles. For the profile command-line options, the term short_profile_name refers to the name that appears in parentheses in the Available profiles list in the Profile Manager. You can also display a list of the short profile names by using the command nettracker admin -list. The basic syntax for Profile options is:
nettracker [short_profile_name | all] -command
The all option performs the requested operation on all profiles. Otherwise, the operation is performed only on the specified profile. All parameters used with the command-line options are case-sensitive.
N1E20001
Version 8.2.1
367
19 - NetInsight Command-Line Options
About regular expressions with command-line options

You can use a regular expression to specify multiple profiles on which to operate. The syntax is:
nettracker "%regex" [options]
or:
nettracker admin -list "%regex"
where regex is a regular expression that identifies the profiles you want. If the percent sign (%) is not included, regex is not treated as a regular expression. When you use a regular expression, the actions indicated by the command-line options are carried out on all profiles whose names match the regular expression. It is important to test a regular expression for accuracy before you use it in an operation that affects data. Using the command nettracker admin -list "%regex" is a good way to test the regular expression to ensure that it matches only those profiles you want it to match. For example, before executing the first command below, run the second command to verify that the profiles matching the regular expression are correct:
nettracker "%customer.*" -update
nettracker admin -list "%customer.*"

N1E30001
Profile command-line options

368
-abort -addreport filename [-title newtitle] [-rptlist listname] [-rptfolder foldername] -alert -alerttask alertname -archive YYYYMM -archive YYYYMM,YYYYMM -checkdb -clear -compactdb filename -email -emailtask taskname -expiretitles

N1E30007
-forget log_filename -import -module -quiet -reaggregate -reanalyze -recalc -recipients list -regen -reindex -reindex-missing -remove YYYYMM or YYYYMMDD -remove YYYYMM,YYYYMM -reports -reprofile -resample -reseed seed_number -resolvetitles -samplecalc entity number -update
-abort
Aborts the profile. This kills the associated Unica NetInsight process and resets the profile. For all operations other than abort, a profilename.lck file is created in the profile data directory (install_directory/data/profilename/) and the contents of that file are the PID of the current process. When abort is run on a certain profile, it opens the profilename.lck file, if it exists, and attempts to kill the process with the PID found in the lock file. Importing of data is rolled back to the last checkpoint. If there is no Unica NetInsight process associated with this profile (in other words, there is no short_profile_name.lck file), this option has no effect. Example:
nettracker short_profile_name -abort
N1E50001
Version 8.2.1
369
-addreport filename [-title newtitle] [-rptlist listname] [rptfolder foldername]

Adds a previously defined custom report to the profile. The report definition XML file must exist in the Unica NetInsight install_directory/data/short_profile_name. The dimensions, filters, and metrics defined in the report must all exist in the profile into which the report is being added. If the report definition references invalid dimensions or metrics, the report is not added and you receive an error message. If the report definition references an invalid filter, the filter is ignored and the report is added. You can use the title, -rptlist, and rptfolder subcommand-line options with the addreport option, but they are not required. The title option specifies a report title to use instead of the one specified in the XML file that defines the report. The rptlist option specifies the report list to which Unica NetInsight should add the report. If you do not use the rptlist option, the report is added to the default report list for the profile. The rptfolder option specifies the folder in the report list to which Unica NetInsight should add the report. If you do not use the rptfolder option, the report is added to the Custom Analysis folder. Only the report filename is required. Example:
nettracker short_profile_name -addreport SomeReport.xml -title SomeTitle
N1E60001
-alert
Instructs Unica NetInsight to execute all email alerts that have been configured in the options for the profile specified. The Email option in the administrative options, and the Email Tasks and Email Alerts options in the profile options, must be configured correctly for email alerts to successfully execute. You can combine this option with the -email, -recalc, -recipients, -regen, and -update options. Reports are emailed at the conclusion of the -recalc, regen, or -update, assuming that the email alert threshold is met. Example:
nettracker short_profile_name -alert -update
N1E70001
-alerttask alertname
Instructs Unica NetInsight to execute the specified email alert. The Email option in the administrative options, and the Email Tasks and Email Alerts options in the profile options, must be configured correctly for the email alert to successfully execute.
370
If the alert name contains spaces, you must put the alert name in quotation marks. Example:
nettracker short_profile_name -alerttask SomeEmailAlert
N1E80001
-archive YYYYMM
Removes the given month from the database and archives the reports for that month. You cannot drill into reports for archived months. Removing the last month from your profile is equivalent to clearing all data from the profile. This includes removing all information concerning unique visitors, which influences the identification of new and repeat visitors when importing new data. Example:
nettracker short_profile_name -archive 200901
N1E90001
-archive YYYYMM,YYYYMM
Removes multiple months from the Unica NetInsight database and archives the reports for each listed month. (There should be no space after the comma that separates the months.) You cannot drill into reports for archived months. Removing all months from your profile is equivalent to clearing all data from the profile. This includes removing all information concerning unique visitors, which will influence the identification of new and repeat visitors when importing new data. Example:
nettracker short_profile_name --archive 200901,200902
N1EA0001
-checkdb
Checks the Unica NetInsight database to ensure that all necessary tables and indices exist. This command also outputs the disk usage of each table and index. If an index is missing, you can run the command nettracker short_ profile_name -reindex -missing to rebuild it.
Version 8.2.1
371
For DB2, MySQL, and Oracle, this command also checks the last analysis date for the statistics on each table and index. If the statistics on these tables and indices are out of date, you can run the command nettracker short_ profile_name -reanalyze to update them. If the user running the -checkdb option has the Select Catalog role for the Oracle database, Unica NetInsight also examines the HASH_AREA_SIZE and SORT_AREA_SIZE parameters of your database to ensure they are set appropriately. For SQL Server, this command also outputs the collation name for the tempdb and the database. This information appears at the end of the output. For example:
Verifying important database settings Collation for ntdb: Latin1_General_BIN Collation for tempdb: SQL_Latin1_General_CP1_CI_AS
Note that the output of this command is designed to be interpreted by a trained database administrator. Before making any changes to your database configuration or running any of the commands mentioned above, you should consult with your database administrator or Unica technical support. Example:
nettracker short_ profile_name -checkdb
N1EB0001
-clear
Removes all data from the Unica NetInsight database tables for the profile. After using this command, you must update the profile before you can use it again. Example:
nettracker short_profile_name -clear
N1EC0001
-compactdb filename
In Unica NetInsight for SQLite, reclaims available space within the given database file, or within all of the profile's database files if no file is specified. For <file> you should file> enter the full path and file name of the database file. Example (Windows):
nettracker short_profile_name -compactdb "C:\Program Files\ Unica NetInsight\data\short_profile_name\ nettracker.dat"
372
Example (UNIX):
nettracker short_profile_name -compactdb /usr/local/ Unica NetInsight/data/short_profile_name/ nettracker.dat
N1ED0001
-email
Instructs Unica NetInsight to perform all email tasks that have been configured in the options for the profile specified. (Tasks that have the Exclude from batch execution check box selected are not executed.) You must configure correctly both the Email Tasks option in the profile options and the Email options in the administrative options for email tasks to be executed successfully. You can combine this option with the -recalc, -recipients, -regen, and update options. Reports are emailed at the conclusion of the -recalc, -regen, or -update, assuming that task completes successfully. Example:
nettracker short_profile_name -email
N1EE0001
-emailtask taskname
Instructs Unica NetInsight to perform the specified email task. You must configure correctly both the Email Tasks option in the profile options and the Email options in the administrative options for email tasks to be executed successfully. If the task name contains spaces, you must put the task name in quotation marks. You can use the -recipients option to specify a list of recipients to use instead of the recipients specified in the task. Example:
nettracker short_profile_name -emailtask SomeEmailTask
N1EF0001
-expiretitles
Instructs Unica NetInsight to mark all page titles as expired. Page titles for any pages processed during subsequent updates are resolved the next time requests for them are processed, as if they had expired normally. Example:
Version 8.2.1 373
nettracker short_profile_name -expiretitles

N1F00001
-forget log_filename
Whenever Unica NetInsight processes a log file, it remembers that file by storing the first 900 bytes of the file, the file size, and the location that it left off in the file. As a result, if the file grows, Unica NetInsight processes only the new data. The -forget command tells Unica NetInsight to forget that it has already processed the log file. If you tell Unica NetInsight to forget a log file, it reprocesses the whole log file instead of picking up from where it left off. For <logfile> you should enter the full path and file name of the log file. Example (Windows):
nettracker short_profile_name -forget c:\logs\access.log
Example (UNIX):
nettracker short_profile_name -forget /logs/access.log
You can tell Unica NetInsight to forget multiple log files with a single command by using wildcards. The -forget option accepts a file specification, as long as it is a valid file specification according to the wildcard rules of the operating system on which Unica NetInsight is installed. Example (Windows):
nettracker short_profile_name -forget "c:\logs\ex0001*"
Example (UNIX):
nettracker short_profile_name -forget "/usr/local/apache/logs/access_log200001*"
N1F10001
-import
Imports new data for both Full and Sample modes without generating reports. You can use the sub-command-line option -nosample with -import. Example:
374
Profile command-line options nettracker short_profile_name -import
-nosample
Skips the sample phase of importing. The sample tables are not modified. Example:
nettracker short_profile_name -import -nosample
N1F20001
-module
Causes Unica NetInsight to forget or remove paid search integration module data for a profile. Use the module command with forget if you want to re-import previously imported paid search data (for example, if the data has changed subsequent to import). Data for the specified dates will not be removed from the Unica NetInsight database. It will be reimported at the next update. Use the module command with remove if you want to permanently remove paid search from the Unica NetInsight database (for example, to reduce the size of the database). The data will be removed and will not be re-imported during subsequent updates. You target data for the command by specifying a date or month. Multiple dates or months can be separated by commas. Do not use spaces between commas. You cannot target an entire year (other than by listing each of its months). You cannot target a date range (other than by listing each date in the range). Format for dates is YYYYMMDD. Format for months is YYYYMM. If you remove data that you later want to get back, use the module command with forget. Then run an update. Example: Forgetting data for specific dates This example will cause Unica NetInsight to forget paid search data for September 4, 5, and 6, 2009. Paid search data for these dates will be re-imported at the next update.
nettracker short_profile_name -module PSI -forget 20090904,20090905,20090906
Example: Forgetting data for specific months This example will cause Unica NetInsight to forget paid search data for September and October 2009. Paid search data for these months will be re-imported at the next update.
nettracker short_profile_name -module PSI -forget 200909,200910
Version 8.2.1
375
Example: Removing data for specific dates This example will remove paid search data from Unica NetInsight for September 4, 5, and 6, 2009. Paid search data for these dates will not be re-imported during subsequent updates.
nettracker short_profile_name -module PSI -remove 20090904,20090905,20090906
Example: Removing data for specific months This example will remove paid search data from Unica NetInsight for September and October. Paid search data for these dates will not be re-imported during subsequent updates.
nettracker short_profile_name -module PSI -remove 200909,200910
N1F30001
-quiet
Instructs Unica NetInsight not to print anything to standard output when performing command-line operations. Example:
nettracker short_profile_name -update -quiet
N1F40002
-reaggregate
Drops and recalculates the aggregate tables for both Full and Sample modes in the database. You can use the sub-command-line options -nosample, and -sampleonly. You can also specify an table name to target a specific aggregate table. This command does not re-import log files . Example:
nettracker short_ profile_name -reaggregate
-nosample
Skips the tables used for Sample mode. The sample tables are not modified. Example:
nettracker short_profile_name -reaggregate -nosample 376 Unica NetInsight - Administrator's Guide
-sampleonly
Drops and recalculates only those tables used for Sample mode. Non-sample tables are not modified. Example:
nettracker short_profile_name -reaggregate -sampleonly
Specifying a table name

Drops and recalculates a specific aggregate table. Can be used in conjunction with the -nosample and -sampleonly parameters. Example:
nettracker short_profile_name -reaggregate table_name -sampleonly
You can verify aggregate table name values by examining your installation's webaggdef.xml file located at netinsight_root/data .
N1F50001
-reanalyze
Forces an update of the analysis statistics on the Unica NetInsight tables and indices in an Oracle, MySQL, or DB2 database. Unica NetInsight automatically updates these statistics every 15 updates. Running the -reanalyze command does not reset this counter. This command has no effect if you are running Unica NetInsight with Microsoft SQL Server. SQL Server automatically updates the statistics it keeps on tables and indices in a database. Example:
nettracker short_profile_name -reanalyze
N1F60001
-recalc
Drops and recalculates the aggregate tables, report tables, and results tables for both Full and Sample modes in the database and then regenerates the corresponding report files for the defined pregenerated report range. You can use the sub-command-line options -nosample, -sampleonly and reportkey. This command does not re-import log files. Example:
nettracker short_profile_name -recalc Version 8.2.1 377
-nosample
Skips the tables used for Sample mode. The sample tables are not modified. Example:
nettracker short_profile_name -recalc -nosample
-sampleonly
Drops and recalculates only those tables used for Sample mode. Non-sample tables are not modified. Example:
nettracker short_profile_name -recalc -sampleonly
reportkey
Drops and recalculates only those tables used for a specific report. Can be used in conjunction with the -nosample and -sampleonly parameters. Example:
nettracker short_profile_name -recalc reportkey -sampleonly
You can verify report key values by examining your profiles rpttimes.log.
N1F70001
-recipients list
Specifies the email addresses that should receive the reports in one or more email tasks. For list, you should enter a comma-delimited list of email addresses, enclosed in quotation marks. (Spaces before or after the commas are ignored.) This list of addresses is used instead of the recipients specified in the email tasks. This option makes it easier to test email tasks and to send reports to different people at different times. Example (-email):
nettracker short_profile_name -email -recipients "bob@ Unica.com, joe@ Unica.com"
Example (-emailtask):
nettracker short_profile_name -emailtask SomeEmailTask recipients "bob@unica.com, joe@ unica.com"
N1F80001
378
-regen
Regenerates the associated HTML files for the profile or the administrative HTML pages if used with the -admin option. You can use this command to re-create the contents of the HTML directory for a profile if they were accidentally deleted. You can use the subcommand-line option -nosample with -regen. With the -admin option, this command is the same as the administrative command -clear. Example (profile):
nettracker short_profile_name -regen
Example (administrative):
nettracker -admin -regen
-nosample
Skips the HTML files used for Sample mode reports. Only reports for Full reporting mode are generated. Example:
nettracker short_profile_name -regen -nosample
N1F90001
-reindex
Rebuilds the Unica NetInsight database indexes, including any that are missing. Example:
nettracker short_profile_name -reindex
N1FA0001
-reindex-missing
Rebuilds only the missing Unica NetInsight database indexes. Example:
nettracker short_profile_name -reindex-missing
N1FB0001
-remove YYYYMM or YYYYMMDD

Removes the given date or month from the database.
Version 8.2.1 379
This option permanently deletes data from your database. If you think you might need the data again at some point in the future, you should ensure that you have copies of all of your log files before you remove the data. If your profile contains data for only one month, removing that month from your profile is equivalent to clearing all data from the profile. This includes removing all information concerning unique visitors, which will influence the identification of new and repeat visitors when importing new data. Examples:
nettracker short_profile_name -remove 20090625
nettracker short_profile_name -remove 200906

N1FC0001
-remove YYYYMM,YYYYMM
Removes multiple months from the database. (There should be no space after the comma that separates the months.) This option permanently deletes data from your database. If you think you might need the data again at some point in the future, you should ensure that you have copies of all of your log files before you remove the data. Removing all months from your profile is equivalent to clearing all data from the profile. This includes removing all information concerning unique visitors, which will influence the identification of new and repeat visitors when importing new data. Example:
nettracker short_profile_name -remove 200901,200902
N1FD0001
-reports
Selectively generates reports for which new data exists or whose content has changed since the last time report generation was run (for example, due to a change in the report's definition) . Both the query and HTML creation phases of report generation are run. You can use the -sampleonly or -nosample sub-command-line options to target only sampled or non-sampled reports. Based on your reporting needs, this can allow you to reduce the time spent on report generation. For example, if you import data every day but rely primarily on sampled reports throughout the week, you could generate sampled reports daily and non-sampled reports once a week. You can replace short_profile_name with all to update all the profiles.
380
Example:
nettracker short_profile_name -reports
-nosample
Sampled reports are not generated. Example:
nettracker short_profile_name -reports -nosample
-sampleonly
Non-sample reports are not generated. Example:
nettracker short_profile_name -reports -sampleonly
N1FE0001
-reprofile
Instructs Unica NetInsight to reapply the visitor profile definitions to the visitor data. The results of -reprofile do not appear on the reports until the profile is updated. Example:
nettracker short_profile_name -reprofile
N1FF0001
-resample
Clears the sample tables in the profile's database and repopulates the tables. Data in non-sample tables is not affected. After you run -resample, you should usually run the -recalc -sampleonly option to keep the sample reports in sync with the underlying sample data. Example:
nettracker short_profile_name -resample
N2000001
-reseed seed_number
Changes the sample seed value in the profile's configuration file. The seed value determines the random number generator algorithm that generates the data sample. The new seed value does not take affect until the profile is sampled.
Version 8.2.1 381
Example:
nettracker short_profile_name -reseed seed_number
N2010001
-resolvetitles
Instructs Unica NetInsight to immediately resolve page titles for all known pages. Example:
nettracker short_profile_name -resolvetitles
N2020001
-samplecalc entity number

Estimates the visitor sample percentage to specify in the profile options to create a sample of the specified number of the specified entity. Common entities are View, Visit, Event, and Visitor. The entity is case-sensitive. The profile needs to contain data before Unica NetInsight can estimate the sample size. This option returns a value that must be entered into the Visitor sample percentageSample % field in the profile options. Because the returned value is an estimate, the resulting data sample might not contain the exact number you specified. Example:
nettracker short_profile_name -samplecalc Visit 10000
N2030001
-update
Updates the profile. This imports any new log file data, updates the sample tables, and then generates all aggregates, dimension levels and bins, metrics and reports associated with the profile for both Full and Sample modes. You can use the subcommand-line options -nosample and -sampleonly with -update. You can replace short_profile_name with all to update all the profiles. Example:
nettracker short_profile_name -update
-nosample
Skips the sample phases of the update. Sample tables are not modified and the sample reports are not generated. Example:
Administrative command-line options
nettracker short_profile_name -update -nosample
-sampleonly
Processes only the sample phase of the report generation during the update. Nonsample reports are not generated. Example:
nettracker short_profile_name -update -sampleonly
N1E40001

N1E40007
-add -addlang pathname_for_language_pack -adduser user_name [-email emailaddress] [-fullname fullname] [-password password] [-role role] [-reportingmode reportingmode] -assignuser user_name short_profile_name {[-role role_name] | [-view view_name]} -changeuser user_name [-email emailaddress] [-fullname fullname] [password password] [-role role] [-reportingmode reportingmode] -clear -dbpasswd -delete short_profile_name -deleteuser user_name -dir dir -list or -list %regex -listroles -listusers short_profile_name [-explicit] -quiet -roleinfo role_name -userinfo user_name [-explicit]
-add
Adds a new profile. This command is similar in functionality to clicking Create Profile at the Profile Manager. You can use sub-command-line options with the -add option, but they are not required. Only the short profile name is required. Example: nettracker admin -add short_profile_name [sub-command-line options]
Version 8.2.1
383
-include<includepath> -include<includepath>
Includes only pages that start with <includepath>. This command-line option corresponds to the Included Pages option in the profile options. When you use this command-line option, you can only filter for pages that start with with.
-logpath<logpath> -logpath<logpath>
Specifies the full path to the log file and the file name or wildcard.
-logtype<logtype> -logtype<logtype>
Specifies the type of log file. 0=Auto detect (default) 1=Netscape Flexible 2=NCSA Common/Combined 3=W3C Extended 4=IIS Standard/Extended 5=Microsoft Proxy 6=WebSite 7=Gauntlet 8=IBM Firewall 9=Raptor Eagle 10=Open Market Extended 11=wu-ftpd 12=NcFTPd 13=CERFNet 14=Squid 15=Sidewinder 16=WatchGuard 17=RealSystem Server, Helix Universal Server 18=Cisco PIX
-name<name> -name<name>
Specifies the name of the profile. This is the same as the Profile title option that can be specified in General Options Options.
384
-password<password> -password<password>
This option will set the password, but does not enable password protection for any of the profile options. You can use the default template to enable password protection.
-template<template> -template<template>
Specifies the full path to the template file. If you do not specify the -template option, the default template file is used. The default location for the template file on UNIX is /usr/local/ Unica NetInsight/data/admin. The default location on Windows is C:\Program Files\ Unica NetInsight\data\admin. You can edit the default template file in the Profile Manager.
-type <profile type> type>

1=Web Server (the default and only option)
-url <url> url>

Specifies the URL. This is the same URL that you would otherwise enter in the General Options Options. The example command that follows creates a profile called test1 (based on a template named template1.cfg) that analyzes Netscape Flexible log files. The example uses the subcommand-line options -dir, -logpath, -logtype, and -template. Example (UNIX):
nettracker admin -add test1 -dir /usr/local/ Unica NetInsight -logpath /export/home/logs/access.log -logtype 1 -template /usr/local/Unica NetInsight/templates/template1.cfg
Example (Windows):
NetTracker.exe admin -add test1 -dir "c:\Program Files\ Unica NetInsight" -logpath c:\WinNT\System32\logfiles\W3CSV1\ex020531.log -logtype 1 -template "C:\Program Files\Unica NetInsight\templates\template1.cfg"
N2040001
-addlang pathname_for_language_pack
Adds the specified Unica NetInsight language pack, to support display of the user interface in multiple languages; each profile can be displayed in a different language if desired.
Version 8.2.1 385
Example:
nettracker admin -addlang c:\n73_fr.gz
N2050001
-adduser user_name [-email emailaddress] [-fullname fullname] [-password password] [-role role] [reportingmode reportingmode]
Adds the user with the specified name. This command is identical in functionality to creating a user in the administrative options. You can use one or more sub-commandline options, listed below, with the -adduser option, but they are not required. Only the user name is required. Example:
nettracker admin -adduser "Bob Smith"
-email email address

Specifies the email address for the user. Example:
nettracker admin -adduser "Bob Smith" -email bob@ Unica.com
-fullname "full name"

Specifies the full name of the user. If the full name contains spaces, you must enclose the name in quotation marks. Example:
nettracker admin -adduser "Bob Smith" -fullname "Bob Leonard Smith"
-password password
Adds the user with the specified password (the default password is blank). If a password is specified and Unica NetInsight is configured to authenticate users using an external database or the Web server, a warning message appears when you run the command. (A password is applicable for internal database authentication only.) Example:
nettracker admin -adduser "Bob Smith" -password a0s9d8
386
-reportingmode reportingmode
Specifies the default reporting mode for the user. The two possible values are full and sample. Example:
nettracker admin -adduser "Bob Smith" -reportingmode sample
-role role_name
Specifies the default role for the user. Example:
nettracker admin -adduser "Bob Smith" -role _pwruser
For this option, use the name of the role (for example, nettracker admin adduser "Bob Smith" -role _pwruser) and not the title of the role (for example, do not use nettracker admin -adduser "Bob Smith" -role Power User). You can display a list of role names by using the command nettracker admin -listroles.
N2060001
-assignuser user_name short_profile_name {[-role short_profile_name role_name] | [-view view_name]}

Assigns the role or view (or both) to the specified user in the specified profile. This command is identical in functionality to assigning a role and/or a view to a user in the specified profile in the administrative options. You must use at least one sub-commandline option with the -assignuser option. Example: nettracker admin -assignuser "Bob Smith" short_profile_name view myview
-role role_name
Assigns the role to the specified user in the specified profile. Example:
nettracker admin -assignuser "Bob Smith" short_profile_name -role pwruser
For this option, use the name of the role (for example, nettracker admin assignuser "Bob Smith" short_profile_name -role _pwruser) and not the title of the role (for example, do not use nettracker admin -assignuser "Bob Smith" short_profile_name -role Power User). You can display a list of role names by using the command nettracker admin -listroles.
Version 8.2.1
387
-view view_name
Assigns the view to the specified user in the specified profile.
N2070001
-changeuser user_name [-email emailaddress] [fullname fullname] [-password password] [-role role] [reportingmode reportingmode]
Changes the specified user's password, default role, or default reporting mode (or any combination of these). This command is identical in functionality to changing a user's password, default role, or default reporting mode in the administrative options. If a password is specified and Unica NetInsight is configured to authenticate users using an external database or the Web server, a warning message appears when you run the command. (A password is applicable for internal database authentication only.) You must use at least one sub-command-line option with the -changeuser option. Example:
nettracker admin -changeuser "Bob Smith"
-email email address

Changes the email address for the user. Example:
nettracker admin -changeuser "Bob Smith" -email bob@ Unica.com
-fullname "full name"

Changes the full name of the user. If the full name contains spaces, you must enclose the name in quotation marks. Example:
nettracker admin -changeuser "Bob Smith" -fullname "Bob Leo Smith"
-password password
Changes the specified user's password. Example:
nettracker admin -changeuser "Bob Smith" -password a0s9d8
388
-reportingmode reportingmode
Changes the specified user's default reporting mode. The two possible values are full and sample. Example:
nettracker admin -changeuser "Bob Smith" -reportingmode sample
-role role_name
Changes the specified user's default role. Example:
nettracker admin -changeuser "Bob Smith" -role _pwruser
For this option, use the name of the role (for example, nettracker admin changeuser "Bob Smith" -role _pwruser) and not the title of the role (for example, do not use nettracker admin -changeuser "Bob Smith" -role Power User). You can display a list of role names by using the command nettracker admin -listroles.
N2080001
-clear
Regenerates the top frame of the Profile Manager and the Unica NetInsight Homepage. This command is the same as the -admin -regen command Example:
nettracker admin -clear
N2090001
-dbpasswd
Changes the password used to connect to the Oracle, SQL Server, MySQL, or DB2 database. This command does not change the password on the database. It only changes the password that Unica NetInsight uses to connect to the database. When running this command you are prompted first to enter your old password and then to enter your new password. Example:
nettracker admin -dbpasswd Unica Unica NetInsight 8.0 - Copyright(c) 2009 Unica Corporation Changing the password for the database connection. Version 8.2.1 389
19 - NetInsight Command-Line Options Enter old password: old_password Enter new password: new_password Database password successfully changed.
N20A0001
-delete short_profile_name short_profile_name

Deletes the specified profile and all of its reports, removing it from the Profile Manager and also removing its associated directories. Example:
nettracker admin -delete short_profile_name
N20B0001
-deleteuser user_name
Deletes the specified user. Example:
nettracker admin -deleteuser "Bob Smith"
N20C0001
-dir dir
Specifies the Unica NetInsight program directory. The -dir option must be specified when executing Unica NetInsight from the command line outside of the Unica NetInsight program directory. The default program directory on UNIX is /usr/local/Unica NetInsight. The default program directory on Windows is C:\Program Files\ Unica NetInsight. If there are spaces in the program directory path, you must enclose the directory parameter in quotation marks. Example (Windows):
C:\Program Files\ Unica NetInsight\nettracker.exe all -update -dir "C:\Program Files\ Unica NetInsight"
Example (UNIX):
/usr/local/ Unica NetInsight/nettracker.exe all -update -dir usr/local/
390
Administrative command-line options Unica NetInsight/

N20D0001
-list or -list %regex

Lists the available profiles. This list of profiles is the same as the list that appears in the Profile Manager. You can use "%regex" immediately after -list to display a list of the profiles described by the regular expression. Example:
nettracker admin -list
N20E0001
-listroles
Lists the title and name of each role. This command is similar in functionality to viewing the title and name of a role in the administrative options. The role title can consist of one or more words. It appears in the list of roles in the administrative options and can be edited after it has been saved. The role name is one word and cannot be edited after it has been saved. Example:
nettracker admin -listroles
N20F0001
-listusers short_profile_name [-explicit] short_profile_name

Lists each user's effective role and default view for the specified profile. This command is similar in functionality to viewing a user's profile settings in the administrative options. You can use a sub-command-line option with the -listusers <short_profile_name> option, but it is not required. Only the short profile name is required. Example:
nettracker admin -listusers short_profile_name
-explicit
Includes only users with a role or default view explicitly assigned for the specified profile name. Example:
nettracker admin -listusers short_profile_name -explicit
Version 8.2.1
391

N2100001
-quiet
Instructs Unica NetInsight not to print anything to standard output when performing administrative command-line operations.
N2110001
-roleinfo role_name
Lists: 1. All profiles with the specified role as the default role 2. All users with the specified role as their default role 3. All users with the specified role explicitly assigned in a profile, along with the profile in which it is assigned For this option, use the name of the role (for example, nettracker admin roleinfo _pwruser) and not the title of the role (for example, do not use nettracker admin -roleinfo Power User). You can display a list of role names by using the command nettracker admin -listroles. Example:
nettracker admin -roleinfo _pwruser
N2120001
-userinfo user_name [-explicit]

Lists the specified user's effective role and default view for each profile. This command is similar in functionality to viewing a user's role and default view for each profile in the administrative options. You can use a sub-command-line option with the -userinfo option, but it is not required. Only the user name is required. Example:
nettracker admin -userinfo "Bob Smith"
-explicit
Includes only profiles in which the user has been explicitly assigned a role or default view. Example:
nettracker admin -userinfo "Bob Smith" -explicit
392
N10CD8
20 NetInsight Configuration Files

N2130002
About Unica NetInsight configuration files NetTracker.cfg: NetInsight Program Configuration File Web.cfg : Global Profile Configuration File
About Unica NetInsight configuration files

Unica NetInsight uses three configuration (.cfg) files to track profile options and other information. Configuration files are written in XML which you can read and edit directly. The program configuration file (NetTracker.cfg) contains information about your Unica NetInsight version and license. It is located in the Unica NetInsight root directory. (In Windows, the root directory is located in C:\Program Files\. In UNIX, the root directory is in /usr/local/.) The profile type configuration file (web.cfg) stores global profile configuration settings. It is stored in the NetInsight _root/data/admin directory. Each time you create a profile, Unica NetInsight creates a local profile configuration file for it. The local configuration file has the same base name as the new profile. It is stored in the NetInsight _root/data/profile_name directory.
N2140001
NetTracker.cfg: NetInsight Program Configuration File

About the Unica NetInsight configuration file activationkey adminbutton
393
Version 8.2.1
20 - NetInsight Configuration Files

394
adminemail authentication backgrounddrilldowns cachesize cgidir cgiextension cgiurl checkpointmegs database datastoredir dbconnect dbpassword dbsessionoptions dnsserver disablehtmlwithlinks email envvars helpurl homepagebutton htmldir htmlurl httpproxy indextablespace license locale logbrowsing logformats loginexpiration mailfrom mailserver maxcache maxcompletedperuser maxdnsrequests maxqueuedlines maxrunningglobal maxrunningperuser method network pagesize passiveftp

N2140007
pathsep platform plugin processlog element progdir reportinbox reportlimits reportsduringimport reportsduringupdate restrictprofilemanager resultsetretention runreportscheduler secure serialnumber source syncmode tempstore tempstoredir titleresolutiontimeout
About the Unica NetInsight configuration file

The program configuration file (NetTracker.cfg) contains all of the options available under Edit Administrative Options It also contains information about your version of and Options. your license. The first line in the file is the XML declaration, which specifies which version of XML the file is using. The first element in the file is <progoptions>. This element is an overall container progoptions> element. All other entries in the file must be after <progoptions> and before progoptions> </progoptions>. The <progoptions> element has two attributes. /progoptions> progoptions>
Attribute version type Definition Version of your product Edition of your product Possible values x.x.x ebl, ebd, ebm, ebo, ebs, ebn Default

N2160001
ebd = Unica NetInsight for DB2 ebm = Unica NetInsight for MySQL ebo = Unica NetInsight for Oracle
Version 8.2.1
395
activationkey
The <activationkey> element specifies the activation key for your license. This element activationkey> has no attributes and no child elements. This element must be contained by the <license> element. license>
Example
<activationkey>eval</activationkey>
N2170001
adminbutton
The <adminbutton> element sets the Enable Administration button option on the adminbutton> Advanced options page of the administrative options. If the element is present, the option is selected. If it is absent, the option is not selected. This element has no attributes, no child elements, and no value.
Example
<adminbutton/>
N2180001
adminemail
The <adminemail> element sets the Administrator's address option on the Email options adminemail> page of the administrative options. This element has no attributes and no child elements. It must be contained by the <email> element. email>
Example
<adminemail>bsmith@ Unica.com</adminemail>
N2190001
authentication
The <authentication> element is a container element for the user authentication child authentication> elements <loginexpiration>, <method>, <password>, <plugin>, <restrictprofilemanager>, loginexpiration> method> password> plugin> restrictprofilemanager> and <source>. The <authentication> element has no attributes and no value. source> authentication> The <password> element is only used when the authentication method is set to password> internal.
Example
<authentication> <loginexpiration>never</loginexpiration> 396 Unica NetInsight - Administrator's Guide
NetTracker.cfg: NetInsight Program Configuration File <method>internal</method> <password length="1" numerics="0" special="0"/> </authentication>
N21A0001
<restrictprofilemanager/>
backgrounddrilldowns
The <backgrounddrilldowns> element sets the Run drilldowns in background option on backgrounddrilldowns> the Advanced options page of the administrative options. If the element is present, the option is selected. If it is absent, the option is not selected. This element has no attributes, no child elements, and no value.
Example
<backgrounddrilldowns/>
N21B0001
cachesize
The <cachesize> element specifies the cache size, in number of database pages, to be cachesize> used by SQLite. The <cachesize> element has no attributes and no child elements. It cachesize> must be contained by the <database> element. The value of the <cachesize> element database> cachesize> is the size of the cache in terms of a number of database pages. The default is 2000. This element applies only to Unica NetInsight for SQLite.
Example
<cachesize>2500</cachesize>
N21C0001
cgidir
The <cgidir> element specifies the path for the Unica NetInsight CGI-BIN directory. The cgidir> directory must be set up as a CGI-BIN directory within your Web server software. The <cgidir> element has no attributes and no child elements. This element must be cgidir> contained by the <platform> element. platform>
Example
<cgidir>c:\inetpub\scripts\ Unica NetInsight\</cgidir>
N21D0001
Version 8.2.1
397
cgiextension
The <cgiextension> element specifies the file extension used for CGI files. For cgiextension> Windows, the extension is .exe. For UNIX, the extension is .cgi. The <cgiextension> cgiextension> element has no attributes and no child elements. This element must be contained by the <platform> element. platform>
Example
<cgiextension>exe</cgiextension>
N21E0001
cgiurl
The <cgiurl> element specifies the URL that corresponds to the CGI-BIN directory. The cgiurl> <cgiurl> element has no attributes and no child elements. This element must be cgiurl> contained by the <platform> element. platform>
Example
<cgiurl>http://www.unica.com/scripts/ Unica NetInsight/</cgiurl>
N21F0001
checkpointmegs
The <checkpointmegs> element specifies the interval at which Unica NetInsight stores checkpointmegs> all processed data in the database. The interval must be specified in megabytes of data processed. The default is 125, meaning Unica NetInsight stores data in the database each time it has processed 125 MB of data. This element has no attributes and no child elements. It must be contained by the <database> element. database>
Example
<checkpointmegs>150</checkpointmegs>
N2200001
database
The <database> element is a container element for the database settings elements database> <maxcache>, <dbconnect>, <dbpassword>, <checkpointmegs>, <indextablespace>, maxcache> dbconnect> dbpassword> checkpointmegs> indextablespace> <dbsessions>, <datastoredir>, <pagesize>, <cachesize>, <syncmode>, <tempstore>, dbsessions> datastoredir> pagesize> cachesize> syncmode> tempstore> and <tempstoredir>. The <database> element has no attributes and no value. tempstoredir> database>
398
Example
<database> <maxcache visits="512" views="4096" errors="1000" ids="503"/> <ctmemory>300</ctmemory> <ctsectors>64</ctsectors> </database>
N2210001
datastoredir
The <datastoredir> element specifies the directory in which to store temporary data files datastoredir> during import. The default value is the profile's data directory. The default data directory is , where Unica CustomerInsightUnica NetInsight is the Unica NetInsight program directory and short_profile_name is the profile name that appears in parentheses in the Available profile list. Do not modify this element without contacting technical support. This element is not present in the program configuration file unless you explicitly add it. Note that no corresponding option is available in the Unica NetInsight administrative options interface. This element has no attributes and no child elements. It must be contained by the <database> element. database>
Example
<datastoredir>Unica NetInsight/data/mywebprofile</datastoredir>
N2220001
dbconnect
The <dbconnect> element specifies the database connection string. This string is built dbconnect> during installation. Do not modify this element without contacting technical support. This element has no attributes and no child elements. It must be contained by the <database> element. database> This element does not apply to Unica NetInsight for SQLite.
Example
<dbconnect>DRIVER={SQL Server};UID=Unica NetInsight;PWD=%s; DATABASE=Unica NetInsight;SERVER=Unica NetInsight\ </dbconnect>
N2230001
Version 8.2.1
399
dbpassword
The <dbpassword> element specifies the password Unica NetInsight uses to connect to dbpassword> the database. You can change this element using the administrative commandline option -dbpasswd. This element has no attributes and no child elements. It must be contained by the <database> element. database>
Example
<dbpassword>c9b8MpJipwUU7M</dbpassword>
N2240001
dbsessionoptions
The <dbsessionoptions> element sets the Database session options option on the dbsessionoptions> Advanced options page of the administrative options. In general, you should not change the value for this element without contacting technical support. This element has no attributes and no child elements. It must be contained by the <database> element. database>
Example
<dbsessionoptions>sort_area_size = 1048576</dbsessionoptions>
N2250001
dnsserver
The <dnsserver> element sets the DNS server address option on the DNS page of the dnsserver> administrative options. This element has two attributes.
Attribute timeout Corresponding option Reverse DNS timeout Possible values Any numeric value from 2 to 7200 Any numeric value from 0 to 100 Default 3
retries
Reverse DNS retries
The <dnsserver> element has no child elements. It must be contained by the <network> dnsserver> network> element.
Example
<dnsserver timeout="10" retries="10"> 172.16.45.2 </dnsserver>
N2260001
400
disablehtmlwithlinks
The <disablehtmlwithlinks> element specifies that the Web Browser, with links (.html) disablehtmlwithlinks> format is not available in the list of formats for reports sent via email. This element has no attributes, no value, and no child elements. This element is not present in the Unica NetInsight program configuration file unless you explicitly add it. Note that no corresponding option is available in the Unica NetInsight administrative options interface. When the <disablehtmlwithlinks> element is present in the Unica NetInsight program disablehtmlwithlinks> configuration file: The Web Browser, with links (.html) option will not appear in the Format of reports drop-down list. This list is located on these windows and pages: Email option pop-up window (this window appears when you click the Email icon in the main interface) Email Tasks Email task description page (this page appears when you edit an email task) Custom Report Wizard Emailing the Report page (this page appears when you click Email on the Custom Report Wizard Report Summary page)
The default option in the Format of reports drop-down list is Web Browser, without links (.html) (.html). An email task that was previously configured to use the Web Browser, with links format will continue to use that format; however, when you edit the email task, the default value of the Format of reports drop-down list is Web Browser, without links (.html) (.html).
Example
<disablehtmlwithlinks/>
N2270001
email
The <email> element is a container element for the email settings elements: email> <mailserver>, <mailfrom>, and <adminemail>. The <email> element has no attributes mailserver> mailfrom> adminemail> email> and no value.
Example
<email> <mailserver port="25">mail.unica.com</mailserver> <mailfrom>Unica NetInsight @unica.com</mailfrom> </email>
Version 8.2.1
401

N2280001
envvars
The <envvars> element specifies the environment variables that should be set when envvars> Unica NetInsight starts. This list appears on the Environment Variables page. The <envvars> element has no attributes and no value. Specify the environment variables envvars> using the child element <envvar>. The <envvar> element has one attribute. envvar> envvar>
Attribute name Corresponding option Name of variable Possible values Any environment variable name Default
Example
<envvars> <envvar name="ORACLE_HOME"> /home/oracle/u01/app/oracle/product/8.1.5 </envvar> <envvar name="NLS_LANG"> AMERICAN_AMERICA.WE8ISO8859P1 </envvar> </envvars>
N2290002
helpurl
The <helpurl> element directs the links in the Help menu to a server of your choosing. If helpurl> it is missing (the default), the links in the Help menu automatically point to Unica's hosted documentation server. Typically you would only add this element if your network does not have internet access and as a result you need to install the Unica NetInsight documentation on your corporate intranet.
Example
<helpurl>http://somedocserver.mydomain.com</helpurl>
N22A0001
homepagebutton
The <homepagebutton> element sets the Enable InsightNetInsightHomepage button homepagebutton> option on the Advanced options page of the administrative options. If the element is present, the option is selected. If it is absent, the option is not selected. This element has no attributes, no child elements, and no value.
Example
<homepagebutton/> 402 Unica NetInsight - Administrator's Guide

N22B0001
htmldir
The <htmldir> element specifies the path for the Unica NetInsight HTML directory. The htmldir> directory must be under the document root for your Web server. The <htmldir> element htmldir> has no attributes and no child elements. This element must be contained by the <platform> element. platform>
Example
<htmldir>c:\inetpub\wwwroot\Unica NetInsight \</htmldir>
N22C0001
htmlurl
The <htmlurl> element specifies the URL that corresponds to the HTML directory. The htmlurl> <htmlurl> element has no attributes and no child elements. This element must be htmlurl> contained by the <platform> element. platform>
Example
<htmlurl>http://www.unica.com/Unica NetInsight/</htmlurl>
N22D0001
httpproxy
The <httpproxy> element sets the HTTP proxy server option on the Proxies page of the httpproxy> administrative options. This element has one attribute.
Attribute port Corresponding option HTTP proxy server port Possible values Any number Default
The <httpproxy> element has no child elements. It must be contained by the <network> httpproxy> network> element.
Example
<httpproxy port="80">172.16.96.7</httpproxy>
N22E0001
indextablespace
The <indextablespace> element specifies the name of the tablespace (filegroup in SQL indextablespace> Server) where the indices are stored. Do not modify the value of this element without contacting technical support. This element has no attributes and no child elements. It must be contained by the <database> element. database>
Version 8.2.1 403
Example
<indextablespace>INDX</indextablespace>
N22F0001
license
The <license> element is a container element for the license settings elements: license> <serialnumber> and <activationkey>. The <license> element has no attributes and no serialnumber> activationkey> license> value.
Example
<license> <serialnumber>eval</serialnumber> <activationkey>eval</activationkey> </license>
N2300001
locale
The <locale> element customizes the administrative interface for your locale. If the locale> element is missing, the defaults are used. This element has four attributes; each one corresponds to an option on the Locale options page in the administrative options.
Attribute timeformat dateformat charset Corresponding option Display time as Display date as Character set Possible values 12hr, 24hr mdy, dmy, ymd latin1, latin2, sjis, big5, gb2312, euckr, user Default 12hr mdy latin1
language
Language
Two-character language en identifier
This element has no child elements and no value.
Example
<locale timeformat="12hr" dateformat="mdy" charset="latin1" language="en"/>
N2310001
404
logbrowsing
The <logbrowsing> element sets the Enable log file browsing option on the Advanced logbrowsing> options page of the administrative options. If the element is present, the option is set. If it is missing, the option is not set. This element has no attributes, no child elements, and no value.
Example
<logbrowsing/>
N2320001
logformats
The <logformats> element contains a list of custom log formats. This list displays on the logformats> Custom Log Formats page of the administrative options. The <logformats> element has logformats> no attributes and no value. Use the child element <logformat> to specify the actual logformat> formats. The value of the <logformat> element is the name of the format. This element logformat> has one attribute.
Attribute format Corresponding option Log format Possible values Any valid log format* Default
* For details on valid log formats, including mandatory field identifiers, see the Unica NetInsight User's Guide or online help.
Example
<logformats> <logformat format="%HOST% %IDENT% %USERNAME% [%DATETIME%] "%REQUEST%" %STATUS% %BYTES% "%REFERRER%" "%USERAGENT%" "%SANECOOKIE%" %SANESTOP% %TIMETAKEN%"> NCSA Combined plus plug-in </logformat> </logformats>
N2330001
loginexpiration
The <loginexpiration> element sets the Logins expire option on the Authentication page loginexpiration> of the administrative options. The possible values are never and session. The default is never. This element has no attributes and no child elements. It must be contained by the <authentication> element. authentication>
Version 8.2.1
405
Example
<loginexpiration>never</loginexpiration>
N2340001
mailfrom
The <mailfrom> element sets the From address option on the Email page of the mailfrom> administrative options. This element has no attributes and no child elements. It must be contained by the <email> element. email>
Example
<mailfrom> Unica NetInsight@unica.com</mailfrom>
N2350001
mailserver
The <mailserver> element sets the Mail server (SMTP) option on the Email page of the mailserver> administrative options. This element has one attribute.
Attribute port Corresponding option Mail server port Possible values Any number up to 65,535 Default 25
Example
<mailserver port="25">mail.unica.com</mailserver>
N2360001
maxcache
The <maxcache> element specifies how database items will be cached on the client. maxcache> This element has five attributes.
Attribute visits Corresponding option Possible values Default 61440
Number of hash buckets Any number equal to or used when caching vis- greater than 2 its Number of views to store before forcing a checkpoint Any number equal to or greater than 0
views
406
NetTracker.cfg: NetInsight Program Configuration File Attribute errors Corresponding option Number of errors to store before forcing a checkpoint Possible values Any number equal to or greater than 2* Default 0
ids
Number of hash buckets Any number equal to or used when caching IDs greater than 2* The amount of memory (in MB) to be used for cached elements Any number equal to or greater than 10
15013
maxdb
* This value should be a prime number for optimal performance. The <maxcache> element has no value and no child elements. It must be contained by maxcache> the <database> element. database>
Example
<maxcache visits="512" views="0" errors="0" ids="503"/>
N2370002
maxcompletedperuser
The <maxcompletedperuser> element specifies the maximum number of reports with maxcompletedperuser> the status of Canceled by Admin, Completed, or Failed that a user is allowed to retain in the Inbox. This element has no attributes and no child elements. It must be contained by the <reportinbox> element. The value of the <maxcompletedperuser> element is the reportinbox> maxcompletedperuser> number of reports. The default value is 100.
Example
<maxcompletedperuser>50</maxcompletedperuser>
N2380001
maxdnsrequests
The <maxdnsrequests> element sets the Maximum simultaneous DNS requests option maxdnsrequests> on the DNS page of the administrative options. The default is 2000. This element has no attributes and no child elements.
Example
<maxdnsrequests>1000</maxdnsrequests>
N2390001
Version 8.2.1
407
maxqueuedlines
The <maxqueuedlines> element specifies how many log file lines are queued for the maxqueuedlines> import process. The import process is comprised of two separate threads: the parser and the loader. The <maxqueuedlines> element has two attributes. maxqueuedlines>
Attribute parser Corresponding option Number of log file lines queued for the parser Possible values Any number Default 0 (single CPU) 2000 (multiple CPUs) 10000
sorter*
Number of log file lines Any number sorted into chronological order
* This attribute only applies to logs in Netscape Flexible format, NCSA Common/Combined format, or a custom format. Setting an attribute to 0 turns off the corresponding thread. The <maxqueuedlines> element has no value and no child elements. maxqueuedlines>
Example
<maxqueuedlines parser="2000" sorter="10000"/>
N23A0002
maxrunningglobal
The <maxrunningglobal> element specifies the maximum number of reports with the maxrunningglobal> status of Running allowed in the system, regardless of who requested them. This element has no attributes and no child elements. It must be contained by the <reportinbox> element. The value of the <maxrunningglobal> element is the number of reportinbox> maxrunningglobal> reports. The default value is 200. A value of 0 means there is no limit.
Example
<maxrunningglobal>10</maxrunningglobal>
N23B0002
maxrunningperuser
The <maxrunningperuser> element specifies the maximum number of reports with the maxrunningperuser> status of Running allowed per user. This element has no attributes and no child elements. It must be contained by the <reportinbox> element. The value of the reportinbox> <maxrunningperuser> element is the number of reports. The default value is 5. A value maxrunningperuser> of 0 means there is no limit.
408
Example
<maxrunningperuser>5</maxrunningperuser>
N23C0001
method
The <method> element sets the Authenticate using option on the Authentication page of method> the administrative options. The possible values are external, internal, webserver, and Unica. The default is internal. This element has no attributes and no child elements. It must be contained by the <authentication> element. authentication>
Example
<method>external</method>
N23D0001
network
The <network> element is a container element for the network settings elements: network> <httpproxy>, <dnsserver>, and <passiveftp>. The <network> element has no attributes httpproxy> dnsserver> passiveftp> network> and no value.
Example
<network> <httpproxy port="80">172.16.96.7</httpproxy> <dnsserver>172.16.45.2</dnsserver> </network>
N23E0001
pagesize
The <pagesize> element specifies the page size to be used for newly created SQLite pagesize> profile data files. This page size will not apply to miscellaneous SQLite data file used elsewhere within Unica NetInsight. The <pagesize> element has no attributes and no pagesize> child elements. It must be contained by the <database> element. The value of the database> <pagesize> element is the size of the page in number of bytes. (The number must be a pagesize> power of two.) The default is 1024. This element applies only to Unica NetInsight for SQLite.
Example
<pagesize>512</pagesize>
N23F0001
Version 8.2.1
409
passiveftp
The <passiveftp> element sets the Use passive mode FTP option on the Proxies passiveftp> Settings page of the administrative options. If the element is present, the option is set. If it is missing, the option is not set. This element has no attributes, no child elements, and no value. It must be contained by the <network> element. network>
Example
<passiveftp/>
N2400001
pathsep
The <pathsep> element specifies the character used to separate directories in file pathsep> paths. For Windows, the character is a backward slash (\). For UNIX, the character is a forward slash (/). The <pathsep> element has no attributes and no child elements. This pathsep> element must be contained by the <platform> element. platform>
Example
<pathsep>\</pathsep>
N2410001
platform
The <platform> element is a container element for the platform settings elements: platform> <progdir>, <htmldir>, <htmlurl>, <cgidir>, <cgiurl>, <pathsep>, <cgiextension>, and progdir> htmldir> htmlurl> cgidir> cgiurl> pathsep> cgiextension> <linefeeds>. The <platform> element has no attributes and no value. linefeeds> platform>
Example
<platform> <progdir>c:\Program Files\Unica NetInsight\</progdir> <htmldir>c:\inetpub\wwwroot\Unica NetInsight\</htmldir> <htmlurl>http://www.unica.com/Unica NetInsight/</htmlurl> <cgidir>c:\inetpub\scripts\Unica NetInsight\</cgidir> <cgiurl>http://www.unica.com/scripts/Unica NetInsight/</cgiurl> <pathsep>\</pathsep> <cgiextension>exe</cgiextension> <linefeeds>lf</linefeeds> </platform>
N2420001
410
plugin
The <plugin> element specifies the plug-in to be used to perform external authentication plugin> and/or retrieve a user's full name and email address. The value must be a path and file name for an NTDI API plug-in capable of performing external authentication. This element has one attribute.
Attribute conf Corresponding option Possible values Default
Full path to conduit con- Path and file name of fig the configuration file to be passed to the plug-in
This attribute has no child elements. It must be contained by the <authentication> authentication> element.
Example
<plugin conf="./ldapauth.conf">./ldapauth.so</plugin>
N2430002
processlog element
The <processlog> element enables Unica NetInsight process logging. It is present processlog> (process logging enabled) by default.
Example
<processlog/>
N2440001
progdir
The <progdir> element specifies the path for the Unica NetInsight program directory. The <progdir> element has no attributes and no child elements. This element must be progdir> contained by the <platform> element. platform>
Example
<progdir>c:\Program Files\Unica NetInsight\</progdir>
N2450002
reportinbox
The <reportinbox> element is a container element for the <maxrunningperuser>, reportinbox> maxrunningperuser> <maxrunningglobal>, <maxcompletedperuser>, and <runreportscheduler> element. The maxrunningglobal> maxcompletedperuser> runreportscheduler> <reportinbox> element has no attributes and no value. reportinbox>
Version 8.2.1 411
Example
<reportinbox> <maxrunningperuser>5</maxrunningperuser> <maxrunningglobal>10</maxrunningglobal> <maxcompletedperuser>50</maxcompletedperuser> <runreportscheduler>true</runreportscheduler> </reportinbox>
N2460002
reportlimits
The <reportlimits> element is a container element for the sub-elements <reports> and reportlimits> reports> <rows>. It has no attributes or value of its own. rows> The <reports> element defines the maximum number of reports NetInsight will return in reports> a single calendar month in response to GetReportData requests received through its XML API. The default is one thousand. Once the specified limit is reached, subsequent requests will return an error. The <rows> element defines the maximum number of report rows NetInsight will return rows> in a single calendar month in response to GetReportData requests received through its XML API. The default is two million. Once the specified limit is reached, subsequent requests will return an error. Note that the number represents the sum total of rows returned from the database and therefore is not limited to actual report rows. For any month NetInsight recognizes whichever limit is reached first, <reports> or reports> <rows>. rows> Note that these limits are only enforced if the ondemand flag is set, meaning they do not pertain to Unica NetInsight Enterprise installations.
Example
<reportlimits> <requests>1000</requests> <rows>2000000</rows> </reportlimits>
N2470001
reportsduringimport
The <reportsduringimport> element sets the Enable reports during data import option on reportsduringimport> the Advanced options page. If this element is present, the option is selected. If it is absent, the option is not selected. This element has no attributes, no child elements, and no value. This element only applies to Unica NetInsight for Oracle and Unica NetInsight for Netezza.
412
Example
<reportsduringimport/>
N2480001
reportsduringupdate
The <reportsduringupdate> element sets the Enable reports during report generation reportsduringupdate> option on the Advanced options page. If this element is present, the option is selected. If it is absent, the option is not selected. This element has no attributes, no child elements, and no value. This element does not apply to Unica NetInsight for SQLite.
Example
<reportsduringupdate/>
N2490001
restrictprofilemanager
The <restrictprofilemanager> element sets the Restrict access to Profile Manager option restrictprofilemanager> on the Authentication options page. If this element is present, the option is selected. If it is absent, the option is not selected. This element has no attributes, no child elements, and no value. This element must be contained by the <authentication> element. authentication>
Example
<restrictprofilemanager/>
N24A0001
resultsetretention
The <resultsetretention> element specifies the length of time that a temporary data resultsetretention> table is to be retained. (Temporary data tables are generated when a user requests a custom report.) The length of time must be specified in seconds. The default value for Unica NetInsight is 900 seconds. A value of 0 specifies that the temporary data tables should not be retained and should be deleted immediately after they are first used. This element has no attributes and no child elements.
Example
<resultsetretention>800</resultsetretention>
N24B0002
Version 8.2.1
413
runreportscheduler
The <runreportscheduler> element sets the Run Queued Reports option on the runreportscheduler> Advanced options page of the Administrative options. This element has no attributes and no child elements. It must be contained by the <reportinbox> element. When the reportinbox> <runreportscheduler> element is set to true, the option is selected and the report runreportscheduler> scheduler runs. When the element is set to false, the option is cleared and no reports are generated.
Example
<runreportscheduler>true</runreportscheduler>
N24C0001
secure
This element applies only to installations on UNIX computers. It has no effect on Windows computers. The <secure> element causes any new profile-related directories to be created with secure> permissions of 755 (readable, writeable, and accessible by the owner and readable and accessible by anyone else) and any new profile-related data files to be created with permissions of 644 (readable and writeable by the owner and readable by anyone else). If this element is not present, new directories are created with permissions of 777 (readable, writeable, and accessible by any user) and new data files are created with permissions of 666 (readable and writeable by any user). This element has no attributes, no child elements, and no value.
Example
<secure/>
N24D0001
serialnumber
The <serialnumber> element specifies the serial number for your license of Unica serialnumber> NetInsight. This element has no attributes and no child elements. It must be contained by the <license> element. license>
Example
<serialnumber>eval</serialnumber>
N24E0001
414
source
The <source> element specifies the environment variable that supplies the user names source> for Web server authentication. This element has no attributes and no child element. The value of the element is the name of the environment variable that supplies the user names. If the <source> element is absent, the user names will come from the source> REMOTE_USER environment variable. This element must be contained by the <authentication> element. authentication>
Example
<source>HTTP_IV_USER</source>
N24F0001
syncmode
The <syncmode> element specifies how hard SQLite should try to ensure that data is syncmode> safely written to disk. This element has no attributes and no child elements. It must be contained by the <database> element. The value of the <syncmode> element is an database> syncmode> integer (0, 1, or 2) corresponding to a setting for the synchronous parameter in SQLite. The default value is 2. This element applies only to Unica NetInsight for SQLite. This element is present in the Unica NetInsight configuration file only if it has been manually set to a value other than the default.
Example
<syncmode>1</syncmode>
N2500001
tempstore
The <tempstore> element specifies where SQLite should store temporary tables and tempstore> indices. This element has no attributes and no child elements. It must be contained by the <database> element. The value of the <tempstore> element is an integer (0, 1, or database> tempstore> 2) corresponding to a setting for the temp_store parameter in SQLite. The default value is 0. This element applies only to Unica NetInsight for SQLite. This element is present in the Unica NetInsight configuration file only if it has been manually set to a value other than the default.
Version 8.2.1
415
Example
<tempstore>1</tempstore>
N2510001
tempstoredir
The <tempstoredir> element specifies the name of the directory in which SQLite will tempstoredir> create temporary tables and indexes. (Temporary files created by SQLite are unlinked immediately after they are created, so they will normally not be visible in the given directory.) If this element is not present, Unica NetInsight determines a location for the temporary files on its own. This element has no attributes and no child elements. It must be contained by the <database> element. The value of the <tempstoredir> element is a database> tempstoredir> directory path. This element applies only to Unica NetInsight for SQLite. This element is present in the Unica NetInsight configuration file only if it has been manually set to a value other than the default.
Example
<tempstoredir>C:\Temp\sqlite_temp</tempstoredir>
N2520001
titleresolutiontimeout
The <titleresolutiontimeout> element specifies how long Unica NetInsight waits for a titleresolutiontimeout> response from the Web server when resolving page titles. This element has no attributes and no child elements. The value of this element is the number of seconds Unica NetInsight should wait for a response from the Web server; the default is 4 seconds.
Example
<titleresolutiontimeout>6</<titleresolutiontimeout>
N2150002
Web.cfg : Global Profile Configuration File

416
About the global profile configuration file aggdeffile aggsrequired bannerads browsers
campaigns casesensitivepages casesensitiveusernames connection contentgroups converttimes cookielookup custommetrics dashboardsize daterange defaults departments dimensionlists dimensionsfile dirindexes dmpackages donotconverttimes dynamicpages element emailalerts emailtasks entity excludedagents excludedhosts excludedpages excludedparametervalues excludedusers filtergroups filterinstances filterlists ftpdebug hidelinks hostgroups hostlookup ignoredfields includedagents includedhosts includedpages includedparametervalues includedusers
417
Version 8.2.1

418
keywordrules levels linklength locale localkeywords logs maildebug maxpathlength member metriclists metricsfile module modules nodefaultautoupdate nodefaultautoupdatefull nodefaultautoupdatesample noimportreindex nonreportabledimensions notableanalysis ntadtrack ntdi ntlinktrack outdefext parameters password platforms precalcdates redirectscripts referrergroups reportlists resolvehosts referrergroups resolvetitles retrievebatchsize roledefaults rows sampling schemafile securityrealms seed

N215000B
segment servers sessionization siteurl spiders summarysize tagimages title titlelength titles unexcludedpages unresolvedtitles url urlsearchrules user userlookup variablesfile viewlist virtual visitorlookup visitorprofiles visitthreshold writebatchsize
About the global profile configuration file

The global profile configuration file (web.cfg) contains all of the default options available under the Edit Profile Options option. The first element in the file is <weboptions>. This a container element. All other entries weboptions> in the file must be within <weboptions>. weboptions>
N2530001
aggdeffile
The <aggdeffile> element specifies the file from which Unica NetInsight should read aggdeffile> aggregate definitions. This element has no attributes and no child elements. The value of the element is the filename of the aggregate definition file to use. The file must be located in the Unica NetInsight/data/directory. If this element is missing, Unica NetInsight uses the default aggregate definition file for the profile.
Example
<aggdeffile>myaggdefs.xml</aggdeffile> Version 8.2.1 419

N2540001
aggsrequired
The <aggsrequired> element specifies that an aggregate definition file must be loaded aggsrequired> successfully or an error will be generated. This element has no attributes, no child elements, and no value. If the element is present, an aggregate definition file must be loaded successfully. If the element is missing, no error will be generated if the aggregate definition file is missing.
Example
<aggsrequired/>
N2550001
bannerads
The <bannerads> element contains a list of banner ads you want to track. This list bannerads> appears on the Banner Ads page. The <bannerads> element has no attributes and no bannerads> value. Each banner ad is specified using the child element <bannerad>. The value of bannerad> the <bannerad> element is the name of the banner ad. The <bannerad> element has bannerad> bannerad> two attributes.
Attribute file url Corresponding option Full path of graphic URL to link to Possible values Any path Any URL Default
Example
<bannerads> <bannerad file="/graphics/bannerad1.jpg" url="http://www. Unica.com"> ACME banner ad </bannerad> </bannerads>
N2560001
browsers
The <browsers> element contains a list of the browser names that will appear in browsers> reports. This list appears on the Browsers page. The <browsers> element has no browsers> attributes and no value. Each browser is specified using the child element <browser>. browser> The <browser> element has two attributes and no value. browser>
420
Web.cfg : Global Profile Configuration File Attribute appendversion Corresponding option Append the version number Name of browser Possible values true, false Default false
name
Any alphanumeric characters
The individual members of each browser group are specified using the child element <member>. The value of the <member> element is the text used to determine if a member> member> browser is to be included in the group.
Example
<browsers> <browser name="America Online"> <member method="match_pattern"> ^Mozilla/.*AOLIWENG </member> <member method="starts_with">aolbrowser/</member> <member method="starts_with">IWENG/</member> </browser> <browser appendversion="true" name="Netscape Navigator"> <member method="match_pattern">^Mozilla/([01234]\.)</member> <member method="match_pattern"> ^Mozilla/[56789]\..*Netscape\d */(\d+.) </member> </browser> </browsers>
N2570001
campaigns
The <campaigns> element contains a list of all the campaigns you want Unica campaigns> NetInsight to track. This list appears on the Campaigns page. The <campaigns> campaigns> element has no attributes and no value. Each campaign is specified using the child element <campaign>. The <campaign> element has one attribute and no value. campaign> campaign>
Attribute name Corresponding option Name of campaign Possible values Any alphanumeric characters Default
Campaign channels are specified using the <channel> element. channel>
Example
<campaigns> <campaign name="Offer"> <channel name="checkdomain" type="bannerad"> <segment name="Ad Segment 1"> <member method="equals">promo</member> Version 8.2.1 421
20 - NetInsight Configuration Files </segment> <segment name="Ad Segment 2"> <member method="equals">demo</member> </segment> </channel> </campaign> </campaigns>
N2580001
casesensitivepages
The <casesensitivepages> element sets the Case sensitive pages option on the casesensitivepages> General options page. If the element is present, the option is selected. If it is absent, the option is not selected. This element has no attributes, no child elements, and no value.
Example
<casesensitivepages/>
N2590001
casesensitiveusernames
The <casesensitiveusernames/> element sets the Case sensitive user names option on casesensitiveusernames/> the General options page. If the element is present, the option is selected. If it is absent, the option is not selected. This element has no attributes, no child elements, and no value.
Example
<casesensitiveusernames/>
N25A0001
connection
The <connection> element is a container element for the information Unica NetInsight connection> needs to connect to an external module. This element must be contained by a <module> element. The <connection> element has no attributes and no value. Use the module> connection> child elements <url>, <user>, and <password> to specify the connection information. url> user> password>
Example
<connection>
<url>http://www.paidsearchintegrationserver.coml</url>
<user>Unica</user>
422
Web.cfg : Global Profile Configuration File <password>encryptedpassword</password>
</connection>
N25B0001
contentgroups
The <contentgroups> element contains a list of content groups that categorize the clips contentgroups> on your streaming media server. This list appears on the Content Groups page. The <contentgroups> element has no attributes and no value. Each content group is contentgroups> specified using the child element <contentgroup>. The <contentgroup> element has one contentgroup> contentgroup> attribute and no value.
Attribute name Corresponding option Name of content group Possible values Any alphanumeric characters Default
Use the child element <member> to specify the individual clips that are part of the member> content group. The value of the <member> element is the text used to determine which member> clips are in the group.
Example
<contentgroups> <contentgroup name="Concerts"> <member method="starts_with">/concerts</member> </contentgroup> <contentgroup name="Lectures"> <member method="starts_with">/lectures</member> </contentgroup> </contentgroups>
N25C0001
converttimes
The <converttimes> element sets the Convert dates and times to local timezone option converttimes> on the Advanced options page. If the element is present, the option is selected. If it is absent, the option is not selected. This element has no attributes, no child elements, and no value.
Example
<converttimes/>
N25D0001
Version 8.2.1
423
cookielookup
The <cookielookup> element sets the Cookie lookup URL option on the Lookup Scripts cookielookup> page. The value of the element is the script you want executed when the user clicks a cookie in the Cookie Summary If the element is missing, the option will be blank. This Summary. element has no attributes and no child elements.
Example
<cookielookup> http://host.domainname.com/scripts/weblookup.exe?cookie= </cookielookup>
N25E0001
custommetrics
The <custommetrics> element contains the list of custom metrics for the profile. This list custommetrics> appears on the Custom Metrics options page. This element has no attributes and no value. Specify each custom emtric using the child element <custommetric>. The custommetric> <custommetric> element has eight attributes. custommetric>
Attribute Corresponding Option Possible values Default
name
Name
Any alphanumeric characters filtered, multiinput
type
Select custom metric type Alignment Minimum twips Recommended twips Graphable Display percentage of total Precision
alignment mintwips recommendedtwips graphable percentage
left, right, center Any numeric value Any numeric value true, false true, false false false
precision
Any number from 1 to 8
The <custommetric> element can contain the child elements <displayname>, custommetric> displayname> <description>, <basemetric>, <filterinstances>, <metric1>, <metric2>, and <operation>. description> basemetric> filterinstances> metric1> metric2> operation> The <displayname> element specifies the title for the metric. This element has no displayname> attributes and no child elements. The value of the element is the metric title.
424
The <description> element specifies the description for the metric. The description description> appears as the text for the metric's column in the reports page help. This element has no attributes and no child elements. The value of the element is the metric description. The <basemetric> element specifies the metric that will provide the data to be basemetric> filtered for the current metric. This element only applies to <custommetric> elements custommetric> whose type attribute has a value of filtered. The <basemetric> element has no basemetric> attributes and no child elements. The value is the name of the base metric. The <filterinstances> element specifies the filters for the metric. This element only filterinstances> applies to <custommetric> elements whose type attribute has a value of filtered. For custommetric> details on the <filterinstances> element, see the document "Unica NetInsight filterinstances> Dimension and Metric Filters." The <metric1> element specifies the metric that you want to divide. This element metric1> only applies to <custommetric> elements whose type attribute has a value of custommetric> multiinput. The <metric1> element has no attributes and no child elements. The metric1> value of the element is the metric name. The <metric2> element specifies the metric by which you want to divide. This metric2> element only applies to <custommetric> elements whose type attribute has a value custommetric> of multiinput. The <metric1> element has no attributes and no child elements. The metric1> value of the element is the metric name. The <operation> element specifies the mathematical operation you want to apply to operation> the metrics specified by the <metric1> and <metric2> elements. The <operation> metric1> metric2> operation> element only applies to <custommetric> elements whose type attribute has a value custommetric> of multiinput.
Example
<custommetrics> <custommetric name="downloadspersession" type="multiinput" alignment="right" mintwips="2000" recommendedtwips="2000" graphable="true" precision="8"> <displayname>Downloads per Session</displayname> <metric1>downloads</metric1> <metric2>sessions</metric2> <operation>div_float</operation> </custommetric> <custommetric name="wdsessions" type="filtered" alignment="right" mintwips="775" recommendedtwips="1775" graphable="true" percentage="true"> <displayname>WeekDay Sessions</displayname> <description>The number of sessions during weekdays</description> <basemetric>sessions</basemetric> <filterinstances> <filterinstance type="dow"> <values> <value>2</value> <value>3</value> <value>4</value> <value>5</value> <value>6</value> </values> Version 8.2.1 425
20 - NetInsight Configuration Files </filterinstance> </filterinstances> </custommetric> </custommetrics>

N25F0001
dashboardsize
The <dashboardsize> element sets the Number of values per dashboard graph option dashboardsize> on the General options page. The default value is 5. This element has no attributes and no child elements.
Example
<dashboardsize>10</dashboardsize>
N2600001
daterange
The <daterange/> element restricts Unica NetInsight to a specified date range of log daterange/> files. Unica NetInsightwill not analyze any log file data outside of the date range. If the element is missing, Unica NetInsight will analyze all of the log file data. This element has two possible attributes. Each attribute corresponds to an option on the Included Dates page.
Attribute start end Corresponding option Starting date Ending date Possible values Any Julian date Any Julian date Default
Example
<daterange start="2449719" end="2451545"/>
N2610001
defaults
The <defaults> element specifies the default role and default view for a profile. This defaults> element is present only when a value other than (None) has been selected for the default role, the default view, or both. The <defaults> element has two possible attributes, each of which has a corresponding defaults> option on the profile Defaults page. Each attribute appears only if the corresponding option is set to a value other than (None) (None).
426
Web.cfg : Global Profile Configuration File Attribute role view Corresponding option Default role Default view Possible values Default
role_name/_noaccess)
view_name
Example
<defaults role="limited" view="marketing"/>
N2620001
departments
The <departments> element contains a list of departments that group the traffic on departments> server. This list appears on the Departments options page. The <departments> element departments> has one attribute and no value.
Attribute click Corresponding option Departments defined primarily by Possible values hosts, users Default hosts
Each department is specified using the child element <department>. The <department> department> department> element has one attribute and no value.
Attribute name Corresponding option Name of department Possible values Any alphanumeric characters Default
The individual members of each department are specified using the child element <member>. The <member> element uses both the method and type attributes inside member> member> the <department> element. The type attribute has two possible values: host and user. department> The default value is host. The value of the <member> element is the host or user name. member>
Example
<departments> <department name="Sales"> <member type="host" method="ends_with">.sales.company.com</member> </department> </departments>
N2630001
Version 8.2.1
427
dimensionlists
The <dimensionlists> element contains a list of dimension list definitions. The list dimensionlists> appears on the Dimension Lists options page. This element has no attributes and no value. Use the <dimensionlist> element to define each dimension list. The dimensionlist> <dimensionlist> element has two attributes. dimensionlist>
Attribute name Corresponding option Title of dimension list Possible values Any character string less than 120 characters Any character string of less than 30 characters that starts with a letter, uses only alphanumeric characters, hyphens, or underscores, and does not match the name of a subdirectory in the profile's HTML directory Default
id
Name of dimension list (one word)
The <dimensionlist> element has no value. Use the child element <group> to specify dimensionlist> group> each group in the list. The <group> element has one attribute. group>
Attribute name* Corresponding option Title of group Possible values Any character string less than 120 characters Default
* Unica NetInsight will create an ID for the group by replacing any spaces and nonalphanumeric characters in the name with underscores. Each group's ID must be unique within the dimension list. The <group> element has no value. Use the child element <dimension> to specify each group> dimension> dimension in the group. The <dimension> element has two attributes. dimension>
Attribute name* Corresponding option Dimension title Possible values Any character string less than 120 characters Any dimension key Default
target
Dimension source
* Unica NetInsight will create an ID for the dimension by replacing any spaces and non-alphanumeric characters in the name with underscores. Each dimension's ID must be unique within the dimension list. The <dimension> element has no child elements and no value. dimension>
428
Example
<dimensionlists> <dimensionlist name="My Dimension List" id="mylist"> <group name="Visitor Dimensions"> <dimension name="Host" target="host"/> </group> </dimensionlist> </dimensionlists>
N2640001
dimensionsfile
The <dimensionsfile> element specifies a dimensions file to use with this profile. This dimensionsfile> element has no attributes and no child elements. The value of the element is the filename of the dimensions file to be used. The file must be located in the Unica NetInsight/data/directory. If this element is missing, Unica NetInsight uses the default dimensions file for the profile type.
Example
<dimensionsfile>mydimensionsfile.xml</dimensionsfile>
N2650001
dirindexes
The <dirindexes> element contains a list of directory indexes. The <dirindexes> element dirindexes> dirindexes> has no attributes and no value. Use the child element <member> to specify the indexes. member> Inside the <dirindexes> element, Unica NetInsight ignores the method attribute of the dirindexes> <member> element. All entries are matched using ends_with The value of the member> ends_with. <member> element is the name of the index. member>
Example
<dirindexes> <member>/index.html</member> </dirindexes>
N2660001
dmpackages
The <dmpackages> element contains a list of all the data model extensions configured dmpackages> for the profile. This list appears on the Available data model extensions page. The <dmpackages> element has no attributes and no value. Each data model extension is dmpackages> specified using the child element <dmpackage>. The <dmpackage> element has one dmpackage> dmpackage> attribute and no value.
Version 8.2.1
429
20 - NetInsight Configuration Files Attribute name Corresponding option Name of the datamodel extension Possible values Any alphanumeric characters Default
The <dmpackage> element contains two elements: dmpackage> <dmext>, the value of which is the path and filename of the data model extensions dmext> file <formatdbext>, the value of which is the path and filename of the output formatting formatdbext> extension file
You can specify the file locations using absolute or relative paths. Paths are relative to the Unica NetInsight/data/ directory. The <dmext> and <formatdbext> elements have no attributes. dmext> formatdbext> If <dmpackages> this element is missing, Unica NetInsight uses the default dimensions dmpackages> file for the profile.
Example
<dmpackages> <dmpackage name="Extension"> <dmext> C:\Program Files\Unica NetInsight\data\myextensionsfile.xml </dmext> <formatdbext> C:\Program Files\Unica NetInsight\data\myeoutputfile.xml </formatdbext> </dmpackage > </dmpackages>
N2670001
donotconverttimes
The <donotconverttimes/> element sets the Do not convert dates and times to local time donotconverttimes/> zone option on the Advanced options page. If the element is present, the option is selected. If it is absent, the option is not selected. This element has no attributes, no child elements, and no value.
Example
<donotconverttimes/>
N2680001
dynamicpages
The <dynamicpages> element contains a list of the dynamic pages for which the query dynamicpages> string will be treated as part of the page. This list appears on the Dynamic Pages page.
The <dynamicpages> element has no attributes and no value. Use the child element dynamicpages> <member> to specify each dynamic page. The value of the <member> element is the member> member> text that identifies a dynamic page.
Example
<dynamicpages> <member method="contains">/cgi-bin/</member> <member method="ends_with">.exe</member> </dynamicpages>
N2690001
element
The <element> element specifies the database column on which the data is sampled. element> The <element> element has no attributes and no child elements. The value of the element> element is the name of the database column. Currently, VisitorID is the only supported sampling element. The <element> element must be contained by the <sampling> element> sampling> element.
Example
<element>VisitorID</element>
N26A0001
emailalerts
The <emailalerts> element contains a list of email alerts. An email alert enables you to emailalerts> notify one or more individuals via email when certain user-defined criteria are met at the completion of each update. The list of email alerts appears on the Email Alerts page. The <emailalerts> element has no attributes and no value. Each individual email alert is emailalerts> specified using the child element <emailalert>. The <emailalert> element has six emailalert> emailalert> attributes.
Version 8.2.1
431
20 - NetInsight Configuration Files Attribute timeperiod Corresponding option Time period Possible values Default
all, latest, today, yester- latest day, currentdays-<num< ber>, currentweeksber> <number>, currentnumber> months-<number>, cur<number> rentquarters-<number>, <number> currentyears-<number>, <number> previousdays-<num< ber>, previousweeksber> <number>, previousnumber> months-<number>, pre<number> viousquarters-<num< ber>, previousyearsber> <number>, currentweek, number> currentmonth, currentquarter, currentyear, previousweek, previousmonth, previousquarter, previousyear Any alphanumeric characters Any email task name Any valid metric name equalto, greaterthan, equalto greaterthanequalto, lessthan, lessthanequalto, notequalto Any numeric characters
name
Name of alert
task metric compare
Email task Metric Execute if calculated value is
threshold
(Unlabeled text entry box)
The <emailalert> element has no value. Use the child element <filterinstances> to emailalert> filterinstances> specify the filters that define the email alert.
Example
<emailalerts> <emailalert timeperiod="previousweek" name="AnEmailAlert" task="AnEmailTask" metric="views" compare="equalto" threshold="5"> <filterinstances> <filterinstance type="host" comparison="equals"> Acme </filterinstance> </filterinstances> </emailalert>
432
Web.cfg : Global Profile Configuration File </emailalerts>

N26B0001
emailtasks
The <emailtasks> element contains a list of email tasks. An email task links reports with emailtasks> recipients so that you can send the reports to the recipients via email. The list of email tasks appears on the Email Tasks page. The <emailtasks> element has no attributes and no value. Each individual email task is emailtasks> specified using the child element <emailtask>. The <emailtask> element has six emailtask> emailtask> attributes.
Attribute exclude Corresponding option Possible values Default false
Specifies whether to ex- true, false clude from batch execution Time period
timeperiod
all, latest, today, yester- latest day, currentdays-<num< ber>, currentweeksber> <number>, currentnumber> months-<number>, cur<number> rentquarters-<number>, <number> currentyears-<number>, <number> previousdays-<num< ber>, previousweeksber> <number>, previousnumber> months-<number>, pre<number> viousquarters-<num< ber>, previousyearsber> <number>, currentweek, number> currentmonth, currentquarter, currentyear, previousweek, previousmonth, previousquarter, previousyear csv, rtf, htmlnolinks, html Any alphanumeric characters Any alphanumeric characters Any alphanumeric characters Value for the From address option on the Email page in the administrative options html
format
Format of reports
subject
Subject of email
name
Name of task
from*
From address
Version 8.2.1
433
* The from attribute is present in the configuration file only when the value specified on the Email task description page in the profile options differs from the value specified for the From address option in the administrative options. The value of the <emailtask> element is the additional text. emailtask> You can include summaries, dashboards, and saved custom reports in an email task. The child element <summaries> contains the reports to send. The <summaries> summaries> summaries> element has no attributes and no value. Use the child element <summary> to specify summary> each report. The value of the <summary> element is as follows: summary>
Dashboard Content Executive Technical Traffic Visitor Dashboard Content Executive Technical Traffic Visitor
For summaries, the value is the abbreviated summary name. For a list of abbreviated summary names, see the <summaries> element. summaries> For dashboards, the value is the abbreviated dashboard name.
Abbreviation contentdash executive techdash trafficdash visdash Abbreviation contentdash executive techdash trafficdash visdash
For saved custom reports, the value is the ID of the custom report. To find the ID: 1. View the profile that contains the custom report. 2. Click the Custom tab. The Managing Reports page opens. 3. View the HTML source code for this screen and then search for the list of HTML <option> tags. An <option> tag for the saved custom report should option> option> appear in the list. For example:
<option value="custom003">My Report</option>
434
In this example, the ID is custom003. The reports are included in the email message in the order in which they are listed in the <summaries> element. summaries> Use the child element <recipients> to specify the recipients of the recipients> reports. The <recipients> element has no attributes and no value. Use recipients> the child element <member> to specify each recipient. (See the member> <member> element.) The value of the <member> element is an email member> member> address.
Example
<emailtasks> <emailtask exclude="false" timeperiod="latest" format="html" subject="New Reports" name="Latest Monthly Reports" from="bob@unica.com"> Description of reports. <summaries> <summary>date</summary> <summary>file</summary> <summary>techdash</summary> <summary>custom003</summary> </summaries> <recipients> <member>abc@unica.com</member> </recipients> </emailtask> </emailtasks>
N26C0001
entity
The <entity> element specifies the database table that contains the sampled element. entity> The <entity> element has no attributes and no child elements. The value of the element entity> is the name of the database table. Currently, Visitor is the only supported sampling entity.
Example
<entity>Visitor</entity>
N26D0001
excludedagents
The <excludedagents> element contains a list of user agents you do not want included excludedagents> in the traffic analysis. This list appears on the Excluded Agents page. If the <excludedagents> element is missing, traffic from all user agents will be included in the excludedagents> analysis. The <excludedagents> element has no attributes and no value. Use the child excludedagents> element <member> to specify the user agents. The value of the <member> element is member> member> the text that determines which user agents are excluded.
Version 8.2.1 435
Example
<excludedagents> <member method="starts_with">Microsoft-WebDAVMiniRedir</member> </excludedagents>
N26E0001
excludedhosts
The <excludedhosts> element contains a list of hosts that you do not want to include in excludedhosts> the traffic analysis. This list appears on the Excluded Hosts page. If the <excludedhosts> element is missing, traffic from all hosts will be included in the excludedhosts> analysis. The <excludedhosts> element has no attributes and no value. Use the child element excludedhosts> <member> to specify the hosts. The value of the <member> element is the text that member> member> determines which hosts are excluded.
Example
<excludedhosts> <member method="ends_with">unica.com</member> </excludedhosts>
N26F0001
excludedpages
The <excludedpages> element contains a list of pages you do not want included in the excludedpages> traffic analysis. This list appears on the Excluded Pages page. If the <excludedpages> excludedpages> element is missing, traffic to all pages will be included in the analysis. The <excludedpages> element has no attributes and no value. Use the child element excludedpages> <member> to specify the pages. The value of the <member> element is the text that member> member> determines which pages are excluded.
Example
<excludedpages> <member method="ends_with">.gif</member> <member method="ends_with">.GIF</member> <member method="ends_with">.jpg</member> <member method="ends_with">.JPG</member> <member method="ends_with">.class</member> </excludedpages>
N2700001
436
excludedparametervalues
The <excludedparametervalues> element contains a list of parameter values. This list excludedparametervalues> appears on the Excluded Parameter Values page. If the <excludedparametervalues> excludedparametervalues> element is missing, all parameter values will be included in the analysis. The <excludedparametervalues> element has no attributes and no value. Use the child excludedparametervalues> element <member> to specify the excluded parameter value rules. The value of each member> <member> element is the text that determines which parameter values are excluded. member>
Example
<excludedparametervalues> <member type="param1" method="equals">images</member> <member type="param2" method="equals">base</member> </excludedparametervalues>
N2710001
excludedusers
The <excludedusers> element contains a list of users that you do not want to include in excludedusers> the traffic analysis. This list appears on the Excluded Users page. If the <excludedusers> element is missing, traffic from all users will be included in the excludedusers> analysis. The <excludedusers> element has no attributes and no value. Use the child element excludedusers> <member> to specify the users. The value of the <member> element is the text that member> member> determines which users are excluded.
Example
<excludedusers> <member method="equals">Bob</member> </excludedusers>
N2720001
filtergroups
The <filtergroups> element contains a list of filter groups. This list appears on the Filter filtergroups> Groups page. If the <filtergroups> element is missing, no filter groups will be available in filtergroups> the profile. The <filtergroups> element has no attributes and no value. Use the child element filtergroups> <filtergroup> to specify the filter groups. The <filtergroup> element has two attributes. filtergroup> filtergroup>
Attribute name Corresponding option Name of filter group Possible values Any alphanumeric characters Default
Version 8.2.1
437
20 - NetInsight Configuration Files Attribute filters Corresponding option Filters that belong to filter group Possible values Filter string for filters you entered for this group Default
The value of the <filtergroup> element is the title of the filter group. filtergroup>
Example
<filtergroups> <filtergroup name="test" filters="brow_0=Netscape&_brow_0=0&_browtype_0=1"> Test Group </filtergroup> </filtergroups>
N2730001
filterinstances
The <filterinstances> element contains all the filters being applied to the element that filterinstances> contains the <filterinstances> element. The <filterinstances> element must be contained filterinstances> filterinstances> by a <dimension> or <metric> element or by a <filter>, <visitorprofile>, or <emailalert> dimension> metric> filter> visitorprofile> emailalert> element in a configuration file. Each <dimension>, <metric>, <filter>, <visitorprofile>, or dimension> metric> filter> visitorprofile> <emailalert> element can contain only one <filterinstances> element. The emailalert> filterinstances> <filterinstances> element has no value and no attributes. filterinstances> Use the child element <filterinstance> to define each filter that is being applied to the filterinstance> dimension, metric, or visitor profile. There are ten types of filters: string, group, numeric, list, range, date, path, retail action, visit type, and filter group. The attributes of the <filterinstance> element vary depending on the type of filter being defined. filterinstance>
string filters
The <filterinstance> element used to define a string filter has three attributes. filterinstance>
Attribute type Definition Type of filter being definedmust match the name attribute of a <dimension> element To evaluate dimension or metric values against the filterinstance value Possible values Any alphanumeric characters Default
comparison
match_regexp, match_pattern, starts_with, ends_with, contains, equals true, false
equals
negate*
Whether to negate the comparison
false
438
* This attribute is optional. The value of the <filterinstance> element is the string value of the filter. The filterinstance> <filterinstance> element for a string filter has no child elements. filterinstance>
Example
<filterinstance type="browser" comparison="equals" negate="true"> Microsoft </filterinstance>
numeric filters
The <filterinstance> element used to define a numeric filter has one attribute. filterinstance>
Attribute type Definition Type of filter being definedmust match the name attribute of a <dimension> element Possible values Any alphanumeric characters Default
The value of the <filterinstance> element is the numeric value. The <filterinstance> filterinstance> filterinstance> element for a numeric filter has no child elements.
Example
<filterinstance type="cost">7</filterinstance>
list filters
List filters store multiple numeric values. The <filterinstance> element used to define a filterinstance> list filter has one attribute.
Attribute type Definition Possible values Default
Type of filter being defi- Any alphanumeric charnedmust match the acters name attribute of a <dimension> element of filtertype list
The <filterinstance> element has no value. Use the child element <values> to specify filterinstance> values> the numeric values in the list. The <values> element has no attributes and no value. values> Use the child element <value> to specify each numeric value. value> The <value> element has no attributes and no child element. The value of a <value> value> value> element is a numeric value.
Version 8.2.1
439
Example
<filterinstance type="dayofweek"> <values> <value>1</target> <value>2</target> <value>5</target> </values> </filterinstance>
range filters
Range filters define a numeric range. The <filterinstance> element used to define a filterinstance> range filter has one attribute.
Attribute type Definition Possible values Default
Type of filter being defi- Any alphanumeric charnedmust match the acters name attribute of a <dimension> element of filtertype range
The <filterinstance> element has no value. Use the child element <range> to specify the filterinstance> range> numeric range. The <range> element has no attributes and no value. Use the child range> elements <start> and <end> to specify the start and end of the range. start> end> The <start> element has no attributes and no child elements. The value of the <start> start> start> element is the start value of the range. The <end> element has no attributes and no child elements. The value of the <end> end> end> element is the end value of the range.
Example
<filterinstance type="numviews"> <range> <start>1</start> <end>4</end> </range> </filterinstance>
date filters
The <filterinstance> element used to define a date filter has two attributes. filterinstance>
Attribute type Definition Type of filter being definedmust match the name attribute of a <dimension> element Possible values Any alphanumeric characters Default
440
Web.cfg : Global Profile Configuration File Attribute comparison Definition To evaluate dimension or metric values against the filterinstance value Possible values equals, between Default equals
If the <filterinstance> element has a comparison attribute of type equals, the value of filterinstance> the element is the value used in the comparison. This value can be either a specific date in the format YYYY-MM-DD or one of two keywords (today, yesterday). If the <filterinstance> element has a comparison attribute of type between, the element filterinstance> will have no value. Use the child element <range> or <values> to specify the values to range> values> use in the comparison. The <range> element has no attributes and no value. Use the child elements <start> range> start> and <end> to specify the start and end dates of the range. end> The <start> element has no attributes and no child element. The value of the element is start> the start date of the range, entered in the format YYYY-MM-DD. The <end> element has no attributes and no child element. The value of the element is end> the end date of the range, entered in the format YYYY-MM-DD. The <values> element has no attributes and no value. Use the child element <duration> values> duration> to specify the date duration to use in the comparison. The <duration> element has two duration> attributes.
Attribute type Definition Type of date duration Possible values days, weeks, months, quarters, years Default
direction
Relation of date duration previous, current to present
The value of the <duration> element is the number of the specified date duration units duration> defining the date range.
Example
<filterinstance type="date" comparison="equals">yesterday</filterinstance> <filterinstance type="date" comparison="equals">1997-04-01</filterinstance> <filterinstance type="date" comparison="between"> <range> <start>2001-01-01</start> <end>2001-02-02</end> </range> </filterinstance> <filterinstance type="date" comparison="between"> <values> <duration type="week" direction="previous">2</duration> </values> </filterinstance>
Version 8.2.1
441
path filters
The <filterinstance> element that defines a path filter has three attributes. filterinstance>
Attribute type Definition Type of filter being definedmust match the name attribute of a <dimension> element To evaluate dimension or metric values against the filterinstance value Whether to negate the comparison Possible values Any alphanumeric characters Default
comparison
match_start, match_end, match_within, match_exact true, false false
negate*
* This attribute is option. The <filterinstance> element has no value. Use the child element <values> to specify filterinstance> values> the pages of the path filter. The <values> element has no attributes and no value. Use values> the child element <value> to specify each page of the path filter. value> The <value> element has no attributes and no child elements. The value of the <value> value> value> element is a path. The value of the <duration> element is the number of the specified date duration units duration> defining the date range.
Example
<filterinstance type="path" comparison="starts_with" negate="true"> <values> <value>/support/NTR/faq.html</value> <value>/products/NTR/</value> </values> </filterinstance>
retail action filters

Retail action filters specify one or more retail actions. Retail action filters can only be used in Web server profiles. The <filterinstance> element used to define a retail action filterinstance> filter has one attribute.
Attribute type Definition Type of filter being defined Possible values actiontype Default
The <filterinstance> element has no value. Use the child element <values> to specify filterinstance> values> the list of retail actions. The <values> element has no attributes and no value. Use the values> child element <value> to specify each retail action. value>
The <value> element has no attributes and no child element. The value of a <value> value> value> element is a numeric value.
Value 1 2 3 4 5 Definition Abandoned Added Purchased Removed Viewed
Example
<filterinstance type="actiontype"> <values> <value>4</value> </values> </filterinstance>
visit type filters

The <filterinstance> element used to define a visit type filter has one attribute. filterinstance>
Attribute type Definition Type of filter being defined Possible values visittype Default
The <filterinstance> element has no value. Use the child element <values> to specify filterinstance> values> the visit type. The <values> element has no attributes and no value. Use the child values> element <value> to specify the numeric value that corresponds to the type of visit. value> The <value> element has no attributes and no child element. The value of a <value> value> value> element is a numeric value.
Value 1 2 Definition New Repeat
Example
<filterinstance type="visittype"> <values> <value>2</value> Version 8.2.1 443
20 - NetInsight Configuration Files </values> </filterinstance>
filter groups
A filter group is a list of multiple filters that are applied together. The <filterinstance> filterinstance> element that specifies a filter group has one attribute.
Attribute type Definition Type of filter being defined Possible values group Default
The <filterinstance> element that specifies a filter group has no child elements. The filterinstance> value of the <filterinstance> element is the name of the filter group. (Filter groups are filterinstance> defined in the profile's configuration file.)
Example
<filterinstance type="group"> _errorgroup </filterinstance>
N2740001
filterlists
The <filterlists> element contains a list of filter list definitions. The list appears on the filterlists> Filter Lists option page. This element has no attributes and no value. Use the <filterlist> filterlist> element to define each filter list. This element has two attributes.
Attribute name Corresponding option Title of filter list Possible values Any character string less than 120 characters Any character string of less than 30 characters that starts with a letter, uses only alphanumeric characters, hyphens, or underscores, and does not match the name of a subdirector in the profile's HTML directory Default
id
Name of filter list (one word)
The <filterlist> element has no value. Use the child element <group> to specify each filterlist> group> folder in the list. The <group> element has one attribute. group>
444
Web.cfg : Global Profile Configuration File Attribute name* Corresponding option Title of group Possible values Any character string less than 120 characters Default
* Unica NetInsight will create an ID for the group by replacing any spaces and nonalphanumeric characters in the name with underscores. Each group's ID must be unique within the filter list. The <group> element has no value. Use the child element <filter> to specify each filter group> filter> in the group. The <filter> element has two possible attributes. filter>
Attribute name Corresponding option Filter title Possible values Any character string less than 120 characters Any filter type Default
target**
Filter source
* Unica NetInsight will create an ID for the filter by replacing any spaces and nonalphanumeric characters in the name with underscores. Each filter's ID must be unique within the filter list. ** This attribute should only be used if the <filter> element does not contain a filter> <filterinstances> element. filterinstances> The <filter> element has no value. If the end user is to be prompted for the specific filter filter> value when the filter is applied, the <filter> element should have no child elements. If filter> the specific filter value is to be predefined in the filter list, use the child element <filterinstances> to specify the value. For details on the <filterinstances> element, see filterinstances> filterinstances> the document Unica NetInsight Filter XML.
Example
<filterlists> <filterlist name="My Filters" id="flistname"> <group name="Content Filters"> <filter name="Document Downloads"> <filterinstances> <filterinstance type="group">_Documents</filterinstance> </filterinstances> </filter> <filter name="File" target="file"/> </group> </filterlist> </filterlists>
N2750001
Version 8.2.1
445
ftpdebug
The <ftpdebug/> element enables the logging of debug information when you use FTP ftpdebug/> to access your log files. If the element is present, debug logging is enabled. If it is absent, debug logging is not enabled. This element has no attributes, no child elements, and no value. Do not modify this element without contacting technical support.
Example
<ftpdebug/>
N2760001
hidelinks
The <hidelinks> element prevents the report entries for files from being hyperlinks to the hidelinks> actual files. Normally, when reports reference a specific file, that reference is a hyperlink to the file. For example, you can click on any file listed in the File Summary to download the actual file. The <hidelinks> element prevents Unica NetInsight Unica NetInsight from hidelinks> creating the hyperlinks. If the element is absent (the default), the hyperlinks are created. The <hidelinks> element has no attributes, no child elements, and no value. hidelinks>
Example
<hidelinks/>
N2770001
hostgroups
The <hostgroups> element contains a list of host groups, each of which can contain hostgroups> multiple hosts. The names of the host groups will appear in Unica NetInsight reports. This list appears on the Host Groups page. The <hostgroups> element has no attributes hostgroups> and no value. Each host group is specified using the child element <hostgroup>. The hostgroup> <hostgroups> element has three attributes and no value. hostgroups>
Attribute domain Corresponding option Domain of host group Possible values Any alphanumeric characters Any alphanumeric characters true, false Default
name
Name of host group
sessionize
Use modified host for sessionization
Use the child element <member> to specify the individual members of each host group. member> (See the <member> element.) The value of the <member> entry is a domain name. member> member>
446
Example
<hostgroups> <hostgroup domain="Online Services" name="America Online" sessionize="true"> <member method="ends_with">.aol.com</member> </hostgroup> <hostgroup domain="Online Services" name="CompuServe" sessionize="true"> <member method="ends_with">.compuserve.com</member> </hostgroup> </hostgroups>
N2780001
hostlookup
The <hostlookup> element sets the Host lookup URL option on the Lookup Scripts hostlookup> page. The value of the element is the script to execute when a user clicks a host in the Host Summary If the element is missing, the option will be blank. This element has no Summary. attributes and no child elements.
Example
<hostlookup> http://host.domainname.com/scripts/weblookup.exe?host= </hostlookup>
N2790001
ignoredfields
The <ignoredfields> element contains a list of fields whose values Unica NetInsight ignoredfields> should not store in the database. Do not modify this element without contacting technical support. The <ignoredfields> element has no attributes and no value. Each ignoredfields> individual field is specified using the child element <ignoredfield>. The <ignoredfield> ignoredfield> ignoredfield> element has no attributes and no child elements. Its value is the name of the field that should be ignored. There are two fields that can be ignored in FTP server profiles.
Optional Field Browser BrowserBreakdown Cookie Domain Keywords PageBreakdown Version 8.2.1 Value When Disabled Unknown Unknown None Unresolved KeywordsID 0 PageBrkdwnID 0 447
20 - NetInsight Configuration Files Optional Field Platform Referrer ReferrerBreakdown User Value When Disabled Unknown None None UserID 0
Example
<ignoredfields> <ignoredfield>Browser</ignoredfield> </ignoredfields>
N27A0001
includedagents
The <includedagents> element contains a list of the user agents you want included in includedagents> the traffic analysis. This list appears on the Included Agents page. Traffic from user agents not on this list will not be analyzed. If the <includedagents> element is missing, includedagents> traffic from all user agents will be included. The <includedagents> element has no includedagents> attributes and no value. Use the child element <member> to specify the hosts. The member> value of the <member> element is the text that determines which hosts are included. member>
Example
<includedagents> <member method="starts_with"> Microsoft-WebDAVMiniRedir </member> </includedagents>
N27B0001
includedhosts
The <includedhosts> element contains a list of the hosts you want included in the traffic includedhosts> analysis. This list appears on the Included Hosts page. Traffic from hosts not on this list will not be analyzed. If the <includedhosts> element is missing, traffic from all hosts will includedhosts> be included. The <includedhosts> element has no attributes and no value. Use the child includedhosts> element <member> to specify the hosts. The value of the <member> element is the text member> member> that determines which hosts are included.
Example
<includedhosts> <member method="ends_with">.edu</member> 448 Unica NetInsight - Administrator's Guide
Web.cfg : Global Profile Configuration File </includedhosts>

N27C0001
includedpages
The <includedpages> element contains a list of the pages you want included in the includedpages> traffic analysis. This list appears on the Included Pages page. Traffic to pages not on this list will not be analyzed. If the <includedpages> element is missing, traffic from all includedpages> pages will be included in the analysis. The <includedpages> element has no attributes includedpages> and no value. Use the child element <member> to specify the pages. The value of the member> <member> element is the text that determines which pages are included. member>
Example
<includedpages> <member method="contains">NetInsight</member> </includedpages>
N27D0001
includedparametervalues
The <includedparametervalues> element contains a list of included parameter values. includedparametervalues> This list appears on the Included Parameter Values page. If the <includedparametervalues> element is missing, all parameter values will be included in includedparametervalues> the analysis. The <includedparametervalues> element has no attributes and no value. includedparametervalues> Use the child element <member> to specify the included parameter value rules. The member> value of each <member> element is the text that determines which parameter values member> are included.
Example
<includedparametervalues> <member type="param1" method="equals">graphs</member> <member type="param2" method="equals">bars</member> </includedparametervalues>
N27E0001
includedusers
The <includedusers> element contains a list of the users you want included in the traffic includedusers> analysis. This list appears on the Included Users page. Traffic from users not on this list will not be analyzed. If the <includedusers> element is missing, traffic from all users will includedusers> be included in the analysis. The <includedusers> element has no attributes and no includedusers> value. Use the child element <member> to specify the users. The value of the member> <member> element is the text that determines which users are included. member>
Version 8.2.1
449
Example
<includedusers> <member method="equals">jsmith</member> <member method="equals">bjones</member> </includedusers>
N27F0001
keywordrules
The <keywordrules> element contains a list of the keyword parsing rules for the profile. keywordrules> This list appears on the Keywords page. The <keywordrules> element has no attributes keywordrules> and no value. Each keyword parsing rule is specified using the child element <keywordrule>. The <keywordrule> element has no value and two attributes. keywordrule> keywordrule>
Attribute name Corresponding option Name of keyword rule Possible values Any alphanumeric characters page, querystring querystring Default
type
Type of rule
The <keywordrule> element contains the child elements <includedsites>, keywordrule> includedsites> <excludedurls>, and <parameters>. excludedurls> parameters> The <includedsites> element contains the list of sites that should be searched using includedsites> the keyword parsing rule. This list appears on the Only sites to be searched using the keyword rule page. The <includedsites> element has no attributes and no value. includedsites> Use the child element <member> to specify each site. The value of the <member> member> member> element is the text that determines which sites are included. The <excludedurls> element contains the list of URLs within the included sites that excludedurls> you do not want to be searched using the keyword parsing rule. This list appears on the URLs that will not be searched using the keyword rule page. The <excludedurls> element has no attributes and no value. Use the child element excludedurls> <member> to specify each excluded URL. The value of the <member> element is member> member> the text that determines which URLs are excluded. The <parameters> element contains the list of parameters that belong to this parameters> keyword rule. This list appears on the Parameters that belong to the keyword rule page. The <parameters> element has no attributes and no value. Use the child parameters> element <member> to specify each parameter. The <member> element will have no member> member> attributes when it is contained in the <parameters> element. The value of the parameters> <member>element is the parameter name. member>
Example
<keywordrules> <keywordrule name="A9" type="page"> <includedreferrers> <member method="equals">A9</member> </includedreferrers> 450 Unica NetInsight - Administrator's Guide
Web.cfg : Global Profile Configuration File </keywordrule> <keywordrule name="Google" type="querystring"> <includedsites> <member method="equals">Yahoo</member> </includedsites> <excludedurls> <member method="contains">/url?</member> <member method="contains">images.yahoo.</member> </excludedurls> <parameters> <member>q</member> <member>query</member> </parameters> </keywordrule> </keywordrules>
N2800001
levels
The <levels> element contains a list of each sampling level specified for the profile. The levels> <levels> element has no attributes and no value. Use the child element <level> to levels> level> specify each level. The first <level> element specifies the Full reporting mode sample level> level. The second <level> element specifies the Sample reporting mode sample level. level> The <levels> element must be contained by the <sampling> element. levels> sampling> The <level> element specifies a sampling level. The <level> element has no attributes level> level> and no child element. The value of the <level> element is the sampling percentage. level>
Example
<levels> <level>100.000000</level> <level>0.050000</level> <levels>
N2810001
linklength
The <linklength> element sets the Link display length option on the Links options page. linklength> The possible values are numbers from 10 through 100 or Unlimited (represented in the configuration file as a 0). If the element is missing, Unica NetInsight uses the default, which is 41. This element has no attributes and no child elements.
Example
<linklength>25</linklength>
N2820001
Version 8.2.1
451
locale
The <locale> element customizes the profile for your locale. If the element is missing, locale> Unica NetInsight uses the defaults. This element has seven possible attributes. Each attribute corresponds to an option on the Locale page.
Attribute timeformat dateformat charset Corresponding option Display time as Display date as Character set Possible values 12hr, 24hr mdy, dmy, ymd latin1, latin2, sjis, big5, gb2312, euckr, user, UTF-8 sunday, monday saturday, friday Default 12hr mdy latin1
weekbegins weekendbegins language
Week begins on Weekend Language
sunday saturday
Two-character language en identifier Generic, Dollar, Pound, Euro, Yen mdy, dmy, ymd Dollar
currency
Currency
altdate*
Log file date format
mdy
* The altdate attribute applies only to Microsoft IIS log files in the IIS Standard/Extended log file format. This element has no child elements and no value.
Example
<locale timeformat="12hr" dateformat="mdy" altdate="mdy" charset="latin1" weekbegins="Sunday" weekendbegins="saturday" language="en"/>
N2830001
localkeywords
The <localkeywords> element contains a list of pages on your site that allow users to localkeywords> enter keywords. The list appears on the Local Keywords page. If the <localkeywords> localkeywords> element is missing, Unica NetInsight does not generate a report of the keywords used on your site. The <localkeywords> element has one optional attribute. localkeywords>
452
Web.cfg : Global Profile Configuration File Attribute parameter Corresponding option Local keyword parameter Possible values Any parameter that contains search words Default
Example
<localkeywords> <member method="ends_with">search.cgi</member> </localkeywords>
N2840001
logs
The <logs> element contains a list of the log files you want to analyze. This list appears logs> on the Log Files page. The <logs> element has no attributes and no value. logs> Use the child element <logfile> to specify the full path of each log file. The <logfile> logfile> logfile> element has one attribute.
Attribute format Corresponding option Format of log file(s) Possible values Default
auto, netscape, ncsa, auto w3c, iis, msproxy, website, gauntlet, ibm, raptor, openmarket, wuftpd, ncftpd, cerfnet, squid, sidewinder, watchguard, real, (User defined valueCustom Log Formats)
Example
<logs> <logfile format="auto">/logs/access.log</logfile> <logfile format="auto">/logs/old/access.*</logfile> <logfile format="auto"> ftp://ftp.unica.com/logs/access.log </logfile> </logs>
N2850001
Version 8.2.1
453
maildebug
The <maildebug> element logs the SMTP conversation between Unica NetInsight and maildebug> the mail server when you email reports through the Email icon or by executing an email task. If this element is present in the profile configuration file, the conversation and other relevant information is logged in Unica NetInsight /data/short_name/maildebug.log, where Unica NetInsight is the Unica NetInsight program directory, and short_name is the name that appears in parentheses in the Available profiles list in the Profile Manager. This element has no attributes, no child elements, and no value. If this element is absent, email debug logging is not enabled. Do not modify this element without contacting technical support. If you use the email command-line option to execute multiple email tasks, only the last email task will be logged in maildebug.log when this element is present in the profile configuration file.
Example
<maildebug/>
N2860001
maxpathlength
The <maxpathlength> element sets the Maximum length of path option on the General maxpathlength> options page. The possible values are numbers 2 through 10. If the element is missing, Unica NetInsight uses the default value, which is 5. This element has no attributes and no child elements.
Example
<maxpathlength>5</maxpathlength>
N2870001
member
The <member> element specifies an item in a list. This element must be included inside member> a container element. The <member> element has one attribute. member>
Attribute method Corresponding option Possible values Default equals
How you determine if an equals, starts_with, item should be included ends_with, contains, in the list match_pattern*
* Use match_pattern for match the regular expression filters.
454
The value of the <member> element depends on the container. member>

N2880001
metriclists
The <metriclists> element contains a list of metric list definitions. The list appears on the metriclists> Metric Lists options page. This element has no attributes and no value. Use the <metriclist> element to define each metric list. The <metriclist> element has two metriclist> metriclist> attributes.
Attribute name Corresponding option Title of metric list Possible values Any character string less than 120 characters Any character string of less than 30 characters that starts with a letter, uses only alphanumeric characters, hyphens, or underscores, and does not match the name of a subdirectory in the profile's HTML directory Default
id
Name of metric list (one word)
The <metriclist> element has no value. Use the child element <group> to specify each metriclist> group> group in the list. The <group> element has one attribute. group>
Attribute name* Corresponding option Title of group Possible values Any character string less than 120 characters Default
* Unica NetInsight creates an ID for the group by replacing any spaces and nonalphanumeric characters in the name with underscores. Each group's ID must be unique within the metric list. The <group> element has no value. Use the child element <metric> to specify each group> metric> metric in the group. The <metric> element has two attributes. metric>
Attribute name* Corresponding option Metric title Possible values Any character string less than 120 characters Any metric key Default
target
Metric source
* Unica NetInsight creates an ID for the metric by replacing any spaces and nonalphanumeric characters in the name with underscores. Each metric's ID must be unique within the metric list.
Version 8.2.1
455
The <metric> element has no child elements and no value. metric>
Example
<metriclists> <metriclist name="My Metric List" id="mylist"> <group name="Traffic Metrics"> <metric name="Number of Sessions" target="sessions"/> </group> </metriclist> </metriclists>
N2890001
metricsfile
The <metricsfile> element specifies a metrics file to use with this profile. This element metricsfile> has no attributes and no child elements. The value of the element is the filename of the metrics file to be used. The file must be located in the Unica NetInsight/data/ directory. If this element is missing, Unica NetInsight uses the default metrics file for the profile type.
Example
<metricsfile>mymetricsfile.xml</metricsfile>
N28A0001
module
The <module> element defines an external module to use in this profile. This element module> must be contained by the <modules> element. The <module> element has the following modules> module> attributes:
Attribute Description/Correspondi Possible values ng Option A unique, case-sensitive psi text string identifying a particular implementation of the module type Enable import check box Enable reporting check box true, false false Default
name
importenabled
reportingenabled
true, false
false
The <module> element has no value. Use the <connection> child element to specify module> connection> connection information for the module. Use the <retrievebatchsize> and retrievebatchsize> <writebatchsize> child elements to control batch sizes for this module. writebatchsize>
456
Example
<module name="psi" importenabled="true" reportingenabled="true">
<connection>
<url>http://www.paidsearchintegrationserver.com</url>
<user>Unica</user>
<password>encryptedpassword</password>
</connection>
<retrievebatchsize>10000</retrievebatchsize>
<writebatchsize>50000</writebatchsize>
</module>
N28B0001
modules
The <modules> element is a container element for external modules that are used in modules> this profile. The <modules> element has no attributes and no value. Use the child modules> element <module> to specify each module. module>
Example
<modules>
<module name="psi" importenabled="true" reportingenabled="true">
<connection>
<user>Unica</user>
<password>encryptedpassword</password>
Version 8.2.1
457
20 - NetInsight Configuration Files </connection>
</module>
</modules>
N28C0001
nodefaultautoupdate
The <nodefaultautoupdate/> element disables the Automatically update report option on nodefaultautoupdate/> the Saving the Report options page for a custom report. If this element is present, the Automatically update report option is not selected for any new custom reports. If this element is absent, the option is selected for any new custom reports. This element has no attributes, no child elements, and no value. This element has been replaced with the <nodefaultautoupdatefull/> and nodefaultautoupdatefull/> <nodefaultautoupdatesample/> elements in new profiles. nodefaultautoupdatesample/>
Example
<nodefaultautoupdate/>
N28D0001
nodefaultautoupdatefull
The <nodefaultautoupdatefull/> element disables the Automatically update full report nodefaultautoupdatefull/> option on the Saving the Report options page for a custom report. If this element is present, the Automatically update full report option is not selected for any new custom reports. If this element is absent, the option is selected for any new custom reports. This element has no attributes, no child elements, and no value.
Example
<nodefaultautoupdatefull/>
N28E0001
458
nodefaultautoupdatesample
The <nodefaultautoupdatesample/> element disables the Automatically update sample nodefaultautoupdatesample/> report option on the Saving the Report options page for a custom report. If this element is present, the Automatically update sample report option is not selected for any new custom reports. If this element is absent, the option is selected for any new custom reports. This element has no attributes, no child elements, and no value.
Example
<nodefaultautoupdatesample/>
N28F0001
noimportreindex
The <noimportreindex> element disables the dropping and recreating of database noimportreindex> indexes during import. If you are using Unica NetInsight as an ETL tool, you should consider using this element. If the element is absent (which it is by default), the indexes are dropped and recreated during import. This element has no attributes, no child elements, and no value. The <noimportreindex> element will not prevent reindexing if the Misc table says noimportreindex> reindexing needs to be done. This element does not apply to Unica NetInsight for SQLite.
Example
<noimportreindex/>
N2900001
nonreportabledimensions
The <nonreportabledimensions> element contains the list of non-reportable dimensions. nonreportabledimensions> (A non-reportable dimension will not appear on the Discovery Panel or in reports even if the log file data and profile options support it.) This list appears in the Available Dimensions list on the Reportable Dimensions page. The <nonreportabledimensions> element has no attributes and no value. Use the child nonreportabledimensions> element <nonreportabledimension> to specify each non-reportable dimension. The nonreportabledimension> <nonreportabledimension> element has no attributes and no child elements. The value nonreportabledimension> of the element is the dimension name.
Example
<nonreportabledimensions> <nonreportabledimension>content<nonreportabledimension> <nonreportabledimension>domain<nonreportabledimension> Version 8.2.1 459
20 - NetInsight Configuration Files <nonreportabledimensions>

N2910001
notableanalysis
The <notableanalysis/> element disables periodic table analysis. If the element is notableanalysis/> absent (which it is by default), periodic table analysis is enabled. This element has no attributes, no child elements, and no value. This element applies only to Unica NetInsight for Oracle, MySQL, and DB2.
Example
<notableanalysis/>
N2920001
ntadtrack
The <ntadtrack> element sets the Full path of ntadtrack.cgi (or ntadtrack.exe option on ntadtrack> ntadtrack.exe) the Banner Ads page. If the element is missing, the option will be blank. This element has no attributes and no child elements.
Example
<ntadtrack>/cgi-bin/ntadtrack.exe</ntadtrack>
N2930001
ntdi
The <ntdi> element contains a list of data conduits. This list appears on the Data ntdi> Conduits page. If the <ntdi> element is missing, Unica NetInsight will not use data ntdi> conduits. The <ntdi> element has no attributes and no value. Use the child element ntdi> <plugin> to specify each plug-in. The <plugin> element has three attributes. plugin> plugin>
Attribute type Corresponding option Conduit tasks Possible values cookie, department, email, host, pagetitle, param_ param-name param-name, rwpage, rwparam_ param-name user, visitor e am-name, Default
conf
Full path to conduit con- Any path and filename fig Name of data conduit Any alphanumeric characters
name
460
The value of the <plugin> element is the plug-in library. The <plugin> element has no plugin> plugin> child elements.
Example
<ntdi> <plugin type="host" conf="ntdiodbc.conf" name="host info"> ntdiodbc.dll </plugin> <plugin type="visitor" conf="ntdiodbc.conf" name="visitor info"> ntdiodbc.dll </plugin> </ntdi>
N2940001
ntlinktrack
The <ntlinktrack> element sets the Full path of ntlinktrack.cgi (or ntlinktrack.exe option ntlinktrack> ntlinktrack.exe) on the Links page. If the element is missing, the option will be blank. This element has no attributes and no child elements.
Example
<ntlinktrack>/cgi-bin/ntlinktrack.exe</ntlinktrack>
N2950001
outdefext
The <outdefext> element specifies the output formatting extensions file to use with this outdefext> profile. The <outdefext> element has no attributes and no child elements. The value is outdefext> the full path and file name of the output formatting extensions file.
Example
<outdefext> C:\Program Files\NetInsight\OutputFiles\output1.xml </outdefext>
N2960001
parameters
The <parameters> element contains a list of parameters you want to track. This list parameters> appears on the Parameters page. The <parameters> element has no attributes and no parameters> value. Each parameter is specified using the child element <parameter>. The parameter> <parameter> element has ten attributes and no value. parameter>
Version 8.2.1
461
20 - NetInsight Configuration Files Attribute type coltitle Corresponding option Type of parameter Column title Possible values file, field, meta Any alphanumeric characters Any alphanumeric characters Default
grtitleasc
Graph title (Ascending)
grtitledsc
Graph title (Descending) Any alphanumeric characters Parameter lookup URL Parameter Any URL Any alphanumeric characters true, false false
lookupurl parameter
displayonbr
Display on associated breakdown Name
name
Any alphanumeric characters true, false true
store
Store parsed parameter value* Associate parameter value with
associatewith
view, visit
view
The individual pages that you want Unica NetInsight to search for the parameters must be specified using the child element <member>. The value of the <member> member> member> element is the text that determines which pages should be searched.
Example
<parameters> <parameter type="file" coltitle="Product Code" grtitleasc="Most Popular Products" grtitledsc="Least Popular Products" lookupurl="http://host.domainname.com/scripts/weblookup.exe?parameter=" parameter="pc" displayonbr="true" name="ProductID" store="true" associatewith="view"> <member method="contains">catalog</member> </parameter> </parameters>
N2970001
462
password
The <password> element specifies a password. When the element is contained only by password> the overall container element for the file, it is used to set password protection for the profile. When it is contained by the <connection> element, it specifies the password connection> Unica NetInsight uses to connect to an external module. If the <password> element is password> missing, there is no password. When used to set the connection password, this element has no attributes. When used to set the profile protection options, the element has five possible attributes and you must include at least one attribute or the password has no effect.
Attribute options Corresponding option Protect all of the profile options Protect only the log file and password options Protect the Remove Data from Profile page Protect the updating of this profile Possible values true, false Default false
logoptions
true, false
false
remove
true, false
false
update
true, false
false
savecustom
Protect saving/removing true, false custom reports
false
This element has no child elements. The value of the element is the encrypted password.
Example
<password options="true" logoptions="true" remove="true" update="true" savecustom="true">encryptedpassword</password>
N2980001
platforms
The <platforms> element contains a list of the platform names that will appear in platforms> reports. This list appears on the Platforms page. The <platforms> element has no platforms> attributes and no value. Use the child element <platform> to specify each platform. The platform> <platform> element has two attributes and no value. platform>
Attribute appendversion Corresponding option Append the version number Possible values true, false Default false
Version 8.2.1
463
20 - NetInsight Configuration Files Attribute name Corresponding option Name of platform Possible values Any alphanumeric characters Default
Use the child element <member> to specify the individual members of each platform member> group. The value of the <member> element is the text that identifies a platform you member> want included in the group.
Example
<platforms> <platform name="Windows 95"> <member method="starts_with">Win95_</member> <member method="match_pattern">^WMP\ (.*os=Windows_95.*\)</member> <member method="match_pattern">^QTS $.*os=Windows_95.*$</member> </platform> <platform name="Windows Me"> <member method="starts_with">Win98_4.9</member> <member method="match_pattern">^WMP $.*os=Windows_ME.*$</member> <member method="match_pattern">^WMP $.*os=Windows_98;osver=4\.9.*$</member> <member method="match_pattern">^QTS $.*os=Windows_Me.*$</member> </platform> </platforms>
N2990001
precalcdates
The <precalcdates> element sets the report generation options for the profile. This precalcdates> element has six possible attributes. Each attribute corresponds with an option on the Report Generation options page. If an attribute is missing, reports for the corresponding date range is not pre-calculated. For the years, quarters, months, weeks, and days attributes, the value of the attribute is the number of the corresponding time frames for which reports will be pre-calculated.
Attribute all years months weeks days Corresponding option All Months Latest ___ Years Latest ___ Quarters Latest ___ Weeks Latest ___ Days Possible values true, false Any numeic value Any numeic value Any numeic value Any numeic value Default false
464
Example
<precalcdates all="false" quarters="1" months="3" days="2"/>
N29A0001
redirectscripts
The <redirectscripts> element contains a list of pages that you want to include in the redirectscripts> analysis even though they return a redirection code. This list appears on the Redirection Scripts page. If the <redirectscripts> element is missing, Unica NetInsight excludes all redirectscripts> hits resulting in an HTTP redirection status code codes 301 and 302. The <redirectscripts> element has no attributes and no value. Use the child element redirectscripts> <member> to specify the pages.The value of the <member> element is the text that member> member> determines which pages are included.
Example
<redirectscripts> <member method="equals">/cgi-bin/redirect.cgi</member> </redirectscripts>
N29B0001
referrergroups
The <referrergroups> element contains a list of referrer groups, each of which can referrergroups> contain multiple referrers. This list appears on the Referrer Groups page. The <referrergroups> element has no attributes and no value. Each referrer group is referrergroups> specified using the child element <referrergroup>. The <referrergroup> element has one referrergroup> referrergroup> attribute.
Attribute name Corresponding option Name of referrer group Possible values Any alphanumeric characters Default
Example
<referrergroups> <referrergroup name="AltaVista"> <member method="contains">altavista.</member> </referrergroup> <referrergroup name="AOL NetFind"> <member method="ends_with">netfind.aol.com</member> </referrergroup> </referrergroups>
N29C0001
Version 8.2.1
465
reportlists
The <reportlists> element contains a list of report list definitions. The list appears on the reportlists> Report Lists options page. This element has no attributes and no value. Use the <reportlist> element to define each report list. The <reportlist> element has two reportlist> reportlist> attributes.
Attribute name Corresponding option Title of report list Possible values Any character string less than 120 characters Any character string of less than 30 characters that starts with a letter, uses only alphanumeric characters, hyphens, or underscores, and does not match the name of a subdirectory in the profile's HTML directory. Default
id
Name of report list (one word)
The <reportlist> element has no value. Use the child element <folder> to specify each reportlist> folder> folder in the list. The <folder> element has one attribute. folder>
Attribute name* Corresponding option Title of folder Possible values Any character string less than 120 characters Default
* Unica NetInsight creates an ID for the folder by replacing any spaces and nonalphanumeric characters in the name with underscores. Each folder's ID must be unique within the report list. The <folder> element has no value. Use the child element <report> to specify each folder> report> report in the folder. The <report> element has two attributes. report>
Attribute name* Corresponding option Report title Possible values Any character string less than 120 characters Any report key Default
target
Report source
* Unica NetInsight creates an ID for the report by replacing any spaces and nonalphanumeric characters in the name with underscores. Each report's ID must be unique within the report list. The <report> element has no child elements and no value. report>
466
Example
<reportlists> <reportlist name="My Report List" id="mylist"> <folder name="Visitor Reports"> <report name="Host Summary" target="host"/> </folder> </reportlist> </reportlists>
N29D0001
resolvehosts
The <resolvehosts> element sets the Resolve host names option on the General resolvehosts> options page. If the element is present, the option is selected. If it is absent, the option is not selected. This element has no attributes, no child elements, and no value.
Example
<resolvehosts/>
N29B0001
referrergroups
The <referrergroups> element contains a list of referrer groups, each of which can referrergroups> contain multiple referrers. This list appears on the Referrer Groups page. The <referrergroups> element has no attributes and no value. Each referrer group is referrergroups> specified using the child element <referrergroup>. The <referrergroup> element has one referrergroup> referrergroup> attribute.
Attribute name Corresponding option Name of referrer group Possible values Any alphanumeric characters Default
Example
<referrergroups> <referrergroup name="AltaVista"> <member method="contains">altavista.</member> </referrergroup> <referrergroup name="AOL NetFind"> <member method="ends_with">netfind.aol.com</member> </referrergroup> </referrergroups>
N29E0001
Version 8.2.1
467
resolvetitles
The <resolvetitles> element sets the Resolve page titles option on the General options resolvetitles> page. If the element is present, the option is selected. If it is absent, the option is not selected. This element has no attributes, no child elements, and no value.
Example
<resolvetitles/>
N29F0001
retrievebatchsize
The <retrievebatchsize> element defines the number of rows Unica NetInsight requests retrievebatchsize> from the external module server at a time. This element must be contained by the <module> element. The <retrievebatchsize> element has no attributes and no child module> retrievebatchsize> elements. The value of the <retrievebatchsize> element is the number of rows. If this retrievebatchsize> element is missing, Unica NetInsight uses the default value, which is 10000.
Example
N2A00001
roledefaults
The <roledefaults> element stores the list of role default views specified for the profile. roledefaults> This element has no attributes and no value. Specify each role default view using the child element <roledefault>. The <roledefault> element has one attribute. roledefault> roledefault>
Attribute view Corresponding option Default view Possible values Name of any view defined for the profile Default
The value of the <roledefault> element is the name of a role. roledefault>
Example
<roledefaults> <roledefault view="techview">techrole</roledefault> </roledefaults>
N2A10001
rows
The <rows> element is not currently supported. rows>
N2A20001
468
sampling
The <sampling> element is a container element for the sampling settings elements sampling> <entity>, <element>, <seed>, <rows>, and <levels>. The <sampling> element has no entity> element> seed> rows> levels> sampling> attributes and no value.
Example
<sampling> <entity>Visitor</entity> <element>VisitorID</element> <seed>0</seed> <rows>0</rows> <levels> <level>100.000000</level> <level>0.050000</level> </levels> </sampling>
N2A30001
schemafile
The <schemafile> element specifies the schema definition file to be used to create SQL schemafile> Server, Oracle, or DB2 database tables for this profile. This element has no attributes and no child elements. The value of the element is the filename of the schema definition file to be used. The file must be located in the Unica NetInsight/data/ directory. If this element is missing, Unica NetInsight uses the default schema definition file for the profile.
Example
<schemafile>myschema.xml</schemafile>
N2A40001
securityrealms
The <securityrealms> element contains a list of security realms that categorize pages securityrealms> on a Web site in order to resolve the titles of pages on Web servers that require authentication. This list appears on the Security Realms page. Use the child element <securityrealm> to specify each security realm. This element has securityrealm> three attributes.
Attribute name Corresponding option Realm name Possible values Any alphanumeric characters Any alphanumeric characters 469 Default
username
User name
Version 8.2.1
20 - NetInsight Configuration Files Attribute password Corresponding option Password Possible values Encrypted password Default
The <securityrealm> element has no value. Use the child element <member> to specify securityrealm> member> the individual pages that are part of the security realm. The value of each <member> member> element is the text that determines which pages belong to the security realm.
Example
<securityrealms> <securityrealm name="Realm1" username="Bob Smith" password="a1nc82"> <member method="contains">NetInsight</member> <member method="starts_with">/eval</member> </securityrealm> <securityrealm name="Realm2" username="Susan Wright" password="gn3x"> <member method="contains">Microsoft</member> <member method="ends_with">.net</member> <securityrealm> </securityrealms>
N2A50001
seed
The <seed> element specifies the sample seed value. The seed value is used by the seed> random number generator to produce a repeatable sequence of element IDs used to populate the sample tables. The <seed> element has no attributes and no child seed> elements. The value of the element is used as the seed. The <seed> element must be seed> contained by the <sampling> element. sampling>
Example
<seed>0</seed>
N2A60001
segment
The <segment> element contains the name of a campaign segment, which is the ad segment> variation or group within a campaign channel. The <segment> element must be segment> contained by the <channel> element. The <segment> element has no value and one channel> segment> attribute.
Attribute name Corresponding option Name of campaign segment Possible values Any alphanumeric characters Default
470
Each campaign segment has a unique identifier in entry pages affiliated with that segment. The individual entry pages associated with a campaign segment are specified using the child element <member>. The value of the <member> element is the text member> member> used to determine which entry pages are in the campaign segment.
Example
<campaigns> <campaign name="Offer"> <channel name="checkdomain" type="bannerad"> <segment name="Ad Segment 1"> <member method="equals">promo</member> </segment> <segment name="Ad Segment 2"> <member method="equals">demo</member> </segment> </channel> </campaign> </campaigns>
N2A70001
servers
The <servers> element contains a list of the clustered log files you want to analyze. (If servers> your log files are not clustered, do not use this element. Use the <logs> element logs> instead. You should not use the <servers> element and the <logs> element in the same servers> logs> configuration file.) This list appears on the Log Files page. The <servers> element has servers> one attribute.
Attribute type Corresponding option Log files are Possible values single Default single
The <servers> element has no value. The server that contains the log files is specified servers> using the child element <server>. The <server> element has one attribute. server> server>
Attribute name Corresponding option Name of server Possible values Any alphanumeric characters Default
The <server> element has no value. The full path of each log file is specified using the server> child element <logfile>. The <logfile> element has one attribute. logfile> logfile>
Version 8.2.1
471
20 - NetInsight Configuration Files Attribute format Corresponding option Format of log file(s) Possible values Default
auto, netscape, ncsa, auto w3c, iis, msproxy, website, gauntlet, ibm, raptor, openmarket, wuftpd, ncftpd, cerfnet, squid, sidewinder, watchguard, real, (User defined value Custom Log Formats)
Example
<servers type="single"> <server name="Server 1"> <logfile format="auto">/logs/server1/*.log</logfile> </server> <server name="Server 2"> <logfile format="auto">/logs/server2/*.log</logfile> </server> </servers>
N2A80001
sessionization
The <sessionization> element sets the sessionization methods on the Sessionization sessionization> page. The <sessionization> element has two attributes. sessionization>
Attribute parameter username Corresponding option Parameter value for Authenticated user name Possible values Any parameter name true, false false Default
For Web server profiles, Unica NetInsight will sessionize using whatever attributes are present. If the parameter or cookie attribute is not present, Unica NetInsight will not sessionize using parameters or cookies. The <sessionization> element has no child elements and no value. sessionization>
<sessionization parameter="SessionID" username="true"/>
Example
For Web server profiles:
<sessionization parameter="SessionID" optoutcookievalue="OPT_OUT" parameterforvisitor="true" 472 Unica NetInsight - Administrator's Guide
Web.cfg : Global Profile Configuration File username="true" cookie="UnicaID"/>

N2A90001
siteurl
The <siteurl> element sets the URL of the site being analyzed option on the General siteurl> options page. If the element is missing, the option will be blank. This element has no attributes and no child elements.
Example
<siteurl>Protocol://URL</siteurl>
N2AA0001
spiders
The <spiders> element contains a list of hosts and user agents that should be classified spiders> as robots and spiders. This list appears on the Robots/Spiders page. The <spiders> spiders> element has no attributes and no value. Each robot or spider is specified using the child element <spider>. The <spider> element has one attribute. spider> spider>
Attribute name Corresponding option Name of spider Possible values Any alphanumeric characters Default
The <spider> element has no value. The individual members of each spider or robot are spider> specified using the child element <member>. The <member> element uses both the member> member> method and type attributes inside the <spider> element. The type attribute has three spider> possible values: host, referrer, and useragent. The default value is host. The value of the <member> element is the text that determines which hosts and user agents should member> be included in the robot or spider.
Example
<spiders> <spider name="Acoon"> <member type="useragent" method="starts_with"> Acoon Robot </member> </spider> <spider name="Internap Performance Crawler"> <member type="referrer"method="equals"> http://www.internap.com/measurements/readme.html </member> </spider> </spiders>
N2AB0001
Version 8.2.1
473
summarysize
The <summarysize> element sets the Number of rows per summary option on the summarysize> General options page. The possible values are 5, 10, 15, 20, 25, 50, 75, or 100. If the element is missing, Unica NetInsight uses the default value, which is 10. This element has no attributes and no child elements.
Example
<summarysize>10</summarysize>
N2AC0001
tagimages
The <tagimages> element contains a list of page tag images. This list appears on the tagimages> Page Tagging page. This element has no value and one attribute.
Attribute type Corresponding option Page tags are Possible values off, augment, single, multiple*, hybrid** Default off
* Applies to the Used instead of log files to collect data for multiple sites page tagging option. ** Applies to the Used in addition to log files to collect data for multiple sites page tagging option. Use the child element <member> to specify the page tag images. The value of each member> <member> element is the text that determines the image that will be used to collect member> data from page tags.
Example
<tagimages type="hybrid"> <member method="equals">ntptnojs.gif</member> </tagimages>
N2AD0001
title
The <title> element sets the profile title option on the General options page. If the title> element is missing, the option is blank. This element has no attributes and no child elements.
Example
<title>Unica Corporation</title>
474

N2AE0001
titlelength
The <titlelength> element sets the Page title display length option on the General titlelength> options page. The possible values are numbers from 10 through 100 or unlimited (represented in the configuration file as a 0). If the element is missing, the default, 41, is used. This element has no attributes and no child elements.
Example
<titlelength>50</titlelength>
N2AF0001
titles
The <titles> element contains a list of page title mappings. A page title mapping titles> specifies a page title for Unica NetInsight to use for a given page instead of the title that results from resolving the page title. This list appears on the Page Title Mappings page. If the <titles> element is missing, Unica NetInsight will use the resolved page titles for titles> the pages. The <titles> element has no attributes and now value. Each page title titles> mapping is specified using the child element <title>. The <title> element has one title> title> attribute.
Attribute Corresponding option Possible values Default
page
Page
Any directory path and filename
The value of the <title> element is the page title that Unica NetInsight uses. title>
Example
<titles> <title page ="/Unica NetInsight/whitepapers/analyzing.html"> Analyzing Your Web Traffic </title> <title page ="/Unica NetInsight/whitepapers/parameters.html"> Using Parameter Summaries </title> </titles>
N2B00001
Version 8.2.1
475
unexcludedpages
The <unexcludedpages> element contains a list of pages from the excluded page types unexcludedpages> that should be included in the traffic analysis. For example, if you had previously excluded all .gif files, you could use the <unexcludedpages> element to include a unexcludedpages> specified .gif file in the analysis. This list appears on the Unexcluded Pages page. If the <unexcludedpages> element is missing, traffic from all pages of the types specified in unexcludedpages> the excluded pages list will be excluded. The <unexcludedpages> element has no attributes and no value. Use the child element unexcludedpages> <member> to specify the pages. The <member> element value is the text that identifies member> member> the pages to include.
Example
<unexcludedpages> <member method="equals">map.jpg</member> </unexcludedpages>
N2B10001
unresolvedtitles
The <unresolvedtitles> element contains a list of pages whose titles should not be unresolvedtitles> resolved. This list appears on the Unresolved Page Titles page. If the <unresolvedtitles> unresolvedtitles> element is missing, Unica NetInsight tries to resolve titles on all pages if the Resolve page titles check box is selected on the General options page. You should at least include executable files in your list, since Unica NetInsight should not attempt to resolve these page titles. The <unresolvedtitles> element has no attributes and no value. Use the child element unresolvedtitles> <member> to specify the pages.The value of the <member> element is the text that member> member> determines which pages should be included in the list.
Example
<unresolvedtitles> <member method="contains">/cgi-bin/</member> <member method="contains">/scripts/</member> <member method="ends_with">.cgi</member> <member method="ends_with">.exe</member> </unresolvedtitles>
N2B20001
url
The <url> element specifies the location of the external module. This element must be url> contained by a <connection> element. The <url> element has no attributes and no child connection> url> elements. The value of the <url> element is the URL for the external module. url>
476
Example
N2B30001
urlsearchrules
The <urlsearchrules> element contains a list of URL search and replace rules. This list urlsearchrules> appears on the URL Search and Replace page. The <urlsearchrules> element has no urlsearchrules> attributes and no value. Each URL search and replace rule is specified using the child element <urlsearchrule>. The <urlsearchrule> element has five attributes. urlsearchrule> urlsearchrule>
Attribute type global search Corresponding option Type of rule Replacement scope Search rule Possible values page, param_xyz * true, false** Any regular expression that describes the part of the URL you want to replace Any text you want to replace the text described by the search rule. To delete it, leave this attribute empty. Any alphanumeric characters Default page false
replace
Replacement value
name
Description
* In param_xyz, xyz is the parameter name. ** The value true corresponds to the option All matches and false corresponds to Only first match.The <urlsearchrule> element has no value. Use the child urlsearchrule> element <member> to specify the individual files that Unica NetInsight should scan member> for the search rule. The value of the <member> element is the text that identifies member> which files should be scanned.
Example
<urlsearchrules> <urlsearchrule type="page" global="false" search="\/(channel1)\.rm" replace="News" name="Rename news channel"> <member method="starts_with">/channel</member> </urlsearchrule> </urlsearchrules>K> Version 8.2.1 477

N2B40001
user
The <user> element specifies the user name Unica NetInsight uses to connect to the user> external module. This element must be contained by the <connections> element. The connections> <user> element has no attributes and no child elements. The value of the <user> user> user> element is the user name.
Example
<user>Unica</user>
N2B50001
userlookup
The <userlookup> element sets the User lookup URL option on the Lookup Scripts userlookup> page. If the element is missing, the option will be blank. This element has no attributes and no child elements.
Example
<userlookup> http://host.domainname.com/scripts/weblookup.exe?user= </userlookup>
N2B60001
variablesfile
The <variablesfile> element specifies a variables file to use with this profile. This variablesfile> element has no attributes and no child elements. The value of the element is the filename of the variables file to be used. The file must be located in theUnica NetInsight/data/directory. If this element is missing, Unica NetInsight uses the default variables file for the profile type.
Example
<variablesfile>myvariablesfile.xml</variablesfile>
N2B70001
viewlist
The <viewlist> element contains a list of views. The list appears on the Views options viewlist> page. This element has no attributes and no value. Specify each view using the child element <view>. The <view> element has two attributes. view> view>
478
Web.cfg : Global Profile Configuration File Attribute name Corresponding option Title of view Possible values Any unique character string less than 120 characters Any unique character string of less than 30 characters that starts with a letter, uses only alphanumeric characters, hyphens, or underscores, and does not match the name of a subdirectory in the profile's HTML directory Default
id*
Name of view (one word)
* One view must be specified as the default view by having an ID value of _default. The <view> element has no value. Use the required child elements <timeperiod> and view> timeperiod> <reportlist> to specify the default calendar state and the list of reports for the view. Use reportlist> the optional child elements <dimensionlist>, <filterlist>, and <metriclist> to specify the dimensionlist> filterlist> metriclist> dimension, filter, and metric lists for the view. The <timeperiod> element sets the Time period option on the Views options page. This timeperiod> element has three attributes.
Attribute type Corresponding option Time period Possible values all, latestday, latestweek, latestmonth, latestquarter, latestyear, prevday, prevweek, prevmonth, prevquarter, prevyear, range Any date in the form YYYYMMDD Any date in the form YYYYMMDD Default all
start*
Dates from
end*
Dates to
* This attribute is only valid if the type attribute has the value range. The <timeperiod> element has no value and no child elements. timeperiod> The <reportlist> element has no attributes and no child elements. The value of the reportlist> <reportlist> element is the ID of a defined report list. For details on defining a report list, reportlist> see the <reportlists> element. reportlists>
Version 8.2.1
479
The <dimensionlist> element has no attributes and no child elements. The value of the dimensionlist> <dimensionlist> element is the ID of a defined dimension list. For details on defining a dimensionlist> dimension list, see the <dimensionlists> element. dimensionlists> The <filterlist> element has no attributes and no child elements. The value of the filterlist> <filterlist> element is the ID of a defined filter list. For details on defining a filter list, see filterlist> the <filterlists> element. filterlists> The <metriclist> element has no attributes and no child elements. The value of the metriclist> <metriclist> element is the ID of a defined metric list. For details on defining a metric list, metriclist> see the <metriclists> element. metriclists>
Example
<viewlist> <view name="Sales View" id="sales"> <reportlist>salesreports</reportlist> <dimensionlist>salesdimensions</dimensionlist> <filterlist>salesfilters</filterlist> <metriclist>salesmetrics</metriclist> <timeperiod type="latestmonth"/> </view> <viewlist>
N2B80001
virtual
The <virtual> element sets the Only process traffic to the configured site option on the virtual> Advanced options page. If the element is present, the option is selected. If it is absent, the option is not selected. This element has no attributes, no child elements, and no value.
Example
<virtual>
N2B90001
visitorlookup
The <visitorlookup> element sets the Visitor lookup URL option on the Lookup Scripts visitorlookup> page. If the element is missing, the option will be blank. This element has no attributes and no child elements.
Example
<visitorlookup> http://host.domainname.com/scripts/weblookup.exe?visitor= </visitorlookup>
N2BA0001
480
visitorprofiles
The <visitorprofiles> element contains a list of visitor groups. (You can sort visitors into visitorprofiles> groups based on any of a large number of filters.) This list appears on the Visitor Profiles page. The <visitorprofiles> element has no attributes and no value. Each visitor visitorprofiles> group is specified using the child element <visitorprofile>. The <visitorprofile> element visitorprofile> visitorprofile> has one attribute.
Attribute name Corresponding option Name of profile Possible values Any alphanumeric characters Default
Use the child element <filterinstances> to specify the filters that define the visitor profile. filterinstances> For details on the <filterinstances> element, see the document Unica NetInsight filterinstances> Dimension and Metric Filters." Even if you want to create a visitor profile that contains all visits, the <visitorprofile> visitorprofile> element must contain the <filterinstances> element. (The <filterinstances> element filterinstances> filterinstances> can then be empty.) If the <visitorprofile> element does not contain the visitorprofile> <filterinstances> element, the visitor profile will be ignored. filterinstances>
Example
<visitorprofiles> <visitorprofile name="Downloaded"> <filterinstances> <filterinstance type="page" comparison="ends_with"> .exe </filterinstance> </filterinstances> </visitorprofile> </visitorprofiles>
N2BB0001
visitthreshold
The <visitthreshold> element sets the Number of minutes between visits option on the visitthreshold> Sessionization page. The possible values are numbers from 1 through 999. If the element is missing, the default value of 30 is used. This element has no attributes and no child elements.
Example
<visitthreshold>40</visitthreshold>
N2BC0001
Version 8.2.1
481
writebatchsize
The <writebatchsize> element defines the number of rows of data from the external writebatchsize> module Unica NetInsight writes to the database at a time. This element must be contained by the <module> element. The <writebatchsize> element has no attributes module> writebatchsize> and no child elements. The value of the <writebatchsize> element is the number of writebatchsize> rows. If this element is missing, Unica NetInsight uses the default value, which is 50,000.
Example
482

NetInsight Admin Guide

Diunggah oleh

Informasi Dokumen

Deskripsi Asli:

Hak Cipta

Format Tersedia

Bagikan dokumen Ini

Bagikan atau Tanam Dokumen

Opsi Berbagi

Apakah menurut Anda dokumen ini bermanfaat?

Apakah konten ini tidak pantas?

Hak Cipta:

Format Tersedia

NetInsight Admin Guide

Diunggah oleh

Hak Cipta:

Format Tersedia

Unica NetInsight

Publication Date: January 17, 2011

Examples and Data

Trademarks and Patents

2 Connecting to and Using the NetInsight Interface ...................................................... 36 ......................................................36

3 Creating and Configuring Profiles ............................................................................... 50 ...............................................................................50

4 Importing Log Files ...................................................................................................... 70 Files......................................................................................................

Unica NetInsight - Administrator's Guide

5 Working with Page Tags ............................................................................................. 82 .............................................................................................82

Unica NetInsight - Administrator's Guide

ntptSubmitTag ........................................................................................................................... 124

6 Configuring Reporting Options ..................................................................................125 Options.................................................................................. 125

Unica NetInsight - Administrator's Guide

7 Creating Reports ....................................................................................................... 148

8 Archiving, Emailing, and Exporting Reports ..............................................................179 Reports.............................................................. 179

Unica NetInsight - Administrator's Guide

9 Analyzing Content ..................................................................................................... 202 .....................................................................................................202

10 Analyzing Dynamic Content .................................................................................... 213 ....................................................................................213

Unica NetInsight - Administrator's Guide

11 Analyzing Marketing Efforts .................................................................................... 234 ....................................................................................234

12 Analyzing Page Titles ..............................................................................................256 Titles.............................................................................................. 256

13 Analyzing Retail Activity .......................................................................................... 262 ..........................................................................................262

Unica NetInsight - Administrator's Guide

14 Analyzing Visitors or Users ..................................................................................... 264 .....................................................................................264

About changing the order of visitor profiles ..................................................................................277

15 NetInsight System Administration ........................................................................... 278 ...........................................................................278

Unica NetInsight - Administrator's Guide

Unica NetInsight - Administrator's Guide

16 Working with Data Conduits ....................................................................................325 Conduits.................................................................................... 325

17 Working with User-Defined Processes ....................................................................354 Processes.................................................................... 354

18 Using Regular Expressions with NetInsight ............................................................ 360 ............................................................360

19 NetInsight Command-Line Options ......................................................................... 367 .........................................................................367

Unica NetInsight - Administrator's Guide

-roleinfo role_name ....................................................................................................................... 392 -userinfo user_name [-explicit] ...................................................................................................... 392

20 NetInsight Configuration Files ................................................................................. 393 .................................................................................393

Unica NetInsight - Administrator's Guide

Unica NetInsight - Administrator's Guide

Unica NetInsight - Administrator's Guide

Contacting Unica technical support

Contacting Unica technical support

Information you should gather

Unica NetInsight - Administrator's Guide

Contacting Unica technical support

Contact information for Unica technical support

1 Introduction to Unica NetInsight

About Unica NetInsight

About data collection methods

Unica NetInsight - Administrator's Guide

About data collection methods

Avoid log file transfer from disparate Web server farms

Track page views following a click on the browser's back button

1 - Introduction to Unica NetInsight

Page Tagging Log Files

The stages of Web site tracking

About Unica NetInsight reports

About Unica NetInsight reports

1 - Introduction to Unica NetInsight

2 Connecting to and Using the NetInsight Interface

About Unica NetInsight logons

Unica NetInsight - Administrator's Guide

To connect to other Unica applications from Unica NetInsight

To change your user password in NetInsight

2 - Connecting to and Using the NetInsight Interface