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: Define um par de campo/valor ou um grupo de pares de campo/valor no rastreador. |
send([hitType], [...fields], [fieldsObject]) |
Retorna: 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 }); });