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 la etiqueta 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, envía 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 de origen.

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 la ruta de entrega de etiquetas

Debes reservar una ruta en el dominio de tu sitio web para publicar la etiqueta. Asegúrate de que esta ruta de acceso no se esté usando en tu dominio.

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 deseas una ruta de acceso más legible, puedes usar una palabra como /metrics, /securemetric, /analytics o cualquier otra palabra que desees.

La ruta de acceso no debe ser la ruta raíz / ni superar los 100 caracteres.

Completa los siguientes campos 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.

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. Balanceador de cargas de GCP abierto

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

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 Servicio de backend nuevo.
   • 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 CNAME. Cloudflare la usa para enrutar solicitudes de forma interna.

Elige un subdominio para reservarlo para la entrada CNAME. Completa los siguientes campos 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

Nota: La puerta de enlace de etiquetas de Google para anunciantes con Akamai se encuentra 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 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 comportamiento nuevo.
   • Selecciona Comportamiento estándar de la propiedad y elige el comportamiento Servidor de origen.
   • 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 provocar 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. Navega a la sección Variables de propiedad y agrega las siguientes variables.

   Nombre de la variable	Configuración de seguridad
   USER_REGION	Hidden
   USER_COUNTRY	Hidden

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

3. Agrega dos nuevos comportamientos de Set Variable.

   • Selecciona Comportamiento de propiedad estándar y elige el comportamiento Establecer variable. Crea un comportamiento para cada variable.
   • Establece los siguientes valores para cada comportamiento

     Variable	Crear valor a partir de	Obtener datos de	Campo de Edgescape	Operación
     PMUSER_USER_REGION	Extract	Edgescape Data	Region Code	None
     PMUSER_USER_COUNTRY	Extract	Edgescape Data	Country Code	None

4. Se agregaron dos nuevos comportamientos de Modify Outgoing Request Header.

   • Selecciona Comportamiento de propiedad estándar y elige el comportamiento Modificar encabezado de solicitud saliente. Crea un comportamiento para cada variable geográfica de Edgescape.
   • Establece los siguientes valores para cada comportamiento

     Acción	Selecciona el nombre del encabezado	Nombre del encabezado personalizado	Valor del encabezado
     Add	Other...	X-Forwarded-Region	{{user.PMUSER_USER_REGION}}
     Add	Other...	X-Forwarded-Country	{{user.PMUSER_USER_COUNTRY}}

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.

6. 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.

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 que enrute las solicitudes al extremo 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: Es el país del usuario como un 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 predeterminada
6. 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.
7. Configura la ruta reservada para que tenga mayor prioridad que la regla predeterminada.
8. En un navegador, verifica la configuración navegando a https://example.com/metrics/healthy. La página debe decir ok.

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

Reemplaza las secuencias de comandos en 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 acceso de la 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.