Envoyer des pageviews

Rappel. ー Une pageview est la visite par un internaute d’une page (il est parfois appelé hit ou pagehit). Il contient automatiquement et notamment l’URL courante de la page, la taille de l’écran, la taille de la fenêtre et la taille du document.

Il y a 2 instructions qui peuvent être à l’origine d’un pageview.

Un pageview est automatiquement et obligatoirement envoyé lorsque le tag principal est chargé. Il n’est pas possible d’empêcher cet envoi mais il est possible de modifier l’URL envoyée. Notez que l’URL qui est envoyée ne contient pas le hash (les éléments présents après le ”#”).

Modifier l’URL envoyée avec setPath

Une instruction JavaScript peut-être exécutée pour envoyer un pageview artificiel, via la commande trackPageview. Cette commande est utile lorsque la page change sans provoquer un full reload et donc un nouveau chargement du tag principal :

• chargement en ajax,
• ouverture d’une popin,
• changement d’onglets,…

Il suffit de charger le tag principal.

En savoir plus sur l’installation du tag principal.

Voir Les pageviews artificielles.

Pour modifier l’URL qui sera envoyée automatiquement par le tag principal, utilisez une des deux commandes suivantes setPath ou setQuery :

Contentsquare fournit des commandes pour modifier l’URL envoyée automatiquement par le Tag.
Ces commandes permettent notamment de passer des informations après le signe ’#’ ou de supprimer des données personnelles.

Pour surcharger le chemin, utilisez la commande setPath:

<script type="text/javascript">
  window._uxa = window._uxa || [];
  window._uxa.push(['setPath', <PATH_A_ENVOYER>]);
</script>

Le domaine sera ajouté automatiquement avant, et la query string à la suite.

• La valeur est 255 caractères maximum.

• N’utilisez pas ”#” : les fragments sont considérés comme des ancres — tout ce qui suit sera supprimé dans la pipeline Contentsquare.

• N’utilisez pas cette commande pour envoyer des paramètres de requête. Si l’URL initiale contient déjà des paramètres, l’URL envoyée sera mal formée :

  • URL initiale : https://www.domain.com/path?initial=1
  • URL envoyée : https://www.domain.com/overridenPath?overriden=0?initial=1

Prenons l’exemple d’une Single Page Application qui utilise des fragments à la place du chemin pour définir l’identifiant de la page :

• L’URL initiale de la page est : https://www.domain.com/en#dynamic-app-path/in-the-fragment?query=param
• L’URL insérée dans la base de données Contentsquare serait : https://www.domain.com/en
• Pour éviter ce comportement, remplacez les caractères # par /__, par exemple : window._uxa.push(['setPath', window.location.pathname + window.location.hash.replace('#','/__')]);
• L’URL finale sera : https://www.domain.com/fr/__dynamic-app-path/in-the-fragment?query=param

Pour surcharger les paramètres de la requête, utilisez la commande setQuery:

<script type="text/javascript">
  window._uxa = window._uxa || [];
  window._uxa.push(['setQuery', <PARAMETRES_A_ENVOYER>]);
</script>

Le domaine et le chemin seront automatiquement ajoutés avant.

• La valeur est 255 caractères maximum.
• N’utilisez pas ”#” : les fragments sont considérés comme des ancres — tout ce qui suit sera supprimé dans la pipeline Contentsquare.

Prenons l’exemple d’une page chargée dans une popin, et que nous souhaitons identifier :

• L’URL initiale de la page est : https://www.domain.com/mypage?existingQueryParam=all
• En utilisant la commande setQuery : window._uxa.push(['setQuery', window.location.search + '&cookies-popin=true']);
• L’URL finale sera : https://www.domain.com/mypage?existingQueryParam=all&cookies-popin=true

L’extension Chrome Contentsquare Tracking Setup Assistant affiche chaque pageview envoyé avec l’URL et les Custom vars correspondantes.

Pour vérifier les requêtes qui sont envoyées, suivez les requêtes GET vers //c.contentsquare.net/pageview, avec ces paramètres :