La capture des événements par AFS Analytics permet de mesurer les interactions entre les visiteurs et les pages d’un site internet. Ces informations révèlent les erreurs de conception et permettent d’améliorer l’expérience utilisateur et la navigation des visiteurs.
Les événements sont envoyés à AFS Analytics via la commande Send ou détectés automatiquement par l’activation de l’option autotrack.
Ce guide explique l’utilisation de la commande send pour l’envoi des événements à AFS Analytics.
Remarque: Les catégories, actions ou types doivent être spécifiés en Anglais.
L’utilisation de la commande send couplé au type d’appel event envoie un événement à AFS Analytics.
Voici la syntaxe simplifiée de la commande :
aa('send','event',[category], [action],[label], [type],[url], [callback],[params]) ;
Les champs obligatoires:
Une chaine de caractères vide comme paramètre indique à analytics.js d’utiliser la valeur par défaut.
Exemple d’envoi d’un événement:La fonction suivante indique a AFS Analytics qu’un visiteur à débuté la visualisation d’une vidéo :
aa('send', 'event', 'video', 'play', 'Ma video');
La même commande avec un objet comme argument:
Cet exemple utilise des champs compatibles avec Google Analytics.
aa('send', {
hitType: 'event',
eventCategory: 'Video',
eventAction: 'play',
eventLabel: 'Ma video'
});
Version propre à AFS Analytics :
function mycallback(a,b,c) { console.log(a,b,c); }
aa('send', {
hitType: 'event',
eventCategory: 'video',
eventAction: 'stop',
eventLabel: 'Ma video test',
eventType:"all",
eventUrl: 'http://www.afsanalytics/mavideo.avi',
hitCallback: mycallback,
params:{message:"this has been sent"}
});
Remarque: Ne pas confondre le champ hitType avec le champ type.
Dans les exemples suivants, vous trouverez une version utilisant autotrack et les datasets. Les exemples fonctionnent si l’option autotrack est activée en mode Dataset ou On.
Si vous avez un doute sur le réglage de l’option autotrack, ajoutez la ligne suivante activant autotrack en mode dataset après la création du traqueur .
aa( 'Set' ,'autotrack', 'dataset') ;
data-[datasetprefix]-[nom du champ à renseigner]='valeur du champ'
Remarque: datasetprefix est une variable définie avec la valeur par défaut aa dans analytics.js. Elle est modifiable grâce à l’option set.
Exemple d’initialisation du champ category
data-aa-category='click'
Les champs datasets sont ceux propre à AFS Analytics. C'est-à-dire hittype,category, action, label, url, callback,params;
Dans les datasets seul les champs category et label sont obligatoires. Le champ action peut être recommandé pour certains types d’événements. Les autres champs sont généralement détectés. Par défaut le champ hitType est réglé sur event.
L’option Autotrack détecte les datasets des balises a, div, button, iframe, form.
Exemple d’utilisation de dataset dans une iframe de youtube.
<iframe width="480" height="280" src="https://www.youtube.com/embed/cnBtRh08ShQ?rel=0" frameborder="0" data-aa-category='video' data-aa-action='start' data-aa-label='Advanced visitor tracking'></iframe>
A chaque clic sur la vidéo, l’événement sera capturé par AFS Analytics.
Si le champ action est vide, analytics.js détectera automatiquement le type du clic : inside ou outbound. Si le champ url n’est pas renseigné, il sera remplacé par none.
aa('send', 'event', 'click', 'inside', 'Mon clic’);
Pour un clic sortant :
aa('send', 'event', 'click', 'outbound', 'Mon clic’);
<a href="https://afsanalytics.com" data-aa-hitType="event" data-aa-category="click" data-aa-label="mon super click" >mon super clic</a>
Remarque: AFS Analytics détectera automatiquement les champs url, type et action, s’ils ne sont pas définis dans les « datasets ».
aa('send', 'event', 'download', 'successful', 'Mon fichier’,’non’,’http://monsite.com/monfichier.pdf’);
<a href="http://monsite.com/monfichier.pdf" data-aa-hitType="event" data-aa-category="download" data-aa-label="mon super fichier pdf" data-aa-callback="mycallback" data-aa-params="{message:'test'}" >monfichier.pdf</a>
Remarque: Le passage de la fonction de retour (callback) qui sera appelée après l’envoi de l’événement à analytics.js. L’url n’a pas besoin d’être spécifiée dans les « dataset», elle est déjà renseignée dans la balise a href.
AFS Analytics permet de détecter les événements liés au remplissage des formulaires. Si les événements sont envoyés correctement, AFS calculera le temps moyen de remplissage et le taux d’abandon. La catégorie form est réservé au formulaire.
Les différentes étapes du remplissage d’un formulaire :1. l’ouverture du formulaire : l’action : open
aa('send', 'event', 'form', 'open', 'Mon formulaire');
2. la soumission du formulaire : l’action submit
aa('send', 'event', 'form', 'submit', 'Mon formulaire');
3. Le résultat de la soumission.
aa('send', 'event', 'form', 'successful', 'Mon formulaire');
aa('send', 'event', 'form', 'failed’, 'Mon formulaire');
aa('send', 'event', 'form', 'close', 'Mon formulaire');
Dans le cas ou le formulaire est fermé avec un bouton d’annulation.
aa('send', 'event', 'form', 'cancel', 'Mon formulaire');
aa('send', 'event', 'form', 'close', 'Mon formulaire');
ou en utilisant l’action: cancelandclose:
aa('send', 'event', 'form', 'cancelandclose', 'Mon formulaire');
Si les actions open et close ont été correctement définies. Le temps moyen de visualisation de la fenêtre sera affiché sur le tableau de bord.
Les valeurs du champ type associées au formulaire:En ajoutant le paramètre type vous pouvez définir le type de la forme.
Les options disponibles sont :Cette partie sera ajoutée ultérieurement.
L’événement window offre deux actions : open et close.
1. l’ouverture de la fenêtre : open
aa('send', 'event', 'window', 'open', 'Ma fenêtre');
2. la fermeture avec close
aa('send', 'event', 'window', 'close', 'Ma fenêtre’);
Si les actions open et close ont été correctement définies. Le temps moyen de visualisation de la fenêtre sera affiché sur le tableau de bord.
Quatre actions sont proposées pour l’événement Video: start, pause, resume , stop. L’action start peut être remplacée par play, la librairie analytics.js accepte les deux possibilités.
1. L’utilisateur commence la lecture de la video :
aa('send', 'event', 'video', 'start', 'Ma vidéo');
2. L’utilisateur clique sur le bouton pause.
aa('send', 'event', 'video', 'pause', 'Ma vidéo');
3. L’utilisateur reprend la lecture de la vidéo
aa('send', 'event', 'video', 'resume', 'Ma vidéo');
3. La vidéo est finie ou l’utilisateur arrête la vidéo.
aa('send', 'event', 'video', 'stop', 'Ma vidéo');
Comme mentionné ci-dessus, l’action play peut être utilisé comme alternative à l’action start.
<iframe src="https://www.youtube.com/embed/cnBtRh08ShQ?rel=0" frameborder="0" data-aa-category='video' data-aa-action='play' data-aa-label='AFS Analytics vidéo'></iframe>
L’événement « alert » est très utiles pour envoyer des messages d’alertes personnalisés à AFS Analytics. De nombreuses multinationales utilisent un compte dédié d’AFS Analytics pour la capture des bogues de leur site. Cette option, utilisée par les agences web pour assurer la fiabilité des sites développés, permet pour chaque alerte de consulter la fiche et la configuration du visiteur qui a généré l’erreur.
Les actions disponibles pour l’événement alert:Pour le type d’alerte, il est possible de choisir entre warning, debug, error or fatal.
aa('send', 'event', 'alert', 'post', 'Erreur routine javascript', 'fatal');
L’événement campaign est généré automatiquement par analytics.js grâce aux paramètres utm présents dans la query string de la page. Veuillez consulter le guide « Comment mesurer le trafic des campagnes publicitaires » pour plus de renseignements.
La capture des ventes et des transactions liées à l’e-commerce sont décrites dans le guide : Capture des ventes et E-commerce.
AFS Analytics accepte seulement des "catégories", "actions" et "types" prédéfinis. Voici une liste non exhaustive.
click, download form, video, window, alert, et navigation
None,Open,Close,Outbound,Inside,Send,Submit,Cancel,Cancelandclose,Successful,Failed,Start,End,Proceed,View ,Post,Email,SMS,EmailAndSMS,Play,Pause ,Stop,Resume
None,Button,Link,Div,iframe,Page,Information,Alert,Setting,Signup,Login,Warning,Fatal,Debug,Error,Contact,Logout,Menu
Ce guide vous a appris à capturer les événements avec analytics.js. Pour poursuivre votre formation, la consultation des guides suivants est recommandée :
La capture des événements avec Autotrack.
Mesurer l’impact des campagnes publicitaires.
La capture des événements liés à l’e-Commerce.
Ce guide a été mis-a-jour le 28 Février 2017 par AFS Analytics, Web Analytics.