Las propiedades Universal Analytics estándares (UA) dejaron de procesar datos el 1 de julio de 2023. Las propiedades UA 360 dejarán de procesar datos el 1 de julio de 2024, y algunas funciones de UA 360 dejarán de estar disponibles antes de esa fecha, a medida que migremos a Google Analytics 4. Agrega Google Analytics 4 a tu implementación existente.

Se usó la API de Cloud Translation para traducir esta página.

Comparaciones de sintaxis

En este documento, se muestran ilustraciones de códigos de seguimiento para una variedad de personalizaciones de seguimiento comunes. Si tu fragmento de seguimiento de Google Analytics contiene el lenguaje de marcado urchin.js o la sintaxis ga.js tradicional, usa esta guía para migrar el seguimiento al fragmento asíncrono mejorado.

Cómo migrar al seguimiento asíncrono

Como práctica recomendada, primero copia y guarda las personalizaciones existentes del código de seguimiento en un archivo de texto (no en un documento de procesador de texto). Con una copia de seguridad, puedes asegurarte de haber migrado todas las personalizaciones de tu sitio.

Para convertir tus páginas de modo que usen el fragmento asíncrono, haz lo siguiente:

Quita el fragmento de código de seguimiento existente y todas las personalizaciones que hayas realizado.
Para reducir los errores, te recomendamos que quites el fragmento de código de seguimiento existente del archivo de inclusión o del mecanismo que lo inserta en tus páginas web. Puedes pegar el fragmento de código de seguimiento existente en un archivo de texto para realizar un seguimiento de los métodos personalizados que utilices.
Inserta el fragmento asíncrono en la parte inferior de la sección <head> de tus páginas, después de las otras secuencias de comandos que pueda usar tu página o plantilla.
Una de las principales ventajas del fragmento asíncrono es que puedes colocarlo en la parte superior del documento HTML. Esto aumenta la probabilidad de que la baliza de seguimiento se envíe antes de que el usuario abandone la página. Determinamos que, en la mayoría de las páginas, la ubicación óptima para el fragmento asíncrono es al final de la sección <head>, justo antes de la etiqueta de cierre </head>.
Modifica el método _setAccount con tu ID de propiedad web.

Para obtener más información sobre los IDs de propiedad web, consulta la sección "Propiedad web" del documento Cuentas y vistas (perfiles).
Vuelve a agregar tus personalizaciones con la sintaxis asíncrona. Usa las personalizaciones que se describen en el resto de esta guía. Consulta la Guía de uso del seguimiento asíncrono para obtener información detallada sobre el código de seguimiento asíncrono.

Nota: Para garantizar el funcionamiento más optimizado del fragmento asíncrono con respecto a otras secuencias de comandos, te recomendamos que coloques otras secuencias de comandos en tu sitio de una de las siguientes maneras:

Antes del fragmento de código de seguimiento en la sección <head> de su HTML
Después del fragmento de código de seguimiento y de todo el contenido de la página (p.ej., al final del cuerpo HTML)

Aunque no sea posible, puedes colocar el fragmento asíncrono en la parte inferior de la página. También puedes dividir el fragmento para conservar algunos de los beneficios del seguimiento asíncrono.

Seguimiento básico de páginas

El seguimiento básico de páginas es el mejor lugar para familiarizarte con la sintaxis asíncrona. En estos ejemplos, se configura el objeto de seguimiento con la cuenta correcta y se llama al método de seguimiento de la página.

Fragmento asíncrono (recomendado)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();

Seguimiento de urchin.js

_uacct = "UA-XXXXX-X";
urchinTracker();

Volver al principio

Detección de la configuración del navegador

Estos ejemplos ilustran las personalizaciones de la configuración del navegador, como inhabilitar la detección de Flash, desactivar la detección del nombre o la versión del navegador, etc.

Fragmento asíncrono (recomendado)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setClientInfo', false]);
_gaq.push(['_setAllowHash', false]);
_gaq.push(['_setDetectFlash', false]);
_gaq.push(['_setDetectTitle', false]);
_gaq.push(['_trackPageview']);

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setClientInfo(false);
pageTracker._setAllowHash(false);
pageTracker._setDetectFlash(false);
pageTracker._setDetectTitle(false);
pageTracker._trackPageview();

Seguimiento de urchin.js

_uacct = "UA-XXXXX-X";
_ufsc = 0;    // track browser info
_uhash = "on"; // (on|off) unique domain hash for cookies
_uflash = 0;  // detect Flash version
_utitle = 0;  // track title in reports
urchinTracker();

Volver al principio

Duración de la campaña

De forma predeterminada, la duración de las campañas de Google Ads se establece en 6 meses. Puedes ajustar la duración de las campañas con el método _setCampaignCookieTimeout().

Fragmento asíncrono (recomendado)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampaignCookieTimeout', 31536000000]);
_gaq.push(['_trackPageview']);

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampaignCookieTimeout(31536000000);
pageTracker._trackPageview();

Seguimiento de urchin.js

_uacct = "UA-XXXXX-X";
_ucto = "31536000"; // the number of seconds in 1 year
urchinTracker();
</script>

Volver al principio

Campos de la campaña: personalizado

Google Analytics recopila tus datos de Google Ads automáticamente si vinculaste tu cuenta de Google Ads con la de Analytics. Para realizar un seguimiento de los vínculos de palabras clave de otras fuentes publicitarias, de campañas por correo electrónico o de fuentes similares, puedes crear campos de campañas personalizadas con los métodos que se indican a continuación. Para obtener más información, consulta "Seguimiento de campañas" en la guía de fuentes de tráfico.

Fragmento asíncrono (recomendado)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampNameKey', 'ga_campaign']);    // name
_gaq.push(['_setCampMediumKey', 'ga_medium']);    // medium
_gaq.push(['_setCampSourceKey', 'ga_source']);    // source
_gaq.push(['_setCampTermKey', 'ga_term']);        // term/keyword
_gaq.push(['_setCampContentKey', 'ga_content']);  // content
_gaq.push(['_setCampNOKey', 'ga_nooverride']);    // don't override
_gaq.push(['_trackPageview']);

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampNameKey('ga_campaign');       // name
pageTracker._setCampMediumKey('ga_medium');       // medium
pageTracker._setCampSourceKey('ga_source');       // source
pageTracker._setCampTermKey('ga_term');           // term/keyword
pageTracker._setCampContentKey('ga_content');     // content
pageTracker._setCampNOKey('ga_nooverride');       // don't override
pageTracker._trackPageview();

Seguimiento de urchin.js

_uacct = "UA-12345-1";
_uccn = "ga_campaign"; // name [default: utm_campaign]
_ucmd = "ga_medium"; // medium [default: utm_medium]
_ucsr = "ga_source"; // source [default: utm_source]
_uctr = "ga_term"; // term/keyword [default: utm_term]
_ucct = "ga_content"; // content [default: utm_content]
_ucid = "ga_id"; // id number [default: utm_id]
_ucno = "ga_nooverride"; // don't override [default: utm_nooverride]
urchinTracker();

Volver al principio

Seguimiento de la campaña: Inhabilitado

Google Analytics habilita el seguimiento de campañas automáticamente, pero puedes inhabilitarlo con el método _setCampaignTrack().

Fragmento asíncrono (recomendado)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampaignTrack', false]);    // Turn off campaign tracking
_gaq.push(['_trackPageview']);

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampaignTrack(false);       // Turn off campaign tracking
pageTracker._trackPageview();

Seguimiento de urchin.js

_uacct = "UA-12345-1";
_uctm = "disable";
urchinTracker();

Volver al principio

Vinculación multidominio

Para realizar un seguimiento del tráfico en varios dominios, puedes usar la función _setAllowLinker() para realizar un seguimiento de los clics de los usuarios entre dos dominios. Para obtener detalles sobre cómo configurar el seguimiento multidominio, consulta Seguimiento multidominio.

Fragmento asíncrono (recomendado)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setDomainName('none');
pageTracker._setAllowLinker(true);
pageTracker._trackPageview();
...
<a href="http://example.com/test.html"
onclick="pageTracker._link('http://example.com/test.html'); return false;">click me</a>

Seguimiento de urchin.js

_uacct = "UA-12345-1";
_udn = "none";
_ulink = 1;
urchinTracker();

...
<a href="http://newsite.com/test.html"
onclick="__utmLinker('http://newsite.com/test.html'); return false;">click me</a>

Volver al principio

Datos de formularios entre dominios

Puedes usar el método _linkByPost() para pasar datos del usuario de un dominio a otro en el que el seguimiento multidominio está habilitado para ambos dominios. Para obtener detalles sobre cómo configurar el seguimiento multidominio, consulta Seguimiento multidominio.

Fragmento asíncrono (recomendado)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<form name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setDomainName('none');
pageTracker._setAllowLinker(true);
pageTracker._trackPageview();
...
<form name="f" method="post" onsubmit="pageTracker._linkByPost(this);">
...
</form>

Seguimiento de urchin.js

_uacct = "UA-12345-1";
_udn = "none";
_ulink = 1;
urchinTracker();
...
<form name="f" method="post" onsubmit="__utmLinkPost(this)">
...
</form>

Volver al principio

Seguimiento de comercio electrónico

El seguimiento de comercio electrónico implica llamar a tres métodos clave en tu configuración de seguimiento. Consulta Seguimiento de comercio electrónico para obtener más información.

Fragmento asíncrono (recomendado)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
_gaq.push(['_addTrans',
  '1234',           // order ID - required
  'Mountain View',  // affiliation or store name
  '11.99',          // total - required
  '1.29',           // tax
  '5',              // shipping
  'San Jose',       // city
  'California',     // state or province
  'USA'             // country
]);
_gaq.push(['_addItem',
  '1234',           // order ID - required
  'DD44',           // SKU/code
  'T-Shirt',        // product name
  'Green Medium',   // category or variation
  '11.99',          // unit price - required
  '1'               // quantity - required
]);
_gaq.push(['_trackTrans']);

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();
pageTracker._addTrans(
  '1234',           // order ID - required
  'Mountain View',  // affiliation or store name
  '11.99',          // total - required
  '1.29',           // tax
  '5',              // shipping
  'San Jose',       // city
  'California',     // state or province
  'USA'             // country
);
pageTracker._addItem(
  '1234',           // order ID - required
  'DD44',           // SKU/code
  'T-Shirt',        // product name
  'Green Medium',   // category or variation
  '11.99',          // unit price - required
  '1'               // quantity - required
);
pageTracker._trackTrans();

Seguimiento de urchin.js

_uacct = "UA-12345-1";
urchinTracker();
</script>
<form name="utmform" id="utmform">
<textarea name="utmtrans" id="utmtrans" style="display:none">
UTM:T|1234|Mountain View|11.99|1.29|5|San Jose|California|USA
UTM:I|1234|DD44|T-Shirt|Green Medium|11.99|1
</textarea>
</form>
<script type="text/javascript">
__utmSetTrans();

Volver al principio

Seguimiento de eventos

El uso del seguimiento de eventos implica realizar una llamada a un evento en el lugar apropiado de tus páginas, como un controlador onclick. Para obtener más información sobre el seguimiento de eventos, consulta la Guía para el seguimiento de eventos. Nota: El seguimiento de eventos no está disponible con el código de seguimiento urchin.js.

Fragmento asíncrono (recomendado)

En esta sección, se muestran dos maneras de configurar el seguimiento con la sintaxis asíncrona. Con el seguimiento de eventos, el controlador onclick usa exactamente la misma sintaxis.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
...
<a onclick="_gaq.push(['_trackEvent', 'category', 'action', 'opt_label', opt_value]);">click me</a>

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();
...
<a onclick="pageTracker._trackEvent('category', 'action', 'opt_label', opt_value);">click me</a>

Volver al principio

Tiempo de espera de la sesión

De forma predeterminada, el tiempo de espera de las sesiones de usuario se agota después de 30 minutos de inactividad en tu sitio. En estos ejemplos, se muestra cómo se puede modificar con el método _setSessionCookieTimeout().

Fragmento asíncrono (recomendado)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setSessionCookieTimeout', 3600000]);
_gaq.push(['_trackPageview']);

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setSessionCookieTimeout(3600000);
pageTracker._trackPageview();

Seguimiento de urchin.js

<script type="text/javascript">
_uacct = "UA-12345-1";
_utimeout = "3600"; // the number of seconds in 1 hour
urchinTracker();
</script>

Volver al principio

Fuentes: motores de búsqueda, palabras clave, URL de referencia

De forma predeterminada, Google Analytics identifica una lista de sitios web como referencias de motores de búsqueda en tus informes. Puedes usar estos métodos para modificar la lista de motores de búsqueda. Para obtener más información, consulta "Motores de búsqueda" en la guía Fuentes de tráfico. También puedes configurar Google Analytics para que ignore las referencias de ciertos dominios o para que trate búsquedas de palabras clave específicas como tráfico directo.

Fragmento asíncrono (recomendado)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_addIgnoredOrganic', 'ignore']);
_gaq.push(['_addIgnoredRef', 'urchin.com']);
_gaq.push(['_addOrganic', 'new_search_engine', 'q']);
_gaq.push(['_trackPageview']);

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._addIgnoredOrganic('ignore');
pageTracker._addIgnoredRef('urchin.com');
pageTracker._addOrganic('new_search_engine','q');
pageTracker._trackPageview();

Seguimiento de urchin.js

_uacct = "UA-12345-1";
_uOno[0] = "ignore"; // keyword to treat as referral
_uRno[0] = "urchin.com"; // referral to treat as direct
_uOsr[41] = "new_search_engine"; // new search engine to treat as referral
_uOkw[41] = "query"; // keyword query parameter for new search engine

urchinTracker();

Volver al principio

Seguimiento limitado a un subdirectorio

Utiliza el método _setCookiePath() para establecer un subdirectorio como la ruta de acceso predeterminada para todo el seguimiento. Debes hacer esto para limitar todo el seguimiento a un subdirectorio de un sitio.

Fragmento asíncrono (recomendado)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCookiePath', '/path/of/cookie/']);
_gaq.push(['_trackPageview']);

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCookiePath('/path/of/cookie/');
pageTracker._trackPageview();

Seguimiento de urchin.js

<script type="text/javascript">
_uacct = "UA-12345-1";
_utcp = "/path/of/cookie/";
urchinTracker();
</script>

Volver al principio

Usa un servidor local

Utiliza estos métodos si realizas el seguimiento de tu sitio web con el software independiente Urchin y también con Google Analytics. Para obtener información detallada, consulta la sección Servidor de Urchin de la referencia de la API de seguimiento.

Fragmento asíncrono

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setLocalRemoteServerMode']);
_gaq.push(['_trackPageview']);

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setLocalRemoteServerMode();
pageTracker._trackPageview();

Seguimiento de urchin.js

_uacct = "UA-12345-1";
_userv = 0;
urchinTracker();

Volver al principio

Vistas de página virtuales

Usa el método _trackPageview() junto con una URL que crees para realizar un seguimiento de los clics de los usuarios que no dirigen a páginas reales de tu sitio web. En general, te recomendamos que uses el seguimiento de eventos para hacer un seguimiento de las descargas, los vínculos de salida, los PDF o tipos similares de interacciones del usuario. Esto se debe a que las vistas de página virtuales se agregarán a tu recuento total de vistas de página.

Fragmento asíncrono

_gaq.push(['_trackPageview', '/downloads/pdfs/corporateBrief.pdf']);

Fragmento tradicional (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview('/downloads/pdfs/corporateBrief.pdf');

Seguimiento de urchin.js

urchinTracker('/downloads/pdfs/corporateBrief.pdf');

Volver al principio