17 visitor.ini

The visitor.ini file is installed by WebCenter Sites. However, the properties in the file configure WebCenter Sites: Engage rather than WebCenter Sites. The properties configure the visitor data collection and other features provided by WebCenter Sites: Engage.

Properties in the visitor.ini file are organized by function on the following tabs in the Property Editor:

17.1 Visitor Data Tab

The Visitor Data tab holds the main properties in the file.

Table 17-1 Properties in visitor.ini: Visitor Data Tab

Property Description

vis.adminrole

Specifies the ACL that Engage users need in order to work with the visitor attribute, history attribute, history type, and recommendation asset types.

Default value: VisitorAdmin

Do not change the value of this property.

vis.compileclasspath

Specifies the classpath against which to compile the rules.

This value is set during the installation and should not be changed after that point.

vis.editrole

Specifies the ACL that two kinds of Engage users need:

  • Content providers who use the WebCenter Sites system to create segments and promotions.

  • The visitors to your online site when you are using Engage to gather information about them for segments.

Default value: Visitor

Do not change the value of this property.

vis.genclasspath

Specifies the directory (including the final slash character) where rules-engine-generated class files for visitor data are stored.

This value is set during the installation and should not be changed after that point.

vis.money

Specifies the SQL string for defining fields that hold monetary values.

Do not change the value of this property without consulting your database administrator.

vis.path

Specifies the directory that holds the ruleset.dtd file, which is usually the installation directory. This value is set during installation.

Do not change the value of this property.

vis.rulesetxmlpath

Specifies the defdir (default storage directory) for the XML versions of the rule sets.

This value is set during installation.

Do not change the value of this property.

vis.sessiondata

Specifies the defdir (default storage directory) for storing visitor session data.

This value is set during installation.

Do not change the value of this property.

vis.update

Specifies whether every page access will update the visitor timestamp in the visitor data.

Possible values: true | false

Set to true if you want every page access to update the visitor timestamp in the visitor data; false otherwise.

Default value: true

vis.url

Specifies the SQL string for defining visitor and history attributes of type URL.

Default value: VARCHAR(128)

Do not change the value of this property without consulting your database administrator.

vis.urlpath

Specifies the defdir for binary visitor and history attributes.

Default value: /futuretense/visurl/

vis.useSessionVisitorConnection

This property determines whether Engage visitors will be tracked via the database- or memory-centric method, which improves the performance of heavily trafficked sites featuring Engage assets. In memory-centric tracking, WebCenter Sites stores visitor scalar attribute values to the add-on repository, and visitor history attribute values to its own database. All computations to determine a visitor's segments are performed in memory; results are cached.

By default, this property is not automatically included in visitor.ini, in which case its value is understood to be false (i.e., database-centric).

This property must be set on the delivery system in one of the following ways:

On content management systems, this property must be either set to false or omitted, given that visitor attributes are created and managed only on CM systems that are enabled for database-centric tracking. Management of visitor attributes is not supported on delivery systems; the attributes must be published to the delivery systems.

17.2 User Defined Tab

Table 17-2 Properties in visitor.ini: User Defined Tab

Property Description

This tab, by default, has no properties.

N/A