En esta referencia se describen los métodos disponibles en el objeto Tracker
.
Resumen de métodos
Métodos | |
---|---|
get(fieldName) |
Devuelve: Obtiene el valor de un campo almacenado en el objeto de seguimiento. |
set(fieldName|fieldsObject, [fieldValue]) |
Devuelve: Configura un par campo-valor o un grupo de pares campo-valor en el objeto de seguimiento. |
send([hitType], [...fields], [fieldsObject]) |
Devuelve: Envía un hit a Google Analytics. |
Detalles de método
get
Obtiene el valor de un campo almacenado en el objeto de seguimiento.
Uso
tracker.get(fieldName);
Parámetros
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
fieldName |
string |
sí | Nombre del campo del que se obtendrá el valor. |
Devuelve
*
Ejemplos
// 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
Configura un par campo-valor o un grupo de pares campo-valor en el objeto de seguimiento.
Uso
// Sets a single field/value pair. tracker.set(fieldName, fieldValue);
// Sets a group of field/value pairs. tracker.set(fieldsObject);
Parámetros
En la referencia de campos puedes consultar la documentación de cada campo.
Devuelve
undefined
Ejemplos
// 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
Envía un hit a Google Analytics.
Uso
tracker.send([hitType], [...fields], [fieldsObject]);
Los campos que se envían son los valores especificados en los parámetros ...fields
y en fieldsObject
, y se combinan con los campos que están almacenados en el objeto de seguimiento.
Parámetros
Los campos que se pueden especificar con los parámetros ...fields
varían según el tipo de hit. En la tabla siguiente se enumeran los campos que corresponden a cada tipo de hit. Los tipos de hit que no aparecen en la tabla no aceptan los parámetros ...fields
, solo fieldsObject
.
Tipo de hit | ...fields |
---|---|
pageview |
page |
event |
eventCategory , eventAction , eventLabel y eventValue |
social |
socialNetwork , socialAction y socialTarget |
timing |
timingCategory , timingVar , timingValue y timingLabel |
En la referencia de campos puedes consultar la documentación de cada campo.
Devuelve
undefined
Ejemplos
// 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 }); });