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 maintenant 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 de votre utilisateur. 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