Pages vues

La mesure des pages vues vous permet de mesurer le nombre de vues enregistrées pour une page spécifique de votre site Web. Les pages correspondent souvent à un document HTML complet, mais elles peuvent également représenter du contenu chargé dynamiquement. C'est ce que l'on appelle les "pages vues virtuelles".

Ce guide explique comment implémenter la mesure des pages vues avec analytics.js.

Présentation

La balise JavaScript comprend une commande permettant de créer un objet de suivi, puis une commande permettant d'envoyer une page vue à Google Analytics. Lorsque l'outil de suivi est créé, plusieurs champs sont définis en fonction du contexte de navigation. Le champ title est défini sur la valeur de document.title, tandis que le champ location est défini sur la valeur de document.location, en ignorant la partie ancrage de l'URL.

Lorsque la commande send est exécutée, les champs title et location stockés dans l'outil de suivi sont envoyés, et Google Analytics utilise ces valeurs pour vous indiquer les pages que vos utilisateurs ont consultées.

L'outil de suivi par défaut ne définit pas le champ page. Toutefois, si vous le définissez manuellement, cette valeur est utilisée comme chemin de la page dans les rapports, écrasant ainsi la valeur du champ location.

Implémentation

Les appels de page vue peuvent être envoyés en utilisant la commande send et en spécifiant un hitType de pageview. La commande send a la signature suivante pour le type d'appel pageview:

ga('send', 'pageview', [page], [fieldsObject]);

Champs "Page vue"

Le tableau suivant récapitule les principaux champs pertinents pour mesurer les pages vues. Pour en savoir plus (et pour accéder à des champs supplémentaires), consultez la section Informations sur le contenu de la documentation de référence sur les champs.

Nom du champ Type de valeur Obligatoire Description
title text no Titre de la page (par exemple, page d'accueil)
location text non * URL de la page.
page text non * Partie chemin d'accès d'une URL. Cette valeur doit commencer par une barre oblique (/).

* Bien que les champs page et location ne soient pas obligatoires, l'un d'entre eux doit être présent, sans quoi l'appel ne sera pas valide.

Exemples :

La commande suivante envoie un appel de page vue à Google Analytics et inclut le chemin de la page actuelle.

ga('send', 'pageview', location.pathname);

Notez que, comme pour toutes les commandes send, les champs transmis dans les paramètres de commodité peuvent également être spécifiés dans fieldsObject. La commande ci-dessus peut être réécrite comme suit:

ga('send', {
  hitType: 'pageview',
  page: location.pathname
});

Modifier les URL des pages

Dans certains cas, l'URL que vous souhaitez envoyer à Google Analytics diffère de l'URL qui apparaît dans la barre d'adresse du navigateur de l'utilisateur. Prenons l'exemple d'un site comportant quelques pages sur lesquelles les utilisateurs peuvent se connecter et consulter/modifier leurs informations personnelles. Si ce site comporte des pages distinctes pour les informations personnelles, les informations sur le compte et les paramètres de notification, les URL de ces pages peuvent se présenter comme suit:

  • /user/USER_ID/profile
  • /user/USER_ID/account
  • /user/USER_ID/notifications

Si vous souhaitez connaître le nombre total de personnes qui ont consulté chacune de ces pages, il est beaucoup plus difficile d'inclure une valeur d'ID utilisateur unique dans les URL.

Pour résoudre ce problème, vous pouvez spécifier une valeur page sans supprimer l'ID utilisateur:

// Checks to see if the current user's userID is
// found in the URL, if it is, remove it.
// (Note, this assume the user ID is stored
// in a variable called `userID`)

if (document.location.pathname.indexOf('user/' + userID) > -1) {
  var page = document.location.pathname.replace('user/' + userID, 'user');
  ga('send', 'pageview', page);
}

Les valeurs page suivantes seront envoyées pour tous les utilisateurs:

  • /user/profile
  • /user/account
  • /user/notifications

Si la page actuelle envoie d'autres appels (par exemple, des événements), vous devez vous assurer que chaque appel est envoyé avec l'URL appropriée. Dans ce cas, vous devez mettre à jour le champ page sur l'outil de suivi au lieu de le transmettre dans la commande send.

Si vous la définissez sur l'outil de suivi, la nouvelle valeur page sera utilisée pour tous les appels suivants:

if (document.location.pathname.indexOf('user/' + userID) > -1) {
  var page = document.location.pathname.replace('user/' + userID, 'user');

  // Sets the page value on the tracker.
  ga('set', 'page', page);

  // Sending the pageview no longer requires passing the page
  // value since it's now stored on the tracker object.
  ga('send', 'pageview');
}

Suivi des pages vues virtuelles

Aujourd'hui, de nombreux sites Web chargent le contenu de manière dynamique via AJAX, sans qu'il soit nécessaire de charger toute la page pour chaque "page". Ces sites sont communément appelés applications monopages (SPA).

Si votre site Web charge le contenu des pages de manière dynamique et met à jour l'URL du document, vous souhaiterez généralement envoyer des pages vues supplémentaires pour mesurer ces "pages vues virtuelles". Pour en savoir plus sur l'implémentation, consultez le guide sur le suivi des applications monopages avec analytics.js.