Résolution des problèmes liés au code de suivi

Si vous souhaitez résoudre les problèmes liés au suivi Google Analytics, assurez-vous d'abord que votre configuration de base est correcte, comme indiqué dans le centre d'aide sous Vérifier votre configuration.

La résolution des problèmes liés au suivi Analytics s'articule autour de deux points clés:

  1. Syntaxe de erreurs ou de fautes de frappe dans votre code de suivi (espaces blancs, orthographes mal orthographiées, noms de paramètres incorrects, par exemple)
  2. Données manquantes dans vos rapports

Le reste de ce document explique comment utiliser les outils de dépannage pour identifier et corriger ces deux problèmes de base.

Erreurs courantes liées au code de suivi

Que vous utilisiez la syntaxe asynchrone ou traditionnelle, tenez compte des points suivants pour éviter les erreurs les plus courantes lorsque vous personnalisez ou ajustez le code de suivi. Pour découvrir comment détecter facilement ces erreurs, consultez la section Déboguer avec ga_debug.js.

  • Les noms des méthodes utilisent une casse incorrecte.
    N'oubliez pas que les méthodes sont sensibles à la casse. Si vous utilisez un nom de méthode sans la casse, vos appels de méthode ne fonctionneront pas. Exemples :
      _gaq.push(['_trackpageview']);   // wrong
      _gaq.push(['_trackPageView']);   // wrong
      _gaq.push(['_trackPageview']);   // correct
  • Noms de méthode incorrects.
    Si votre suivi ne fonctionne pas correctement, vérifiez que vous utilisez le nom approprié pour la méthode. Exemples :
      _gaq.push(['_setDomain', 'example.com']);       // wrong
      _gaq.push(['_setDomainName', 'example.com']);   // correct
  • Transmettre une valeur autre qu'une chaîne entre guillemets.
    Seules les chaînes doivent être transmises entre guillemets. Tous les autres types ne doivent pas être entre guillemets.
    Toute valeur qui n'est pas une chaîne, telle que des valeurs booléennes, des littéraux d'objet, des fonctions ou des tableaux, doit être transmise sans guillemets. Utilisez uniquement des guillemets lorsque vous transmettez un élément destiné à être interprété comme une chaîne. Si vous migrez depuis la syntaxe traditionnelle, tout paramètre de fonction transmis sans guillemets ne doit pas être entre guillemets dans la syntaxe asynchrone. Exemples :
      _gaq.push(['_setAllowLinker', 'false']);    // wrong
      _gaq.push(['_setAllowLinker', false]);      // correct
  • Les chaînes contiennent des espaces de début ou de fin.
    Exemples :
      _gaq.push(['_setAccount', ' UA-65432-1']);    // wrong
      _gaq.push(['_setAccount', 'UA-65432-1']);     // correct

Haut de page

Problèmes courants liés aux données des rapports

S'il vous manque des données dans vos rapports, consultez cette section pour identifier les erreurs les plus courantes et les actions recommandées.

Modification ou configuration du code de suivi non détectées

Lorsque vous installez le code de suivi pour la première fois sur une page ou que vous ajoutez une fonctionnalité supplémentaire de code de suivi (pour l'e-commerce, par exemple), vous pouvez facilement vérifier que la demande de page est correctement configurée en vérifiant les éléments suivants:

  • La page demande le code JavaScript ga.js.
  • La page demande l'__utm.gif
  • Les variables utmac et utmcc sont envoyées dans la requête __utm.gif.
  • Tous les paramètres de suivi pertinents sont disponibles pour les données supplémentaires que vous devriez envoyer (consultez la liste des paramètres de requête GIF ci-dessous).

Si tous ces éléments sont correctement envoyés, les données devraient s'afficher dans vos rapports sous 24 heures au maximum. Toutefois, vous pouvez également vérifier si les données s'affichent plus tôt en définissant la plage de dates dans vos rapports sur "aujourd'hui".

Haut de page

Page ou événement n'apparaissant pas dans les rapports

Si une page contenant le code de suivi ne figure pas dans les rapports de la section "Contenu", vérifiez les points suivants:

  • Recherchez-vous la bonne page ?
  • Google Analytics utilise la valeur du paramètre utmp comme page demandée. Par conséquent, si l'URL de votre page est /test/myPage.html, assurez-vous de rechercher myPage.html dans les rapports de la section "Contenu". Vérifiez la valeur du paramètre utmp pour savoir quelle demande de page est envoyée.
  • Recherchez-vous le bon événement ?
  • Google Analytics utilise la valeur du paramètre utme pour suivre les événements sous la forme 5(object*action*label)(value) :
    • 5 est une constante.
    • objet et action obligatoires
    • libellé et valeur sont des options
    Pour en savoir plus, consultez la documentation sur le suivi des événements.
  • Suivez-vous plus de 50 000 URL uniques ou pages virtuelles par jour ?
  • Google Analytics collecte toutes les données d'un site Web et génère des rapports sur les 50 000 premières pages (triées par pages vues) par jour. Toutes les pages restantes sont regroupées dans une section distincte, intitulée (other) dans les rapports sur le contenu. Afin d'afficher des informations de rapport détaillées pour les pages vues à faible trafic, vous pouvez configurer une nouvelle vue (profil) avec un filtre afin de supprimer toutes les pages vues dont le trafic est plus élevé. Les pages restantes seront alors incluses dans les 50 000 URL les plus visitées.
  • Assurez-vous d'accéder au compte et à la vue (profil) appropriés dans l'interface utilisateur des rapports.
  • Google Analytics distingue les différents comptes par ID de domaine, qui se présentent sous la forme UA-123456-1. Cet ID de domaine est inséré dans le code de suivi, qui permet d'associer les données d'une page à un compte donné. Assurez-vous que le compte et la vue (profil) que vous consultez (Paramètres Analytics -> modifier -> vérifier l'état) possèdent le même ID de domaine que celui envoyé dans le paramètre utmac de la demande GIF.

Haut de page

Problèmes de suivi des campagnes

Pour qu'une campagne publicitaire puisse faire l'objet d'un suivi dans Google Analytics, des paramètres de suivi doivent être ajoutés aux liens publicitaires vers votre site Web. Le code GATC utilise ensuite une combinaison d'URL de page et de paramètres de référence pour identifier la campagne en cours d'envoi. Ces informations sont ensuite stockées dans le cookie de votre site et envoyées dans le paramètre utmcc de la demande GIF. Dans de nombreux cas, les redirections d'URL de sites Web suppriment les paramètres de suivi ou les données de référence de ces liens, ce qui génère des rapports de campagne incorrects.

Pour vérifier si les redirections entraînent des problèmes de suivi des campagnes, cliquez sur un lien référent ou sur un lien marqué pointant vers votre site Web, puis recherchez les données de campagne appropriées dans le paramètre utmcc. Pour savoir comment trouver et lire le paramètre utmcc, consultez Paramètres de la requête GIF et Débogage avec ga_debug.js.

Attribution de l'objectif (conversion) incorrecte

Une conversion est un objectif associé à une campagne spécifique. Pour vous assurer que vous avez correctement associé un objectif à une campagne ou à un site référent donné, procédez comme suit:

  1. Cliquez sur un lien vers votre site. Les cookies de la campagne sont alors définis.
  2. Cliquez sur votre site pour accéder à la page de conversion ou d'objectif.
  3. Vérifiez les données envoyées dans le paramètre utmcc pour vous assurer que le cookie de la campagne est conservé.

Une fois que le code de suivi capture toutes les informations sur la campagne, il est stocké dans un cookie qui persiste avec l'utilisateur sur plusieurs sessions. Pour chaque page exécutant les fonctions de suivi, les informations sur la campagne sont envoyées dans la demande GIF. Chaque page vue est donc associée à des données de campagne ou de sites référents. Si l'une de ces pages vues est configurée en tant qu'objectif, la campagne correspondante est alors associée à l'objectif. Pour savoir comment trouver et lire le paramètre utmcc, consultez Paramètres de la requête GIF et Débogage avec ga_debug.js.

Haut de page

Étapes de débogage de base

Chaque fois que le code de suivi Google Analytics s'exécute, il demande une image GIF d'un pixel à __utm.gif aux serveurs de collecte Google Analytics.Tous les paramètres capturés par Google pour une demande de page particulière figurent dans la chaîne de requête, y compris les suivants:

  • Informations sur la page vue de l'URL
  • Informations sur la campagne
  • Données d'e-commerce
  • Propriétés du navigateur
  • ID client

Les données contenues dans la demande GIF correspondent exactement aux données envoyées aux serveurs Google Analytics, lesquelles sont ensuite traitées et se retrouvent dans vos rapports. Ainsi, en consultant les données envoyées dans la requête __utm.gif, vous pouvez déterminer si le code de suivi fonctionne et, plus important encore, s'il envoie des données incorrectes à vos rapports.

Pour déboguer votre code de suivi, procédez comme suit :

  1. Utilisez un outil de débogage tiers pour inspecter la demande GIF envoyée à Google Analytics. Pour ce faire, cliquez sur le lien approprié sur votre site Web.
  2. Vérifiez que le code de suivi ne contient aucune des erreurs de code de suivi courantes.
  3. Assurez-vous que le paramètre utmp est présent.
  4. Assurez-vous que le paramètre utmcc est présent et non vide.
    Dans le cas d'un paramètre utmcc vide, aucune donnée de cookie n'est envoyée et la requête est ignorée.
  5. Répétez le test plusieurs fois pour vous assurer que la demande GIF est envoyée à chaque fois.

Haut de page

Outils de débogage

Un nombre de paramètres de nom/valeur est associé à l'URL de la demande GIF. Plutôt que d'essayer d'examiner cette chaîne dans son intégralité, vous pouvez utiliser un outil offert pour afficher la requête GIF dans un format plus lisible. Le tableau suivant répertorie plusieurs outils à utiliser avec les navigateurs les plus courants.

Pour plus de commodité, nous avons développé l'outil de suivi du code de suivi Google Analytics, qui vous aide à résoudre les problèmes de code de suivi sans que vous ayez à modifier votre code. Il vous suffit d'activer cette extension pour rechercher les erreurs dans vos pages de production. En savoir plus sur ga_debug.js

Navigateur Outil
All Firebug Lite
Chrome Débogueur de code de suivi Google Analytics Nouveau !
Chrome Outils de développement intégrés (par exemple, Ressources)
Firefox En-têtes HTTP actifs
Firefox Feu
Firefox Charles
Internet Explorer Burger
Internet Explorer Charles
Safari Fenêtre Activité intégrée
Safari Charles

Une fois l'outil installé et configuré, vous pouvez ouvrir la page Web qui pose problème et voir l'analyse GIF dans l'outil. Vous devez d'abord vous assurer que la page en question envoie bien une requête __utm.gif. Tant que vous voyez la demande, vous pouvez vous assurer que les serveurs Google Analytics collectent des données à partir de cette page. Le reste de cette section donne des instructions de base sur l'utilisation de Live HTTP Header et Firebug, afin de vous aider à comprendre avec quelle facilité vous pouvez utiliser les outils ou les modules complémentaires intégrés à votre navigateur Web.

Utiliser des en-têtes HTTP actifs

  1. Téléchargez et installez LiveHTTPHeaders for Firefox. Redémarrez votre navigateur.
  2. Ouvrez les en-têtes HTTP actifs (Tools > LiveHTTPHeaders).
  3. Cliquez sur l'onglet Generator (Générateur).
  4. Accédez à votre site (ou à toute page sur laquelle le code de suivi Google Analytics est installé).
  5. Vérifier qu'une requête est effectuée pour urchin.js ou ga.js
  6. Vérifiez qu'une requête est envoyée pour __utm.gif.

Utiliser Firebug

L'extension Firebug présente une vue plus structurée de la demande de code de suivi (urchin.js ou ga.js) et de la demande GIF (__utm.gif).  La procédure ci-dessous montre comment utiliser Firebug pour afficher les détails de la demande de GIF.

  1. Téléchargez et installez Firebug pour Firefox. Redémarrez votre navigateur.
  2. Accédez à votre site.
  3. Dans Firefox, sélectionnez Tools> Firebug > Open Firebug > "Enable Firebug for this web site".
  4. Cliquez sur Net, puis sur Images.
  5. Actualisez la page et vérifiez qu'une nouvelle demande pour __utm.gif apparaît dans la liste.
  6. Vérifiez les composants de la requête dans l'onglet Paramètres.

Haut de page

Déboguer avec ga_debug.js

En plus de la version standard ga.js, l'équipe Analytics a déployé une autre version de JavaScript Google Analytics appelée ga_debug.js. Ce script a pour but d'aider les utilisateurs d'Analytics à résoudre les problèmes liés à leurs installations. C'est particulièrement utile si vous débutez avec Analytics ou si vous migrez votre site vers la nouvelle syntaxe asynchrone.

Ce script fournit des détails sur chaque demande GIF, et consigne les messages d'avertissement et d'erreur lorsqu'il détecte des problèmes dans le code de suivi. Pour ce faire, les messages sont imprimés dans l'objet window.console. Vous pouvez ensuite utiliser l'un des outils suivants pour afficher ces erreurs:

  • Firebug (pour Firefox)
  • Outils intégrés pour Chrome et/ou Safari
  • Firebug Lite (pour les autres navigateurs)

Pour utiliser le script ga_debug.js, vous pouvez modifier la référence du code de suivi d'une page Web à laquelle vous avez accès et que vous pouvez modifier. Pour ce faire, remplacez toutes les références à /ga.js par /u/ga_debug.js dans le code de suivi de cette page. Si vous utilisez le script de débogage pour un site Web à grande échelle, nous vous recommandons de l'utiliser uniquement dans votre environnement de test. Par ailleurs, si vous déboguez un site de petite taille, nous vous recommandons de ne tester que certaines pages plutôt que l'intégralité du site.

Important : Vous ne devez pas modifier votre site de production pour utiliser cette version de JavaScript. Le script ga_debug.js est plus volumineux que le code de suivi ga.js et n'est généralement pas mis en cache. Par conséquent, en l'utilisant sur l'ensemble de votre site de production, vous le ralentirez pour l'ensemble de vos utilisateurs. Encore une fois, ceci n'est destiné qu'à vos tests.

Si vous utilisez Universal Analytics (analytics.js) pour effectuer le suivi de vos sites, vous pouvez activer analytics_debug.js, la version de débogage de analytics.js, afin de résoudre les problèmes liés au code de suivi. Pour plus d'informations sur analytics_debug.js, consultez la section Débogage.

Utiliser le débogueur de code de suivi Google Analytics

Le débogueur de code de suivi Google Analytics est une extension du navigateur Chrome qui vous permet d'utiliser ga_debug.js sans avoir à modifier votre code. Il s'agit probablement du moyen le plus simple d'utiliser ga_debug.js pour résoudre les problèmes et analyser le comportement de suivi de votre site Web. Il vous suffit d'activer cette extension pour rechercher les erreurs dans vos pages de production, sans avoir à modifier les références de suivi dans le code.

Pour utiliser cette extension, activez-la en cliquant sur son icône située à droite de la barre d'adresse. Ouvrez ensuite la console JavaScript Chrome pour afficher les messages.

  • Sous Windows ou Linux, cliquez sur [Page Icon] -> Developer -> JavaScript script console (Console de JavaScript) ou appuyez sur Ctrl-Maj-J.
  • Sous Mac, cliquez sur Afficher -> Développeur -> Console JavaScript ou appuyez sur Commande+Option+J.

Haut de page

Paramètres de la demande GIF

La requête GIF est assez longue. Voici un exemple d'une partie d'une requête GIF:

http://www.google-analytics.com/__utm.gif?utmwv=4&utmn=769876874&utmhn=example.com&utmcs=ISO-8859-1&utmsr=1280x1024&utmsc=32-bit&utmul=en-us&utmje=1&utmfl=9.0%20%20r115&utmcn=1&utmdt=GATC012%20setting%20variables&utmhid=2059107202&utmr=0&utmp=/auto/GATC012.html?utm_source=www.gatc012.org&utm_campaign=campaign+gatc012&utm_term=keywords+gatc012&utm_content=content+gatc012&utm_medium=medium+gatc012&utmac=UA-30138-1&utmcc=__utma%3D97315849.1774621898.1207701397.1207701397.1207701397.1%3B...   

Ce tableau contient la liste des nombreux paramètres transmis via la requête GIF. Tous les paramètres ne sont pas transmis à chaque exécution du code de suivi, car certains ne s'appliquent qu'à certaines conditions, telles que les paniers d'achat ou les campagnes liées à une campagne. Lorsque vous utilisez cette référence, gardez à l'esprit que vous recherchez les variables qui s'appliquent le plus souvent à la page ou à la requête que vous examinez.

Variable Description Exemple de valeur
utmac Chaîne du compte. S'affiche pour toutes les requêtes. utmac=UA-2202604-2
utmcc (
)
Valeurs des cookies. Ce paramètre de requête envoie tous les cookies demandés à partir de la page.
utm\cc
utmcn Démarre une nouvelle session de campagne. utmcn ou utmcr est présent pour chaque requête. Modifie les données de suivi de la campagne, mais ne lance pas de nouvelle session
utmcn=1.
utmcr
Indique une visite répétée de la campagne. Ce paramètre est défini lorsque des clics ultérieurs sont effectués sur le même lien. utmcn ou utmcr est présent pour chaque requête.
utmcr=1
utmcs (
)
Encodage de langue pour le navigateur. Certains navigateurs ne le font pas. Dans ce cas, il est défini sur "-".
utmcs=ISO-8859-1.
utmdt
Titre de la page, qui est une chaîne encodée au format URL. utmdt=analytics%20page%20test
CANNOT TRANSLATE Paramètre extensible La valeur est encodée. Utilisé pour les événements et les variables personnalisées.
utmfl
Version Flash utmfl=9.0%20r48&
utmhn

Nom d'hôte, qui est une chaîne encodée au format URL. utmhn=x343.gmodules.com
utmhid

Nombre aléatoire utilisé pour associer les demandes GIF Analytics à Google AdSense. utmhid=2059107202
utmipc
Code produit. Code SKU d'un produit donné.

utmipc=989898ajssi
utmipn
Nom du produit, qui est une chaîne encodée au format URL. utmipn=tee%20shirt
utmipr
Prix unitaire. Défini au niveau de l'article. La valeur définie correspond aux nombres dans le format de la devise américaine.
utmipr=17100.32
utmiqt
Quantité. utmiqt=4
utmiva
Variantes d'un article. Exemples: grand, moyen, petit, rose, blanc, noir, vert. La chaîne est encodée au format URL.
utmiva=rouge ;
utmje
Indique si le navigateur est compatible Java. 1 est vraie. utmje=1
utmn
Identifiant unique généré pour chaque requête GIF afin d'empêcher la mise en cache de l'image GIF. utmn=1142651215
utmp
Demande de page pour la page active. utmp=/testDirectory/maPage.html
utm
Site référent, URL complète. utmr=http://www.example.com/aboutUs/index.php?var=selected
utmsc
Profondeur de couleur de l'écran utmsc=24 bits
utmsr
Résolution d'écran utmsr=2400x1920
utmt
Indique le type de requête parmi les suivants: event, transaction, item ou custom variable. Si cette valeur n'est pas présente dans la requête GIF, elle est saisie comme page. utmt=événement
utmtci
Ville de facturation utmtci=San%20Diego
utmtco
Pays de facturation utmtco=Royaume-Uni
utmtid
ID de commande (chaîne encodée au format URL). utmtid=a2343898.
utmtrg
Région de facturation, chaîne encodée au format URL. utmtrg=Nouveau%20Brunswick
utmtsp
Frais de port. Valeurs de l'unité et du prix. utmtsp=23.95
utmtst
Affiliation. Généralement utilisé pour les applications physiques d'e-commerce. utmtst=google%20mtv%20store
utmtto
Total Valeurs de l'unité et du prix. utmtto=334.56
utmttx
Taxes. Valeurs de l'unité et du prix. utmttx=29,16
utmul
Langue du navigateur utmul=pt-ch
utmwv
Version du code de suivi utmwv=1.

 

Haut de page