La capture des pages


La capture des pages

La capture des pages permet de mesurer le nombre de vues et le temps consacré par vos visiteurs à chacune d’elles. Ce guide explique comment utiliser la librairie analytics.js pour capturer et envoyer ces données à AFS Analytics, solution de web analytics .

La commande "Send" pour la capture des pages

Lors de la création du traqueur, plusieurs champs sont définis par les données fournies dans le document. Par exemple, le champ title est indiqué dans la balise <title> et l’URL correspond à l’adresse de la page.

Une fois les données collectées, elles sont modifiable grâce à la commande set, et certaines d’entre elles, peuvent être remplacées directement dans la commande d’envoi.

L’envoi des données se fait avec la commande send en utilisant la syntaxe suivante:


aa(‘send’,’pageview’,[page],[title],[location] ,[hitCallback],[params]) 

Seul le champ hitType est obligatoire. Il doit indiquer pageview comme type d’appel.

Les champs optionnels :

Remarque: Si un champ comporte une chaine vide, la valeur par défaut ou stockée précédemment sera utilisée.

  • Page: Ce champs indique l’index utilisé par AFS Analytics pour trier les pages. Vous pouvez utiliser votre propre méthode d’indexation ou utiliser une méthode prédéfinie comme autoindex, titleindex, urlindex, pageindex.
  • Title: Ce champ spécifie le nom ou le titre de la page.
  • Location: Ce champ indique l’adresse URL de la page.
  • hitCallback: Ce champ définit la fonction de retour callback. Cette fonction sera appelée après l’envoi de la page au serveur d’AFS Analytics. La valeur peut être une fonction, ou une chaine avec le nom de la fonction.
  • Params: C’est un objet contenant vos propres variables récupérables dans la fonction de retour.

Exemples d’utilisation.

Utilisation sans aucun paramètre:

aa(‘send’,’pageview’);
Utilisation en définissant le titre de la page.

Notez la chaine vide pour le champ page


 aa(‘send’,’pageview’,’’,’mon titre’); 
Utilisation en définissant une fonction de retour.

Notez les chaines vides pour les arguments page et url.


aa('send','pageview','','montitre','', 'mafonctionderetour'); 

Définir les champs sous forme d’objet :

Les champs peuvent être aussi spécifiés dans un objet. Vous êtes libres de choisir les champs à renseigner. Seul le champ hitType est obligatoire.


aa('send',{
hitType :'pageview',
page : 'titleindex',
title : 'mapage',
location : 'https://monsite.com',
hitCallback : 'mafonctionderetour',
}) ;

Simplification de l’adresse de la page

Si l’URL de la page contient dans la query string ou dans la partie ancrage des paramètres de campagnes publicitaires, AFS les détachera et les traitera avec l’envoi de la page.

Analytics.js offre également un paramètre allowAnchor, qui permet de sauvegarder ou d’ignorer la query string et la partie d’ancrage de l’URL lors de sa transmission. Cette commande à placer après la création du traqueur demande à AFS d’ignorer les additifs à l’URL.


aa(set,'allowAnchor',false) ; // on peut remplacer false par 0;

Remarque : allowAnchor est réglé sur false par défaut lors de la création du traqueur.

Comment utiliser la fonction de retour.

Vous trouverez une explication détaillée dans le guide : L’envoi des données à AFS Analytics.

La fonction de retour ou callback est appelée après l’envoi de la page à AFS Analytics. Elle retourne trois paramètres :

  • 1. Le hitType de la commande exécutée.
  • 2. L’objet tracker.
  • 3. L’objet params défini dans la fonction appelante.
  • Exemple fonction de retour:
    
     //définition de mon propre objet
    Var monobjet={
        message:"la page vue a été envoyée a AFA Analytics",
        pagevue:document.title,
        location:window.location.href
    };
    //définition de ma fonction de retour
    function mycallback(commande,tracker,objretour)
    {
            console.log("Les informations du traqueur ont été envoyé a AFS Analytics!");
            console.log("La commande était ->",commande);
            console.log("La page était ->",objretour.pagevue,"l'url->",objretour.location);
            console.log ("L'unique ID  du visitor envoyé par AFS est->",tracker.get("visitor.id"));
            console.log ("Le traqueur est nommé ->",tracker.get("name"));
            console.log ("Le cookie du visiteur ->",tracker.get("cookie.str"));
            console.log(tracker);
    }
    
    //appels à analytics.js
    aa('create', '00000003', 'auto');
    aa('send', 'pageview',"autoindex","Test Page","","mycallback",monobjet);
    
    Sortie sur la console :
    
    Les informations du traqueur ont été envoyé a AFS Analytics!
    La commande était -> pageview
    La page était -> Test callback 
    l'url-> http://127.0.0.1/tc.html
    l'unique ID  du visitor envoyé par AFS est-> 31
    Le traqueur est nommé -> afstracker0
    Le cookie du visiteur -> 3x6226x1191x31x6103x1
    

    Définir l’envoi d’une page vue via AutoTrack

    Dans les sites avec une seule page, l’accès aux différentes sections est généralement défini à l’aide d’une ancre. Pour capturer la visualisation de ces sections comme des pages, vous devez :

    1. Définir l’index avec la valeur titleindex. Référence les sections avec des noms différents.

    2. Utiliser:
    a: Soit l’option Autotrack: L’option Autotrack permet de définir des événements spécifiques à exécuter lors d’un click sur un lien. Pour cela, on définit les données dans les datasets :

    
    <a href="#contact-us” data-aa-hitType="pageview"  data-aa-title="contact-us" >contact-us</a>
    
    A chaque clic, la page vue contact-us sera envoyée par anlytics.js à AFS Analytics.

    b: Soit définir votre propre fonction et l’appeler avec onclick.

    Utiliser onclick couplée avec une fonction appelant AFS Analytics.
    
     function SendPV(name) {
      aa('send','pageview','titleindex',name);  
      return true;
    }
    <a href="#contact-us" onclick="return sendPV("contact us");">Contact Us!</a>
    

    L’étape suivante:

    Dans ce guide, vous avez appris à capturer les pages avec AFS Analytics.
    La prochaine étape est la capture des événements.

    By AFS Website Analytics.

    Go Top

AFS Analytics uses LiveDisplay Tachnology