Riferimento ai metodi oggetto ga

Questo riferimento descrive i metodi disponibili nell'oggetto ga.

Riepilogo del metodo

I seguenti metodi sono disponibili sull'oggetto ga dopo il caricamento della libreria analytics.js. Poiché questi metodi non sono subito disponibili, dovresti sempre richiamarli utilizzando il callback pronto della coda dei comandi ga.

No: utilizza i metodi dell'oggetto ga al di fuori di readyCallback perché potrebbero non essere ancora disponibili.

var trackers = ga.getAll();

Sì: utilizza i metodi oggetto ga all'interno di un elemento readyCallback, in quanto ne è garantita la disponibilità.

ga(function() {
  var trackers = ga.getAll();
});

Metodi
create([trackingId], [cookieDomain], [name], [fieldsObject]);	restituzioni: Tracker Crea una nuova istanza di tracker con i campi specificati.
getByName(name)	restituzioni: Tracker Recupera l'istanza del tracker con il nome specificato.
getAll()	restituzioni: Array<Tracker> Recupera tutte le istanze del tracker.
remove(name)	restituzioni: undefined Rimuove l'istanza del tracker con il nome specificato.

Dettagli del metodo

create

Crea una nuova istanza di tracker con i campi specificati.

Utilizzo

ga.create([trackingId], [cookieDomain], [name], [fieldsObject]);

Nota: si consiglia di chiamare il metodo create tramite la coda dei comandi ga. Per ulteriori dettagli, consulta Riferimento al metodo di creazione.

Parametri

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

Ritorni

Tracker

Esempi

// Creates a default tracker for the property UA-XXXXX-Y
// and uses automatic cookie domain configuration.
ga(function() {
  var tracker = ga.create('UA-XXXXX-Y', 'auto');
})

// Creates a tracker with the name "myTracker" for the property
// UA-XXXXX-Y, sets the cookieDomain to "example.com" and specifies
// a site speed sample rate of 10%.
ga(function() {
  var myTracker = ga.create('UA-XXXXX-Y', 'example.com', 'myTracker', {
    siteSpeedSampleRate: 10
  });
});

---

getByName

Recupera l'istanza del tracker con il nome specificato.

Utilizzo

ga.getByName(name);

Parametri

Nome	Tipo	Obbligatorio	Descrizione
name	string	yes	Il nome del tracker da ottenere.

Ritorni

Tracker

Esempi

// Gets the default tracker.
ga(function() {
  ga.getByName('t0');
});

// Gets the tracker with the name "myTracker".
ga(function() {
  ga.getByName('myTracker');
});

---

getAll

Recupera tutte le istanze del tracker.

ga.getAll();

Ritorni

Array<Tracker>

Esempio

// Logs a list of all tracker names to the console.
ga(function() {
  var trackers = ga.getAll();
  trackers.forEach(function(tracker) {
    console.log(tracker.get('name'));
  });
});

---

remove

Rimuove l'istanza del tracker con il nome specificato.

Utilizzo

ga.remove(name);

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

Parametri

Nome	Tipo	Obbligatorio	Descrizione
name	string	yes	Il nome del tracker da rimuovere.

Ritorni

undefined

Esempi

// Removes the default tracker.
ga(function() {
  // Note that, unlike the ga command queue's remove method,
  // this method requires passing a tracker name, even when
  // removing the default tracker.
  ga.remove('t0');
});

// Removes the tracker with the name "myTracker".
ga(function() {
  ga.remove('myTracker');
});