Aller au contenu principal
Zenovay
Gratuit10 minutesDébutant

Le suivi ne fonctionne pas

Diagnostiquez et résolvez les problèmes courants lorsque le suivi Zenovay n'enregistre pas les données des visiteurs. Apprenez à résoudre les problèmes de suivi.

trackinginstallationdebuggingscriptissues
Dernière mise à jour :

Suivez ce guide pour diagnostiquer et résoudre les problèmes lorsque Zenovay n'enregistre pas les visiteurs.

Diagnostic rapide

Vérifier dans la console du navigateur

  1. Ouvrez votre site web
  2. Appuyez sur F12 ou clic droit → Inspecter
  3. Allez à l'onglet Console
  4. Tapez: window.zenovay

Résultat attendu: Une fonction (typeof === 'function') Si non défini: Le script ne se charge pas

Vérifier l'onglet Réseau

  1. Allez à l'onglet Réseau
  2. Actualisez la page
  3. Filtrez par "zenovay" ou "analytics"
  4. Cherchez z.js et les appels API

Problèmes courants

Problème: Le script ne se charge pas

Symptôme: window.zenovay est non défini

Causes:

  1. La balise de script est manquante ou incorrecte
  2. Le bloqueur de publicités bloque le script
  3. Content Security Policy (CSP) bloque
  4. Erreur de chargement du script

Solutions:

Vérifiez votre balise de script:

<!-- Format correct -->
<script
  defer
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>

Erreurs courantes:

<!-- Incorrect: L'ID du site web est manquant -->
<script src="https://api.zenovay.com/z.js"></script>

<!-- Incorrect: Faute de frappe dans l'URL -->
<script src="https://api.zennovay.com/z.js"></script>

<!-- Incorrect: Balise de fermeture manquante -->
<script src="https://api.zenovay.com/z.js">

Problème: Interférence du bloqueur de publicités

Symptôme: Le script se charge pour vous mais pas pour tous les visiteurs

Test:

  1. Désactivez votre bloqueur de publicités
  2. Actualisez la page
  3. Vérifiez si le suivi fonctionne

Solutions:

Auto-hébergement du script:

# Télécharger le script
curl -o zenovay.js https://api.zenovay.com/z.js

# Héberger sur votre domaine
# Puis utilisez:
<script src="/js/zenovay.js" data-tracking-code="YOUR_TRACKING_CODE"></script>

L'auto-hébergement du script à partir de votre propre origine est rarement bloqué par les bloqueurs de publicités. Si vous auto-hébergez, gardez le fichier à jour pour obtenir les corrections et nouvelles fonctionnalités.

Problème: Content Security Policy bloque

Symptôme: La console affiche une erreur de violation CSP

Exemple d'erreur:

Refused to load the script 'https://api.zenovay.com/z.js'
because it violates the Content-Security-Policy directive

Solution:

Mettez à jour votre en-tête CSP:

Content-Security-Policy:
  script-src 'self' https://api.zenovay.com;
  connect-src 'self' https://api.zenovay.com;

Problème: Mauvais ID du site web

Symptôme: Pas de données dans le tableau de bord

Vérifier:

  1. Ouvrez Domains et sélectionnez votre site web
  2. Ouvrez Settings → General pour voir l'extrait d'installation pour ce site
  3. Comparez la valeur data-tracking-code dans l'extrait avec celle de votre page en direct

Les codes doivent correspondre exactement:

<script data-tracking-code="abc123-def456-ghi789"></script>

Problème: Le script se charge après que le visiteur parte

Symptôme: Nombre faible de pages vues

Cause: Script mal placé ou chargement lent

Solution: Placez le script dans <head> avec defer:

<head>
  <script
    defer
    data-tracking-code="YOUR_TRACKING_CODE"
    src="https://api.zenovay.com/z.js">
  </script>
</head>

Problème: L'application monopage ne suit pas les changements de page

Symptôme: Seule la première page vue est enregistrée

Cause: Les applications monopages ne déclenchent pas les chargements complets

Comment Zenovay gère cela: Le tracker détecte automatiquement les changements de route côté client. Il corrige history.pushState / history.replaceState et écoute popstate et pageshow, donc les navigations dans React Router, Vue Router, Next.js et les frameworks similaires sont enregistrées sans code supplémentaire.

Si vous ne voyez que la première page vue, assurez-vous que:

  1. Le script est chargé une seule fois, en haut de votre application (dans <head> avec defer) et n'est pas supprimé lors du changement de route
  2. Votre routeur met à jour réellement l'URL via l'API d'historique (la plupart le font)

Pages vues manuelles (optionnel): Si votre application modifie la "page" visible sans changer l'URL, vous pouvez enregistrer une page vue vous-même:

if (window.zenovay) {
  window.zenovay('page');
}

Faites cela uniquement pour les navigations que le tracker ne peut pas voir de lui-même – l'appeler sur chaque changement de route en plus du suivi automatique comptera les vues en double.

Problème: Localhost/Development ne suit pas

Symptôme: Fonctionne en production, pas localement

Cause: Le tracker bloque les noms d'hôtes localhost, 127.0.0.1 et *.local par défaut pour que votre trafic de développement ne pollue pas les données de production.

Pour autoriser le suivi sur localhost, ajoutez data-allow-localhost="true" à la balise de script:

<script
  defer
  data-tracking-code="YOUR_TRACKING_CODE"
  data-allow-localhost="true"
  src="https://api.zenovay.com/z.js">
</script>

Vous pouvez également l'activer par site dans le tableau de bord: ouvrez Domains, sélectionnez votre site web, puis Settings → General et activez l'option localhost / debug.

Pour voir ce que fait le tracker, activez la journalisation du débogage avec data-debug="true" (ou ajoutez ?zenovay_debug=true à l'URL de la page):

<script
  defer
  data-tracking-code="YOUR_TRACKING_CODE"
  data-debug="true"
  src="https://api.zenovay.com/z.js">
</script>

Problème: Incompatibilité HTTPS/HTTP

Symptôme: Le script est bloqué sur les sites HTTPS

Cause: Chargement du script HTTP sur une page HTTPS

Solution: Utilisez toujours HTTPS:

<!-- Correct -->
<script src="https://api.zenovay.com/z.js"></script>

<!-- Incorrect sur les sites HTTPS -->
<script src="http://api.zenovay.com/z.js"></script>

Mode débogage

Activez la journalisation détaillée en ajoutant data-debug="true" au script:

<script
  defer
  data-tracking-code="YOUR_TRACKING_CODE"
  data-debug="true"
  src="https://api.zenovay.com/z.js">
</script>

Vous pouvez également l'activer sur n'importe quelle page sans modifier l'extrait en ajoutant ?zenovay_debug=true à l'URL.

Vérifiez la console pour:

  • Initialisation du script
  • Événements de page vue
  • Réponses API
  • Messages d'erreur

Suivi des tests

Test manuel

// Dans la console du navigateur
if (window.zenovay) {
  window.zenovay('track', 'test_event', { test: true });
  console.log('Event sent!');
} else {
  console.log('Zenovay not loaded');
}

Vérifier en temps réel

  1. Ouvrez Domains, sélectionnez votre site web et allez à l'onglet Live View
  2. Visitez votre site dans un autre onglet
  3. Vous devriez apparaître dans les secondes

Problèmes de rendu côté serveur

Next.js

// Charger uniquement sur le client
import dynamic from 'next/dynamic';

const Analytics = dynamic(() => import('./Analytics'), {
  ssr: false
});

Nuxt.js

// nuxt.config.js
export default {
  head: {
    script: [
      {
        src: 'https://api.zenovay.com/z.js',
        'data-tracking-code': 'YOUR_ID',
        defer: true,
        body: true // Charger à la fin du body
      }
    ]
  }
}

Problèmes WordPress

Zenovay ne fournit pas de plugin WordPress officiel – vous ajoutez le script de suivi manuellement (dans le header.php de votre thème, via une action wp_head dans functions.php, ou avec un plugin "en-têtes/pieds de page de script"). Voir Ajouter Zenovay à WordPress pour le code exact.

Le script ne se charge pas

Vérifier:

  1. L'extrait de suivi est réellement présent dans la source de la page (voir source, chercher z.js)
  2. La valeur data-tracking-code correspond à celle de votre tableau de bord
  3. Le cache a été vidé après avoir modifié le thème ou l'extrait

Conflits du plugin de cache

Excluez Zenovay de l'optimisation:

WP Rocket:

Settings → File Optimization → Exclude External:
api.zenovay.com

W3 Total Cache:

Performance → Minify → JS Minify Settings → Never minify:
api.zenovay.com/z.js

Liste de contrôle de vérification

  • Balise de script présente dans la source de la page
  • ID du site web correct
  • Pas d'erreurs de console
  • La demande réseau réussit (statut 200)
  • Non bloqué par le bloqueur de publicités
  • CSP permet le domaine d'analyse
  • Domaine correct dans les paramètres du tableau de bord
  • La vue en temps réel montre les visites

Toujours pas de solution?

Rassembler des informations

Avant de contacter l'assistance:

  1. L'URL de votre site web
  2. Erreurs de console du navigateur
  3. Captures d'écran de l'onglet Réseau
  4. ID du site web (partiel)
  5. Quand cela a-t-il cessé de fonctionner

Contacter le support

Envoyez un e-mail à [email protected] avec:

  • Objet: "Tracking Not Working"
  • Informations rassemblées ci-dessus
  • Étapes que vous avez déjà essayées

Étapes suivantes

Articles connexes

  1. Installation du script de suivi

    Apprenez à ajouter le script de suivi de Zenovay à votre site web via différentes méthodes, notamment HTML, npm et les intégrations CMS.

  2. Erreurs de vérification de domaine

    Comprenez et résolvez les erreurs de vérification de domaine, notamment les réponses 403 Forbidden du script de suivi Zenovay. Explorez la configuration du domaine et les bonnes pratiques.

  3. Comment installer Zenovay sur Webflow ?

    Instructions étape par étape pour ajouter le tracker Zenovay à un site Webflow via le panneau de code personnalisé intégré. Aucun plugin requis.

Cet article vous a-t-il aidé ?