Aller au contenu

Capture des visiteurs

La librairie analytics.js vous permet d’envoyer et d’échanger vos données sur les utilisateurs de votre site. Par exemple, lorsque un visiteur remplit un formulaire ou se connecte, vous pouvez transmettre des informations à AFS Analytics. Celles-ci seront attachées au profil du visiteur et apparaitront à chacune de ses visites.

L’envoi des données aux serveurs d’AFS s’effectue en deux étapes:

  1. Le stockage des données par analytics.js: Le stockage s’effectue grâce la commande set suivit du mot clé visitor.
  2. La transmission des données au serveur : La transmission au serveur s’effectue grâce à la commande send suivit du mot clé visitor.

Note

Si vous avez installé l’extension WordPress d’AFS Analytics sur votre site, celle-ci transmettra automatiquement les données à AFS Analytics lors de la connexion des utilisateurs. Ces fonctions sont seulement disponibles avec l'abonnement aux plans Silver et Gold.

Le stockage des données

La commande set permet de stocker les données grâce à un objet, ou une chaine indiquant la variable.

Syntaxe: 

aa("set","visitor",[object])

/* Ou */
aa("set","visitor.[variable]",[value])

Exemple: 

aa("set","visitor",{firstname:"christophe";lastname:"Durand"};

/* Qui est équivalent à */

aa("set","visitor.firstname","Christophe");
aa("set","visitor.lastname","Durand");

Variables disponibles

Note

Toutes les variables sont optionnelles.

Variable Description
job "create" pour la création du profil. "update" pour la mise à jour du profile. "delete" pour la suppression du profile. Par défaut, la valeur est définie à update,mode de mise à jour. Le mode création enregistre les données seulement si l'utilisateur est nouveau. Le mode « mise à jour » met à jour les données ou effectue la création du profil si il n’existe pas. Le mode « suppression » supprime le profil de l’utilisateur
logged Le visiteur s’est authentifié (logged) sur le site.
afsid L’identifiant unique du visiteur créé par AFS Analytics. Par défaut, c’est l'ID du visiteur connecté.
yourid C’est votre propre identifiant unique.
username C’est le pseudo de l’utilisateur ou son identifiant utilisé pour la connexion.
displayedname Le nom à afficher sur la liste des visiteurs. Par défaut c’est l’username qui est affiché.
role La fonction ou le rôle de l’utilisateur. C’est une chaine de caractère. Exemple administrateur, membre, etc. A vous de le définir.
firstname Le prénom de l’utilisateur.
lastname Le nom de famille.
company Le nom de la société.
address Numéro et nom de la rue.
addressplus Adresse ligne 2.
city La ville.
state La région ou l'état.
country Le pays.
zipcode Le code postal.
email Email
phone Le numéro de téléphone (fixe de préférence)
sms Le numéro de téléphone mobile qui peut recevoir des SMS
birthday La date de naissance sous la forme AAAA-MM-JJ.
gender M pour masculin, F pour féminin.
photourl Adresse URL de l'image représentant l’utilisateur (https).
yournote Vos remarques sur le visiteur.
yoururl Le lien pour l’identifiant que vous avez fourni "yourid".
followlist Liste(s) à attacher à l’utilisateur. Cela peut être l’identifiant numérique des listes, ou le nom des listes. S’il y a plusieurs listes, elles doivent être séparées par une virgule. Vous pouvez créer les listes, ou noter leur identifiant en cliquant sur lorsque le profil d’un visiteur est affiché.
addtolist Indique si followlist est un ajout aux listes déja existantes (valeur = "yes") ou doit remplacer les listes existantes (valeur = "no"). Valeur par défault: "no".

Transmission des données au serveur

La transmission des données s’effectue avec la commande send. Après la transmission des données analytics.js réinitialise les données.

Syntaxe: 

aa("send","visitor");

Exemple d'envoi des données: 

data = { 
    job:"update",
    firstname:"Christophe",
    lastname:"Durand",
    username:"chris277",
    displayedname:"The Boss",
    birthday: "1989-12-31",
    photourl:"https://www.afsanalytics.com/images2/profile/demo.png",
    role:"Administrator",
    followlist:"Developer team, support"
    };

/* définit les variables du visiteur */
aa("set","visitor",data); 
aa("create", "xxxxxxxx", "auto"); 
aa("send", "pageview");
aa("send","visitor");

Authentification des utilisateurs

Exception: quand un utilisateur se connecte, la commande Send visitor n’est pas obligatoire après la définition de la variable logged (visitor.logged), si celle-ci est définit avant la ligne envoyant les données de la page.

Par exemple: 

aa("create", "xxxxxxxx", "auto"); 
aa("set","visitor.logged",1); 

/* pas besoin d'ajouter send visitor */

aa("send","pageview");