Referência do objeto do 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);
    

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