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.

Comparaisons de syntaxes

Ce document présente des illustrations du code de suivi pour différentes personnalisations de suivi courantes. 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é.

Migration vers le suivi asynchrone

Nous vous recommandons de commencer par copier et enregistrer les personnalisations existantes de votre code de suivi dans un fichier texte (et non dans un document de traitement de texte). Avec une copie de sauvegarde, vous pouvez vous assurer d'avoir migré toutes les personnalisations de votre site.

Pour convertir vos pages afin d'utiliser l'extrait asynchrone, procédez comme suit:

Supprimez l'extrait de code de suivi existant ainsi que toutes les personnalisations que vous avez apportées.
Pour réduire les erreurs, nous vous recommandons de supprimer l'extrait de code de suivi existant du fichier d'inclusion ou du mécanisme qui l'injecte dans vos pages Web. Vous pouvez coller votre extrait de code de suivi existant dans un fichier texte afin de garder une trace des méthodes personnalisées que vous utilisez.
Insérez l'extrait asynchrone en bas de la section <head> de vos pages, après tout autre script que votre page ou votre modèle est susceptible d'utiliser.
L'un des principaux avantages de l'extrait de code asynchrone est que vous pouvez le placer en haut du document HTML. La balise de suivi aura alors plus de chances d'être envoyée avant que l'utilisateur ne quitte la page. Nous avons déterminé que, sur la plupart des pages, l'emplacement optimal pour l'extrait de code asynchrone se trouve en bas de la section <head>, juste avant la balise de fermeture </head>.
Modifiez la méthode _setAccount avec votre ID de propriété Web.

Pour en savoir plus sur les ID de propriété Web, consultez la section Site Web du document Comptes et vues (profils).
Ajoutez à nouveau vos personnalisations en utilisant la syntaxe asynchrone. Utilisez les personnalisations décrites dans la suite de ce guide. Pour en savoir plus sur le code de suivi asynchrone, consultez le Guide d'utilisation du suivi asynchrone.

Remarque:Pour optimiser le fonctionnement de l'extrait de code asynchrone par rapport aux autres scripts, nous vous recommandons d'insérer d'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 l'ensemble du contenu de la page (en bas du corps HTML, par exemple)

Si ce n'est pas possible, vous pouvez toujours placer l'extrait de code asynchrone au bas de la page. Vous pouvez également scinder votre extrait pour conserver certains des avantages du suivi asynchrone.

Suivi de page standard

Le suivi de base des pages est le meilleur endroit pour vous familiariser avec la syntaxe asynchrone. Ces exemples configurent l'objet de suivi avec le compte approprié et appellent la méthode de suivi de la page.

Extrait asynchrone (recommandé)

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

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();

Suivi urchin.js

_uacct = "UA-XXXXX-X";
urchinTracker();

Haut de page

Détection des paramètres du navigateur

Ces exemples illustrent les personnalisations des paramètres du navigateur, telles que la désactivation de la détection de Flash, de la détection du nom/de la version du 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']);

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setClientInfo(false);
pageTracker._setAllowHash(false);
pageTracker._setDetectFlash(false);
pageTracker._setDetectTitle(false);
pageTracker._trackPageview();

Suivi urchin.js

_uacct = "UA-XXXXX-X";
_ufsc = 0;    // track browser info
_uhash = "on"; // (on|off) unique domain hash for cookies
_uflash = 0;  // detect Flash version
_utitle = 0;  // track title in reports
urchinTracker();

Haut de page

Durée de la campagne

Par défaut, la durée d'une campagne Google Ads est de 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']);

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampaignCookieTimeout(31536000000);
pageTracker._trackPageview();

Suivi urchin.js

_uacct = "UA-XXXXX-X";
_ucto = "31536000"; // the number of seconds in 1 year
urchinTracker();
</script>

Haut de page

Champs de campagne – Personnalisés

Google Analytics collecte automatiquement vos données Google Ads si vous avez associé votre compte Google Ads à votre compte Analytics. Pour suivre les liens de mots clés à partir d'autres sources publicitaires, de campagnes par e-mail ou de sources similaires, vous pouvez créer des champs de campagne personnalisés en utilisant les méthodes ci-dessous. Pour en savoir plus, consultez la section Suivi des campagnes du guide sur les 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']);

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampNameKey('ga_campaign');       // name
pageTracker._setCampMediumKey('ga_medium');       // medium
pageTracker._setCampSourceKey('ga_source');       // source
pageTracker._setCampTermKey('ga_term');           // term/keyword
pageTracker._setCampContentKey('ga_content');     // content
pageTracker._setCampNOKey('ga_nooverride');       // don't override
pageTracker._trackPageview();

Suivi urchin.js

_uacct = "UA-12345-1";
_uccn = "ga_campaign"; // name [default: utm_campaign]
_ucmd = "ga_medium"; // medium [default: utm_medium]
_ucsr = "ga_source"; // source [default: utm_source]
_uctr = "ga_term"; // term/keyword [default: utm_term]
_ucct = "ga_content"; // content [default: utm_content]
_ucid = "ga_id"; // id number [default: utm_id]
_ucno = "ga_nooverride"; // don't override [default: utm_nooverride]
urchinTracker();

Haut de page

Suivi des campagnes : désactivé

Google Analytics active automatiquement le suivi des campagnes, mais vous pouvez le désactiver à l'aide de la méthode _setCampaignTrack().

Extrait asynchrone (recommandé)

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

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampaignTrack(false);       // Turn off campaign tracking
pageTracker._trackPageview();

Suivi urchin.js

_uacct = "UA-12345-1";
_uctm = "disable";
urchinTracker();

Haut de page

Association multidomaine

Pour suivre le trafic entre deux domaines, vous pouvez utiliser la fonction _setAllowLinker() afin de suivre les clics des utilisateurs entre deux domaines. Pour en savoir plus sur la configuration du suivi de plusieurs domaines, consultez l'article 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>

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setDomainName('none');
pageTracker._setAllowLinker(true);
pageTracker._trackPageview();
...
<a href="http://example.com/test.html"
onclick="pageTracker._link('http://example.com/test.html'); return false;">click me</a>

Suivi urchin.js

_uacct = "UA-12345-1";
_udn = "none";
_ulink = 1;
urchinTracker();

...
<a href="http://newsite.com/test.html"
onclick="__utmLinker('http://newsite.com/test.html'); return false;">click me</a>

Haut de page

Données de formulaires multidomaines

Vous pouvez utiliser la méthode _linkByPost() pour transmettre les données utilisateur d'un domaine à un autre lorsque le suivi de plusieurs domaines est activé pour les deux domaines. Pour en savoir plus sur la configuration du suivi de plusieurs domaines, consultez l'article 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>

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setDomainName('none');
pageTracker._setAllowLinker(true);
pageTracker._trackPageview();
...
<form name="f" method="post" onsubmit="pageTracker._linkByPost(this);">
...
</form>

Suivi urchin.js

_uacct = "UA-12345-1";
_udn = "none";
_ulink = 1;
urchinTracker();
...
<form name="f" method="post" onsubmit="__utmLinkPost(this)">
...
</form>

Haut de page

Suivi du e-commerce

Le suivi de l'e-commerce implique l'appel de trois méthodes clés dans la configuration du suivi. Pour en savoir plus, consultez la page Suivi de l'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']);

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();
pageTracker._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
);
pageTracker._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
);
pageTracker._trackTrans();

Suivi urchin.js

_uacct = "UA-12345-1";
urchinTracker();
</script>
<form name="utmform" id="utmform">
<textarea name="utmtrans" id="utmtrans" style="display:none">
UTM:T|1234|Mountain View|11.99|1.29|5|San Jose|California|USA
UTM:I|1234|DD44|T-Shirt|Green Medium|11.99|1
</textarea>
</form>
<script type="text/javascript">
__utmSetTrans();

Haut de page

Suivi des événements

L'utilisation du suivi des événements implique d'effectuer un appel d'événement au bon endroit dans 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 urchin.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>

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();
...
<a onclick="pageTracker._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 cela à l'aide de la méthode _setSessionCookieTimeout().

Extrait asynchrone (recommandé)

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

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setSessionCookieTimeout(3600000);
pageTracker._trackPageview();

Suivi urchin.js

<script type="text/javascript">
_uacct = "UA-12345-1";
_utimeout = "3600"; // the number of seconds in 1 hour
urchinTracker();
</script>

Haut de page

Sources – Moteurs de recherche, mots clés, URL de provenance

Par défaut, Google Analytics identifie une liste de sites Web en tant que 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 en savoir plus, consultez la section Moteurs de recherche du guide Sources de trafic. Vous pouvez également configurer Google Analytics de manière à ignorer les sites référents de certains domaines ou à traiter des 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']);

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._addIgnoredOrganic('ignore');
pageTracker._addIgnoredRef('urchin.com');
pageTracker._addOrganic('new_search_engine','q');
pageTracker._trackPageview();

Suivi urchin.js

_uacct = "UA-12345-1";
_uOno[0] = "ignore"; // keyword to treat as referral
_uRno[0] = "urchin.com"; // referral to treat as direct
_uOsr[41] = "new_search_engine"; // new search engine to treat as referral
_uOkw[41] = "query"; // keyword query parameter for new search engine

urchinTracker();

Haut de page

Suivi limité à un sous-répertoire

Utilisez la méthode _setCookiePath() pour définir un sous-répertoire comme chemin par défaut pour tous les suivis. Cela permet de confier tout le 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']);

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCookiePath('/path/of/cookie/');
pageTracker._trackPageview();

Suivi urchin.js

<script type="text/javascript">
_uacct = "UA-12345-1";
_utcp = "/path/of/cookie/";
urchinTracker();
</script>

Haut de page

Utiliser un serveur local

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

Extrait asynchrone

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

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setLocalRemoteServerMode();
pageTracker._trackPageview();

Suivi urchin.js

_uacct = "UA-12345-1";
_userv = 0;
urchinTracker();

Haut de page

Pages vues virtuelles

Utilisez la méthode _trackPageview() avec une URL que vous avez créée afin de suivre les clics des utilisateurs qui ne mènent pas à de véritables pages de votre site Web. En général, nous vous recommandons d'utiliser le suivi des événements pour suivre les téléchargements, les liens sortants, les fichiers PDF ou d'autres types d'interactions utilisateur similaires. En effet, les pages vues virtuelles s'ajoutent au nombre total de pages vues.

Extrait asynchrone

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

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview('/downloads/pdfs/corporateBrief.pdf');

Suivi urchin.js

urchinTracker('/downloads/pdfs/corporateBrief.pdf');

Haut de page