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.

Comment sont envoyés les pageviews

Section titled Comment sont envoyés les pageviews

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.

Envoyer un pageview artificiel

Section titled Envoyer un pageview artificiel

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

Modifier les paramètres de la requête

Section titled Modifier les paramètres de la requête

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

Vérifier l’envoi du pageview

Section titled Vérifier l’envoi du pageview

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 :

paramètredéfinitiontype
paramètres pour lesquels vous pouvez spécifier une valeur
urlL’URL de la pageString
cvarpLes custom vars définies pour cette pageJSON — facultatif
paramètres déterminés par l’environnement technique ou la configuration
pidL’identifiant du projetInteger
rUn chiffre aléatoire pour éviter la mise en cache de la requêteInteger
uuIdentifiant utilisateur uniqueString
pnNuméro de la page (chaque pageview incrémente de 1)Integer
lvDernière visite (last visit)Timestamp
hdDate du hitTimestamp
lhdDernière date du hit (last hit date)Timestamp
snNuméro de sessionInteger
reRecording1 (standard), 3 (Session Replay) ou 5 (Triggered Session Replay)
dwLargeur du documentInteger
dhHauteur du documentInteger
laLangue du navigateur de l’utilisateurString
drURL de la page précédente (referrer)String
swLargeur de l’écranInteger
shHauteur de l’écranInteger
wwLargeur de la fenêtreInteger
whHauteur de la fenêtreInteger
cvarsCustom vars de la sessionJSON — facultatif
cvaruCustom vars de l’utilisateurJSON — facultatif
ucConsentement de l’utilisateur0 (Non requis), 1 (Non exprimé), 2 (Donné) ou 3 (Retiré)
vNuméro de version du tag ContentsquareString
pvtType de pageview”a” (artificial), “r” (renewal), ou “n” (natural)
exIndique si le pageview peut être inclus dans un Session ReplaySR (exclue) ou vide (peut être inclus)
uxtTests UXT en cours, le cas échéantJSON — facultatif
uxtvVersion du tag de test, le cas échéantString — facultatif