Google Tag Manager
Despliega y gestiona etiquetas de marketing, scripts personalizados y analítica con Google Tag Manager.
Google Tag Manager (GTM) te permite gestionar etiquetas, píxeles de rastreo y scripts personalizados en tu sitio de Boltdocs sin editar código directamente.
Referencia de Configuración
| Propiedad | Tipo | Requerido | Descripción |
|---|---|---|---|
tagId | string | ✓ | Tu ID de Contenedor de GTM (por ejemplo 'GTM-XXXXXX'). |
dataLayerName | string | — | El nombre de la variable global dataLayer de GTM (predeterminado a 'dataLayer'). |
preview | string | — | Cadena de parámetro de consulta de entorno de GTM para probar etiquetas en borrador. |
Ejemplo Avanzado
ts
integrations: {
gtm: {
tagId: 'GTM-XXXXXX',
dataLayerName: 'customDataLayer',
preview: 'env-3&auth=xxxxx',
},
}
Usando el DataLayer
Puedes interactuar con GTM empujando eventos directamente al dataLayer. En tus componentes personalizados:
tsx
export function LeadButton() {
const handlePush = () => {
// Si personalizaste dataLayerName, reemplaza 'dataLayer' con tu nombre personalizado
const dataLayer = (window as any).dataLayer || [];
dataLayer.push({
event: 'form_submission',
category: 'lead',
action: 'click',
});
};
return (
<button onClick={handlePush}>
Submit Form
</button>
);
}
GDPR y gestión de consentimiento
Asegúrate de configurar GTM para respetar el consentimiento del usuario antes de cargar etiquetas de marketing de terceros, especialmente si estás atendiendo usuarios en la UE.
Last updated on October 18, 2026
