Code de suivi: l'objet global _gat

ga.js est une ancienne bibliothèque. Si vous lancez une nouvelle implémentation, nous vous recommandons d'utiliser la dernière version de cette bibliothèque, analytics.js. Pour les implémentations existantes, découvrez comment passer de ga.js à analytics.js.

L'objet global _gat permet de créer et de récupérer des objets de suivi, à partir desquels toutes les autres méthodes sont appelées. Par conséquent, les méthodes de cette liste ne doivent être exécutées qu'à partir d'un objet de suivi créé à l'aide de la variable globale _gat. Toutes les autres méthodes doivent être appelées à l'aide de l'objet global _gaq pour le suivi asynchrone.

Méthodes de l'objet _gat

• _getTracker(account) obsolète
• _createTracker(opt_account, opt_name)
• _getTrackerByName(opt_name)
• _anonymizeIp()
• _forceSSL(bool)

Informations sur la méthode

_getTracker()

_getTracker(account)

Cette méthode est obsolète. Veuillez utiliser _gat._createTracker(opt_account, opt_name) à la place.

Crée un objet de suivi pour l'ID de propriété Web donné. Si cette méthode est appelée plusieurs fois pour le même ID de compte Analytics, un objet est créé pour chaque appel.

_gat._getTracker('UA-65432-1');

paramètres

String account ID de propriété Web complet (par exemple, UA-65432-1) pour l'objet de suivi.

retours

Tracker Objet de suivi créé.

---

_createTracker()

_createTracker(opt_account, opt_name)

Crée un objet de suivi et lui attribue le nom donné. Si aucun nom n'est indiqué, un nom sera généré. Les objets de suivi sont stockés sous leur nom afin d'être récupérés via _getTrackerByName. Si deux outils de suivi sont créés avec le même nom, le second écrasera le premier et le premier ne pourra plus être récupéré via _getTrackerByName.

_gat._createTracker('UA-65432-1');

_gat._createTracker('UA-65432-2', 't2');

paramètres

String opt_account ID de propriété Web complet (par exemple, UA-XXXXX-X) pour l'objet de suivi.
String opt_name Nom facultatif sous lequel stocker l'outil de suivi. Utilisez ce nom pour récupérer le traceur via _getTrackerByName.

retours

Tracker Objet de suivi créé.

---

_getTrackerByName()

_getTrackerByName(opt_name)

Récupère l'objet de suivi portant le nom donné. Si aucun nom n'est donné, la valeur par défaut sera utilisée, c'est-à-dire la chaîne vide (''). Si aucun outil de suivi n'existe avec le nom donné, un outil de suivi est créé, affecté à ce nom, puis renvoyé.

_gat._getTrackerByName();

_gat._getTrackerByName('t2');

paramètres

String opt_name Nom facultatif de l'outil de suivi à récupérer. La valeur par défaut est la chaîne vide ('').

retours

Tracker Objet de suivi récupéré ou créé.

---

_anonymizeIp().

_anonymizeIp()

Demande à Google Analytics de masquer les informations envoyées par les objets de suivi en supprimant le dernier octet de l'adresse IP avant son stockage. Notez que cela réduit légèrement la précision des données géographiques de vos rapports Google Analytics.

Lorsque vous utilisez cette fonction pour masquer le suivi, vous devez utiliser la fonction push et l'associer correctement à l'objet de suivi, comme illustré ci-dessous.

Extrait asynchrone (recommandé)

var _gaq = _gaq || [];
_gaq.push (['_setAccount', 'UA-XXXXXXX-YY']);
_gaq.push (['_gat._anonymizeIp']);
_gaq.push (['_trackPageview']);

Extrait traditionnel (ga.js)

<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try{
var pageTracker = _gat._getTracker("UA-xxxxxx-x");
_gat._anonymizeIp();
pageTracker._trackPageview();
} catch(err) {}</script>

---

_forceSSL()

_forceSSL(bool)

Configure Google Analytics de sorte qu'il envoie tous les appels SSL, même ceux provenant de pages (HTTP) non sécurisées.

Extrait asynchrone (recommandé)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_gat._forceSSL']);       // Send all hits using SSL, even from insecure (HTTP) pages.
_gaq.push(['_trackPageview']);

Extrait traditionnel (ga.js)

var pageTracker = _gat._getTracker("UA-12345-1");
// Send all hits using SSL even from insecure (HTTP) pages.
_gat._forceSSL();
pageTracker._trackPageview();