Identification des Éléments Sélectionnés - AFS - Technical Notes

Bonnes Pratiques Pour la Qualification des Visiteurs AFS

Product
AFS
AFS_Version
7.11
Category
Technical Notes
language
French
audience
public

AFS comprend un web service (click) permettant d’enregistrer sur quel document, facette ou plus généralement quel élément d’une réponse un utilisateur a cliqué. click permet d’effectuer uniquement l’enregistrement et de façon optionnelle de proposer ensuite l’élément cible à l’utilisateur au moyen d’un mécanisme de redirection.

Liste des paramètres du web service click :

Nom du paramètre

Cardinalité

Description

afs:service

obligatoire

Numéro du service de recherche

afs:status

optionnel

Statut du service de recherche (défaut à stable)

afs:label

optionnel

Titre du document (sera utilisé dans le hit-parade des docs dans le Back Office)
Correspond en général au contenu de la balise afs:title

afs:action

obligatoire

Permet de choisir le comportement de click:

  • afs:action=logHttpRedirect est le comportement par défaut : enregistre le clic et fait la redirection HTTP.
  • afs:action=log enregisre le clic mais ne fait pas la redirection HTTP.
  • afs:action=HttpRedirect fait la redirection HTTP mais n'enregistre pas le clic.

afs:target

obligatoire

URL de redirection vers la fiche finale.

afs:ip

Optionnel

Définie l'IP de l'utilisateur faisant la requête. Cela surcharge la valeur du navigateur.

afs:userAgent

Optionnel

Définie le User-Agent de l'utilisateur faisant la requête. Cela surcharge la valeur du navigateur.

Exemple d’utilisation :

http://myproject.afs-antidot.net/click?afs:service=<my_service_id>&afs:log=foobar&afs:label="foo+bar"&afs:target=http://www.myproject.com/my_page.html

L'URL ci dessus n'est pas encodée, pour faciliter la compréhension. Dans la pratique, il est nécessaire de l'encoder (voir Wikipedia, percent-encoding pour plus d'information).