Code de suivi: l'objet global _gaq

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 _gaq peut être utilisé directement pour le suivi asynchrone des pages via la méthode push(...). Elle dispose également de méthodes permettant de créer des objets de suivi, mais celles-ci ne doivent être utilisées que dans de rares cas.

Pour le suivi des pages classique, utilisez plutôt l'objet global _gat.

Méthodes des objets _gaq

• _createAsyncTracker(accountId, opt_name) obsolète
• _getAsyncTracker(opt_name) obsolète
• push(commandArray)

Informations sur la méthode

_createAsyncTracker() ;

_createAsyncTracker(accountId, opt_name)

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

Crée un objet de suivi que vous pouvez désigner par son nom lorsque vous effectuez des appels de suivi asynchrones. Si aucun nom n'est indiqué, il s'agit de la chaîne vide '', qui représente l'outil de suivi par défaut dans la syntaxe asynchrone. Si un outil de suivi asynchrone existe déjà pour le nom donné, il sera remplacé par le nouvel outil de suivi.

Remarque: Cette méthode ne peut généralement être utilisée sans risque que dans une fonction transmise à _gaq. Il ne doit être utilisé que dans de rares cas.

_gaq._createAsyncTracker('UA-65432-1');

paramètres

String accountId ID de propriété Web complet (par exemple, UA-65432-1) pour l'objet de suivi.
String opt_name Nom sous lequel stocker l'objet de suivi. Utilisez ce nom pour faire référence ultérieurement à l'objet Tracker dans les appels de suivi asynchrones.

retours

Tracker Objet de suivi créé.

---

_getAsyncTracker().

_getAsyncTracker(opt_name)

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

Renvoie l'objet de suivi précédemment créé sous le nom donné. Si aucun nom n'est indiqué, le nom de l'outil de suivi par défaut (la chaîne vide '') sera utilisé. S'il n'existe aucun objet de suivi portant le nom donné, un outil de suivi est créé, attribué à ce nom, puis renvoyé.

Remarque: Cette méthode ne peut généralement être utilisée sans risque que dans une fonction transmise à _gaq. Il ne doit être utilisé que dans de rares cas.

_gaq._getAsyncTracker();

paramètres

String opt_name Nom de l'objet de suivi à récupérer.

retours

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

---

push

push(commandArray)

Exécute le command array donné, qui est simplement un tableau JavaScript conforme au format suivant. Le premier élément du tableau doit être le nom d'une méthode d'objet de suivi transmise sous forme de chaîne. Les autres éléments du tableau sont les valeurs à transmettre en tant qu'arguments à la fonction.

L'utilisation suivante est courante:


var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-65432-1']);
_gaq.push(['_trackPageview']);


Cette fonction est nommée push afin qu'un tableau puisse être utilisé à la place de _gaq avant le chargement complet d'Analytics. Pendant le chargement d'Analytics, les commandes sont transférées/mises en file d'attente dans le tableau. Une fois le chargement terminé, Analytics remplace le tableau par l'objet _gaq et exécute toutes les commandes en file d'attente. Les appels suivants à _gaq.push renvoient à cette fonction, qui exécute les commandes au fur et à mesure de leur transmission.

Vous pouvez nommer les traceurs en ajoutant le nom de l'outil de suivi (avec un point) devant le nom de la méthode. Si un nom de fonction est qualifié avec le nom d'un outil de suivi, il est exécuté sur cet outil.

L'exemple suivant crée et utilise un traceur appelé arbitrairement myTracker.


var _gaq = _gaq || [];
_gaq.push(['myTracker._setAccount', 'UA-65432-2']);
_gaq.push(['myTracker._setDomainName', 'foo.com']);
_gaq.push(['myTracker._trackPageview']);


Remarque:Les traceurs sont créés la première fois qu'une commande les référence. L'outil de suivi par défaut est créé via la première commande qui ne nomme pas explicitement son outil de suivi. Le nom de l'outil de suivi par défaut correspond à la chaîne vide ''.

En plus de transmettre des tableaux de commandes, vous pouvez transmettre des objets fonction. Cela peut être particulièrement utile pour les méthodes de suivi qui renvoient des valeurs. Ces fonctions peuvent faire référence à la fois à _gat et à _gaq.


var _gaq = _gaq || [];
_gaq.push(function() {
  var tracker = _gat._getTracker('UA-65432-1');
  tracker._trackPageview();
});


Vous pouvez également utiliser la syntaxe push directement dans le code HTML de votre page.


onclick="_gaq.push(['_trackEvent', 'name', value]);"


Tant que l'extrait Analytics asynchrone est présent au-dessus du lien, les clics sont enregistrés sans erreur, même si Analytics n'a pas été entièrement chargé au moment du clic. C'est l'un des nombreux avantages du suivi asynchrone.


Enfin, au lieu de saisir _gaq.push(...) pour chaque tableau de commandes, vous pouvez transférer toutes vos commandes en même temps. Le code suivant illustre cette technique. Pour en savoir plus, consultez le guide d'utilisation de l'extrait asynchrone.

_gaq.push(
  ['_setAccount', 'UA-XXXXX-X'],
  ['_setDomainName', 'example.com'],
  ['_setCustomVar', 1, 'Section', 'Life & Style', 3],
  ['_trackPageview']
);

paramètres

Array commandArray Commande à exécuter. Un ou plusieurs de ces éléments peuvent être transmis dans le même appel.

retours

Number : nombre de commandes qui n'ont pas pu être exécutées.

---