Acerca del fragmento gtag.js y los ID de propiedad
Los fragmentos gtag.js de una propiedad Universal Analytics y de una propiedad Google Analytics 4 son fundamentalmente los mismos. Ambos fragmentos tienen la siguiente estructura:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<Some Property ID A>');
08:
09: gtag('config', '<Some Property ID B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Some Property ID B>' });
14:
15: </script>
Línea 1: Si ya implementó una propiedad Universal Analytics a través de gtag.js, es probable que ya tenga esta línea de código en su sitio. En lugar de <Some Property ID A>, verá "UA-" seguido de una serie de números. Si ya implementó el fragmento gtag.js para Google Ads o algún otro producto de Google Marketing Platform, también puede tener esta línea de código en su sitio web, pero <Some Property ID A> comenzará con "AW-" o "DC-".
El ID de propiedad (o ID de etiqueta, para las propiedades Google Analytics 4) indicado por <Some Property ID A> "controla" este fragmento gtag.js. A continuación, le explicamos por qué es importante:
- Si esta línea ya está presente, no es necesario que se implemente por segunda vez. Solo deberá agregar una línea "config" para especificar el ID de la etiqueta.
- El ID de propiedad de esta línea es el "controlador" del fragmento gtag.js. Si un ID de propiedad Universal Analytics ("UA-XXXXXXXX") controla la etiqueta, podrá usar las etiquetas conectadas del sitio para enviar datos de medición a una propiedad Google Analytics 4, sin necesidad de agregar ningún código nuevo a la página.
Línea 7: La directiva "config" de gtag habilita la recopilación de datos para la propiedad asociada con <Some Property ID A>. Por ejemplo, en una propiedad Google Analytics 4, agregar esta directiva con un ID de etiqueta enviará eventos page_view a esa propiedad.
El ID de propiedad puede representar la medición para diferentes productos de Google, lo que incluye una propiedad Universal Analytics ("UA-XXXXXXXX"), una propiedad Google Analytics 4 ("G-XXXXXXXX"), Google Ads ("AW-XXXXXXXX") o Floodlight ("DC -XXXXXXXX").
Línea 11: La directiva "event" de gtag enviará un evento. En los fragmentos donde hay varias directivas "config" presentes para varias propiedades, el evento se enviará a todas las propiedades.
En este ejemplo, el parámetro "sign_up" es el nombre del evento. El último parámetro es un objeto que contiene un conjunto de parámetros de eventos. En este caso, "method" es un parámetro con un valor de "email".
Línea 13: El evento aquí tiene "send_to" como parámetro. Este es un parámetro especial que envía el evento asociado a una propiedad específica. En otras palabras, este evento solo se enviará a la propiedad indicada por <ID de propiedad B>.
El comando config de gtag habilita la medición básica.
- Para una propiedad Universal Analytics, la directiva "config" con un ID de propiedad Universal Analytics envía un hit de página vista.
- En el caso de una propiedad Google Analytics 4, la directiva "config" con un ID de etiqueta habilita la recopilación de eventos page_view (como un evento recopilado automáticamente) cuando se carga en una página.
Identificadores de propiedades
Los ID de propiedad Universal Analytics tienen el formato "UA-XXXXXXXX". En algunas ocasiones, se denomina ID de seguimiento. En esta guía, lo llamaremos ID de propiedad UA.
Los flujos de datos web de la propiedad Google Analytics 4 usan un ID de etiqueta con el formato "G-XXXXXXXX".
En algunos ejemplos de código y documentos, es posible que a ambos se los denomine "TAG_ID".
Recopilación de datos básicos
Si habilita la recopilación de datos básicos para una propiedad Google Analytics 4, podrá recopilar lo siguiente:
- eventos page_view
- eventos recopilados automáticamente
- eventos de medición mejorada (si están habilitados en la IU)
Si su propiedad Universal Analytics existente usa una implementación de gtag.js, debe habilitar la recopilación de datos básicos para su propiedad Google Analytics 4 de la siguiente manera:
- Opción 1: Agregar una nueva directiva "config" con el ID de etiqueta correspondiente
O - Opción 2: Activar las etiquetas conectadas del sitio (si su actual implementación de gtag.js es apta)
Independientemente de la opción que elija, su propiedad Universal Analytics existente no se verá afectada y seguirá recopilando datos.
Opción 1: Agregue una nueva directiva "config"
Si en la página hay un código gtag.js existente, simplemente agregue una directiva "config" adicional con el ID de medición de la propiedad Google Analytics 4 correspondiente. En el siguiente ejemplo, se agregó la línea 8 a una implementación de gtag.js existente, que hace referencia al ID de medición de la propiedad Google Analytics 4. Esto enviará eventos de page_view a esa propiedad Google Analytics 4. También habilita los eventos recopilados automáticamente y los eventos de medición mejorada (si habilitó la medición mejorada) en esa propiedad Google Analytics 4.1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
2: <script>
3: window.dataLayer = window.dataLayer || [];
4: function gtag(){dataLayer.push(arguments);}
5: gtag('js', new Date());
6:
7: gtag('config', '<Some Property ID A>');
8: gtag('config', 'G-XXXXXXXX');
9: </script>
Opción 2: Active las etiquetas conectadas del sitio
Puede utilizar una etiqueta conectada del sitio en estos casos:
- El fragmento gtag.js existente en la página donde quiere medir las interacciones del usuario está "controlado" por una propiedad Universal Analytics (es decir, el ID al que se hace referencia en esta línea del fragmento gtag.js comienza con "UA-"):
<script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
(Las etiquetas conectadas del sitio también funcionarán si el fragmento gtag.js existente está controlado por una propiedad Google Analytics 4. Sin embargo, solo encontrará esta situación si ya se implementó una propiedad Google Analytics 4).
- Y tiene acceso de administrador a la propiedad Universal Analytics a la que hace referencia el ID del fragmento.
Parámetros de configuración de gtag.js
Puede configurar el fragmento gtag.js básico para controlar los parámetros de configuración de recopilación de datos, como la anonimización de IP, las personalizaciones de cookies y los indicadores de Google. Para ello, use las directivas "config" o "set" en gtag.js.
Las propiedades Universal Analytics ("UA-XXXXXXXX") y Google Analytics 4 ("G-XXXXXXXX") admiten la implementación de estos parámetros de configuración "config" mediante gtag.js. Sin embargo, existen algunas diferencias entre estos parámetros de configuración para las propiedades Universal Analytics y Google Analytics 4.
- La anonimización de IP establece "true" como valor estándar y no se puede configurar en una propiedad Google Analytics 4. Como tal, la dirección IP se enmascara automáticamente con el evento estándar a la propiedad Google Analytics 4 ("G-XXXXXXXX").
- Cuando se debe aplicar la configuración global a todas las propiedades configuradas, se debe usar el comando "set" a fin de aplicarla a todos los ID de medición o de propiedad, incluidos los implementados a través de las etiquetas conectadas del sitio.
- Preste especial atención a las funciones de inhabilitación de la personalización de anuncios, que suelen implementarse con una línea "config".
- Cuando se usan las etiquetas conectadas del sitio: Cualquier configuración realizada en el código gtag.js mediante "config" se aplica solo a la propiedad asociada con el ID de medición en esa línea de código; no se enviarán automáticamente a la propiedad Google Analytics 4 conectada. Si desea que la configuración se aplique a la propiedad Google Analytics 4 conectada, haga lo siguiente:
- Cree una directiva "config" separada y aplíquela a la propiedad Google Analytics 4 correspondiente haciendo referencia al ID de medición.
O - Establezca el parámetro de configuración con una directiva "set", en cuyo caso la configuración se aplicará a todas las propiedades configuradas.
- Cree una directiva "config" separada y aplíquela a la propiedad Google Analytics 4 correspondiente haciendo referencia al ID de medición.
Ejemplos de configuración
Cómo habilitar la recopilación de datos básicos y configurar el User-ID
gtag('config', 'GA_MEASUREMENT_ID', {
'user_id': 'USER_ID'
});
Cómo establecer la configuración de cookies
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 días, en segundos
});
Cómo bloquear un evento page_view
Si no necesita que se envíe un evento page_view al cargar el código "config" (por ejemplo, si se está cargando un iframe), puede ajustar el parámetro de configuración "config" para bloquear dicho evento. Considere una situación en la que se envía un evento page_view y, luego, un usuario accede al sitio. Para la interacción de acceso, usa una directiva "config" a fin de establecer el ID del usuario, pero no desea enviar otro evento page_view. En el siguiente código, se ilustra cómo evitar que se envíe el evento page_view.
gtag('config', 'MEASUREMENT_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Eventos
Consulte la guía de migración de eventos.
Dimensiones y métricas personalizadas
Las dimensiones y métricas personalizadas se pueden usar para ampliar la información y para importar datos sin conexión, p. ej., desde sistemas de CRM.
Cuando utiliza la etiqueta de Google (gtag.js), las mediciones de las dimensiones y métricas personalizadas se traducen automáticamente a parámetros si se usan etiquetas conectadas del sitio o una propiedad Google Analytics 4 (p. ej., “G-XXXXXXXX”).
Obtenga más información sobre dimensiones y métricas personalizadas.