Universal Analytics (UA) quedará obsoleto el 1 de julio de 2023, lo que significa que dejará de procesar datos. Las propiedades de Analytics 360 dejarán de funcionar el 1 de octubre de 2023. Migre a Google Analytics 4 .

Referencia de campo de Analytics.js

Este documento enumera todos los nombres de campo configurables para analytics.js.

  1. Crear solo campos
  2. General
  3. Usuario
  4. Sesión
  5. Fuentes de tráfico
  6. Información del sistema
  7. Golpear
  8. Información de contenido
  9. aplicaciones
  10. Eventos
  11. Comercio electrónico mejorado
  12. Interacciones sociales
  13. Momento
  14. Excepciones
  15. Dimensiones/métricas personalizadas

Crear solo campos

Los siguientes campos solo se pueden establecer en el método create . Para obtener más detalles, lea la sección Creación de objetos de seguimiento en la Guía de configuración avanzada.

ID de seguimiento/ ID de propiedad web

Obligatorio para todos los tipos de visitas.

El ID de seguimiento/ID de propiedad web. El formato es UA-XXXX-Y. Todos los datos recopilados se asocian con este ID.

Nombre del campo Tipo de valor Valor por defecto
trackingId texto Ninguno
Valor de ejemplo: UA-XXXX-Y
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y');

// Alerts the tracking ID for the default tracker.
ga(function(tracker) {
  alert(tracker.get('trackingId'));
});

Nombre del rastreador

Opcional. Esto solo se puede establecer en el método create .

Nombre del objeto rastreador.

Nombre del campo Tipo de valor Valor por defecto
name texto t0
Valor de ejemplo: myTracker
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {'name': 'myTracker'});

Identificación del cliente

Opcional. Esto solo se puede establecer en el método create .

Identifica de forma seudónima una instancia del navegador. De forma predeterminada, este valor se almacena como parte de la cookie de Analytics de origen con una caducidad de dos años.

Nombre del campo Tipo de valor Valor por defecto
clientId texto Randomly Generated
Valor de ejemplo: 35009a79-1a05-49d7-b876-2b884d0f825b
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {
  'clientId': '35009a79-1a05-49d7-b876-2b884d0f825b'
});

Frecuencia de muestreo

Opcional. Esto solo se puede establecer en el método create .

Especifica qué porcentaje de usuarios debe ser rastreado. El valor predeterminado es 100 (no se muestrean usuarios), pero es posible que los sitios grandes necesiten usar una frecuencia de muestreo más baja para mantenerse dentro de los límites de procesamiento de Google Analytics.

Nombre del campo Tipo de valor Valor por defecto
sampleRate número 100
Valor de ejemplo: 5
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {'sampleRate': 5});

Frecuencia de muestreo de la velocidad del sitio

Opcional. Esto solo se puede establecer en el método create .

Esta configuración determina la frecuencia con la que se enviarán las balizas de velocidad del sitio. De forma predeterminada, se medirá automáticamente el 1 % de los usuarios.

Nombre del campo Tipo de valor Valor por defecto
siteSpeedSampleRate número 1
Valor de ejemplo: 10
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {'siteSpeedSampleRate': 10});

Enviar siempre referente

Opcional. Esto solo se puede establecer en el método create .

De forma predeterminada, la URL de referencia HTTP, que se utiliza para atribuir fuentes de tráfico, solo se envía cuando el nombre de host del sitio de referencia difiere del nombre de host de la página actual. Habilite esta configuración solo si desea procesar otras páginas de su host actual como referencias.

Nombre del campo Tipo de valor Valor por defecto
alwaysSendReferrer booleano false
Valor de ejemplo: true
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {'alwaysSendReferrer': true});

Permitir parámetros de anclaje

Opcional. Esto solo se puede establecer en el método create .

De forma predeterminada, analytics.js buscará parámetros de campaña personalizados, como utm_source, utm_medium, etc., tanto en la cadena de consulta como en el ancla de la URL de la página actual. Establecer este campo en falso hará que se ignoren los parámetros de campaña personalizados que aparecen en el ancla.

Nombre del campo Tipo de valor Valor por defecto
allowAnchor booleano true
Valor de ejemplo: false
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {'allowAnchor': false});

Nombre de la galleta

Opcional. Esto solo se puede establecer en el método create .

Nombre de la cookie utilizada para almacenar datos analíticos

Nombre del campo Tipo de valor Valor por defecto
cookieName texto _ga
Valor de ejemplo: gaCookie
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {'cookieName': 'gaCookie'});

Dominio de cookies

Opcional. Esto solo se puede establecer en el método create .

Especifica el dominio utilizado para almacenar la cookie de análisis. Establecer esto en 'ninguno' establece la cookie sin especificar un dominio.

Nombre del campo Tipo de valor Valor por defecto
cookieDomain texto document.location.hostname (normalized)
Valor de ejemplo: example.com
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {'cookieDomain': 'example.com'});

Banderas de cookies

Opcional. Esto solo se puede establecer en el método create .

Especifica banderas adicionales para agregar a la cookie. Las banderas deben estar separadas por punto y coma.

Nombre del campo Tipo de valor Valor por defecto
cookieFlags texto Ninguno
Valor de ejemplo: SameSite=None; Secure
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {'cookieFlags': 'SameSite=None; Secure'});

Caducidad de las cookies

Opcional. Esto solo se puede establecer en el método create .

Especifica la caducidad de la cookie, en segundos.

Nombre del campo Tipo de valor Valor por defecto
cookieExpires entero 63072000 (two years)
Valor de ejemplo: 86400
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {'cookieExpires': 86400});

Actualización de cookies

Opcional. Esto solo se puede establecer en el método create .

Cuando cookieUpdate se establece en verdadero (el valor predeterminado), analytics.js actualizará las cookies en cada carga de página. Esto actualizará la caducidad de la cookie que se establecerá en relación con la visita más reciente al sitio. Por ejemplo, si la caducidad de la cookie se establece en una semana y un usuario visita usando el mismo navegador cada cinco días, la caducidad de la cookie se actualizará en cada visita y, por lo tanto, nunca caducará.

Nombre del campo Tipo de valor Valor por defecto
cookieUpdate booleano true
Valor de ejemplo: true
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {'cookieUpdate': 'false'});

Tienda GAC

Opcional. Esto solo se puede establecer en el método create .

Por defecto, analytics.js escribe una cookie para almacenar información de la campaña. Este campo se puede utilizar para deshabilitar la escritura de esa cookie.

Nombre del campo Tipo de valor Valor por defecto
storeGac booleano true
Valor de ejemplo: false
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {'storeGac': false});

Dominio de cookies heredado

Opcional. Esto solo se puede establecer en el método create .

Este campo se usa para configurar cómo analytics.js busca cookies generadas por secuencias de comandos anteriores de Google Analytics, como ga.js y urchin.js.

Nombre del campo Tipo de valor Valor por defecto
legacyCookieDomain texto Ninguno
Valor de ejemplo: store.example.com
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {'legacyCookieDomain': 'store.example.com'});

Importación de historial heredado

Opcional. Esto solo se puede establecer en el método create .

Especifica si analytics.js debe intentar importar datos de historial de las cookies de ga.js.

Nombre del campo Tipo de valor Valor por defecto
legacyHistoryImport booleano true
Valor de ejemplo: false
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', 'auto', {'legacyHistoryImport': false});

Permitir parámetros del enlazador

Opcional. Esto solo se puede establecer en el método create .

Si se establece este campo en verdadero, se habilitará el análisis de los parámetros del enlazador entre dominios que se utilizan para transferir el estado entre dominios.

Nombre del campo Tipo de valor Valor por defecto
allowLinker booleano false
Valor de ejemplo: true
Ejemplo de uso: 
ga('create', 'UA-XXXX-Y', {allowLinker: true});

General

Permitir funciones publicitarias

Opcional.

Establezca este campo en falso para deshabilitar las balizas para las funciones publicitarias de Google Analytics cuando estas funciones se hayan habilitado mediante el complemento de funciones de visualización o desde Google Analytics (Configuración de la propiedad > Recopilación de datos).

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
allowAdFeatures Ninguno booleano true N / A todo
Valor de ejemplo: false
Ejemplo de uso: 
ga('set', 'allowAdFeatures', false)

IP de máscara

Opcional.

Cuando esté presente, la dirección IP del remitente estará enmascarada.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
anonymizeIp aip booleano Ninguno N / A todo
Valor de ejemplo: true
Ejemplo de uso: 
ga('set', 'anonymizeIp', true);

Fuente de datos

Opcional.

Indica la fuente de datos del hit. Los hits enviados desde analytics.js tendrán la fuente de datos establecida en 'web'; los hits enviados desde uno de los SDK móviles tendrán la fuente de datos establecida en 'aplicación'.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
dataSource ds texto Ninguno Ninguno todo
Valor de ejemplo: crm
Ejemplo de uso: 
ga('set', 'dataSource', 'crm');

Tiempo de cola

Opcional.

Se utiliza para recopilar visitas fuera de línea / latentes. El valor representa el delta de tiempo (en milisegundos) entre el momento en que se produjo el hit notificado y el momento en que se envió el hit. El valor debe ser mayor o igual a 0. Los valores superiores a cuatro horas pueden provocar que los hits no se procesen.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
queueTime qt entero Ninguno Ninguno todo
Valor de ejemplo: 560
Ejemplo de uso: 
ga('set', 'queueTime', 560);

Forzar SSL

Opcional.

De forma predeterminada, las balizas enviadas desde páginas https se enviarán mediante https, mientras que las balizas enviadas desde páginas http se enviarán mediante http. Establecer forceSSL en verdadero obligará a las páginas http a enviar también todas las balizas usando https.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
forceSSL Ninguno booleano false N / A todo
Valor de ejemplo: true
Ejemplo de uso: 
ga('set', 'forceSSL', true);

Transporte

Opcional.

Esto especifica el mecanismo de transporte con el que se enviarán los hits. Las opciones son 'baliza', 'xhr' o 'imagen'. De forma predeterminada, analytics.js intentará encontrar el mejor método en función del tamaño del hit y las capacidades del navegador. Si especifica 'beacon' y el navegador del usuario no es compatible con el método 'navigator.sendBeacon', volverá a 'image' o 'xhr' según el tamaño del hit.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
transport Ninguno texto none (automatically determined) Ninguno todo
Valor de ejemplo: beacon
Ejemplo de uso: 
ga('send', 'event', 'click', 'download-me', {transport: 'beacon'});

Usar baliza

Opcional.

Esta opción ahora está obsoleta. Utilice 'transporte' en su lugar. Al establecer esto en verdadero, se le indicará al cliente que use navigator.sendBeacon para enviar el hit. Esto es útil en los casos en los que desea realizar un seguimiento de un evento justo antes de que un usuario abandone su sitio, sin demorar la navegación. Si el navegador no es compatible con navigator.sendBeacon, el hit se enviará normalmente.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
useBeacon Ninguno booleano false N / A todo
Valor de ejemplo: true
Ejemplo de uso: 
ga('send', 'event', 'click', 'download-me', {useBeacon: true});

Parámetro del enlazador

Opcional.

El parámetro del enlazador para la medición entre dominios.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
linkerParam Ninguno texto Ninguno Ninguno todo
Valor de ejemplo: _ga=1.231587807.1974034684.1435105198
Ejemplo de uso: 
// Alerts the linker parameter for the default tracker.
ga(function(tracker) {
  alert(tracker.get('linkerParam'));
});

Pulse Devolución de llamada

Opcional.

Una función que se llamará después de procesar un hit. Esta devolución de llamada está diseñada para llamarse siempre, ya sea directamente después de que se envíe correctamente un hit o cuando se haya determinado que no se puede enviar un hit o no se pudo enviar. No se pasan argumentos a la función cuando se llama. Es posible que desee evitar el uso de hitcallBack para ejecutar código que es fundamental para su aplicación, ya que es posible que no se llame en casos excepcionales (por ejemplo, si el servidor no responde o si no se carga analytics.js). En este caso, puede establecer un tiempo de espera para garantizar la ejecución.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
hitCallback Ninguno función Ninguno Ninguno todo
Ejemplo de uso: 
// Alerts the user when a hit is sent.
ga('send', 'pageview', {
  'hitCallback': function() {
    alert('hit sent');
  }
});


// Use a timeout to ensure the execution of critical application code.
ga('send', 'pageview', {'hitCallback': criticalCode});
setTimeout(criticalCode, 2000);

// Only run the critical code once.
var alreadyCalled = false;
function criticalCode() {
  if (alreadyCalled) return;
  alreadyCalled = true;

  // Run critical code here...
}

Usuario

ID de usuario

Opcional.

Este campo es obligatorio si no se especifica el ID de cliente (cid) en la solicitud. Este pretende ser un identificador conocido para un usuario proporcionado por el propietario del sitio/usuario de la biblioteca. No debe ser en sí mismo PII (información de identificación personal). El valor nunca debe persistir en las cookies de Google Analytics u otro almacenamiento proporcionado por Analytics.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
userId uid texto Ninguno Ninguno todo
Valor de ejemplo: as8eknlll
Ejemplo de uso: 
// Set the user ID when creating the tracker.
ga('create', 'UA-XXXX-Y', {'userId': 'as8eknlll'});

// Alternatively, you may set the user ID via the `set` method.
ga('set', 'userId', 'as8eknlll');

Sesión

Control de sesión

Opcional.

Se utiliza para controlar la duración de la sesión. Un valor de 'start' obliga a que una nueva sesión comience con este hit y 'end' obliga a que la sesión actual finalice con este hit. Todos los demás valores se ignoran.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
sessionControl sc texto Ninguno Ninguno todo
Valor de ejemplo: start
Ejemplo de uso: 
// Starts a new session.
ga('send', 'pageview', {'sessionControl': 'start'});

Fuentes de tráfico

Referencia del documento

Opcional.

Especifica qué fuente de referencia trajo tráfico a un sitio web. Este valor también se utiliza para calcular la fuente de tráfico. El formato de este valor es una URL. Este campo se inicializa con el comando de creación y solo se establece cuando el nombre de host actual difiere del nombre de host de referencia, a menos que el campo 'alwaysSendReferrer' se establezca en verdadero.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
referrer dr texto document.referrer 2048 bytes todo
Valor de ejemplo: http://example.com
Ejemplo de uso: 
ga('set', 'referrer', 'http://example.com');

Nombre de campaña

Opcional.

Especifica el nombre de la campaña.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
campaignName cn texto Ninguno 100 bytes todo
Valor de ejemplo: (direct)
Ejemplo de uso: 
ga('set', 'campaignName', '(direct)');

Origen de la campaña

Opcional.

Especifica la fuente de la campaña.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
campaignSource cs texto Ninguno 100 bytes todo
Valor de ejemplo: (direct)
Ejemplo de uso: 
ga('set', 'campaignSource', '(direct)');

Medio de campaña

Opcional.

Especifica el medio de la campaña.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
campaignMedium cm texto Ninguno 50 bytes todo
Valor de ejemplo: organic
Ejemplo de uso: 
ga('set', 'campaignMedium', 'organic');

Palabra clave de la campaña

Opcional.

Especifica la palabra clave de la campaña.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
campaignKeyword ck texto Ninguno 500 bytes todo
Valor de ejemplo: Blue Shoes
Ejemplo de uso: 
ga('set', 'campaignKeyword', 'Blue Shoes');

Contenido de la campaña

Opcional.

Especifica el contenido de la campaña.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
campaignContent cc texto Ninguno 500 bytes todo
Valor de ejemplo: content
Ejemplo de uso: 
ga('set', 'campaignContent', 'content');

Identificación de la campaña

Opcional.

Especifica el ID de la campaña.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
campaignId ci texto Ninguno 100 bytes todo
Valor de ejemplo: ID
Ejemplo de uso: 
ga('set', 'campaignId', 'ID');

Información del sistema

Resolución de la pantalla

Opcional.

Especifica la resolución de la pantalla. Este campo se inicializa con el comando de creación.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
screenResolution sr texto Ninguno 20 bytes todo
Valor de ejemplo: 800x600
Ejemplo de uso: 
ga('set', 'screenResolution', '800x600');

Tamaño de la ventana gráfica

Opcional.

Especifica el área visible del navegador/dispositivo. Este campo se inicializa con el comando de creación.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
viewportSize vp texto Ninguno 20 bytes todo
Valor de ejemplo: 123x456
Ejemplo de uso: 
ga('set', 'viewportSize', '123x456');

Codificación de documentos

Opcional.

Especifica el juego de caracteres utilizado para codificar la página/documento. Este campo se inicializa con el comando de creación.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
encoding de texto UTF-8 20 bytes todo
Valor de ejemplo: UTF-8
Ejemplo de uso: 
ga('set', 'encoding', 'UTF-16');

Colores de pantalla

Opcional.

Especifica la profundidad de color de la pantalla. Este campo se inicializa con el comando de creación.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
screenColors sd texto Ninguno 20 bytes todo
Valor de ejemplo: 24-bits
Ejemplo de uso: 
ga('set', 'screenColors', '8-bit');

Idioma del usuario

Opcional.

Especifica el idioma. Este campo se inicializa con el comando de creación.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
language ul texto Ninguno 20 bytes todo
Valor de ejemplo: en-us
Ejemplo de uso: 
ga('set', 'language', 'en-us');

Java habilitado

Opcional.

Especifica si se habilitó Java. Este campo se inicializa con el comando de creación.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
javaEnabled je booleano Ninguno N / A todo
Valor de ejemplo: true
Ejemplo de uso: 
ga('set', 'javaEnabled', true);

Versión flash

Opcional.

Especifica la versión flash. Este campo se inicializa con el comando de creación.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
flashVersion fl texto Ninguno 20 bytes todo
Valor de ejemplo: 10 1 r103
Ejemplo de uso: 
ga('set', 'flashVersion', '10 1 r103');

Golpear

tipo de golpe

Obligatorio para todos los tipos de visitas.

El tipo de golpe. Debe ser uno de 'página vista', 'pantalla vista', 'evento', 'transacción', 'elemento', 'social', 'excepción', 'tiempo'.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
hitType t texto Ninguno Ninguno todo
Valor de ejemplo: pageview
Ejemplo de uso: 
ga('send', {
  'hitType': 'pageview',
  'page': '/home'
});

Hit sin interacción

Opcional.

Especifica que un hit se considere no interactivo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
nonInteraction ni booleano Ninguno N / A todo
Valor de ejemplo: true
Ejemplo de uso: 
ga('set', 'nonInteraction', true);

Información de contenido

URL de ubicación del documento

Opcional.

Especifica la URL completa (excluyendo el ancla) de la página. Este campo se inicializa con el comando de creación.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
location dl texto Ninguno 2048 bytes todo
Valor de ejemplo: http://foo.com/home?a=b
Ejemplo de uso: 
ga('set', 'location', 'http://foo.com/home?a=b');

Nombre del host del documento

Opcional.

Especifica el nombre de host desde el que se alojó el contenido.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
hostname dh texto Ninguno 100 bytes todo
Valor de ejemplo: foo.com
Ejemplo de uso: 
ga('set', 'hostname', 'foo.com');

Ruta del documento

Opcional.

La parte de la ruta de la URL de la página. Debe comenzar con '/'. Para los hits de 'página vista', se debe especificar &dl o &dh y &dp para que el hit sea válido. Se utiliza para especificar rutas de páginas virtuales.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
page dp texto Ninguno 2048 bytes todo
Valor de ejemplo: /foo
Ejemplo de uso: 
ga('set', 'page', '/foo');

Titulo del documento

Opcional.

El título de la página/documento. El valor predeterminado es documento.título.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
title dt texto Ninguno 1500 bytes todo
Valor de ejemplo: Settings
Ejemplo de uso: 
ga('set', 'title', 'Settings');

Nombre de pantalla

Obligatorio para el tipo de hit de vista de pantalla.

Este parámetro es opcional en las propiedades web y obligatorio en las propiedades móviles para las vistas de pantalla, donde se usa para el 'Nombre de pantalla' de la vista de pantalla. En las propiedades web, se establecerá de forma predeterminada en la URL única de la página, ya sea utilizando el parámetro &dl tal como está o ensamblando desde &dh y &dp.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
screenName cd texto Ninguno 2048 bytes vista de pantalla
Valor de ejemplo: High Scores
Ejemplo de uso: 
ga('set', 'screenName', 'High Scores');

Grupo de contenido

Opcional.

Puede tener hasta 5 agrupaciones de contenido, cada una de las cuales tiene un índice asociado entre 1 y 5, ambos inclusive. Cada agrupación de contenido puede tener hasta 100 grupos de contenido. El valor de un grupo de contenido es un texto jerárquico delimitado por '/". Se eliminarán todas las barras inclinadas iniciales y finales y las barras inclinadas repetidas se reducirán a una sola barra inclinada. Por ejemplo, '/a//b/' se convertirá en 'a/b'.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
contentGroup cg<groupIndex> texto Ninguno 100 bytes todo
Valor de ejemplo: news/sports
Ejemplo de uso: 
ga('set', 'contentGroup5', '/news/sports');

ID de enlace

Opcional.

El ID de un elemento DOM en el que se hizo clic, que se usa para eliminar la ambigüedad de varios enlaces a la misma URL en los informes de In-Page Analytics cuando la atribución de enlace mejorada está habilitada para la propiedad.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
linkid linkid texto Ninguno Ninguno todo
Valor de ejemplo: nav_bar
Ejemplo de uso: 
ga('set', '&linkid', 'html-element-id');

aplicaciones

Nombre de la aplicación

Opcional.

Especifica el nombre de la aplicación. Este campo es obligatorio para cualquier hit que tenga datos relacionados con la aplicación (es decir, versión de la aplicación, ID de la aplicación o ID del instalador de la aplicación). Para las visitas enviadas a las propiedades web, este campo es opcional.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
appName an texto Ninguno 100 bytes todo
Valor de ejemplo: My App
Ejemplo de uso: 
ga('set', 'appName', 'My App');

ID de aplicación

Opcional.

Identificador de la aplicación.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
appId aid texto Ninguno 150 bytes todo
Valor de ejemplo: com.company.app
Ejemplo de uso: 
ga('set', 'appId', 'com.company.app');

Versión de la aplicación

Opcional.

Especifica la versión de la aplicación.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
appVersion av texto Ninguno 100 bytes todo
Valor de ejemplo: 1.2
Ejemplo de uso: 
ga('set', 'appVersion', '1.2');

ID del instalador de la aplicación

Opcional.

Identificador del instalador de la aplicación.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
appInstallerId aiid texto Ninguno 150 bytes todo
Valor de ejemplo: com.platform.vending
Ejemplo de uso: 
ga('set', 'appInstallerId', 'com.platform.vending');

Eventos

Categoría de evento

Obligatorio para el tipo de hit de evento.

Especifica la categoría del evento. No debe estar vacío.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
eventCategory ec texto Ninguno 150 bytes evento
Valor de ejemplo: Category
Ejemplo de uso: 
ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action'
});

Acción de evento

Obligatorio para el tipo de hit de evento.

Especifica la acción del evento. No debe estar vacío.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
eventAction ea texto Ninguno 500 bytes evento
Valor de ejemplo: Action
Ejemplo de uso: 
ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action'
});

Etiqueta de evento

Opcional.

Especifica la etiqueta del evento.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
eventLabel el texto Ninguno 500 bytes evento
Valor de ejemplo: Label
Ejemplo de uso: 
ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action',
  'eventLabel': 'Label'
});

Valor del evento

Opcional.

Especifica el valor del evento. Los valores deben ser no negativos.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
eventValue ev entero Ninguno Ninguno evento
Valor de ejemplo: 55
Ejemplo de uso: 
ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action',
  'eventValue': 55
});

Comercio electrónico mejorado

SKU del producto

Opcional.

El SKU del producto. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product) id pr<productIndex>id texto Ninguno 500 bytes todo
Valor de ejemplo: P12345
Ejemplo de uso: 
ga('ec:addProduct', {'id': 'P12345'});

nombre del producto

Opcional.

El nombre del producto. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product) name pr<productIndex>nm texto Ninguno 500 bytes todo
Valor de ejemplo: Android T-Shirt
Ejemplo de uso: 
ga('ec:addProduct', {'name': 'Android T-Shirt'});

Producto de marca

Opcional.

La marca asociada al producto. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product) brand pr<productIndex>br texto Ninguno 500 bytes todo
Valor de ejemplo: Google
Ejemplo de uso: 
ga('ec:addProduct', {'brand': 'Google'});

categoria de producto

Opcional.

La categoría a la que pertenece el producto. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. El parámetro de categoría de producto puede ser jerárquico. Utilice / como delimitador para especificar hasta 5 niveles de jerarquía. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product) category pr<productIndex>ca texto Ninguno 500 bytes todo
Valor de ejemplo: Apparel
Ejemplo de uso: 
ga('ec:addProduct', {'category': 'Apparel'});

Variante del producto

Opcional.

La variante del producto. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product) variant pr<productIndex>va texto Ninguno 500 bytes todo
Valor de ejemplo: Black
Ejemplo de uso: 
ga('ec:addProduct', {'variant': 'Black'});

Precio del producto

Opcional.

El precio unitario de un producto. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product) price pr<productIndex>pr divisa Ninguno Ninguno todo
Valor de ejemplo: 29.20
Ejemplo de uso: 
ga('ec:addProduct', {'price': '29.20'});

Cantidad de producto

Opcional.

La cantidad de un producto. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product) quantity pr<productIndex>qt entero Ninguno Ninguno todo
Valor de ejemplo: 2
Ejemplo de uso: 
ga('ec:addProduct', {'quantity': 2});

Código de cupón del producto

Opcional.

El código de cupón asociado a un producto. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product) coupon pr<productIndex>cc texto Ninguno 500 bytes todo
Valor de ejemplo: SUMMER_SALE13
Ejemplo de uso: 
ga('ec:addProduct', {'coupon': 'SUMMER_SALE13'});

Posición del producto

Opcional.

La posición del producto en una lista o colección. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product) position pr<productIndex>ps entero Ninguno Ninguno todo
Valor de ejemplo: 2
Ejemplo de uso: 
ga('ec:addProduct', {'position': 2});

Dimensión personalizada del producto

Opcional.

Una dimensión personalizada a nivel de producto donde el índice de dimensión es un número entero positivo entre 1 y 200, inclusive. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product) dimension pr<productIndex>cd<dimensionIndex> texto Ninguno 150 bytes todo
Valor de ejemplo: Member
Ejemplo de uso: 
ga('ec:addProduct', {'dimension1': 'Member'});

Métrica personalizada del producto

Opcional.

Una métrica personalizada a nivel de producto donde el índice de la métrica es un número entero positivo entre 1 y 200, inclusive. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product) metric pr<productIndex>cm<metricIndex> entero Ninguno Ninguno todo
Valor de ejemplo: 28
Ejemplo de uso: 
ga('ec:addProduct', {'metric1': 28});

Acción del producto

Opcional.

El papel de los productos incluidos en un hit. Si no se especifica una acción de producto, se ignorarán todas las definiciones de producto incluidas con el hit. Debe ser uno de: detalle, hacer clic, agregar, eliminar, pagar, checkout_option, comprar, reembolsar. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product action) pa texto Ninguno Ninguno todo
Valor de ejemplo: detail
Ejemplo de uso: 
ga('ec:setAction', 'detail');

ID de transacción

Opcional.

El ID de la transacción. Este es un parámetro adicional que se puede enviar cuando la Acción del producto se establece en 'compra' o 'reembolso'. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product action) id ti texto Ninguno Ninguno todo
Valor de ejemplo: T1234
Ejemplo de uso: 
ga('ec:setAction', 'purchase', {'id': 'T1234'});

Afiliación

Opcional.

La tienda o afiliación desde la que se produjo esta transacción. Este es un parámetro adicional que se puede enviar cuando la Acción del producto se establece en 'compra' o 'reembolso'. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product action) affiliation ta texto Ninguno Ninguno todo
Valor de ejemplo: Google Store
Ejemplo de uso: 
ga('ec:setAction', 'purchase', {'affiliation': 'Google Store'});

Ganancia

Opcional.

El valor total de la transacción, incluidos los impuestos y el envío. Si no se envía, este valor se calculará automáticamente utilizando los campos de cantidad y precio del producto de todos los productos en el mismo hit. Este es un parámetro adicional que se puede enviar cuando la Acción del producto se establece en 'compra' o 'reembolso'. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product action) revenue tr divisa Ninguno Ninguno todo
Valor de ejemplo: 123.21
Ejemplo de uso: 
ga('ec:setAction', 'purchase', {'revenue': '123.21'});

Impuesto

Opcional.

El impuesto total asociado con la transacción. Este es un parámetro adicional que se puede enviar cuando la Acción del producto se establece en 'compra' o 'reembolso'. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product action) tax tt divisa Ninguno Ninguno todo
Valor de ejemplo: 10.78
Ejemplo de uso: 
ga('ec:setAction', 'purchase', {'tax': '10.78'});

Envío

Opcional.

El costo de envío asociado con la transacción. Este es un parámetro adicional que se puede enviar cuando la Acción del producto se establece en 'compra' o 'reembolso'. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product action) shipping ts divisa Ninguno Ninguno todo
Valor de ejemplo: 3.55
Ejemplo de uso: 
ga('ec:setAction', 'purchase', {'shipping': '3.55'});

Código promocional

Opcional.

El cupón de transacción canjeado con la transacción. Este es un parámetro adicional que se puede enviar cuando la Acción del producto se establece en 'compra' o 'reembolso'. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product action) coupon tcc texto Ninguno Ninguno todo
Valor de ejemplo: SUMMER08
Ejemplo de uso: 
ga('ec:setAction', 'purchase', {'coupon': 'SUMMER08'});

Lista de acciones del producto

Opcional.

La lista o colección a partir de la cual se produjo una acción de producto. Este es un parámetro adicional que se puede enviar cuando la Acción del producto se establece en 'detalle' o 'clic'. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product action) list pal texto Ninguno Ninguno todo
Valor de ejemplo: Search Results
Ejemplo de uso: 
ga('ec:setAction', 'click', {'list': 'Search Results'});

Paso de pago

Opcional.

El número de paso en un embudo de pago. Este es un parámetro adicional que se puede enviar cuando la Acción del producto se establece en 'pagar'. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product action) step cos entero Ninguno Ninguno todo
Valor de ejemplo: 2
Ejemplo de uso: 
ga('ec:setAction', 'checkout', {'step': 2});

Opción de paso de pago

Opcional.

Información adicional sobre un paso de pago. Este es un parámetro adicional que se puede enviar cuando la Acción del producto se establece en 'pagar'. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(product action) option col texto Ninguno Ninguno todo
Valor de ejemplo: Visa
Ejemplo de uso: 
ga('ec:setAction', 'checkout', {'option': 'Visa'});

Nombre de la lista de impresiones del producto

Opcional.

La lista o colección a la que pertenece un producto. El índice de la lista de impresiones debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(impression) list il<listIndex>nm texto Ninguno Ninguno todo
Valor de ejemplo: Search Results
Ejemplo de uso: 
ga('ec:addImpression', {'list': 'Search Results'});

SKU de impresión de producto

Opcional.

El ID o SKU del producto. El índice de la lista de impresiones debe ser un número entero positivo entre 1 y 200, ambos inclusive. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(impression) id il<listIndex>pi<productIndex>id texto Ninguno Ninguno todo
Valor de ejemplo: P67890
Ejemplo de uso: 
ga('ec:addImpression', {'id': 'P67890'});

Nombre de la impresión del producto

Opcional.

El nombre del producto. El índice de la lista de impresiones debe ser un número entero positivo entre 1 y 200, ambos inclusive. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(impression) name il<listIndex>pi<productIndex>nm texto Ninguno Ninguno todo
Valor de ejemplo: Android T-Shirt
Ejemplo de uso: 
ga('ec:addImpression', {'name': 'Android T-Shirt'});

Producto Impresión Marca

Opcional.

La marca asociada al producto. El índice de la lista de impresiones debe ser un número entero positivo entre 1 y 200, ambos inclusive. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(impression) brand il<listIndex>pi<productIndex>br texto Ninguno Ninguno todo
Valor de ejemplo: Google
Ejemplo de uso: 
ga('ec:addImpression', {'brand': 'Google'});

Categoría de impresión del producto

Opcional.

La categoría a la que pertenece el producto. El índice de la lista de impresiones debe ser un número entero positivo entre 1 y 200, ambos inclusive. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(impression) category il<listIndex>pi<productIndex>ca texto Ninguno Ninguno todo
Valor de ejemplo: Apparel
Ejemplo de uso: 
ga('ec:addImpression', {'category': 'Apparel'});

Variante de impresión de producto

Opcional.

La variante del producto. El índice de la lista de impresiones debe ser un número entero positivo entre 1 y 200, ambos inclusive. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(impression) variant il<listIndex>pi<productIndex>va texto Ninguno Ninguno todo
Valor de ejemplo: Black
Ejemplo de uso: 
ga('ec:addImpression', {'variant': 'Black'});

Posición de impresión del producto

Opcional.

La posición del producto en una lista o colección. El índice de la lista de impresiones debe ser un número entero positivo entre 1 y 200, ambos inclusive. El índice de producto debe ser un número entero positivo entre 1 y 200, ambos inclusive. Para analytics.js, el complemento de comercio electrónico mejorado debe estar instalado antes de usar este campo.

Nombre del campo Parámetro de protocolo Tipo de valor Valor por defecto Longitud máxima Tipos de visitas compatibles
(impression) position il<listIndex>pi<productIndex>ps entero Ninguno Ninguno todo
Valor de ejemplo: 2
Ejemplo de uso: 
ga('ec:addImpression', {'position': 2});

Precio de impresión del producto

Opcional.

El precio de un producto. El índice de la lista de impresiones debe ser un número entero positivo entre 1 y 200, ambos inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
(impression) price il<listIndex>pi<productIndex>pr currency None None all
Example value: 29.20
Example usage: 
ga('ec:addImpression', {'price': '29.20'});

Product Impression Custom Dimension

Optional.

A product-level custom dimension where dimension index is a positive integer between 1 and 200, inclusive. Impression List index must be a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
(impression) dimension il<listIndex>pi<productIndex>cd<dimensionIndex> text None None all
Example value: Member
Example usage: 
ga('ec:addImpression', {'dimension1': 'Member'});

Product Impression Custom Metric

Optional.

A product-level custom metric where metric index is a positive integer between 1 and 200, inclusive. Impression List index must be a positive integer between 1 and 200, inclusive. Product index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
(impression) metric il<listIndex>pi<productIndex>cm<metricIndex> integer None None all
Example value: 28
Example usage: 
ga('ec:addImpression', {'metric1': '28'});

Promotion ID

Optional.

The promotion ID. Promotion index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
(promo) id promo<promoIndex>id text None None all
Example value: SHIP
Example usage: 
ga('ec:addPromo', {'id': 'SHIP'});

Promotion Name

Optional.

The name of the promotion. Promotion index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
(promo) name promo<promoIndex>nm text None None all
Example value: Free Shipping
Example usage: 
ga('ec:addPromo', {'name': 'Free Shipping'});

Promotion Creative

Optional.

The creative associated with the promotion. Promotion index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
(promo) creative promo<promoIndex>cr text None None all
Example value: Shipping Banner
Example usage: 
ga('ec:addPromo', {'creative': 'Shipping Banner'});

Promotion Position

Optional.

The position of the creative. Promotion index must be a positive integer between 1 and 200, inclusive. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
(promo) position promo<promoIndex>ps text None None all
Example value: banner_slot_1
Example usage: 
ga('ec:addPromo', {'position': 'banner_slot_1'});

Promotion Action

Optional.

Specifies the role of the promotions included in a hit. If a promotion action is not specified, the default promotion action, 'view', is assumed. To measure a user click on a promotion set this to 'promo_click'. For analytics.js the Enhanced Ecommerce plugin must be installed before using this field.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
(promo) action promoa text None None all
Example value: click
Example usage: 
ga('ec:setAction', 'promo_click'});

Currency Code

Optional.

When present indicates the local currency for all transaction currency values. Value should be a valid ISO 4217 currency code.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
currencyCode cu text None 10 Bytes all
Example value: EUR
Example usage: 
ga('set', 'currencyCode', 'EUR');

Social Interactions

Social Network

Required for social hit type.

Specifies the social network, for example Facebook or Google Plus.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
socialNetwork sn text None 50 Bytes social
Example value: facebook
Example usage: 
ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

Social Action

Required for social hit type.

Specifies the social interaction action. For example on Google Plus when a user clicks the +1 button, the social action is 'plus'.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
socialAction sa text None 50 Bytes social
Example value: like
Example usage: 
ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

Social Action Target

Required for social hit type.

Specifies the target of a social interaction. This value is typically a URL but can be any text.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
socialTarget st text None 2048 Bytes social
Example value: http://foo.com
Example usage: 
ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

Timing

User timing category

Required for timing hit type.

Specifies the user timing category.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
timingCategory utc text None 150 Bytes timing
Example value: category
Example usage: 
ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123
});

User timing variable name

Required for timing hit type.

Specifies the user timing variable.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
timingVar utv text None 500 Bytes timing
Example value: lookup
Example usage: 
ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123
});

User timing time

Required for timing hit type.

Specifies the user timing value. The value is in milliseconds.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
timingValue utt integer None None timing
Example value: 123
Example usage: 
ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123
});

User timing label

Optional.

Specifies the user timing label.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
timingLabel utl text None 500 Bytes timing
Example value: label
Example usage: 
ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123,
  'timingLabel': 'label'
});

Exceptions

Exception Description

Optional.

Specifies the description of an exception.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
exDescription exd text None 150 Bytes exception
Example value: DatabaseError
Example usage: 
ga('send', 'exception', {
  'exDescription': 'DatabaseError'
});

Is Exception Fatal?

Optional.

Specifies whether the exception was fatal.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
exFatal exf boolean 1 N/A exception
Example value: true
Example usage: 
ga('send', 'exception', {
  'exFatal': true
});

Custom Dimensions / Metrics

Custom Dimension

Optional.

Each custom dimension has an associated index. There is a maximum of 20 custom dimensions (200 for Analytics 360 accounts). The dimension index must be a positive integer between 1 and 200, inclusive.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
dimension cd<dimensionIndex> text None 150 Bytes all
Example value: Sports
Example usage: 
ga('set', 'dimension14', 'Sports');

Custom Metric

Optional.

Each custom metric has an associated index. There is a maximum of 20 custom metrics (200 for Analytics 360 accounts). The metric index must be a positive integer between 1 and 200, inclusive.

Field Name Protocol Parameter Value Type Default Value Max Length Supported Hit Types
metric cm<metricIndex> number None None all
Example value: 47
Example usage: 
ga('set', 'metric7', 47);