Riferimento oggetto tracker

Questo riferimento descrive i metodi disponibili nell'oggetto Tracker.

Riepilogo del metodo

Metodi
get(fieldName)	restituzioni: * Recupera il valore di un campo memorizzato sul tracker.
set(fieldName|fieldsObject, [fieldValue])	restituzioni: undefined Imposta una coppia campo/valore o un gruppo di coppie campo/valore sul tracker.
send([hitType], [...fields], [fieldsObject])	restituzioni: undefined Invia un hit a Google Analytics.

Dettagli del metodo

get

Recupera il valore di un campo memorizzato sul tracker.

Utilizzo

tracker.get(fieldName);

Parametri

Nome	Tipo	Obbligatorio	Descrizione
fieldName	string	yes	Il nome del campo di cui ottenere il valore.

Ritorni

*

Esempi

// 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

Imposta una coppia campo/valore o un gruppo di coppie campo/valore sul tracker.

Utilizzo

// Sets a single field/value pair.
tracker.set(fieldName, fieldValue);

// Sets a group of field/value pairs.
tracker.set(fieldsObject);

Nota: si consiglia di chiamare il metodo set utilizzando la coda dei comandi ga. Per ulteriori dettagli, consulta la sezione Riferimento al metodo set.

Parametri

Consulta la documentazione di riferimento dei campi per la documentazione sui singoli campi.

Ritorni

undefined

Esempi

// 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

Invia un hit a Google Analytics.

Utilizzo

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

I campi inviati sono i valori specificati nei parametri ...fields e in fieldsObject, uniti ai campi attualmente memorizzati nel tracker.

Nota: i valori specificati in ...fields e fieldsObject vengono inviati con l'hit corrente, ma non vengono memorizzati nell'oggetto tracker. Usa il metodo set per aggiornare un tracker.

Parametri

I campi che possono essere specificati dai parametri ...fields variano a seconda del tipo di hit. Nella tabella seguente sono elencati i campi corrispondenti a ciascun tipo di hit. I tipi di hit non elencati non accettano i parametri ...fields, ma solo fieldsObject.

Tipo di hit	...fields
pageview	page
event	eventCategory, eventAction, eventLabel, eventValue
social	socialNetwork, socialAction, socialTarget
timing	timingCategory, timingVar, timingValue, timingLabel

Consulta la documentazione di riferimento dei campi per la documentazione sui singoli campi.

Nota: si consiglia di chiamare il metodo send utilizzando la coda dei comandi ga. Per ulteriori dettagli, consulta la documentazione di riferimento al metodo di invio.

Ritorni

undefined

Esempi

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