Référence d'objet de suivi

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:undefined

Définit une paire champ/valeur ou un groupe de paires champ/valeur sur l'outil de suivi.

send([hitType], [...fields], [fieldsObject])

returns:undefined

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
  });
});