Jamdesk Documentation logo

Integración con Google Tag Manager

Agrega tu ID de contenedor de GTM a docs.json para cargar Google Tag Manager en cada página. Gestiona etiquetas de analítica desde GTM.

Agrega tu ID de contenedor de GTM a docs.json para cargar Google Tag Manager en cada página de tu sitio de documentación. A partir de ahí, tu equipo de marketing puede configurar analítica, píxeles de conversión y seguimiento de eventos completamente desde GTM.

Los ID de contenedor de GTM comienzan con GTM-. Si solo necesitas Google Analytics, consulta Integración con Google Analytics para una configuración más simple.

Cuándo usar GTM

Usa Google Tag Manager cuando necesites:

  • Múltiples herramientas de seguimiento - GA4, Facebook Pixel, LinkedIn, etc.
  • Control del equipo de marketing - Deja que el equipo de marketing agregue etiquetas sin ayuda de desarrollo
  • Triggers avanzados - Rastrear clics en botones, envíos de formularios, visualizaciones de video
  • Integración con pruebas A/B - Conectar herramientas como Google Optimize

Para analítica básica únicamente, agregar GA4 directamente es más simple.

Obtener tu ID de contenedor

  1. Ve a Google Tag Manager
  2. Selecciona tu cuenta y contenedor (o crea unos nuevos)
  3. Copia el Container ID (ID de contenedor) en la parte superior de la página (comienza con GTM-)

Agregar GTM a tus documentos

Agrega el ID de contenedor a tu docs.json:

docs.json
{
  "name": "My Docs",
  "integrations": {
    "gtm": {
      "tagId": "GTM-XXXXXXX"
    }
  }
}

Reemplaza GTM-XXXXXXX con tu ID de contenedor real.

Consentimiento de cookies

Eres responsable de configurar los banners de consentimiento de cookies si los necesitas. Jamdesk carga tu contenedor de GTM en cada página, así que cualquier etiqueta que configures se activa para todos los visitantes. Si tus lectores están sujetos a GDPR, CCPA o regulaciones similares, configura el modo de consentimiento en GTM o usa una plataforma de gestión de consentimiento. Jamdesk también puede restringir GTM mismo detrás del consentimiento. Consulta Consentimiento de cookies.

Configurar GA4 a través de GTM

Si deseas usar GA4 a través de GTM en lugar de agregarlo directamente:

  1. En GTM, ve a TagsNew
  2. Elige Google Analytics: GA4 Configuration
  3. Ingresa tu ID de medición de GA4 (comienza con G-)
  4. Configura el trigger en All Pages
  5. Publica tu contenedor

Si configuras GA4 a través de GTM, no lo agregues también directamente en docs.json. Esto causa seguimiento duplicado.

Verificar la instalación

Usando el modo Preview de GTM

  1. En GTM, haz clic en Preview en la esquina superior derecha
  2. Ingresa la URL de tu sitio de documentación
  3. Una ventana de depuración muestra qué etiquetas se activan en cada página

Usando las herramientas de desarrollador del navegador

  1. Abre tu sitio con las herramientas de desarrollador (F12)
  2. Ve a la pestaña Network
  3. Filtra por gtm.js o googletagmanager
  4. Deberías ver solicitudes realizándose

Etiquetas comunes de GTM para documentación

Rastrear enlaces salientes

Crea una etiqueta para rastrear cuando los usuarios hacen clic en enlaces externos:

  1. Tag: Google Analytics: GA4 Event
  2. Event Name: click
  3. Trigger: Click - Just Links, donde Click URL no contiene tu dominio

Rastrear el uso de la búsqueda

Rastrea cuando los usuarios interactúan con la función de búsqueda:

  1. Tag: Google Analytics: GA4 Event
  2. Event Name: search
  3. Trigger: Custom event que coincida con tu interacción de búsqueda

Rastrear el tiempo en la página

Comprende cuánto tiempo pasan los usuarios leyendo:

  1. Tag: Google Analytics: GA4 Event
  2. Event Name: timing
  3. Trigger: Timer trigger (por ejemplo, cada 30 segundos)

Solución de problemas

  1. Verifica el Container ID - Debe comenzar con GTM-
  2. Publica tu contenedor - Los cambios sin publicar no aparecerán en tu sitio
  3. Usa el modo Preview - El preview de GTM muestra qué etiquetas se activan en cada página

Si tienes GA4 configurado en ambos:

  • Directamente en docs.json (integrations.ga4)
  • A través de GTM como una etiqueta GA4

Obtendrás vistas de página duplicadas. Elimina uno de ellos.

Artículos relacionados

Google Analytics

Agrega GA4 directamente sin GTM

Analíticas del proyecto

Ver la analítica integrada de Jamdesk