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 pageviewsIl y a 2 instructions qui peuvent être à l’origine d’un pageview.
Pageview naturel
Section titled Pageview naturelUn 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
Pageview artificiel
Section titled Pageview artificielUne 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,…
Envoyer un pageview naturel
Section titled Envoyer un pageview naturelIl suffit de charger le tag principal.
En savoir plus sur l’installation du tag principal.
Envoyer un pageview artificiel
Section titled Envoyer un pageview artificielVoir Les pageviews artificielles.
Modifier l’URL envoyée
Section titled Modifier l’URL envoyéePour 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.
Modifier le path
Section titled Modifier le pathPour surcharger le chemin, utilisez la commande setPath
:
Le domaine sera ajouté automatiquement avant, et la query string à la suite.
Recommandations et limites
Section titled Recommandations et limites-
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
- URL initiale :
Exemple
Section titled ExemplePrenons 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êtePour surcharger les paramètres de la requête, utilisez la commande setQuery
:
Le domaine et le chemin seront automatiquement ajoutés avant.
Recommandations et limites
Section titled Recommandations et limites- 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.
Exemple
Section titled ExemplePrenons 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 pageviewVérification simple
Section titled Vérification simpleL’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ètre | définition | type |
---|---|---|
paramètres pour lesquels vous pouvez spécifier une valeur | ||
url | L’URL de la page | String |
cvarp | Les custom vars définies pour cette page | JSON — facultatif |
paramètres déterminés par l’environnement technique ou la configuration | ||
pid | L’identifiant du projet | Integer |
r | Un chiffre aléatoire pour éviter la mise en cache de la requête | Integer |
uu | Identifiant utilisateur unique | String |
pn | Numéro de la page (chaque pageview incrémente de 1) | Integer |
lv | Dernière visite (last visit) | Timestamp |
hd | Date du hit | Timestamp |
lhd | Dernière date du hit (last hit date) | Timestamp |
sn | Numéro de session | Integer |
re | Recording | 1 (standard), 3 (Session Replay) ou 5 (Triggered Session Replay) |
dw | Largeur du document | Integer |
dh | Hauteur du document | Integer |
la | Langue du navigateur de l’utilisateur | String |
dr | URL de la page précédente (referrer) | String |
sw | Largeur de l’écran | Integer |
sh | Hauteur de l’écran | Integer |
ww | Largeur de la fenêtre | Integer |
wh | Hauteur de la fenêtre | Integer |
cvars | Custom vars de la session | JSON — facultatif |
cvaru | Custom vars de l’utilisateur | JSON — facultatif |
uc | Consentement de l’utilisateur | 0 (Non requis), 1 (Non exprimé), 2 (Donné) ou 3 (Retiré) |
v | Numéro de version du tag Contentsquare | String |
pvt | Type de pageview | ”a” (artificial), “r” (renewal), ou “n” (natural) |
ex | Indique si le pageview peut être inclus dans un Session Replay | SR (exclue) ou vide (peut être inclus) |
uxt | Tests UXT en cours, le cas échéant | JSON — facultatif |
uxtv | Version du tag de test, le cas échéant | String — facultatif |