Ce document de référence décrit les méthodes disponibles pour l'objet Tracker
.
Récapitulatif sur la méthode
Méthodes | |
---|---|
get(fieldName) |
returns: Récupère la valeur d'un champ stocké dans l'outil de suivi. |
set(fieldName|fieldsObject, [fieldValue]) |
returns: Définit une paire champ/valeur ou un groupe de paires champ/valeur sur l'outil de suivi. |
send([hitType], [...fields], [fieldsObject]) |
returns: Envoie un appel à Google Analytics. |
Informations sur la méthode
get
Récupère la valeur d'un champ stocké dans l'outil de suivi.
Utilisation
tracker.get(fieldName);
Paramètres
Nom | Type | Obligatoire | Description |
---|---|---|---|
fieldName |
string |
oui | Nom du champ dont vous souhaitez obtenir la valeur. |
Renvoie
*
Exemples
// Creates a default tracker. ga('create', 'UA-XXXXX-Y', auto); // Gets the client ID of the default tracker and logs it. ga(function(tracker) { var clientId = tracker.get('clientId'); console.log(clientId); });
set
Définit une paire champ/valeur ou un groupe de paires champ/valeur sur l'outil de suivi.
Utilisation
// Sets a single field/value pair. tracker.set(fieldName, fieldValue);
// Sets a group of field/value pairs. tracker.set(fieldsObject);
Paramètres
Consultez la documentation de référence sur les champs pour en savoir plus sur chaque champ.
Renvoie
undefined
Exemples
// Creates a default tracker. ga('create', 'UA-XXXXX-Y', auto); ga(function(tracker) { // Sets the page field to "/about.html". tracker.set('page', '/about.html'); });
// Creates a default tracker. ga('create', 'UA-XXXXX-Y', auto); ga(function(tracker) { // Sets both the page and title fields. tracker.set({ page: '/about.html', title: 'About' }); });
send
Envoie un appel à Google Analytics.
Utilisation
tracker.send([hitType], [...fields], [fieldsObject]);
Les champs envoyés sont les valeurs spécifiées dans les paramètres ...fields
et fieldsObject
, fusionnées avec les champs actuellement stockés dans l'outil de suivi.
Paramètres
Les champs pouvant être spécifiés par les paramètres ...fields
varient en fonction du type d'appel. Le tableau suivant liste les champs correspondant à chaque type d'appel. Les types d'appels non répertoriés n'acceptent pas les paramètres ...fields
, mais uniquement fieldsObject
.
Type d'appel | ...fields |
---|---|
pageview |
page |
event |
eventCategory , eventAction , eventLabel , eventValue |
social |
socialNetwork , socialAction et socialTarget |
timing |
timingCategory , timingVar , timingValue , timingLabel |
Consultez la documentation de référence sur les champs pour en savoir plus sur chaque champ.
Renvoie
undefined
Exemples
// Creates a default tracker. ga('create', 'UA-XXXXX-Y', auto); ga(function(tracker) { // Sends a pageview hit. tracker.send('pageview'); });
// Creates a default tracker. ga('create', 'UA-XXXXX-Y', auto); ga(function(tracker) { // Sends an event hit for the tracker named "myTracker" with the // following category, action, and label, and sets the nonInteraction // field value to true. tracker.send('event', 'link', 'click', 'http://example.com', { nonInteraction: true }); });