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.
La capture des événements avec la commande SEND
L’utilisation de la commande send couplé au type d’appel event envoie un événement à AFS Analytics.
1. category: Ce champ définit la catégorie de l’événement (par exemple : Video). Le champ alternatif : eventCategory est accepté afin d’assurer la compatibilité avec Google Analytics.
2. action: Ce champ spécifie le type d’action attachée à la catégorie (par exemple play). L’appellation eventAction pour ce champ est accepté assurant la compatibilité avec Google Analytics.
3. label: Ce champ donne un titre à l’événement (par exemple: Ma vidéo de vacance). eventLabel est accepté afin d’assurer la compatibilité avec Google Analytics.
Les champs optionnels:
4. type: Ce champ définit le type ou une information supplémentaire à propos de l’événement. Champ optionnel.
5. url: Ce champ définit une location à l’événement. Champ optionnel.
6. callback: Fonction de retour à appeler après la transmission de l’événement aux serveurs d’AFS Analytics. La fonction renvoie trois paramètres. Le hitType, l’objet event et l’objet params. Ce paramètre peut être une fonction ou une chaine de caractères contenant le nom de la fonction. Champ optionnel
7. params: Un objet définit dans la fonction appelante à retourner comme paramètres dans la fonction de retour. Champ optionnel
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.
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.
L’option "Autotrack" et les "datasets"
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') ;
Définir les datasets:
La syntaxe d’un "dataset" dans une balise HTML est la suivante :
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.
Les balises détectées par Autotrack
L’option Autotrack détecte les datasets des balises a, div, button, iframe, form.
Exemple d’utilisation de dataset dans une iframe de youtube.
A chaque clic sur la vidéo, l’événement sera capturé par AFS Analytics.
L’événement "click" pour la détection des clics.
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.
La détection des clics avec "Autotrack" et les "datasets".
<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 ».
L’événement "download" pour la détection des fichiers téléchargés.
L’envoi d’un fichier téléchargé se transmet à analytics.js via la catégorie « Download ». Le champ « type » n’étant pas utile on indique la valeur « none », le champ « URL » indique l’emplacement du fichier.
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.
L’événement "form" pour les formulaires.
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 :
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.
L’événement "Video" pour les vidéos.
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 :
L’événement Alert pour les alertes et le débogage.
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:
Post: Toujours vrai, l’alerte apparait dans le rapport regroupant les alertes.
Email: L’alerte est transmise par email à l’adresse email définie dans AFS Analytics.
SMS: L’alerte est transmise par SMS.
EmailandSms: L’alerte est transmise par SMS et EMAIL.
Pour le type d’alerte, il est possible de choisir entre warning, debug, error or fatal.
L’événement Campaign pour la capture des campagnes publicitaires.
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.
Les événements liés à l’e-commerce.
La capture des ventes et des transactions liées à l’e-commerce sont décrites dans le guide : Capture des ventes et E-commerce.
Les options prédéfinies acceptées par AFS Analytics.
AFS Analytics accepte seulement des "catégories", "actions" et "types" prédéfinis. Voici une liste non exhaustive.
Les catégories des événements:
click, download form, video, window, alert, et navigation
