Cómo configurar la puerta de enlace de la etiqueta de Google para anunciantes

Este documento está dirigido a los usuarios que desean implementar la puerta de enlace de etiquetas de Google para anunciantes. Recomendamos la puerta de enlace de etiquetas de Google para anunciantes para obtener la configuración de etiquetas más duradera.

Descripción general

La puerta de enlace de etiquetas de Google para anunciantes te permite implementar una etiqueta de Google con tu propia infraestructura de origen, alojada en el dominio de tu sitio web. Esta infraestructura se encuentra entre tu sitio web y los servicios de Google. La configuración que se describe en esta documentación te ayudará a medir mejor tu sitio web. Puedes configurarlo con tu red de distribución de contenido (CDN), balanceador de cargas o servidor web existentes.

En las configuraciones estándar de la etiqueta de Google, tu página web solicita una etiqueta de Google desde un dominio de Google. Cuando se activa la etiqueta, se envían solicitudes de medición directamente al producto de Google. Con la puerta de enlace de etiquetas de Google para anunciantes, tu sitio web carga la etiqueta de Google desde tu dominio de origen. Cuando se activa la etiqueta, se enviarán algunas solicitudes de medición a Google a través de tu dominio propio.

En este diagrama, se representa el flujo de información en la puerta de enlace de etiquetas de Google para anunciantes:

Antes de comenzar

En esta guía, se supone que tu sitio web ya está configurado con lo siguiente:

• Una etiqueta de Google o un contenedor de Tag Manager.
• Una red de distribución de contenidos (CDN) o un balanceador de cargas que pueda reenviar solicitudes a extremos externos.

Para comenzar, elige el tipo de configuración.

Configuración manual Configuración automatizada con Cloudflare

1. Elige las rutas de medición

Debes reservar una ruta de medición única en el dominio de tu sitio web para publicar cada etiqueta o contenedor de Google Tag Manager.

Requisitos de la ruta de medición:

• Las rutas no deben estar en uso en tu dominio.
• Cada ruta no debe ser la ruta raíz /.
• Cada ruta no debe superar los 100 caracteres.

Google Tag Manager:

Si utilizas Google Tag Manager, solo debes proporcionar tu ID de contenedor (p.ej., GTM-XXXXXX). Esta única configuración es suficiente para todas las etiquetas (como Google Analytics, Google Ads, etcétera) que ya se agregaron a ese contenedor.

Para cada contenedor único o etiqueta independiente, necesitarás una ruta de publicación única y su ID correspondiente.

Para configurar la puerta de enlace de etiquetas de Google para anunciantes, elige cualquier ruta que aún no se use en tu sitio. Para reducir la probabilidad de que entre en conflicto con una ruta de acceso que ya se encuentra en el sitio, puedes elegir cualquier combinación de letras y números o, si quieres una ruta de acceso más legible, puedes usar una palabra como /gtm, /metrics, /analytics o cualquier otra palabra que desees.

Por ejemplo:

Caso de uso	ID	Ruta de acceso de publicación de la etiqueta	Extremo de origen
Etiqueta independiente 1	G-12345	/abjfo/	g-12345.fps.goog/abjfo/
Etiqueta independiente 2	G-67890	/fjdso/	g-67890.fps.goog/fjdso/
Contenedor de GTM	GTM-ABCDEF	/cvfjk/	gtm-abcdef.fps.goog/cvfjk/

Completa la siguiente información para propagar los ejemplos en todo este documento.

Your domain: example.com
Google tag ID: G-12345
Tag serving path: /metrics

Precaución: Esta configuración redirecciona todo el tráfico con la ruta elegida. Para evitar que se vea afectado tu sitio web, elige una ruta que aún no se esté usando.

Cómo controlar varias etiquetas o contenedores:

Si tus etiquetas están en el mismo contenedor de GTM, no es necesario que repitas esta configuración. Solo tienes que agregar el único contenedor de Google Tag Manager, y se controlarán todas las etiquetas que contenga.

Si tus etiquetas están en contenedores de GTM separados O no están vinculadas, haz lo siguiente: Debes repetir esta configuración para cada instancia. Esto se aplica si ejecutas lo siguiente:

• Varios contenedores independientes de Google Tag Manager
• Etiquetas individuales (p.ej., G-XXXXXX) que no están dentro de un contenedor.

Cuando lo hagas, debes asignar una ruta de acceso de publicación de etiquetas única a cada contenedor o etiqueta.

2. Enruta el tráfico

En esta sección, se supone que tu sitio web ya usa una CDN o un balanceador de cargas que admite el enrutamiento del tráfico por rutas.

Google Cloud

Debes configurar un nuevo backend que busque la ubicación geográfica aproximada del visitante del sitio y crear reglas de enrutamiento en tu balanceador de cargas de aplicaciones externo existente.

Crea el backend nuevo

1. Abrir el balanceador de cargas de GCP

2. En tu balanceador de cargas, abre la sección Configuración de backend. Crea un servicio de backend nuevo.

3. Configura tu nuevo servicio de backend con información de ubicación geográfica:

   • Especifica un nombre, como measurement-be-svc.
   • Configura Tipo de backend como Grupo de extremos de red de Internet.
   • Establece Protocolo en HTTPS y deja Tiempo de espera con el valor predeterminado.
   • En Backends, haz clic en el menú desplegable Internet network endpoint group y crea un nuevo grupo de extremos de red de Internet:
     • Establece Tipo de grupo de extremos de red en NEG de Internet (global, regional).
     • Establece Alcance en Global.
     • Establece Agregar a través de en Nombre y puerto de dominio completamente calificados.
     • Establece Nombre de dominio completamente calificado en G-12345.fps.goog.
     • Haz clic en CREAR para crear el extremo.
     • Cierra la pestaña Grupo de extremos de red para volver a la pestaña Nuevo servicio de backend.
   • Busca el nombre del nuevo grupo de extremos de red y selecciónalo.
   • Abre la sección Configuración avanzada. Agrega los siguientes encabezados de solicitud personalizados.

     Nombre del encabezado	Valor del encabezado
     Host	G-12345.fps.goog
     X-Forwarded-Country	{client_region}
     X-Forwarded-Region	{client_region_subdivision}

   • Revisa los demás parámetros de configuración. Ni Cloud CDN ni Cloud Armor son necesarios para esta integración, por lo que puedes inhabilitarlos de forma segura.
   • Guarda el servicio de backend nuevo.

Configura reglas de enrutamiento

1. En tu balanceador de cargas, abre la sección Reglas de enrutamiento.

2. Agrega las siguientes reglas de host y ruta de acceso:

   Host	Ruta	Backend
   *	/metrics/*	measurement-be-svc

3. Actualiza la configuración del balanceador de cargas.

4. En un navegador, verifica la configuración navegando a https://example.com/metrics/healthy. La página debe tener el texto ok. Para verificar que se incluya la información geográfica, navega a https://example.com/metrics/?validate_geo=healthy. La página debe tener el texto ok.

Cloudflare

Para publicar tu etiqueta en la puerta de enlace de etiquetas de Google para anunciantes, crearás una entrada CNAME para un subdominio nuevo, crearás una regla de origen para reenviar solicitudes y crearás una regla de transformación para incluir información de ubicación geográfica. Para completar esta configuración, deberás tener un plan de Cloudflare Enterprise. Si no tienes un plan Enterprise, considera usar la configuración automatizada de Cloudflare.

Crea una entrada de CNAME

Nota: Las etiquetas no usarán esta entrada de CNAME. Cloudflare la usa para enrutar solicitudes de forma interna.

Elige un subdominio para reservarlo para la entrada CNAME. Completa la siguiente información para propagar los ejemplos en todo este documento. Este CNAME nunca se expone fuera de tu configuración de Cloudflare, por lo que el nombre es arbitrario.

CNAME subdomain: fps

1. En la pestaña DNS, abre la sección Registros.
2. Agrega un registro nuevo con la siguiente configuración:
   • Establece Tipo en CNAME.
   • Establece el Nombre como fps.
   • Establece Objetivo en G-12345.fps.goog.
3. Guarda el registro CNAME.

Crea la regla de origen

1. En la pestaña Rules, abre Origin Rules y crea una regla.
2. Ingresa un nombre para la regla, como Route measurement.
3. Haz coincidir las solicitudes entrantes según una expresión de filtro personalizada y haz clic en Editar expresión.
4. Pega la siguiente expresión en el compilador: (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
5. Actualiza el encabezado del host a Reescribir en… G-12345.fps.goog.
6. Actualiza el registro DNS a Anular con… fps.example.com.
7. Guarda la regla de origen.
8. Si hay otras reglas de origen, aumenta la posición de la regla recién creada para que se ejecute después de cualquier otra ruta de comodín.
9. En un navegador, verifica la configuración navegando a https://example.com/metrics/healthy. La página debe decir ok.

Incluye información de ubicación geográfica

1. En la pestaña Reglas, abre Configuración.
2. Habilita la opción Agregar encabezados de ubicación del visitante.
3. Espera unos minutos para que se propague la regla. En un navegador, verifica la configuración. Para ello, ve a https://example.com/metrics/?validate_geo=healthy. La página debe mostrar el mensaje ok.

Akamai

Para publicar tu etiqueta en la puerta de enlace de etiquetas de Google para anunciantes, deberás agregar una nueva regla en tu propiedad para reenviar solicitudes y agregar información de ubicación geográfica.

Crea la regla de redireccionamiento

1. Crea una versión nueva de tu configuración de entrega en el Administrador de propiedades
2. En la sección Configuración de la propiedad, agrega un nuevo Rule.
   • Ingresa un nombre, como Route measurement.
3. Agrega una nueva coincidencia.
   • Establece los menús desplegables de coincidencia en Ruta de acceso y es uno de.
   • Establece el valor de coincidencia en /metrics/*.
4. Agrega un nuevo Comportamiento.
   • Selecciona Standard Property Behavior y elige el comportamiento Origin Server.
   • Establece Nombre de host del servidor de origen en G-12345.fps.goog.
   • Establece Forward Host Header en Origin Hostname.
5. Guarda la regla nueva y, luego, implementa los cambios.
   • Asegúrate de probar la nueva regla de redireccionamiento en tu entorno de pruebas antes de implementarla en producción.
   • Sugerencia: Asegúrate de no tener ninguna regla que modifique o quite los encabezados de respuesta salientes. Esto puede hacer que las secuencias de comandos de Google fallen si falta el encabezado de respuesta Content-Type.

Incluye información de ubicación geográfica

1. Elige tu regla de redireccionamiento (creada anteriormente) en la Configuración de la propiedad.

2. Agrega un nuevo Comportamiento

   • Selecciona Comportamiento de propiedad estándar y elige el comportamiento Segmentación por contenido (EdgeScape).
   • Establece Habilitar en true.

3. Guarda el nuevo comportamiento e implementa los cambios.

   • Asegúrate de probar la nueva regla de redireccionamiento en tu entorno de pruebas antes de implementarla en producción.

4. En un navegador, verifica la configuración navegando a https://example.com/metrics/healthy. La página debe tener el texto ok. Para verificar que se incluya la información geográfica, navega a https://example.com/metrics/?validate_geo=healthy. La página debe tener el texto ok.

Amazon CloudFront

Nota: La puerta de enlace de etiquetas de Google para anunciantes con Amazon CloudFront está en versión beta. Si tienes alguna pregunta o problema con la configuración, comunícate con nosotros a [e-mail].

Para publicar tu etiqueta con la puerta de enlace de etiquetas de Google para anunciantes, deberás configurar el comportamiento de tu distribución para reenviar solicitudes y agregar información de ubicación geográfica.

Agrega un origen nuevo

1. Ve a la página de CloudFront en Amazon Web Services (AWS)
2. Elige tu distribución de CloudFront.
3. En la pestaña Orígenes, crea un origen con la siguiente configuración:
   • Establece Dominio de origen en G-12345.fps.goog.
   • Establece Protocolo en Solo HTTPS.

Crea el comportamiento de redireccionamiento

1. Ve a la página de CloudFront en AWS.
2. Elige tu distribución de CloudFront.
3. En la pestaña Comportamientos, crea un nuevo Comportamiento con los siguientes parámetros de configuración:
   • Establece Patrón de ruta de acceso en /metrics/*.
   • Establece Orígenes y grupos de orígenes en G-12345.fps.goog.
   • Establece Comprimir objetos automáticamente en No.
   • Establece Política de protocolo del visualizador en Solo HTTPS.
   • Establece Allowed HTTP Methods en GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE.
   • En Solicitudes de origen y clave de caché, elige Política de caché y política de solicitud de origen.
     • Establece Política de caché en CachingDisabled.
     • Establece Origin request policy en AllViewerExceptHostHeader.
4. En la lista Comportamiento, verifica que el Precedence del comportamiento nuevo sea más alto que el de todos los demás comportamientos.
   • Para cambiar el Precedence, selecciona tu comportamiento y, luego, el botón Subir hasta que esté más arriba que todos los demás comportamientos.
5. En un navegador, verifica la configuración navegando a https://example.com/metrics/healthy. La página debe decir ok.

Incluye información de ubicación geográfica

1. Para reenviar la información de ubicación geográfica necesaria, establece Headers en AllViewerExceptHostHeader en el comportamiento de redireccionamiento.
   • En este artículo, se detalla una lista completa de los encabezados de ubicación del visualizador de CloudFront.
2. Espera unos minutos para que se implemente tu distribución. En un navegador, verifica la configuración navegando a https://example.com/metrics/?validate_geo=healthy. La página debe mostrar el mensaje ok.

Fastly

Nota: La puerta de enlace de etiquetas de Google para anunciantes con Fastly se encuentra en beta. Si tienes alguna pregunta o problema con la configuración, comunícate con nosotros a [e-mail].

Para publicar tu etiqueta en la puerta de enlace de etiquetas de Google para anunciantes, deberás configurar tu servicio de CDN de Fastly para que reenvíe solicitudes y agregue información de ubicación geográfica. Este proceso implica crear una condición, un host y dos fragmentos de VCL.

Crea la condición y el host

Primero, configurarás una condición para identificar las solicitudes de la puerta de enlace y un host para enrutarlas a Google.

1. Crea una condición nueva con el siguiente parámetro de configuración:

   • Tipo: Request
   • Nombre: Google Tag Gateway Path (o el nombre que prefieras)
   • Aplicar si…: req.url.path ~ "^/metrics"

2. Crea un nuevo host con la siguiente configuración:

   • Nombre o dirección del host: fps.goog

3. Configura el nuevo host con estos parámetros adicionales:

   • Haz clic en Adjuntar una condición y selecciona la condición que creaste en el paso 1.
   • Establece Invalidar host en fps.goog.
   • Deja el resto de la configuración con sus valores predeterminados.
   • Haz clic en Actualizar para guardar el host.

Agrega el ID de la etiqueta de Google y los encabezados de ubicación geográfica

A continuación, agregarás fragmentos de VCL (Varnish Configuration Language) para adjuntar tu ID de la etiqueta de Google y los datos de ubicación geográfica del cliente. Debes crear dos fragmentos separados, uno para vcl_miss y otro para vcl_pass, con el mismo código exacto.

1. En tu servicio, ve a VCL Snippets y crea un fragmento con los siguientes campos:

   • Nombre: Geo_MISS (o el nombre que prefieras)
   • Posición: Within Subroutine
   • Subrutina: vcl_miss

   • VCL:

     if (req.url.path ~ "^/metrics") {
       set bereq.http.X-Gtg-Tag-Id = "G-12345";
       set bereq.http.X-Forwarded-Country = client.geo.country_code;
       set bereq.http.X-Forwarded-Region = client.geo.region;
       set bereq.http.X-Forwarded-Geolocation = "latlog=" +
         client.geo.latitude + "," + client.geo.longitude + ";city=" +
         client.geo.city;
     }
     

2. Crea otro fragmento con los siguientes campos:

   • Nombre: Geo_PASS (o el nombre que prefieras)
   • Tipo: vcl_pass

   • VCL:

     if (req.url.path ~ "^/metrics") {
       set bereq.http.X-Gtg-Tag-Id = "G-12345";
       set bereq.http.X-Forwarded-Country = client.geo.country_code;
       set bereq.http.X-Forwarded-Region = client.geo.region;
       set bereq.http.X-Forwarded-Geolocation = "latlog=" +
         client.geo.latitude + "," + client.geo.longitude + ";city=" +
         client.geo.city;
     }
     

   Ahora deberías tener dos fragmentos nuevos y separados. Esto garantiza que los encabezados de geolocalización se agreguen a cualquier solicitud que deba recuperarse de tu host, ya sea una "falla de caché" (vcl_miss) o un "acierto de caché" (vcl_pass).

Activa y verifica la configuración completa

Ahora que creaste todos los fragmentos de host, condición y VCL, puedes activar y probar la configuración completa.

1. Haz clic en Activar para implementar todos los cambios nuevos.

2. Verifica la configuración ejecutando ambas pruebas en tu navegador:

   • Prueba 1 (etiquetado y enrutamiento): Navega a https://example.com/metrics/healthy.
   • Prueba 2 (ubicación geográfica): Navega a https://example.com/metrics/?validate_geo=healthy.

   Ambas páginas deben mostrar el mensaje ok.

Nota: Es posible que debas purgar tu servicio y esperar unos minutos para que se apruebe esta verificación.

Otro

Para publicar tu etiqueta en la puerta de enlace de etiquetas de Google para anunciantes, debes configurar tu CDN o balanceador de cargas para enrutar las solicitudes al endpoint de la puerta de enlace de etiquetas de Google para anunciantes.

1. Agrega un origen o un backend que apunte a G-12345.fps.goog.
2. Anula el encabezado Host para que sea igual a G-12345.fps.goog. Permite que se reenvíen todas las cookies y cadenas de consulta.
3. Pasa la información de ubicación geográfica del visitante incluyendo uno de los siguientes encabezados:
   • X-Forwarded-CountryRegion: Es el país y la región del usuario en un solo código ISO 3166-2 (por ejemplo, US-CA).
   • X-Forwarded-Country y X-Forwarded-Region:
     • X-Forwarded-Country: País del usuario como código ISO 3166-1 alfa-2 (por ejemplo, US).
     • (Opcional) X-Forwarded-Region: Es el código de subdivisión regional del usuario (por ejemplo, CA).
   • Si se incluyen ambos conjuntos de encabezados, se usará X-Forwarded-CountryRegion.
4. Agrega una regla de ruta de acceso para /metrics/* para enrutar el tráfico a la puerta de enlace de etiquetas de Google para anunciantes.
5. Configura la ruta reservada para que tenga mayor prioridad que la regla predeterminada.
6. En un navegador, verifica la configuración navegando a https://example.com/metrics/healthy. La página debe decir ok. Para verificar que se incluya la información geográfica, navega a https://example.com/metrics/?validate_geo=healthy. La página debe mostrar el mensaje ok.

Paso 3: Actualiza las secuencias de comandos del sitio web para usar la ruta de medición

Reemplaza las secuencias de comandos de cada página del sitio web por una de las siguientes:

gtag.js

En la parte superior de la sección <head>, busca las dos líneas de secuencia de comandos con tu ID de la etiqueta de Google:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-12345"></script>

y reemplázalas por la ruta de medición:

<!-- Google tag (gtag.js) -->
<script async src="/metrics/"></script>

gtm.js

En la parte superior de la sección <head>, reemplaza el fragmento de Tag Manager por lo siguiente:

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'/metrics/?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','');</script>
<!-- End Google Tag Manager -->

Prueba la configuración de medición

Para probar la configuración de medición, configura tu contenedor de modo que tenga al menos una etiqueta que se active.

1. Ve a Tag Assistant y obtén una vista previa de tu contenedor.
2. Navega por tu sitio web para activar eventos.

3. En la pestaña Resumen > Resultado > Hits enviados, verifica que los hits se redireccionen a /metrics.