Instalar en WooCommerce

En WooCommerce, TraceLog es un plugin de WordPress. Lo vinculas con un código corto, sin copiar claves, y el recorrido de compra ya viene declarado. Lo que aporta a una tienda está en TraceLog para WooCommerce.

Instala y vincula

1. En WordPress, ve a Plugins › Añadir plugin, busca TraceLog, instálalo y actívalo (su página en el directorio).
2. En Plugins, pulsa Activar las actualizaciones automáticas en la fila de TraceLog, para que cada nueva versión del plugin llegue a tu tienda sin que tengas que hacer nada.
3. En TraceLog, abre la página Instalación y claves del proyecto y pulsa Crear un código de vinculación: ocho caracteres, válido durante quince minutos y para un solo uso.
4. Abre TraceLog en el menú de administración de WordPress, o Ajustes en la fila de TraceLog en Plugins, y pega el código.

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 plugin

El plugin envía la plantilla de compra sin configuración adicional:

• Pasos: view_item, add_to_cart, begin_checkout
• Conversión: purchase en la página de pedido recibido, identificada por el número de pedido e incluyendo total, moneda y artículos del pedido

Desde la versión 0.2.0, el plugin también envía lo que se compró: cada artículo es un producto, con su ID y su nombre —⁠una variación cuenta como su producto⁠—⁠, su cantidad y su precio unitario antes de descuentos. La compra y la confirmación del servidor llevan los artículos del pedido; view_item, el producto que se muestra, y begin_checkout, el carrito. No se envía nada sobre el comprador.

Desde la versión 0.5.0, el plugin 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.

Cuando un pedido pasa a pagado, el servidor de la tienda envía una confirmación con el mismo número de pedido. Así, si el comprador cierra la pestaña durante el pago, la conversión no se pierde. La evidencia del navegador y del servidor se unen gracias a ese identificador. Si a GA4 o a Meta les faltan compras de pedidos pagados en otra web, consulta la guía Pedidos de WooCommerce que no llegan a GA4.

Desde la versión 0.6.0, la confirmación se envía con cualquier pasarela, también en un pedido pagado por transferencia, contra reembolso o marcado como pagado a mano; antes, solo la enviaban las pasarelas que completan el pago en línea.

Desde la versión 0.7.0, cuando un pedido se marca como fallido, el servidor de la tienda le dice a TraceLog el identificador del método de pago, y nada más del pedido.

Las renovaciones de WooCommerce Subscriptions no se envían ni desde el navegador ni desde el servidor: renuevan lo que ya se compró en un pedido anterior, así que no son conversiones. Las renovaciones de otros plugins de suscripción sí se envían.

Consentimiento

TraceLog no captura nada hasta que tu tienda lo permita. Qué hacer depende de cómo pida tu tienda el consentimiento:

1. Tu banner lo muestra un plugin de cookies compatible con la WP Consent API, como Complianz. Instala también el plugin WP Consent API, desde Plugins › Añadir plugin: a través de él, TraceLog sigue la categoría statistics de tu banner. Empieza a capturar cuando el visitante permite las estadísticas y se detiene cuando las retira, en la misma carga de página. Sin ese plugin, lo que decide el de cookies nunca llega a TraceLog.
2. Tu tienda no muestra ningún aviso de consentimiento. Marca "Esta tienda no muestra ningún aviso de consentimiento. TraceLog puede registrar el recorrido de conversión desde que se carga la página." ("This store shows no consent banner", si el plugin está en inglés) en la página de ajustes del plugin. TraceLog captura entonces desde la carga de la página. Con un plugin de cookies conocido activo, como Complianz, esta casilla no se aplica, y la página de ajustes lo dice.
3. Tu banner es código tuyo. TraceLog espera. Llama a TraceLog.consent.grant() desde el código de tu banner en la página en la que el visitante acepta, y de nuevo en cada página posterior mientras mantenga su consentimiento, y a TraceLog.consent.deny() si lo rechaza.

Si tienes instalado el plugin WP Consent API y ningún plugin de cookies activo, WP Consent API responde que sí y TraceLog captura. La página de ajustes del plugin indica en cuál de los tres casos está tu tienda, y cuenta este caso como el primero. Con un pedido de prueba pasa lo mismo: sin consentimiento no se captura nada, y la página Instalación y claves te lo indica.

Verifica con un pedido de prueba

Activa el modo de prueba de una pasarela y haz un pedido. El navegador y el servidor lo marcan como tráfico de verificación: se ejecuta el proceso de compra real y no cuenta para tu límite, tu factura ni tus cifras. Después sigue visible en la página Recorrido.

Mantén abierta la página Instalación y claves mientras lo haces. La lista de Tu recorrido de conversión avanza a medida que llegan los eventos, y ambas evidencias aparecen bajo un solo identificador.

Si la lista de comprobación no avanza

No llegan eventos de la tienda.

El plugin de TraceLog aún no ha enviado nada desde tu tienda: ¿está activado y vinculado?

La configuración del plugin no es válida.

Vuelve a vincular la tienda desde los ajustes del plugin de TraceLog con un código de vinculación nuevo: el plugin guarda la clave del proyecto y no hay que pegar nada a mano.

Llega una conversión sin su identificador.

La matriz completa, con lo que cada condición supone para la verificación, está en instalar con una etiqueta script. El plugin es GPLv2-or-later. Su cabecera declara las versiones de WordPress, PHP y WooCommerce que requiere y la última de WooCommerce con la que se ha probado; su readme, la última de WordPress con la que se ha probado.

Tras un cambio de tema o de checkout

Los eventos declarados los emite el plugin, así que un cambio de tema no los elimina. Un cambio de checkout o de plugin de consentimiento sí puede. Qué comprobar tras cualquier cambio está en verifica tras cambiar de plataforma.