Les propriétés Universal Analytics (UA) standards ont cessé de traiter les données le 1er juillet 2023. Les propriétés UA 360 cesseront de traiter des données le 1er juillet 2024, et certaines fonctionnalités UA 360 seront abandonnées avant cette date, car nous migrons vers Google Analytics 4. Ajoutez Google Analytics 4 à votre implémentation existante.

Cette page a été traduite par l'API Cloud Translation.

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

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

La résolution des problèmes de suivi Analytics s'articule autour de deux problèmes principaux:

Syntaxe de votre code de suivi contenant des erreurs ou des fautes de frappe (espaces blancs, personnalisations mal orthographiées ou noms de paramètres incorrects, par exemple)
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 dans le code de suivi

Que vous utilisiez la syntaxe asynchrone ou traditionnelle, gardez à l'esprit les points suivants pour éviter les erreurs les plus courantes lorsque vous personnalisez ou ajustez le code de suivi. Pour savoir comment vérifier facilement ces erreurs, consultez la section Débogage avec ga_debug.js.

Les noms de 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 appropriée, vos appels de méthode ne fonctionneront pas. Exemples :
```
  _gaq.push(['_trackpageview']);   // wrong
  _gaq.push(['_trackPageView']);   // wrong
  _gaq.push(['_trackPageview']);   // correct
```
Noms de méthodes incorrects.
Si le suivi ne fonctionne pas correctement, vérifiez que vous utilisez le nom correct 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 à l'aide de guillemets
Seules les chaînes de caractères doivent être transmises entre guillemets. Ne laissez pas les autres types de 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. N'utilisez que des guillemets lorsque vous transmettez un élément destiné à être interprété comme une chaîne. Si vous effectuez une migration à partir de la syntaxe traditionnelle, tout paramètre de fonction transmis sans guillemets doit rester sans guillemets dans la syntaxe asynchrone. Exemples :
```
  _gaq.push(['_setAllowLinker', 'false']);    // wrong
  _gaq.push(['_setAllowLinker', false]);      // correct
```

Les chaînes contiennent des espaces blancs 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 de rapport

Si des données ne figurent pas dans vos rapports, lisez cette section pour identifier les erreurs les plus courantes et les actions recommandées.

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

Lorsque vous installez le code de suivi pour la première fois sur une page ou lorsque vous ajoutez d'autres fonctionnalités de code de suivi (pour le commerce électronique, 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 prévoyez d'envoyer (voir la liste des paramètres de requête GIF ci-dessous).

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

Haut de page

La page ou l'événement n'apparaît pas dans les rapports

Si une page contenant le code de suivi n'apparaît pas dans les rapports "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 "Contenu". Vérifiez la valeur du paramètre utmp pour voir quelle demande de page est envoyée.

Vous recherchez l'événement approprié ?

Google Analytics utilise la valeur du paramètre utme pour suivre les événements au format 5(object*action*label)(value) :

5 est une constante
un objet et une action sont requis
"label" et "value" sont des options

Pour en savoir plus, consultez la documentation sur les événements de suivi.

Effectuez-vous le suivi de plus de 50 000 URL uniques ou pages virtuelles par jour ?

Google Analytics collecte toutes les données envoyées à partir d'un site Web et génère des rapports sur les 50 000 pages principales (triées par pages vues) par jour. Les pages restantes sont regroupées dans une section distincte intitulée (autre) dans les rapports sur le contenu. Pour afficher des informations de rapport détaillées sur les pages vues générant un faible trafic, vous pouvez configurer une nouvelle vue (profil) avec un filtre afin de supprimer toutes les pages vues générant un trafic plus élevé. Les pages restantes peuvent ainsi être incluses dans les 50 000 URL les plus visitées.

Vérifiez que vous accédez au bon compte et à la bonne vue (profil) dans l'interface utilisateur des rapports.

Google Analytics distingue différents comptes en fonction de leur ID de domaine, qui se présente 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) sont associés au même ID de domaine que celui envoyé dans le paramètre utmac de la demande GIF.

Haut de page

Problèmes liés au suivi des campagnes

Pour qu'une campagne publicitaire puisse être suivie dans Google Analytics, vous devez ajouter des paramètres de suivi aux liens publicitaires vers votre site Web. Le code GATC utilise ensuite une combinaison de paramètres d'URL de page et de site référent pour identifier la campagne envoyée. 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 site Web suppriment les paramètres de suivi ou les données sur les sites référents de ces liens, ce qui génère des rapports incorrects sur les campagnes.

Pour vérifier si les redirections entraînent des problèmes de suivi de la campagne, cliquez sur un lien référent ou un lien tagué qui redirige 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 les pages Paramètres de requête GIF et Déboguer avec ga_debug.js.

Attribution de l'objectif (conversion) incorrecte

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

Cliquez sur un site référent. Les cookies de la campagne sont alors définis.
Cliquez sur votre site pour accéder à la page de conversion ou d'objectif.
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 a capturé toutes les informations sur la campagne, celles-ci sont stockées dans un cookie qui est conservé avec l'utilisateur pendant plusieurs sessions. Pour chaque page qui exécute les fonctions de suivi, les informations sur la campagne sont envoyées dans la demande GIF. Par conséquent, chaque page vue est associée à des données de campagne ou de site référent. Si l'une de ces pages vues est configurée en tant qu'objectif, la campagne "Pages vues" associée est alors associée à l'objectif. Pour savoir comment trouver et lire le paramètre utmcc, consultez les pages Paramètres de requête GIF et Déboguer avec ga_debug.js.

Haut de page

Étapes de débogage de base

À chaque exécution du code de suivi Google Analytics, il demande une image GIF d'un seul pixel aux serveurs de collecte Google Analytics appelés __utm.gif.La chaîne de requête associée à l'image comprend tous les paramètres que Google capture à propos d'une demande de page particulière, y compris les suivants:

Informations sur les pages vues 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, qui sont ensuite traitées et apparaissent 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:

À l'aide d'un outil de débogage tiers, inspectez la demande GIF envoyée à Google Analytics en cliquant sur le lien correspondant sur votre site Web.
Vérifiez que le code de suivi ne contient aucune des erreurs de code de suivi courantes.
Assurez-vous que le paramètre utmp est présent.
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.
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 certain nombre de paramètres nom/valeur sont associés à 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 sans frais pour afficher la demande GIF dans un format plus lisible. Le tableau suivant répertorie un certain nombre d'outils à utiliser avec les navigateurs les plus courants.

Pour plus de commodité, nous avons développé le débogueur de code de suivi Google Analytics, qui vous permet de résoudre les problèmes liés au code de suivi sans que vous ayez à modifier le code. Il vous suffit d'activer cette extension pour vérifier si vos pages de production ne comportent pas d'erreurs. En savoir plus sur ga_debug.js

Visiteur	Outil
Toutes	Firebug Lite
Chrome	Débogueur de code de suivi Google Analytics Nouveau !
Chrome	Outils intégrés pour les développeurs (par exemple, Ressources)
Firefox	En-têtes HTTP actifs
Firefox	Firebug
Firefox	Charles
Internet Explorer	Villeur
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 consulter l'analyse des 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 être sûr 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 de Firebug pour vous donner une idée de la facilité avec laquelle vous pouvez utiliser des outils ou des modules complémentaires intégrés dans votre navigateur Web.

Utiliser des en-têtes HTTP en direct

Téléchargez et installez LiveHTTPHeaders pour Firefox, puis redémarrez votre navigateur.
Ouvrez LiveHTTPHeaders (Tools > LiveHTTPHeaders).
Cliquez sur l'onglet Generator (Générateur).
Accédez à votre site (ou à une page sur laquelle le code de suivi Google Analytics est installé).
Vérifier qu'une requête est effectuée pour urchin.js ou ga.js
Vérifiez qu'une demande est effectuée pour __utm.gif.

Utilisation de Firebug

L'extension Firebug offre une vue plus structurée de la demande de code de suivi (urchin.js ou ga.js) ainsi que de la demande GIF (__utm.gif). Ces étapes vous expliquent comment utiliser Firebug pour afficher les détails d'une demande GIF.

Téléchargez et installez Firebug pour Firefox, puis redémarrez votre navigateur.
Accédez à votre site.
Dans Firefox, sélectionnez Outils> Firebug > Ouvrir Firebug > "Activer Firebug pour ce site Web".
Cliquez sur Net, puis sur Images.
Actualisez la page et vérifiez qu'une nouvelle demande pour __utm.gif apparaît dans la liste.
Vérifiez les composants de la requête dans l'onglet Params (Paramètres).

Haut de page

Déboguer avec ga_debug.js

En plus de l'ga.js standard, l'équipe Analytics a déployé une autre version du JavaScript de Google Analytics, appelée ga_debug.js. L'objectif de ce script est d'aider les utilisateurs d'Analytics à résoudre les problèmes liés à leur installation. Elle est particulièrement utile si vous débutez avec Analytics ou si vous souhaitez migrer votre site vers la nouvelle syntaxe asynchrone.

Le script fournit des détails sur chaque requête GIF, et consigne des messages d'avertissement et d'erreur lorsqu'il détecte des problèmes dans le code de suivi. Pour ce faire, elle imprime des messages 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 vous servez du script de débogage pour un site Web de grande envergure, nous vous recommandons de l'utiliser uniquement dans votre environnement de test. Si vous déboguez un site de petite taille, nous vous recommandons également de ne tester cette méthode que sur certaines pages et non sur l'ensemble du site.

Important: Vous ne devez pas modifier votre site de production pour utiliser cette version du 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, son utilisation sur votre site de production ralentira votre site pour tous vos utilisateurs. Encore une fois, ceci ne sera utilisé qu'à des fins de test.

Si vous utilisez Universal Analytics (analytics.js) pour suivre 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 en savoir plus sur analytics_debug.js, consultez la page Débogage.

Utilisation de l'outil de débogage du code de suivi Google Analytics

Le débogueur de code de suivi Google Analytics est une extension du navigateur Chrome qui permet d'activer ga_debug.js sans avoir à modifier le code. Le moyen le plus simple d'utiliser ga_debug.js consiste probablement à analyser le comportement de suivi de votre site Web et à résoudre les problèmes associés. Il vous suffit d'activer cette extension pour vérifier que vos pages de production ne comportent pas d'erreurs, sans avoir à modifier les références de suivi dans le code lui-même.

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

Sous Windows et Linux, cliquez sur [Page Icon] -> Developer -> JavaScript console ([Icône de la page] -> Développeur -> Console JavaScript) ou appuyez sur les touches Ctrl+Maj+J.
Sur Mac, cliquez sur Affichage -> Développeur -> Console JavaScript ou appuyez sur Commande + Option + J.

Haut de page

Paramètres des requêtes GIF

La demande GIF est assez longue. Voici un exemple d'une partie seulement 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...

Cette table contient la liste des nombreux paramètres transmis via la requête GIF. Certains paramètres ne sont pas transmis à chaque exécution du code de suivi, car certains ne s'appliquent qu'à certaines conditions, comme les sites référents de campagne ou les paniers d'achat. Lorsque vous utilisez cette documentation de référence, gardez à l'esprit que vous recherchez les variables qui s'appliquent le plus souvent à la page/demande que vous étudiez.

Variable	Description	Exemple de valeur
utmac	Chaîne de compte. Apparaît pour toutes les requêtes.	utmac=UA-2202604-2
utmcc	Valeurs des cookies. Ce paramètre de demande envoie tous les cookies demandés à partir de la page.	et
UTMC	Démarre une nouvelle session de campagne. utmcn ou utmcr sont présents dans chaque demande. Modifie les données de suivi de la campagne, mais ne démarre pas de nouvelle session	utmcn=1
UTMC	Indique une visite répétée d'une campagne. Ce paramètre est défini lorsque des clics ultérieurs se produisent sur le même lien. utmcn ou utmcr sont présents dans chaque demande.	utmcr=1
UTMCS	Encodage de langue pour le navigateur. Certains navigateurs ne définissent pas cette option, auquel cas elle est définie sur "-".	utmcs=ISO-8859-1
utmdt	Titre de la page, qui correspond à une chaîne encodée au format URL.	utmdt=test%20page%20analytics
UTM	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
UTMC	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 doit correspondre à des chiffres uniquement dans le format de devise des États-Unis.	utmipr=17 100,32
utmiqt	Quantité.	utmiqt=4
Ucive	Variantes d'un article Par exemple: 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 avec Java. La valeur 1 est vraie.	utmje=1
UTM	ID unique généré pour chaque demande de GIF afin d'empêcher la mise en cache de l'image GIF.	utmn=1142651215
UTMp	Demande de page pour la page actuelle.	utmp=/testDirectory/myPage.html
UTM	URL de provenance, URL complète.	utmr=http://www.example.com/aboutUs/index.php?var=selected
UTMS	Profondeur de couleur de l'écran	utmsc=24 bits
utmsr	Résolution d'écran	utmsr=2400x1920
UTM	Indique le type de requête, à savoir event, transaction, item ou variable personnalisée. Si cette valeur n'est pas présente dans la requête GIF, la requête est saisie sous la forme 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 pour l'unité et le prix.	utmtsp=23,95
utmtst	Affiliation. Généralement utilisé pour les applications physiques d'e-commerce.	utmtst=google%20mtv%20store
utmtto	Total Valeurs pour l'unité et le prix.	utmtto=334,56
utmttx	Taxes. Valeurs pour l'unité et le prix.	utmttx=29,16
UTM	Langue du navigateur	utmul=pt-br
utmwv	Version du code de suivi	utmwv=1

Haut de page