Instalar en PrestaShop
Última actualización: 15 nov 2026
Seguimiento de conversiones en PrestaShop: descarga el módulo de TraceLog, súbelo desde el back office, pega un código de vinculación de ocho caracteres y verifica con un pedido hecho en la pestaña que abre tu página Instalación y claves.
En PrestaShop, TraceLog es un módulo. Lo vinculas con un código de vinculación, sin copiar claves, y el recorrido de compra ya viene declarado. Lo que aporta a una tienda está en TraceLog para PrestaShop.
Instala y vincula
El módulo de TraceLog aún no está en el PrestaShop Marketplace: lo descargas aquí, y la página Instalación y claves de tu proyecto ofrece el mismo archivo.
- Descarga el módulo de TraceLog, versión 0.7.2, un archivo .zip que se sube tal cual, sin descomprimirlo.
- En el back office de PrestaShop, abre Módulos › Gestor de módulos (Administrador de módulos en PrestaShop 8), pulsa Subir un módulo y suelta el archivo.
- Cuando aparezca ¡Módulo instalado!, pulsa Configurar.
- En TraceLog, abre la página Instalación y claves del proyecto y pulsa Crear un código de vinculación. Pégalo en el campo Código de vinculación del módulo y pulsa Vincular. Es válido durante quince minutos y funciona una sola vez.
Puedes pegarlo con espacios, guiones, mayúsculas o minúsculas. Las claves del proyecto no se muestran ni se pegan en ninguna página.
Qué configura el módulo
El módulo envía por sí mismo los pasos y la compra, con la referencia del pedido; aquí no se escribe nunca ninguna credencial.
- Pasos:
view_item,add_to_cart,begin_checkout - Conversión:
purchaseen la página de confirmación del pedido, identificada por la referencia del pedido e incluyendo el total pagado y la moneda del pedido
Cuando un pedido llega a un estado de pagado, el módulo envía una confirmación desde el servidor con la misma referencia. Así, si el comprador cierra la pestaña durante el pago, la conversión no se pierde. La evidencia del navegador y del servidor de un mismo pedido se une en una sola conversión. Un carrito que PrestaShop divide en varios pedidos conserva una sola referencia, así que cuenta como una conversión del carrito entero en los dos lados.
Desde la versión 0.5.0, el módulo indica también si un pedido es el primero del cliente: busca en los pedidos de la tienda uno anterior ya pagado con el mismo correo y envía solo la respuesta, nunca el correo.
Desde la versión 0.7.0, cuando un pedido pasa al estado de error de pago, el servidor de la tienda le dice a TraceLog el nombre del módulo de pago, y nada más del pedido.
Consentimiento
El consentimiento decide si se envía algo. Si la tienda no muestra ningún
aviso, desactiva cualquier módulo de cookies y marca «Esta tienda no muestra
ningún aviso de consentimiento» en los ajustes del módulo de TraceLog. Si no, llama a
TraceLog.consent.grant() desde el botón de aceptar de tu aviso, en la página
en la que el visitante acepta, y de nuevo en cada página posterior mientras
mantenga su consentimiento. PrestaShop no tiene una API de consentimiento, así
que un módulo de cookies solo llega a TraceLog mediante esa llamada: añádela
donde el módulo te deje poner un script que se ejecute al aceptar las
estadísticas, en cada página mientras el visitante mantenga su consentimiento,
o pregunta a su desarrollador.
Hasta entonces, el módulo de TraceLog no envía nada.
Desde la versión 0.7.1, con un módulo de cookies conocido activado la casilla no se aplica: lo dice la página de ajustes del módulo de TraceLog, y un aviso en el Panel de control nombra el módulo de cookies. La página de ajustes del módulo de TraceLog indica en qué caso está tu tienda. Un pedido de prueba sigue la misma regla: sin consentimiento no captura nada, y la página Instalación y claves lo dice.
Verifica con un pedido de prueba
Abre tu tienda desde la página Instalación y claves del proyecto con Abrir mi sitio y haz un pedido en esa pestaña: el módulo lo marca como verificación en los dos lados. PrestaShop no tiene un modo de prueba que el módulo pueda leer, así que es la pestaña que abrió la página Instalación y claves la que marca el pedido: se recorre el pago real y no cuenta para tu límite, tu factura ni tus cifras. Un pedido hecho en cualquier otra pestaña cuenta como real.
Mantén abierta la página Instalación y claves del proyecto mientras lo haces: la lista de Tu recorrido de conversión avanza a medida que llegan los eventos, y la evidencia del navegador y del servidor aparece bajo un mismo identificador cuando el pedido se paga.
Si la lista de comprobación no avanza
No llegan eventos de la tienda.
El módulo de TraceLog aún no ha informado desde tu tienda: ¿está instalado y vinculado?
La configuración del módulo no es válida.
Vuelve a vincular la tienda desde los ajustes del módulo de TraceLog con un código nuevo: el módulo guarda la clave del proyecto y no se pega nada a mano.
Llega una conversión sin su identificador.
El módulo envía el número de pedido con cada compra. Si ves esto, escribe a info@tracelog.io.
La matriz completa, con lo que cada condición supone para la verificación, está en instalar con una etiqueta script. El módulo tiene licencia MIT y funciona en PrestaShop 8.0 o posterior, incluido el 9, con PHP 7.2 o posterior.
Tras un cambio de tema o de checkout
El módulo emite los eventos del navegador a través de los hooks que muestra el tema, así que un cambio de tema puede eliminarlos; la confirmación del servidor de un pedido pagado no depende del tema. Un cambio de módulo de checkout o de consentimiento también puede eliminarlos. Qué comprobar tras cualquier cambio está en verifica tras cambiar de plataforma.