Comparaisons syntaxiques

Ce document présente des illustrations de code de suivi pour diverses personnalisations courantes de suivi. Si votre extrait de suivi Google Analytics contient le balisage urchin.js ou la syntaxe ga.js traditionnelle, utilisez ce guide pour migrer votre suivi vers l'extrait asynchrone amélioré.

Migrer vers le suivi asynchrone

Pour convertir vos pages afin qu'elles utilisent l'extrait asynchrone:

  1. Supprimez votre extrait de code de suivi et les personnalisations que vous avez effectuées.

    Pour réduire le nombre d'erreurs, nous vous recommandons de supprimer du fichier d'inclusion ou du mécanisme l'extrait de code de suivi existant qui l'injecte dans vos pages Web. Vous pouvez coller votre extrait de code de suivi existant dans un fichier texte afin de suivre les méthodes personnalisées que vous utilisez.

  2. Insérez l'extrait asynchrone au bas de la section <head> de vos pages, après tout autre script que votre page ou modèle pourrait utiliser.

    L'un des principaux avantages de l'extrait asynchrone est qu'il peut être positionné en haut du document HTML. Cela augmente la probabilité que la balise de suivi soit envoyée avant que l'utilisateur ne quitte la page. Nous avons constaté que, sur la plupart des pages, l'emplacement optimal pour l'extrait de code asynchrone se trouve au bas de la section <head>, juste avant la balise de fermeture </head>.

  3. Remplacez la méthode _setAccount par l'ID de votre propriété Web.

    Pour en savoir plus sur les ID de propriété Web, consultez la section "Propriété Web" du document Comptes et vues (profils).

  4. Ajoutez vos personnalisations à l'aide de la syntaxe asynchrone. Utilisez les personnalisations décrites dans le reste de ce guide. Pour en savoir plus sur le code de suivi asynchrone, consultez le Guide d'utilisation du suivi asynchrone.

Remarque:Pour garantir le fonctionnement simplifié de l'extrait asynchrone par rapport aux autres scripts, nous vous recommandons de placer les autres scripts sur votre site de l'une des manières suivantes:

  • Avant l'extrait de code de suivi dans la section <head> de votre code HTML
  • Après l'extrait de code de suivi et tout le contenu de la page (par exemple, en bas du corps HTML)

Si cette option n'est pas disponible, vous pouvez toujours placer l'extrait asynchrone au bas de la page. Vous pouvez également diviser votre extrait pour conserver certains avantages du suivi asynchrone.

Suivi de page de base

Le suivi de page de base est le meilleur moyen de vous familiariser avec la syntaxe asynchrone. Ces exemples configurent l'objet de suivi avec le bon compte et appellent la méthode de suivi de la page.

Extrait asynchrone (recommandé)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);

Haut de page

Détection des paramètres du navigateur

Ces exemples illustrent les personnalisations apportées aux paramètres du navigateur, telles que la désactivation de la détection Flash, la désactivation de la détection des noms/versions de navigateur, etc.

Extrait asynchrone (recommandé)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setClientInfo', false]);
_gaq.push(['_setAllowHash', false]);
_gaq.push(['_setDetectFlash', false]);
_gaq.push(['_setDetectTitle', false]);
_gaq.push(['_trackPageview']);

Haut de page

Durée de la campagne

Par défaut, la durée d'une campagne Google Ads est définie sur six mois. Vous pouvez ajuster la durée des campagnes à l'aide de la méthode _setCampaignCookieTimeout().

Extrait asynchrone (recommandé)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampaignCookieTimeout', 31536000000]);
_gaq.push(['_trackPageview']);

Haut de page

Champs de campagne — Personnalisé

Si vous avez associé votre compte Google Ads à Google Analytics, Google Analytics collecte automatiquement vos données. Pour suivre les liens de mots clés provenant d'autres sources publicitaires, de campagnes par e-mail ou de sources similaires, vous pouvez créer des champs de campagnes personnalisées à l'aide des méthodes ci-dessous. Pour en savoir plus, reportez-vous à la section Suivi des campagnes du guide Sources de trafic.

Extrait asynchrone (recommandé)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampNameKey', 'ga_campaign']);    // name
_gaq.push(['_setCampMediumKey', 'ga_medium']);    // medium
_gaq.push(['_setCampSourceKey', 'ga_source']);    // source
_gaq.push(['_setCampTermKey', 'ga_term']);        // term/keyword
_gaq.push(['_setCampContentKey', 'ga_content']);  // content
_gaq.push(['_setCampNOKey', 'ga_nooverride']);    // don't override
_gaq.push(['_trackPageview']);

Haut de page

Suivi des campagnes désactivé

Google Analytics active automatiquement le suivi des campagnes, mais vous pouvez le désactiver en utilisant la méthode _setCampaignTrack().

Extrait asynchrone (recommandé)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampaignTrack', false]);    // Turn off campaign tracking
_gaq.push(['_trackPageview']);

Haut de page

Association multidomaine

Pour suivre le trafic sur plusieurs domaines, vous pouvez utiliser la fonction _setAllowLinker() afin de suivre les clics utilisateur entre deux domaines. Pour en savoir plus sur la configuration du suivi de plusieurs domaines, consultez la section Suivi de plusieurs domaines.

Extrait asynchrone (recommandé)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

Haut de page

Données de formulaire inter-domaines

Vous pouvez utiliser la méthode _linkByPost() pour transmettre des données utilisateur d'un domaine à un autre, où le suivi de plusieurs domaines est activé pour les deux domaines. Pour en savoir plus sur la configuration du suivi de plusieurs domaines, consultez la page Suivi de plusieurs domaines.

Extrait asynchrone (recommandé)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<form name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

Haut de page

Suivi du e-commerce

Le suivi de l'e-commerce implique d'appeler trois méthodes clés dans votre configuration du suivi. Pour en savoir plus, consultez la page sur le suivi du e-commerce.

Extrait asynchrone (recommandé)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
_gaq.push(['_addTrans',
  '1234',           // order ID - required
  'Mountain View',  // affiliation or store name
  '11.99',          // total - required
  '1.29',           // tax
  '5',              // shipping
  'San Jose',       // city
  'California',     // state or province
  'USA'             // country
]);
_gaq.push(['_addItem',
  '1234',           // order ID - required
  'DD44',           // SKU/code
  'T-Shirt',        // product name
  'Green Medium',   // category or variation
  '11.99',          // unit price - required
  '1'               // quantity - required
]);
_gaq.push(['_trackTrans']);

Haut de page

Suivi des événements

L'utilisation du suivi des événements implique d'effectuer un appel d'événement à l'emplacement approprié sur vos pages, par exemple dans un gestionnaire onclick. Pour en savoir plus sur le suivi des événements, consultez le Guide sur le suivi des événements. Remarque : Le suivi des événements n'est pas disponible avec le code de suivi ear.js.

Extrait asynchrone (recommandé)

Cette section présente deux façons de configurer le suivi à l'aide de la syntaxe asynchrone. Avec le suivi des événements, le gestionnaire onclick utilise exactement la même syntaxe.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
...
<a onclick="_gaq.push(['_trackEvent', 'category', 'action', 'opt_label', opt_value]);">click me</a> 

Haut de page

Fin de la session

Par défaut, les sessions utilisateur expirent après 30 minutes d'inactivité sur votre site. Ces exemples montrent comment modifier ce paramètre à l'aide de la méthode _setSessionCookieTimeout().

Extrait asynchrone (recommandé)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setSessionCookieTimeout', 3600000]);
_gaq.push(['_trackPageview']);

Haut de page

Sources : moteurs de recherche, mots clés, URL de provenance

Par défaut, Google Analytics identifie une liste de sites Web comme provenant de sites référents de moteur de recherche dans vos rapports. Vous pouvez utiliser ces méthodes pour modifier la liste des moteurs de recherche. Pour plus d'informations, consultez la section Moteurs de recherche du guide Sources de trafic. Vous pouvez également configurer Google Analytics de sorte qu'il ignore les sites référents de certains domaines ou qu'il traite les recherches par mots clés spécifiques comme des accès directs.

Extrait asynchrone (recommandé)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_addIgnoredOrganic', 'ignore']);
_gaq.push(['_addIgnoredRef', 'urchin.com']);
_gaq.push(['_addOrganic', 'new_search_engine', 'q']);
_gaq.push(['_trackPageview']);

Haut de page

Suivi limité à un sous-répertoire

Utilisez la méthode _setCookiePath() pour définir un sous-répertoire en tant que chemin par défaut pour tout suivi. Cela vous permet d'empêcher tout suivi dans un sous-répertoire d'un site.

Extrait asynchrone (recommandé)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCookiePath', '/path/of/cookie/']);
_gaq.push(['_trackPageview']);

Haut de page

Utiliser un serveur local

Utilisez ces méthodes si vous effectuez le suivi de votre site Web à l'aide du logiciel Urchin autonome et de Google Analytics. Pour en savoir plus, consultez la section Serveur Urchin de la documentation de référence sur l'API de suivi.

Extrait asynchrone

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setLocalRemoteServerMode']);
_gaq.push(['_trackPageview']);

Haut de page

Pages vues virtuelles

Utilisez la méthode _trackPageview() avec une URL que vous créez afin de suivre les clics des utilisateurs qui ne mènent pas à des pages réelles de votre site. En général, nous vous recommandons d'utiliser le suivi des événements pour effectuer le suivi des téléchargements, des liens sortants, des fichiers PDF ou des interactions similaires des internautes. En effet, les pages vues virtuelles sont comptabilisées dans le nombre total de pages vues.

Extrait asynchrone

_gaq.push(['_trackPageview', '/downloads/pdfs/corporateBrief.pdf']);

Haut de page