Referência do objeto "rastreador"

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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

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.

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.

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