mod_usertrack
Journalisation Clickstream des liens parcourus par un utilisateur sur un site
Extension
mod_usertrack.c
usertrack_module

Ce module permet de suivre le parcours d'un utilisateur à travers votre site web en faisant appel aux cookies de navigateur.

# 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
CookieDomain
Le domaine auquel le cookie traceur s'applique
CookieDomain domaine
server config
virtual host
directory
.htaccess
FileInfo

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.

La plupart des navigateurs utilisés actuellement n'autorisent pas la définition de cookies pour un domaine racine de deux niveaux, tel que `.co.uk`, bien qu'un tel domaine remplisse les conditions de validité décrites ci-dessus.

Ces domaines sont équivalents à des domaines racines comme `.com`, et autoriser de tels cookies peut constituer un risque en matière de sécurité. Ainsi, si vous vous situez sous un domaine racine de deux niveaux, vous devez encore utiliser votre domaine véritable, comme vous le feriez avec tout autre domaine racine (par exemple `.example.co.uk`).

CookieDomain .example.com
CookieExpires
Durée avant expiration du cookie traceur
CookieExpires durée
server config
virtual host
directory
.htaccess
FileInfo

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"
CookieName
Nom du cookie traceur
CookieName symbole
CookieName Apache
server config
virtual host
directory
.htaccess
FileInfo

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
CookieStyle
Format du champ d'en-tête cookie
CookieStyle Netscape|Cookie|Cookie2|RFC2109|RFC2965
CookieStyle Netscape
server config
virtual host
directory
.htaccess
FileInfo

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
CookieTracking
Active le cookie traceur
CookieTracking on|off
CookieTracking off
server config
virtual host
directory
.htaccess
FileInfo

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