Mesurer les applications à page unique
Dans une application à page unique (SPA), une seule page HTML est chargée, puis le contenu est mis à jour à l’aide d’API JavaScript pour modifier le contenu affiché. Par défaut, ces modifications ne sont pas mesurées en tant que nouvelles pages vues. Il est donc nécessaire de générer des pages vues virtuelles pour cela.
Il existe trois méthodes pour mesurer les pages virtuelles visitées :
- Fonction de wrapper automatique.
- Balise wrapper dans le gestionnaire de balises etracker.
- Installation manuelle de l’enrouleur.
Fonction de wrapper automatique
Certaines modifications peuvent être détectées automatiquement et utilisées pour déclencher la mesure d’un nouvel appel de page. Pour ce faire, l’ajout suivant doit être effectué au sein du code etracker intégré dans le site web :
data-page-changed-detection="Modus"
Ces options sont disponibles pour le mode :
- off : Désactivé.
- url : Déclenche un nouvel appel de page si l’URL sans valeur de hachage change.
- url_debug : comme url, mais uniquement lisible dans le console.log des DevTools du navigateur.
- hash : déclenche un nouvel appel de page si l’URL, y compris la valeur de hachage, change.
- hash_debug : Comme hash, mais uniquement lisible dans le console.log des DevTools du navigateur.
- title : déclenche un nouvel appel de page lorsque document.title est modifié.
- title_debug : comme title, mais uniquement lisible dans le console.log des devTools du navigateur.
Remarque : La valeur doit être placée entre guillemets doubles ou simples, en fonction de la manière dont les autres attributs de données ont déjà été utilisés.
Balise wrapper dans le gestionnaire de balises etracker
Un appel de page virtuel peut également être généré par le gestionnaire de balises etracker. Celui-ci évite de modifier le code etracker et donc le code HTML du site Web. En outre, le tag wrapper propose d’autres déclencheurs en plus de “History Change”. Il s’agit notamment de
- Clic d’élément : Par exemple, une structure à onglets (tabs) peut modifier considérablement le contenu. Les clics d’onglets peuvent servir de déclencheurs.
- Visibilité des éléments : les modifications de contenu peuvent également être déclenchées par le survol ou la saisie.
- Profondeur de défilement : lorsque les modifications de contenu sont déclenchées par le défilement.
- Datalayer Push : manière flexible de transmettre les modifications de contenu.

Vous trouverez ici des instructions pour la mise en place de la balise wrapper.
Installation manuelle de l’enrouleur
Le wrapper est livré avec le code JavaScript standard d’etracker et peut par exemple être intégré de cette manière :
<script>
function testCall(){
if(typeof(_etracker) === 'object') {
et_eC_Wrapper({et_et: 'ACCOUNTSCHLÜSSEL', et_pagename: 'pagename', et_areas: 'Bereich1/Bereich2/Bereich3', et_seg1: 'Eigenes Segment 1'});
}
}
</script>
Afin que l’appel de la fonction wrapper par un code etracker éventuellement bloqué, par exemple par l’exclusion du comptage, n’entraîne pas d’erreur JavaScript, la présence de l’objet etracker est d’abord vérifiée avec typeof.
Paramètres de l’enveloppeur
Le paramètre et_et pour la clé de compte est un paramètre obligatoire. Tous les autres paramètres sont facultatifs :
| Variable | Type | Bedeutung | Beschreibung |
|---|---|---|---|
| et_pagename | String | Seitenname | Eindeutiger Name der Seite |
| et_areas | String | Bereichsname | Bezeichnung des Seitenbereichs |
| et_tval | Float | Gesamtbestellwert | Nettoumsatz, der durch die Zielerreichung generiert wurde |
| et_tonr | String | Bestellnummer | Eindeutige Bestellnummer (ohne Kommas und Semikolons) |
| et_tsale | Integer | Bestellstatus | Bestellstatus für Umsatzziele: 0 = Lead 1 = Sale 2 = Vollstorno |
| et_basket | String | Warenkorb | Vom Shopsystem vergebene Parameter zum Zuordnen der Warenkorbartikel (ArtNr, ArtName, ArtGruppe, Anzahl, Preis) |
| cc_attributes | String | Kampagnen-Attribute | Attributname und Attributwert für Kampagnen |
| et_seg1 | String | Eigenes Segment | Inhalt des eigenen Segments |
Si les paramètres optionnels ne sont pas explicitement définis, les valeurs transmises à etracker lors de la dernière consultation de la page sont prises en compte. Les valeurs peuvent être transmises via le code de suivi standard lors de l’appel de la page dans le navigateur ou via l’enveloppeur lors du chargement dynamique de la page.
L’appel suivant génère les mêmes données que l’appel initial via le code de suivi standard :
<script>
if(typeof(_etracker) === 'object') {
et_eC_Wrapper({et_et: 'ACCOUNTSCHLÜSSEL'});
}
</script>
<script>
if(typeof(_etracker) === 'object') {
et_eC_Wrapper(
{
et_et: 'ACCOUNTSCHLÜSSEL',
et_pagename:'Suchergebnisse',
et_areas: 'DE/Suche',
cc_attributes:{etcc_cu:'onsite',etcc_med_onsite:'Interne Suche',etcc_cmp_onsite:'Mit Ergebnis',etcc_st_onsite:'Stiefel'},
et_seg1: 'eingeloggt',
et_seg2: 'B2B'
}
);
}
</script>
Remarques générales sur la fonction de wrapper
Saisie d’événements en interaction avec le wrapper
Si des événements sont transmis à etracker dans le cadre du suivi des événements etracker, ceux-ci sont attribués au nom de la page qui a été transmis en dernier lieu à etracker avant le déclenchement de l’événement. Si, par exemple, un appel de page a d’abord été déclenché au moyen d’un wrapper et qu’un événement a ensuite été tracké, l’événement sera attribué dans l’évaluation au nom de la page qui a été transmis à etracker avec le wrapper.
Capture d’URL en interaction avec le wrapper
Étant donné qu’aucune URL ne peut être transmise à etracker via l’enveloppe, etracker attribue toujours les appels de page transmis à etracker au moyen de l’enveloppe à l’URL définie dans la propriété document.location.href est enregistrée.
Les SPA ne disposent pas d’une URL unique pour l’évaluation. Afin de garantir une évaluation claire des contenus individuels, il convient de veiller à ce que chaque page virtuelle ait un nom de page unique et facilement compréhensible dans l’évaluation.
Si cela n’est pas possible en raison du grand nombre de contenus ou pour d’autres raisons, nous vous recommandons de ne pas utiliser de noms de page parlants, mais plutôt de transmettre des chemins d’accès virtuels aux pages via le paramètre et_pagename.