Referência do objeto "rastreador"

Esta referência descreve os métodos disponíveis no objeto Tracker.

Resumo do método

Métodos
get(fieldName)	Retorna: * Acessa o valor de um campo armazenado no rastreador.
set(fieldName|fieldsObject, [fieldValue])	Retorna: undefined Define um par de campo/valor ou um grupo de pares de campo/valor no rastreador.
send([hitType], [...fields], [fieldsObject])	Retorna: undefined Envia um hit ao Google Analytics.

Detalhes do método

get

Acessa o valor de um campo armazenado no rastreador.

Uso

tracker.get(fieldName);

Parâmetros

Nome	Tipo	Obrigatório	Descrição
fieldName	string	Sim	Nome do campo do qual acessar o valor.

Retorna

*

Exemplos

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

Define um par de campo/valor ou um grupo de pares de campo/valor no rastreador.

Uso

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

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

Observação: é recomendado chamar o método set usando a fila de comandos do ga. Confira a referência do método set para mais detalhes.

Parâmetros

Consulte a referência de campos para ver a documentação referente a cada um.

Retorna

undefined

Exemplos

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

Envia um hit ao Google Analytics.

Uso

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

Os campos enviados são os valores especificados nos parâmetros ...fields e fieldsObject, combinados com os campos atualmente armazenados no rastreador.

Observação: os valores definidos em ...fields e fieldsObject são enviados com o hit atual, mas não são armazenados no objeto "rastreador". Use o método set para atualizar um rastreador.

Parâmetros

Os campos que podem ser especificados pelos parâmetros ...fields variam de acordo com o tipo de hit. A tabela a seguir lista os campos que correspondem a cada tipo de hit. Os tipos de hit não listados não aceitam parâmetros ...fields, somente os fieldsObject.

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

Consulte a referência de campos para ver a documentação referente a cada um.

Observação: é recomendado chamar o método send usando a fila de comandos ga. Consulte a referência do método "send" para ver mais detalhes.

Retorna

undefined

Exemplos

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