El plan de conversión
Qué declara un plan —cada conversión, su identificador estable y los pasos anteriores esperados— y qué ocurre cuando lo modificas.
El plan de conversión indica qué eventos debe recibir TraceLog. Por ejemplo: ver un producto, añadirlo al carrito, iniciar el pago y completar una compra. Lo defines al crear el proyecto. TraceLog lo usa para verificar la instalación y, más adelante, para detectar lo que deja de llegar.
Qué declara un plan
Para cada conversión:
| Campo | Significado |
|---|---|
| Tipo | Compra, lead, reserva, registro, suscripción, solicitud o donación |
| Nombre del evento | El nombre que envía tu código, con el formato admitido |
| Identificador estable | El valor que acompaña cada conversión: número de pedido, lead o reserva |
| Valor y moneda | Opcionales y declarados juntos |
| Pasos | Opcionales: los eventos que deberían ocurrir antes, en la misma sesión |
| Principal | Exactamente una conversión del plan se marca como principal |
La conversión principal es la que representa una «tasa de conversión» sin más detalle y la que encabeza el resumen. Las demás se capturan y se comprueban igual.
Por qué declarar los pasos
Los pasos son opcionales. Sin ellos, un paso del recorrido puede dejar de llegar mientras la conversión sigue llegando, y nada lo detecta. Además, cada conversión que envía el navegador llevará un aviso porque ningún paso la precede en la sesión.
El identificador estable
Permite contar cada conversión una sola vez. La verificación se bloquea si falta el identificador o si el mismo identificador llega con datos incompatibles. Usa el número de pedido, contacto o reserva que ya asigna tu sistema, no uno aleatorio creado en el navegador, y mantenlo al reenviar esa misma conversión:
Envía el identificador estable declarado con cada evento de conversión.
Usa un único identificador estable para cada conversión y mantén su valor sin cambios.
El identificador también permite unir la evidencia del navegador y del servidor para una misma conversión. Consulta la API de servidor.
Plantillas
Al crear un proyecto, el tipo de conversión propone una plantilla. Una compra,
por ejemplo, incluye view_item, add_to_cart, begin_checkout y después
purchase, identificada por el número de pedido y con un valor. La app de
Shopify y el plugin de WooCommerce declaran esa misma plantilla, así que un
proyecto creado desde ellos ya tiene plan.
En una instalación por script o npm, después puedes adaptar el plan a tu propio recorrido de conversión. En Shopify y WooCommerce el plan lo pone la app o el plugin y no se edita.
Versiones
Cada cambio crea una versión del plan. TraceLog la usa en las comprobaciones a partir de ese momento, y cada alerta indica qué versión estaba activa cuando saltó. Si renombras un paso a propósito, no se informa como un fallo.
Cómo modificar un plan con seguridad
- Publica primero el código que envía los nombres nuevos.
- Modifica el plan cuando esos eventos ya estén llegando.
- Comprueba en la página Instalación que la versión nueva se verifica.
Si modificas el plan antes que el código, el proyecto queda en receiving: se
reciben eventos, pero falta un elemento declarado, y TraceLog indica cuál.
Completa la conversión declarada y comprueba que su evento se envíe después de los pasos anteriores.