Cómo añadir un dominio personalizado al contenedor del servidor de Google Tag Manager
En este artículo, describiré cómo configurar un dominio personalizado dentro del contenedor del servidor de Google Tag Manager. La principal ventaja de utilizar un dominio personalizado para sGTM es que ayuda a aumentar la vida útil de las cookies al establecer cookies de origen en lugar de cookies de terceros.
Ventajas de asignar un dominio personalizado dentro de sGTM
La principal ventaja del etiquetado en el servidor reside en el establecimiento de cookies de origen, aunque no está activado por defecto. Para aprovechar esta capacidad, es necesario implementar un dominio personalizado en su GTM del lado del servidor.
Dado que Chrome es el último navegador que admite cookies de terceros y empezará a eliminar gradualmente las cookies de terceros en 2024, ahora es el momento de empezar a utilizar cookies de origen en lugar de las de terceros.
⚠️ UPDATE: Google ha anunciado que no seguirá adelante con sus planes de eliminar las cookies de terceros. En su lugar, la empresa introducirá una nueva solución: una única solicitud que permitirá a los usuarios establecer sus preferencias, que se aplicarán en todas las experiencias de navegación de Google.
La estabilidad y longevidad de las cookies establecidas por sGTM dependen de cómo se implemente un dominio personalizado. Hay tres tipos de configuraciones de dominio personalizado dentro de sGTM.
Puede utilizar una URL de servidor de etiquetado personalizada para configurar cookies de origen. La URL del servidor de etiquetado personalizado o dominio personalizado debe compartir el mismo dominio que su sitio web. Por ejemplo, si el dominio de su sitio web es ejemplo.com, la URL del servidor de etiquetado debe ser ss.ejemplo.com.
Hay tres formas de configurar un dominio personalizado:
- Mismo origen
- Subdominio
- Dominio por defecto
| Características | El mismo origen | Subdominio | Default dominio |
| Ejemplo URL | example.com/sgtm | sgtm.example.com | wjzsdfvom.us.stape.io |
| Estabilidad de las cookies | Ofrece toda la ventaja de prolongar la vida útil de las cookies sin necesidad de configuración adicional. | Ofrece la posibilidad de establecer cookies de origen, aunque para aumentar la vida útil de las cookies en Safari y otros navegadores con ITP, es necesario configurar CDN o utilizar Cookie Keeper. | Sólo puede establecer cookies de Javascript. |
| Complejidad | Complicado. Configure una CDN o un equilibrador de carga para reenviar las solicitudes. Puede ser necesario actualizar las entradas DNS. | Fácil. Actualice las entradas DNS. | Está preconfigurado para usted cuando configura la cuenta de stape.io. |
Cómo añadir un dominio personalizado dentro del contenedor del servidor de Google Tag Manager
En primer lugar, debe crear y configurar el contenedor de servidor de Google Tag Manager. Si no dispone de un contenedor de servidor, siga estas instrucciones.
Mostraremos dos formas de mapear un dominio personalizado para el contenedor de tags del servidor de Google Tag Manager:
- Utilizando un subdominio.
- Utilizando el mismo origen.
UUtilizando el subdominio
Paso 1. Añadir su dominio personalizado
Elija su contenedor en Stape, desplácese hacia abajo y haga clic en Add custom domain.
Añada el Subdomain name: puede ser cualquier nombre que prefiera, pero asegúrese de evitar frases relacionadas con publicidad o seguimiento: ad, gtm, stgm, tracking, analytics, metrics, stape, gtag, etc.
Paso 2. Añadir CDN
Una Content Delivery Network (CDN) distribuye los recursos de su sitio web a través de una red global de servidores para reducir la latencia y mejorar los tiempos de carga para usuarios en diferentes ubicaciones. Es útil si su audiencia está distribuida geográficamente o si desea mejorar el seguimiento de cookies y la precisión de los datos.
De forma predeterminada, la CDN está deshabilitada, lo que significa que los archivos JavaScript (como gtm.js, gtag.js y analytics.js) se sirven directamente desde el servidor donde está alojado su contenedor sGTM. En la práctica, esto omite tanto Stape Global CDN como Own CDN y establece una conexión directa y sin proxy entre su sitio y el contenedor sGTM.
| Importante: tenga en cuenta la normativa de privacidad de su país antes de configurar una CDN. |
Para habilitar la CDN, haga clic en el botón Add CDN y seleccione una de las siguientes opciones:
- Stape Global CDN: carga los scripts desde el servidor más cercano a la ubicación del visitante de su sitio web, lo que reduce la latencia y mejora los tiempos de carga para audiencias distribuidas geográficamente. Utilizaremos Stape Global CDN en nuestra configuración. Esta función es gratuita y está disponible para todos los contenedores sGTM de Stape.
- Own CDN (incompatible con la opción de conexión Automatically (via Entri)): ayuda a enrutar el dominio personalizado de sGTM y a hacer proxy del tráfico de sGTM a través del proveedor DNS de su sitio web. En este caso, las direcciones IP de su sitio web y del dominio personalizado de sGTM coincidirán, y las cookies del lado del servidor se considerarán de origen propio. Como resultado, permite aumentar la duración de las cookies.
Paso 3. Seleccionar el método de conexión
A continuación, en la sección How to connect, hay dos formas de conectar un dominio personalizado a su contenedor:
- Automatically (via Entri)
La forma más sencilla de conectar dominios. Inicie sesión con los datos de su proveedor DNS a través de Entri y otórguenos permiso puntual para conectar su dominio. Con esto, puede proceder directamente al Paso 5 para verificar su dominio; no se requiere configuración manual.
- Manually
Con esta opción, debe añadir los registros DNS manualmente en su proveedor de alojamiento para conectar su subdominio a Stape.
Una vez que añada un subdominio personalizado a su contenedor, verá los registros DNS que deben crearse para verificar el dominio personalizado. El registro DNS depende de la ubicación del servidor y de la opción de CDN que elija. En el siguiente paso, se explica cómo añadir registros DNS.
Paso 4. Añadir registros DNS (para el método de conexión manual)
De forma predeterminada, la verificación del subdominio se realiza con registros CNAME, pero también puede verificar su subdominio con registros A y AAAA si lo necesita (generalmente cuando necesita evitar la creación de registros duplicados).
A continuación, cubrimos ambas opciones con una guía paso a paso sobre cómo crear registros usando Cloudflare. Puede utilizar cualquier otro proveedor.
Añadir un dominio personalizado con un registro CNAME
Debe crear un registro CNAME si no usa Stape Global CDN, y dos registros si la usa.
1. Inicie sesión en su servicio de nombres de dominio y cree un nuevo registro DNS para el subdominio que desea utilizar. Para ello, haga clic en los tres puntos y seleccione Configure DNS junto al nombre de su dominio en la página de inicio de la cuenta.
2. Haga clic en Add record.
3. Vuelva a su cuenta de Stape e introduzca el registro que aparece en la cuenta. Asegúrese de que el estado de proxy (Proxy status) esté desactivado (off).
Usamos Stape Global CDN, por lo que creamos dos registros CNAME:
Añadir un subdominio personalizado con registros A y AAAA
| Tenga en cuenta que los registros A/AAAA son incompatibles con la CDN habilitada. |
1. Si necesita verificar su subdominio personalizado mediante registros A y AAAA, añada el subdominio personalizado al contenedor y asegúrese de que el botón CDN esté desactivado.
Haga clic en Advanced settings y marque la casilla Use A records instead of CNAME records. Verá los registros DNS que debe añadir dentro de su contenedor de Stape. Los registros DNS que debe configurar varían según la ubicación del servidor.
2. Inicie sesión en su cuenta DNS y añada los registros que aparecen en su cuenta de Stape. En la página de inicio de la cuenta, junto al nombre de su dominio, haga clic en los tres puntos y seleccione Configure DNS.
3. Haga clic en Add record.
4. A continuación, cree los registros que aparecen en su cuenta de Stape. Asegúrese de que el estado de proxy (Proxy status) esté desactivado (off).
Tome los valores para sus registros DNS de la cuenta de Stape:
Como resultado, obtendrá dos registros DNS:
Paso 5. Verificar su dominio
Una vez que haya añadido los registros DNS en su proveedor de DNS, vuelva a la página del contenedor de Stape donde configuró el dominio personalizado y haga clic en Verify.
![[Botón "Verify"]](/_next/image?url=https%3A%2F%2Fcdn.stape.io%2Fi%2F69fb59b6249dd138292882.png&w=3840&q=75)
Espere a que Stape termine de verificar su dominio personalizado (cuando la barra de estado del contenedor cambie de Verifying a Ready). Normalmente, la verificación del dominio personalizado tarda entre 2 y 3 horas. Para algunos proveedores de DNS, la verificación de los registros puede tardar hasta 72 horas. Le enviaremos un correo electrónico una vez que el dominio personalizado sea verificado o si se detecta algún error.
Si tiene algún problema con la verificación del dominio, siga nuestra guía de resolución de problemas de dominios personalizados.
Paso 6. Añadir la URL del servidor de etiquetado y actualizar el script de su sitio web
Vaya a su contenedor de servidor de Google Tag Manager → Admin → Container Settings → cambie Tagging server URL a su subdominio.
Actualizar el script
Si utiliza un dominio personalizado, se recomienda encarecidamente actualizar el script de Web GTM en su sitio web. Este ajuste cargará gtm.js desde su dominio. Para ello, reemplace el dominio predeterminado googletagmanager.com con el dominio personalizado que configuró en el paso anterior.
Alternativamente, puede automatizar este proceso con el Custom Loader power-up. En lugar de editar manualmente el script de GTM, Custom Loader genera un fragmento de código listo para usar que carga los scripts de GTM y GA4 directamente desde su dominio personalizado. Esto le ahorra tiempo, hace que sus scripts de seguimiento sean más resistentes a los bloqueadores de anuncios y garantiza que todas las cookies se traten como de origen propio.
Utilizando el mismo origen
Requisitos previos
Antes de comenzar, asegúrate de tener lo siguiente:
- Un CDN o balanceador de carga capaz de reenviar solicitudes, a través del cual se enruta todo el tráfico de tu sitio.
- Si usas App Engine, el servidor de etiquetado debe ejecutar la versión 2.2.0 o posterior.
Nota:
Configuración del dominio de mismo origen paso a paso
Según tu infraestructura, puedes configurar el dominio personalizado de mismo origen utilizando diferentes plataformas y servicios. Aquí encontrarás las guías para cada uno:
Nota:
A continuación, explicaremos el proceso de configuración usando Cloudflare como ejemplo.
Para que esta opción funcione, todo el tráfico de tu sitio debe pasar por un proxy de Cloudflare: la funcionalidad de Cloudflare Workers te permitirá entonces hacer proxy de las solicitudes de sGTM también. También debes usar SSL/TLS en modo Full; de lo contrario, el proxy de mismo origen puede funcionar a través de una redirección 301, lo cual no es correcto.
Paso 1. Crear un Cloudflare Worker
En la barra lateral izquierda, haz clic en Compute → Workers & Pages → haz clic en Create application → selecciona la opción Start with Hello World!.
Paso 2. Nombrar e implementar el worker
Agrega un nombre para el worker → haz clic en Deploy.
Paso 3. Editar el código del worker
Decide el path para tu dominio personalizado de sGTM – por ejemplo, example.com/sgtm, example.com/data, or example.com/metrics.
En la configuración del worker, haz clic en Edit code y pega un JS similar al ejemplo siguiente, donde:
/metrics/es el path que elegiste para tu contenedor de servidor.https://sst.stapedesk.com/es la URL de tu servidor de etiquetado.
Para la URL del servidor de etiquetado, tienes dos opciones:
- [No recomendado] La URL predeterminada del servidor de etiquetado proporcionada por Stape (p. ej.,
https://wapdsrl.ca.stape.io). - [Recomendado] El subdominio personalizado que configuraste en el Stape admin. Usar un subdominio personalizado ofrece dos ventajas: carga
gtm.jsygtag.jsdesde un path personalizado a través del Custom Loader power-up, haciendo que los scripts de seguimiento no puedan ser bloqueados, y habilita cookies de primera parte de larga duración.
Si usas un subdominio personalizado como URL del servidor de etiquetado de mismo origen, asegúrate de haber agregado un dominio personalizado a tu contenedor de sGTM en Stape y de haber creado los registros DNS necesarios. No uses Own CDN con el dominio de mismo origen.
export default {
async fetch(request, env, ctx) {
let { pathname, search, host } = new URL(request.url);
pathname = pathname.replace('/metrics/', '/');
const domain = 'sst.stapedesk.com';
let newRequest = new Request((`https://` + domain + pathname + search), request);
newRequest.headers.set('Host', domain);
return fetch(newRequest);
},
};
Implementa y guarda los cambios.
Paso 4. Agregar una ruta al worker
Ve a tu worker de sGTM → haz clic en Settings → Domains & Routes → crea una nueva Ruta. Agrega la URL que usas para el GTM de servidor que termine con * (en nuestro ejemplo, es stapedesk.com/metrics*) y selecciona tu dominio en la selección de zona.
Paso 5. Crear una regla de configuración
Junto al nombre de tu dominio, haz clic en los tres puntos → Configure Rules.
Haz clic en Create rule → Configuration Rules:
- Especifica un nombre de regla comprensible, p. ej., sGTM mismo origen.
- Selecciona Custom filter expression.
- La ruta URI comienza con
/metrics(actualiza esto si usas un path diferente). - SSL → selecciona la opción Full.
Haz clic en Deploy.
Paso 6. Crear una regla de transformación de encabezado de solicitud
Ve a Rules → Overview → Create Rule → Request Header Transform Rule:
- Ingresa un nombre descriptivo para la regla, p. ej., Encabezado sGTM.
- Selecciona Custom filter expression.
- La ruta URI comienza con
/metrics(actualiza esto si usas un path diferente). - Define un nombre de encabezado estático
X-From-Cdncon el valorcf-stape.
Guarda la regla.
Si no usas tu propio subdominio y estás haciendo proxy de solicitudes al subdominio estándar de Stape, también debes agregar el X-Stape-Host header.
Ve a Rules → Overview → Create Rule → Request Header Transform Rule:
- Ingresa un nombre descriptivo para la regla, p. ej., sGTM mismo origen Stape host.
- Selecciona Custom filter expression.
- La ruta URI comienza con
/metrics(actualiza esto si usas un path diferente). - Define un nombre de encabezado estático
X-Stape-Hostcon el valor del host donde se producen los eventos (en nuestro ejemplo, es stape.work).
Guarda la regla.
Paso 7. Actualizar el Custom Loader
Una vez completada la configuración de mismo origen, también recomendamos actualizar el power-up Custom Loader para protección contra bloqueadores de anuncios e implementarlo en tu sitio. No olvides especificar tu path de Same Origin en él.
Para más información, consulta nuestra guía sobre Custom Loader.
Paso 8. Agregar la URL del contenedor de servidor en el GTM web y de servidor
1. En tu contenedor web de GTM, agrega Google Tag y especifica tu ID de medición (cualquier ID sirve para pruebas). Configura el server_container_url con el path de mismo origen que configuraste (en nuestro ejemplo, es https://stapedesk.com/metrics.
2. Para agilizar las pruebas, haz clic en Admin → Container Settings → ingresa el path en Server container URLs.
3. Para las pruebas del dominio de mismo origen (como mostramos en el paso siguiente), también deberás configurar el Client (que transmitirá datos del contenedor web al de servidor) y la etiqueta Google Analytics: GA4 en el server GTM.
Como Client, usaremos GA4.
Para agregar el Client de GA4 en el GTM de servidor, abre la sección de clients → Create New client → Selecciona el tipo de client Google Analytics: GA4 (Web) → Agrega el nombre del client y haz clic en Save.
Para configurar la etiqueta de GA4, agrega una nueva etiqueta con la configuración de etiqueta “Google Analytics: GA4”, y simplemente especifica tu ID de medición en la etiqueta.
Y agrega el trigger para la etiqueta. Debe activarse cuando el nombre del client recibe las solicitudes (en nuestro caso, el Client es GA4):
Prueba de tu configuración de Same Origin
Haz clic en Preview en ambos contenedores de GTM, web y de servidor.
Si todo está configurado correctamente, el contenedor de servidor debería abrirse en la vista previa en el nuevo path que creaste. Si, por alguna razón, la vista previa no se abre en el nuevo path, puedes ingresarlo manualmente en la URL de la ventana de vista previa.
- En DNS Records, asegúrate de que las solicitudes a tu dominio principal pasen por un proxy de Cloudflare.
- En SSL/TLS, verifica que el modo de cifrado esté configurado en Full. Si no lo está, haz clic en Configure, selecciona Full, y haz clic en Save. Este cambio puede tardar hasta 24 horas, así que dale tiempo suficiente para que se actualice.
Visita tu sitio web. En la vista previa del contenedor server, ahora deberías ver una entrante page_view solicitud proveniente del dominio real de tu sitio web.
Conclusión
La adición de un dominio personalizado a un contenedor de servidor de Google Tag Manager (GTM) puede influir significativamente en la eficacia y la flexibilidad del seguimiento del lado del servidor. En este artículo, hemos proporcionado dos métodos de implementación de dominios personalizados.
Un enfoque de mismo origen ofrece mayor seguridad y una gestión de cookies más sencilla, ideal para dominios singulares y específicos. Una configuración de subdominio proporciona flexibilidad y optimización del rendimiento, adecuada para estructuras de dominio complejas o múltiples. Cada una tiene sus ventajas y desventajas en cuanto a complejidad, rendimiento y gestión. Considere cuidadosamente sus requisitos técnicos, necesidades de seguridad y objetivos de seguimiento para seleccionar la configuración más apropiada para su seguimiento del lado del servidor.
Si tiene alguna pregunta, visite nuestro servicio de asistencia o escriba un ticket. Nuestro equipo de expertos estará encantado de ayudarle con cualquier pregunta relacionada con el alojamiento y el seguimiento del servidor de Stape.
Comentarios