Journalisation

mod_usertrack définit un cookie qui peut être journalisé via les formats configurables du module mod_log_config :

LogFormat "%{Apache}n %r %t" usertrack
CustomLog logs/clickstream.log usertrack

Directive CookieDomain

Cette directive permet de définir le domaine auquel le cookie traceur s'applique. Si elle n'est pas présente, aucun domaine n'est inclus dans le champ d'en-tête cookie.

La chaîne dommaine doit commencer par un point, et doit comporter au moins un point entouré d'autres caractères. Par exemple, .example.com est une chaîne valide, mais www.example.com et .com ne le sont pas.

CookieDomain .example.com

Directive CookieExpires

Lorsqu'elle est utilisée, cette directive définit une durée avant l'expiration du cookie généré par le module usertrack. La durée peut être spécifiée sous la forme d'un nombre de secondes, ou sous une forme du style "2 weeks 3 days 7 hours". les termes valides sont : years, months, weeks, days, hours, minutes et seconds. Si la durée est spécifiée dans un format autre qu'un nombre de secondes, elle doit être entourée de guillemets.

Si cette directive est absente, la durée de vie des cookies est limitée à la session actuelle du navigateur.

CookieExpires "3 weeks"

Directive CookieName

Cette directive vous permet de modifier le nom du cookie que ce module utilise pour sa journalisation. Le nom par défaut du cookie est "Apache".

Vous devez spécifier un nom de cookie valide ; les résultats sont imprévisibles si vous utilisez un nom contenant des caractères inhabituels. Les caractères valides font partie des intervales A-Z, a-z, 0-9, "_", et "-".

CookieName clicktrack

Directive CookieStyle

Cette directive permet de contrôler le format du champ d'en-tête cookie. Les trois formats autorisés sont :

• Netscape : il s'agit du format original, mais est désormais obsolète. C'est le format par défaut et il correspond à la syntaxe historique utilisée par Apache.
• Cookie ou RFC2109 : c'est la syntaxe qui remplace la syntaxe Netscape.
• Cookie2 ou RFC2965 : c'est la syntaxe de cookie la plus actuelle.

Tous les clients ne supportent pas l'ensemble de ces formats, mais il est conseillé d'utiliser le plus récent qui sera en général supporté par le navigateur utilisé par vos utilisateurs. A l'heure où ce document est écrit, la plupart des navigateurs supportent ces trois formats, Cookie2 étant le format recommandé.

CookieStyle Cookie2

Directive CookieTracking

Lorsque le module mod_usertrack est chargé, et si CookieTracking on est définie, Apache enverra un cookie traceur pour toute nouvelle requête. Cette directive peut être utilisée pour activer ou désactiver ce comportement pour un serveur virtuel ou un répertoire. Par défaut, l'activation de mod_usertrack ne suffit pas pour activer les cookies.

CookieTracking on