Cómo configurar el etiquetado del servidor con App Engine

En esta guía, se explica cómo hacer lo siguiente:

• Aprovisionar un servidor de etiquetado en Google Cloud Platform (GCP) App Engine
• Actualice el servidor de etiquetado para controlar el tráfico en vivo.
• Aumenta o disminuye la cantidad de servidores que ejecutan tu contenedor de Google Tag Manager.
• Mantén actualizada la versión del servidor de etiquetado después de aprovisionar el servidor.

Requisitos previos

1. Necesitas una cuenta de GCP. Si no tienes una, crea una cuenta nueva de GCP.
2. Necesitas una cuenta de facturación de GCP. Si no tienes una, crea una cuenta de facturación de GCP (requiere el rol de Creador de cuenta de facturación).
3. Necesitas el rol Creador del proyecto y Usuario de la cuenta de facturación. Obtén más información para agregar roles.

Nota: El propietario del proyecto primero debe habilitar App Engine; de lo contrario, verás un error de permiso cuando implementes el servidor de etiquetado. Obtén más información sobre las funciones predefinidas de App Engine.

1. Aprovisiona un servidor

Puedes aprovisionar un servicio de App Engine de forma automática en Google Tag Manager o de forma manual en Google Cloud.

Aprovisionamiento automático Aprovisionamiento manual

Selecciona un método de aprovisionamiento

Configuración inicial del servidor (testing)

La configuración de prueba es adecuada para explorar el producto, ya que envía pequeñas cantidades de tráfico de prueba y usa la función de vista previa en Tag Manager. Esta configuración es una clase de instancia F1 de App Engine en el entorno estándar y, en la mayoría de los casos, no se generarán costos.

2. Usa App Engine en producción

En la configuración de production, cada servidor cuesta alrededor de $40 por mes (USD). Cada servidor es una instancia de App Engine con 1 CPU virtual, 0.5 GB de memoria, 10 GB de disco en el entorno flexible.

Consulta Administra los costos de App Engine para comprender la facturación de App Engine y cómo configurar las alertas de facturación. Te recomendamos que configures una alerta de facturación.

Configuración de producción recomendada

Recomendamos ejecutar un mínimo de 3 servidores para reducir el riesgo de pérdida de datos en caso de una interrupción del servidor. Sin embargo, puedes optar por ejecutar menos (o más) servidores. Esperamos que el ajuste de escala automático de 3 a 6 servidores (el valor predeterminado) maneje de 50 a 200 solicitudes por segundo. El rendimiento depende de la cantidad de etiquetas y de su función.

Precaución: De forma predeterminada, App Engine registra cada solicitud. Si tu contenedor de servidor maneja muchas solicitudes por mes (p.ej., más de 1 millón), recomendamos inhabilitar el registro de solicitudes de App Engine.

Para configurar el servidor de etiquetado, sigue estos pasos:

1. Abre Cloud Shell en Google Cloud Platform.
2. Configurar el proyecto de Cloud Platform en Cloud Shell Reemplaza project ID por el ID del proyecto de GCP que anotaste antes:

   gcloud config set project project ID

3. Para volver a configurar el servidor de etiquetado para un entorno de producción, ejecuta la secuencia de comandos de configuración que aparece a continuación. Realiza las siguientes tareas:

   bash -c "$(curl -fsSL https://googletagmanager.com/static/serverjs/setup.sh)"

   1. Cambia el tipo de implementación a production.
   2. Configura servidores adicionales para entregar tráfico de producción. Recomendamos un mínimo de tres servidores.

Inhabilita el registro de solicitudes de App Engine (opcional)

De forma predeterminada, App Engine registra información sobre cada solicitud (p. ej., ruta de solicitud, parámetros de consulta, etc.) que recibe. Si tu servidor de etiquetado maneja muchas solicitudes por mes (p.ej., más de 1 millón), esos mensajes de registro pueden generar cargos de registro significativos. Para reducir o eliminar los cargos de registro, te recomendamos inhabilitar el registro de solicitud de App Engine.

Para inhabilitar el registro de solicitudes de App Engine, haz lo siguiente:

1. En Google Cloud Platform, abre el Enrutador de registros. Asegúrate de estar en el proyecto que coincida con tu ID de contenedor:
   
2. En el campo Tipo: Bucket de Cloud Logging, Nombre: _Default, selecciona el menú ampliado y, luego, haz clic en Editar receptor.
3. En Destino del receptor, seleccione el bucket de registros _Default.

4. En Elige registros para incluirlos en el receptor, agregue una línea nueva. Ingresa la siguiente regla en el filtro de inclusión existente:

   NOT LOG_ID("appengine.googleapis.com/nginx.request") AND NOT
   LOG_ID("appengine.googleapis.com/request_log")
   

5. Para inhabilitar también el registro desde el balanceador de cargas, agrega una línea nueva y, luego, ingresa la siguiente regla en el filtro de inclusión existente:

   NOT LOG_ID("requests")
   

   Nota: Esto inhabilitará todos los registros del balanceador de cargas, incluidas las solicitudes que no se envían al contenedor del servidor.

6. Haz clic en el botón Actualizar receptor, ubicado en la parte inferior.

Ahora, las solicitudes de App Engine se excluirán del registro. Consulta el Explorador de registros para asegurarte de que las solicitudes nuevas no aparezcan en los registros.

3. Asigna la implementación a tu dominio personalizado

La implementación del etiquetado del servidor predeterminado se aloja en un dominio de App Engine. Te recomendamos que modifiques la implementación para usar un subdominio del sitio web.

Asigne el subdominio de su sitio web a su servidor de etiquetado.

4. Cómo agregar la URL del servidor a Google Tag Manager

Ahora que tienes un servidor, debes asegurarte de que Google Tag Manager sepa que debe usarlo.

1. Abre Google Tag Manager.

2. Haz clic en el contenedor del servidor al que quieres apuntar.

3. Abre la configuración del contenedor del servidor en la pestaña Administrador > Configuración del contenedor.

4. Haz clic en Agregar URL y pega la URL de tu servidor.

5. Guarde este mensaje y regrese a su lugar de trabajo.

5. Validación

Ahora que ya configuró su servidor de etiquetado, asegúrese de que funcione según lo previsto. En su lugar de trabajo de Tag Manager, haga clic en el botón Vista previa. Si se carga la página de vista previa, significa que todo está configurado correctamente.

Vista previa de varias URLs

Si asignaste varios dominios a un solo servidor de etiquetado, asegúrate de que cada URL se agregue a la configuración del contenedor.

Si proporcionaste varias URLs, todas las rutas de acceso (la string después del nombre de dominio) deben coincidir.

Trabajos	No funciona
URL 1: example.com/abc URL 2: example2.com/abc	URL 1: example.com/abc URL 2: example2.com/def

Si se agregan varias URL, verás un ícono junto al botón Vista previa que te permitirá seleccionar la URL para la que deseas obtener una vista previa.

Actualice la versión del servidor de etiquetado

Nota: Si aprovisionaste los servidores de etiquetado mediante la Guía de configuración manual o la Guía de configuración de Cloud Run, sigue las instrucciones que se indican allí.

Las nuevas actualizaciones del servidor de etiquetado contienen correcciones de vulnerabilidades de seguridad y funciones nuevas. Recomendamos que, al menos, actualices tu servidor de etiquetado para cada versión principal de la versión (p.ej., actualizar de la versión 1.x.x a la 2.x.x) cuando Tag Manager te notifique que debes actualizar.

Para actualizar tu servidor de etiquetado, vuelve a ejecutar la secuencia de comandos de configuración con la misma configuración que usaste antes. La configuración existente es la predeterminada.

Para actualizar el servidor de etiquetado, sigue estos pasos:

1. Abre Cloud Shell en Google Cloud Platform.
2. Configurar el proyecto de Cloud Platform en Cloud Shell Reemplaza project ID por el ID del proyecto de GCP que anotaste antes:

   gcloud config set project project ID

3. Ejecute la secuencia de comandos de configuración con la misma configuración que usó anteriormente. La configuración existente está establecida de forma predeterminada.

   bash -c "$(curl -fsSL https://googletagmanager.com/static/serverjs/setup.sh)"

Para verificar que la actualización se realizó de forma correcta, sigue estos pasos:

1. En el contenedor del servidor, haz clic en el botón Vista previa para iniciar una nueva sesión de depuración y enviar una solicitud en otra pestaña.
2. En el resumen, selecciona la pestaña Consola y asegúrate de que no haya mensajes que te soliciten actualizar el servidor de etiquetado.

Es posible que Tag Manager te muestre mensajes que te soliciten actualizar el servidor de etiquetado hasta un día después de que el servidor se haya actualizado correctamente. Sin embargo, la página de vista previa mostrará un mensaje actualizado sobre la versión del servidor de etiquetado.

Solucionar problemas de tiempo de espera de la implementación de producción

Cuando ejecutas la secuencia de comandos de configuración para crear o volver a configurar el servidor de etiquetado, es posible que se agote el tiempo de espera de la secuencia de comandos. Esto puede suceder por varios motivos. Los dos más comunes son:

1. Las cuentas de servicio tienen permisos incorrectos: Las cuentas de servicio de Compute Engine y App Engine son responsables de implementar y mantener la producción. De forma predeterminada, se configuran previamente con los permisos correspondientes. Sin embargo, en algunos casos, la política de una organización puede hacer que sean incorrectos.

   1. Navega a la página IAM y administración en la barra de navegación izquierda en la consola de Google Cloud.
   2. Busca la cuenta de servicio de Compute Engine <project_number>[e-mail] y la cuenta de servicio de App Engine <project_name>@appspot.gserviceaccount.com.
   3. Ambas cuentas de servicio deben tener el rol Editor. Si alguna de las cuentas no tiene la función Editor, haz clic en el ícono de lápiz a la derecha de la cuenta para actualizar la función, haz clic en el menú desplegable de la función existente, desplázate hacia arriba, haz clic en Proyecto y, luego, en Editor.

2. Cuota insuficiente: La implementación de producción consume cuota de Compute Engine. Si el proyecto no tiene cuota suficiente, la implementación puede agotar el tiempo de espera mientras intenta aprovisionar recursos.

   1. Navega a la página IAM y administración en la barra de navegación izquierda en la consola de Google Cloud y luego haz clic en la pestaña Cuotas en la barra de navegación izquierda.
   2. Cerca de la parte superior de la página, haz clic en el cuadro de texto que dice Filtrar tabla y escribe Compute Engine API. Haz clic en el único resultado.
   3. Verifica que todos los estados de cuota estén dentro del límite o tengan una marca de verificación verde.
   4. Busca la opción CPU y haz clic en ella. Verifica que el uso actual más la cantidad de instancias implementadas aún estén por debajo del límite de la región de implementación.