Les éléments de base sont les suivants
Documentation
Commencez dès maintenant

Mesurer les applications à page unique

Inhalt
Fonction de wrapper automatique Balise wrapper dans le gestionnaire de balises etracker Installation manuelle de l'enrouleur Paramètres de l'enveloppeur Remarques générales sur la fonction de wrapper

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 :

  1. Fonction de wrapper automatique.
  2. Balise wrapper dans le gestionnaire de balises etracker.
  3. 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 :

  1. off : Désactivé.
  2. url : Déclenche un nouvel appel de page si l’URL sans valeur de hachage change.
  3. url_debug : comme url, mais uniquement lisible dans le console.log des DevTools du navigateur.
  4. hash : déclenche un nouvel appel de page si l’URL, y compris la valeur de hachage, change.
  5. hash_debug : Comme hash, mais uniquement lisible dans le console.log des DevTools du navigateur.
  6. title : déclenche un nouvel appel de page lorsque document.title est modifié.
  7. 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 :

javascript
<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 :

VariableTypeBedeutungBeschreibung
et_pagenameStringSeitennameEindeutiger Name der Seite
et_areasStringBereichsnameBezeichnung des Seitenbereichs
et_tvalFloatGesamtbestellwertNettoumsatz, der durch die Zielerreichung generiert wurde
et_tonrStringBestellnummerEindeutige Bestellnummer (ohne Kommas und Semikolons)
et_tsaleIntegerBestellstatusBestellstatus für Umsatzziele:
0 = Lead
1 = Sale
2 = Vollstorno
et_basketStringWarenkorbVom Shopsystem vergebene Parameter zum Zuordnen der Warenkorbartikel (ArtNr, ArtName, ArtGruppe, Anzahl, Preis)
cc_attributesStringKampagnen-AttributeAttributname und Attributwert für Kampagnen
et_seg1 StringEigenes SegmentInhalt 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 :

javascript
<script>
    if(typeof(_etracker) === 'object') {
        et_eC_Wrapper({et_et: 'ACCOUNTSCHLÜSSEL'});
    }
</script>
Exemple d’appel complet javascript
<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.

Veuillez noter que

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.