Identification des Sessions de Recherche et des Visiteurs Uniques - AFS

Bonnes Pratiques Pour la Qualification des Visiteurs AFS

Product
AFS
AFS_Version
7.11
Category
Technical Notes
language
French
audience
public

Un visiteur unique est un utilisateur du service de recherche. Il est identifié de façon unique à partir du système et du navigateur Web qu’il utilise pour se connecter. Il est stocké sous forme de userId.

Une session de recherche regroupe les requêtes effectuées pendant une période de temps donnée par un visiteur unique. Elle est stockée sous forme de sessionId.

  • L'intégrateur à la responsabilité de propager les informations suivantes:
    • un userId qui peut être stocké de manière persistante sur l’ordinateur d’un utilisateur (via un cookie) ou dans une base utilisateur si le portail client en utilise une.
    • un sessionId qui peut être stocké pendant un cours laps de temps et pendant une session unique de navigateur web (par exemple 30 minute). Un cookie est aussi utilisé.

  • Lors d’une requête au web service search d'AFS:
    • L'intégrateur peut choisir de propager ses propres valeurs de userId et sessionId à l'aide des paramètres afs:userId et afs:sessionId. Cela permet une gestion unifiée des ces identifiants avec son applicatif.
    • Des valeurs pour les userId et sessionId sont générées automatiquement s’ils n’ont pas été fournis dans l’appel.

Les valeurs de ces paramètres sont présentes dans le flux de réponse au xPath afs:replies/afs:header/afs:query. En voici un exemple:

afs:query userId="d293313e-7151-456f-822e-10f48486a561" sessionId="0a8028e8-4565-4088-a90e-2902a64d2828" date="2012-09-19T16:47:01+0200" textQuery="foobar"

Les valeurs de ces paramètres sont aussi présentes dans les cookies.

  • Les appels ultérieurs au moteur doivent propager ces valeurs à l'aide des paramètres afs:userId et afs:sessionId.

En synthèse, pour identifier les sessions de recherche et les visiteurs uniques :

1. Lorsqu’un visiteur fait une recherche, il faut d’abord essayer de le reconnaître : lecture d’un userId de search (en cookie ou en base) et d’un cookie de session.

2. Puis, lancer la requête en propageant ces informations via les paramètres prévus à cet effet.

3. Dans la réponse, récupérer le sessionId et le userId.