Manual de sncustomcode para PrestaShop: GA4, píxeles y GTM sin tocar la plantilla
GA4, píxeles, chat y GTM — guía de instalación y configuración · por Softnet Sistemas
En resumen: sncustomcode es un módulo de PrestaShop 1.7 a 9 que inserta tu GA4, Google Tag Manager, píxeles de Meta o TikTok o un chat en el head o el body, sin editar la plantilla. Se instala desde el Gestor de módulos, creas un fragmento, eliges posición y segmentación, y lo compruebas en tu tienda. Esta guía lo explica paso a paso, con recetas y los problemas más frecuentes. Actualizado el 8 de noviembre de 2026.
1. Qué hace este módulo
Código personalizado inserta cualquier fragmento de terceros (Google Analytics 4, Google Tag Manager, píxeles de Meta/TikTok/Pinterest, widgets de chat, etiquetas de verificación, CSS/JS a medida) dentro del <head> o del <body> de todas las páginas de tu tienda — sin editar ni una sola plantilla y a prueba de actualizaciones del tema. Cada fragmento se puede segmentar por tipo de página, dispositivo, idioma y visibilidad.
2. Requisitos
PrestaShop 1.7.0.0 a 9.x.
No requiere ningún servicio ni cuenta externa. El módulo se ejecuta por completo en tu propia tienda.
3. Instalación
En tu back office, ve a Módulos → Gestor de módulos.
Pulsa Subir un módulo y selecciona el ZIP del módulo (sncustomcode.zip).
PrestaShop lo instala automáticamente. Al terminar, pulsa Configurar.
El módulo registra tres hooks de visualización al instalarse: displayHeader, displayAfterBodyOpeningTag y displayBeforeBodyClosingTag. No hace falta editar plantillas.
4. Añadir tu primer fragmento
En la pantalla de configuración, pulsa Añadir fragmento.
Ponle un Nombre claro (p. ej. “GA4”, “Píxel de Meta”, “Widget de chat”).
Elige la Posición (ver la tabla de abajo).
Pega tu código en el editor. Se guarda exactamente como lo pegas — las etiquetas script y meta nunca se eliminan.
Opcionalmente, define la segmentación (páginas, dispositivo, idioma, visibilidad, prioridad).
Asegúrate de que Activo está marcado y pulsa Guardar.
Abre tu tienda y confirma que la etiqueta se carga correctamente.
Posiciones
Posición
Dónde se imprime
Uso típico
Head
Dentro de <head>
GA4, Matomo, Clarity, metaetiquetas de verificación, la parte script de GTM
Inicio del body
Justo tras <body>
El fragmento <noscript> de Google Tag Manager
Final del body
Antes de </body>
Widgets de chat y scripts no críticos
5. Opciones de segmentación
Páginas — muestra el fragmento en todas las páginas o solo en los tipos elegidos (portada, producto, categoría, CMS, carrito, pago, contacto, búsqueda).
Dispositivo — todos, solo móvil o solo escritorio.
Idioma — todos los idiomas o uno concreto.
Visibilidad — Todos; Ocultar a los empleados con sesión (deja tus propias visitas fuera de tu analítica); o Solo empleados (prueba una etiqueta nueva en producción con seguridad antes de activarla).
Prioridad — los números bajos se imprimen primero cuando varios fragmentos comparten posición.
6. Gestión de fragmentos
Activa o desactiva cualquier fragmento sin borrarlo — pausa un píxel mientras pruebas y vuelve a encenderlo.
Edita o elimina un fragmento desde la lista en cualquier momento.
En instalaciones multitienda, los fragmentos guardados en el contexto de una tienda se aplican solo a esa tienda.
7. Desinstalación
Al desinstalar el módulo desde el Gestor de módulos se eliminan todos los fragmentos y el código insertado en las páginas de tu tienda. No queda ningún dato residual.
Consejo: una etiqueta script mal cerrada puede romper la carga de la página. Tras guardar un fragmento, abre el front office de tu tienda y comprueba que las páginas cargan bien.
8. Recetas rápidas
Google Analytics 4
Crea un fragmento con la posición Head y pega el código de gtag.js que te da Google Analytics. Para que tus propias visitas no cuenten, pon la visibilidad en Ocultar a los empleados con sesión.
Google Tag Manager
Son dos fragmentos: el script en Head y la parte <noscript> en Inicio del body. Cada uno va en su posición, tal como indica la tabla del apartado 4.
Píxel de Meta o de TikTok
Posición Head. Si solo quieres que se cargue en ciertas páginas (por ejemplo producto, carrito y pago), elige esos tipos de página en la segmentación.
Widget de chat
Posición Final del body, para que no retrase el resto de la página.
Probar una etiqueta nueva sin riesgo
Crea el fragmento con la visibilidad Solo empleados, abre la tienda con tu sesión de back office y comprueba que funciona. Cuando esté bien, cámbiala a Todos.
9. Problemas frecuentes
No veo el código en mi tienda. Comprueba que Activo está marcado, que la posición es la correcta y que la segmentación (tipo de página, dispositivo, idioma) no deja fuera la página que estás mirando. Si la visibilidad es Solo empleados, necesitas tener abierta tu sesión de empleado. Vacía también la caché de PrestaShop y la del navegador.
La página se rompe o no carga tras guardar. Suele ser una etiqueta script mal cerrada. Desmarca Activo en ese fragmento, la página vuelve a la normalidad, y corrige el código.
Mis propias visitas aparecen en la analítica. Pon la visibilidad en Ocultar a los empleados con sesión; funciona mientras tengas la sesión de back office abierta en ese navegador.
Dos fragmentos se cargan en otro orden del que quiero. Usa la Prioridad: los números bajos se imprimen primero cuando comparten posición.
El noscript de Tag Manager no funciona. Debe ir en Inicio del body, no en Head.
Tengo varias tiendas. Los fragmentos guardados en el contexto de una tienda solo se aplican a esa tienda.
Preguntas frecuentes
¿Tengo que editar las plantillas de mi tema?
No. El módulo se engancha a tres hooks de visualización al instalarse y el código se guarda en el propio módulo.
¿Con qué versiones de PrestaShop funciona?
Con PrestaShop 1.7.0.0 a 9.x. No necesita ningún servicio ni cuenta externa.
¿Qué pasa con mis fragmentos si lo desinstalo?
Se eliminan todos los fragmentos y el código insertado en las páginas de tu tienda. No queda ningún dato residual.
¿Cuánto cuesta y cómo lo compro?
29 € + IVA, pago único, con entrega inmediata por correo. Lo compras en la ficha de sncustomcode; ahí también están las capturas y el resto de módulos de PrestaShop.