- El tracking de conversiones de Lightspeed funciona mejor cuando cada pedido pagado se envía desde los datos de pedido de Lightspeed en el servidor, con un fragmento en la página de agradecimiento que vincula el pedido con el clic en el anuncio.
- ROASaurus se conecta a Lightspeed eCom (C-Series) a través de su API en los clústeres de la UE y de EE. UU.; E-Series es un producto distinto y no está cubierto.
- Un clic en Create webhook registra un webhook de pedidos en Lightspeed, y ROASaurus además comprueba cada 5 minutos si hay pedidos actualizados, de modo que se capturan los pagos tardíos.
- Solo se envían los pedidos con el estado de pago paid, valorados al precio del pedido con impuestos incluidos.
- Los pedidos de Lightspeed incluyen la dirección IP y el navegador del comprador, así que ROASaurus aún puede vincular algunos pedidos cuando el fragmento de la página de agradecimiento no se ejecutó.
El tracking de conversiones de Lightspeed consiste en informar a plataformas publicitarias como Meta y TikTok de cada pedido pagado de tu tienda online de Lightspeed eCom, para que puedan atribuir el mérito a los anuncios correctos y optimizar tus campañas. La forma fiable es enviar cada compra desde los datos de pedido de Lightspeed en el servidor y añadir un breve fragmento a la página de agradecimiento que vincula el pedido con el clic en el anuncio.
Esta guía explica a qué producto de Lightspeed se aplica, cómo llegan los pedidos a ROASaurus, qué se lee de cada pedido, cómo llegan las compras a Meta y TikTok, la configuración, las pruebas y los límites que conviene conocer.
¿Qué producto de Lightspeed cubre esta guía?
Lightspeed vende más de un producto de ecommerce, así que comprueba primero el tuyo. ROASaurus se conecta a Lightspeed eCom (C-Series), la plataforma de tiendas online cuyo back office tiene Settings › Website Settings › Web Extras. Su API funciona en dos clústeres:
| Clúster | Dirección de la API | Región en ROASaurus |
|---|---|---|
| EU1 | api.webshopapp.com | eu |
| US1 | api.shoplightspeed.com | us |
Cada dirección de la API también contiene un código de idioma de dos letras, por ejemplo /nl/ o /en/. ROASaurus lo pide como idioma de la tienda y usa nl cuando lo dejas vacío.
Lightspeed también ofrece eCom (E-Series). Lightspeed describe el paso a E-Series como una actualización a un producto distinto, que actualmente se ofrece a determinados comerciantes de Norteamérica. El conector de ROASaurus con Lightspeed lee los pedidos solo a través de la API de C-Series, así que no cubre las tiendas con E-Series.
¿Por qué faltan compras de Lightspeed en Meta y TikTok?
Un píxel en el navegador solo informa de una compra cuando el navegador del comprador carga la página de agradecimiento y se ejecuta el script del píxel. Eso falla en varias situaciones habituales:
- Un comprador paga mediante una redirección, por ejemplo con iDEAL o PayPal, y cierra la pestaña antes de que se cargue la página de agradecimiento.
- Un bloqueador de anuncios o un ajuste de privacidad del navegador bloquea el script del píxel.
- El visitante rechaza las cookies de marketing, así que el píxel no debe cargarse.
- El pedido se paga más tarde, por ejemplo por transferencia bancaria, cuando no interviene ningún navegador.
- Safari limita cuánto duran las cookies creadas por scripts, así que el navegador puede olvidar un clic antiguo en un anuncio.
- Necesita que se cargue la página de agradecimiento
- Lo bloquean los bloqueadores de anuncios y algunos navegadores
- No ocurre nada cuando una transferencia bancaria se paga más tarde
- Valor y número de pedido solo si se llega a la página
- Todos los pedidos con el estado de pago paid
- Se envía de servidor a servidor, no desde el navegador
- Los pagos tardíos llegan con la siguiente actualización de pedidos
- Valor, productos y datos del cliente a partir del pedido
¿Cómo llegan los pedidos de Lightspeed a ROASaurus?
Cuando pulsas Create webhook, ROASaurus registra en Lightspeed un webhook para el grupo orders y la acción updated, en formato JSON. A partir de entonces, Lightspeed llama a ROASaurus cuando un pedido cambia.
Por qué ROASaurus vuelve a leer el pedido
Lightspeed añade una cabecera x-signature a un webhook solo cuando lo ha creado una app. Un webhook creado con una clave de API simple, como aquí, no está firmado. Por eso la dirección del webhook contiene un token único de tu tienda, y ROASaurus no se fía del contenido recibido. Lee el pedido y sus productos desde la API de Lightspeed y comprueba por su cuenta el estado de pago.
La comprobación de 5 minutos
Cada 5 minutos, ROASaurus también pide a Lightspeed los pedidos actualizados desde su última comprobación, con 30 minutos de solapamiento, y registra los pedidos pagados que aún no tiene. Como esta comprobación usa la hora de actualización, se captura un pedido pagado días después de hacerse aunque haya fallado la entrega de su webhook. Los pedidos que ROASaurus ya tiene se ignoran, así que el webhook y la comprobación nunca crean dos compras.
Por parte de Lightspeed, un webhook debe recibir una respuesta 2xx en 5 segundos. Las entregas fallidas se reintentan, hasta 10 intentos en total, y un webhook cuya proporción de errores se mantiene por encima del 50% durante 50 horas se desactiva. La comprobación de 5 minutos mantiene la llegada de pedidos durante un hueco así.
¿Qué lee ROASaurus de un pedido de Lightspeed?
| Campo de Lightspeed | Qué hace ROASaurus con él |
|---|---|
number | El id del pedido, por ejemplo ORD01042. Se convierte en el id de evento order-ORD01042, porque la página de agradecimiento muestra el mismo número. |
paymentStatus | Solo se envían los pedidos pagados. Los pedidos no pagados, parcialmente pagados y cancelados se omiten. |
priceIncl | El valor de la compra, con impuestos incluidos. La moneda es la de la tienda que has definido en ROASaurus. |
createdAt | La hora del evento |
| Email, teléfono o móvil, nombre y apellidos | Con hash SHA-256 y enviados como datos del cliente |
| Ciudad, código postal y país de facturación | Con hash y enviados como datos del cliente |
remoteIp, userAgent | Se envía con el evento y se usa para vincular por IP |
| Id de cliente | Con hash y enviado como id externo |
| Productos del pedido | Id de variante (o de producto), cantidad, precio con impuestos incluidos, título y SKU |
El valor de la compra incluye el IVA
El priceIncl de Lightspeed es el precio del pedido con impuestos incluidos, y ese es el valor que envía ROASaurus. Por eso tus plataformas publicitarias informan de ingresos con el IVA incluido. Este es el efecto con un 21% de IVA:
| Ejemplo: 30 pedidos | Valor enviado (IVA incl.) | Ingresos sin IVA |
|---|---|---|
| Gasto publicitario | $1,000 | $1,000 |
| Valor de compra | $3,630 | 3,630 ÷ 1.21 = $3,000 |
| ROAS | 3.63 | 3.00 |
Un ROAS de equilibrio usa ingresos sin IVA. Divide el ROAS de la plataforma entre 1 más tu tasa de IVA antes de comparar ambos.
¿Cómo se vincula un pedido de Lightspeed con el clic en el anuncio?
Para atribuir el mérito a un anuncio, la plataforma necesita los identificadores de clic del visitante que hizo el pedido: el click id y el id de navegador de Meta (fbc, fbp), el click id de TikTok (ttclid) y la cookie de TikTok (ttp). El script de ROASaurus los guarda para cada visitante cuando llega desde un anuncio. ROASaurus no obtiene ese id de visitante del pedido de Lightspeed, así que vincula cada pedido con un visitante de otra manera. Prueba tres métodos, en este orden:
| Método | Cómo funciona | Qué necesita |
|---|---|---|
| 1. Fragmento de la página de agradecimiento | El fragmento dispara una compra de ROASaurus con el número de pedido. ROASaurus encuentra ese evento por su id de evento, order-ORD01042. | El fragmento del cuadro Tracking |
| 2. Email anterior | Un email con hash que el visitante dio antes en tu sitio, en un formulario emergente o mediante una llamada Identify | Un formulario de registro o una llamada Identify |
| 3. Dirección IP y navegador | La misma dirección IP y el mismo navegador vistos desde 3 horas antes hasta 15 minutos después del pedido, solo cuando encaja exactamente un visitante | Nada adicional |
El fragmento también pasa el total del pedido, la moneda y el email del cliente. ROASaurus guarda un hash de ese email en el visitante, lo que ayuda a vincular el siguiente pedido del mismo comprador. ROASaurus espera un momento antes de enviar cada compra, para que el evento de la página de agradecimiento pueda llegar primero, y vuelve a intentar la vinculación en el momento del envío.
Lightspeed variables used by the ROASaurus snippet (Tracking box) order.information.number order id and event id order-<number> order.information.price_incl value order.information.currency currency order.customer.email email, hashed on the visitor
La página Orders muestra cómo se vinculó cada pedido, en la columna Matched by: thank_you, email, ip o not matched. Un pedido sin vincular sigue yendo a tus plataformas publicitarias con los datos del pedido, pero sin identificadores de clic, y la atribución de ROASaurus lo muestra como directo o desconocido.
Envío de las compras de Lightspeed a Meta y TikTok
Cada pedido pagado se convierte en un evento de servidor por plataforma conectada: un Purchase para la Conversions API de Meta y un CompletePayment para la Events API de TikTok, ambos con el id de evento order-ORD01042. TikTok ahora muestra CompletePayment como Purchase en sus informes. Cuando marcas la opción de cargar también el píxel del navegador, el fragmento de la página de agradecimiento dispara los mismos eventos en el navegador con el mismo id de evento. Entonces Meta y TikTok se quedan con una sola copia.
- Id de evento, hora del evento, valor y moneda
- Ids de producto, cantidades y precios
- Email, teléfono, nombre, ciudad, código postal y país con hash
- Dirección IP y navegador
- fbc y fbp cuando el pedido está vinculado
- Id de evento, hora del evento, valor y moneda
- Productos con id, nombre, cantidad y precio
- Email y teléfono con hash
- Dirección IP y navegador
- ttclid y ttp cuando el pedido está vinculado
Los mismos pedidos van a Snapchat, Pinterest, Reddit, X, Microsoft Ads, Taboola, LinkedIn y las demás plataformas publicitarias cuando las conectas. Las conversiones de compra de Google Ads solo se envían desde el checkout de Shopify, así que ROASaurus no las envía desde Lightspeed. Para la parte de Meta de la configuración, consulta la guía de la Meta Conversions API.
Cómo configurar el tracking de conversiones de Lightspeed
- Añade la tienda en ROASaurus
Ve a Add a store, elige Lightspeed eCom e introduce la dirección de tu tienda. La pestaña Connection te muestra entonces tu etiqueta de script y el fragmento de la página de agradecimiento.
- Añade el script a todas las páginas
En el back office de Lightspeed, ve a Settings › Website Settings › Web Extras › Custom JavaScript y pega la etiqueta de script. Lightspeed ejecuta este código en todas las páginas.
- Añade el fragmento de la página de agradecimiento
En la misma página, en el área Tracking, activa Status y pega el fragmento. Lightspeed lo ejecuta en la página Thank You después de un pedido.
- Crea una clave de API
Ve a Settings › Store Settings › Developers › New API key. Activa la clave, marca el acceso de lectura a los pedidos, guarda y selecciona Show para ver el secreto.
- Conecta la API
En la pestaña Connection, introduce la clave, el secreto, la región y el idioma de la tienda. Guarda, pulsa Test connection y después Create webhook.
- Conecta tus plataformas publicitarias
En Tracking & platforms, usa Connect with Facebook o Add pixel para Meta, y Add pixel para TikTok con el código del píxel y un token de acceso de la Events API. Marca la opción de cargar también el píxel del navegador.
API key (Settings › Store Settings › Developers)
API secret (select Show next to the key)
Region eu → api.webshopapp.com
us → api.shoplightspeed.com
Shop language nl, en, de ... (the code in your API addresses)Consentimiento
Fuera de Shopify, el script de ROASaurus lee la decisión del visitante en las herramientas de consentimiento habituales: Cookiebot, OneTrust, los banners IAB TCF y Google consent mode. Con otro banner de cookies, llama a tlq('consent', true) cuando el visitante acepte las cookies de marketing y a tlq('consent', false) cuando las rechace. Hasta que el visitante acepte, no tiene id de visitante ni click ids, y no se dispara ningún píxel del navegador. El pedido pagado se sigue enviando desde el servidor con datos del cliente con hash a partir del pedido y con la dirección IP y el navegador del pedido. La página de ayuda sobre consentimiento explica los detalles.
¿Cómo se prueba el tracking de conversiones de Lightspeed?
- Abre tu tienda con
?roasaurus=connecteden la dirección. Una alerta confirma que el script se ejecuta.?roasaurus=debugregistra en la consola del navegador lo que envía. - En el Event log, en Collected events, las visitas de página deberían mostrar un id de visitante.
- Haz un pedido y asegúrate de que su estado de pago sea paid. En Collected events, el Event log debería mostrar entonces un Purchase con tu número de pedido en sus datos. Si falta, comprueba que Status esté activado en el área Tracking.
- En la pestaña Connection, Last order received muestra el pedido y Last sync muestra la última comprobación de 5 minutos, con cualquier error de Lightspeed.
- En Server deliveries del Event log, cada plataforma conectada tiene una línea con el estado sent y la respuesta de la plataforma.
PageView visitor 7d1e04b2Script en todas las páginasPurchase order-ORD01042Fragmento de la página de agradecimiento, píxeles del navegador disparadoswebhook orders updatedPedido ORD01042, estado de pago paidMeta Purchase sentMatched by thank_youTikTok CompletePayment sentMismo id de evento, deduplicadoPara ver el evento en Meta, pega el código de Events Manager › Test events en el campo Test event code de tu píxel de Meta en ROASaurus y quítalo cuando termines. Los ajustes del píxel de TikTok en ROASaurus tienen el mismo campo.
Límites y casos límite
- Solo C-Series. Las tiendas Lightspeed eCom con E-Series no pueden usar este conector.
- Solo pedidos pagados. Un pedido parcialmente pagado se envía cuando su estado de pago cambia a paid.
- Pagos tardíos y el límite de 7 días de Meta. Meta acepta eventos del servidor hasta 7 días después de la hora del evento. ROASaurus usa la hora de creación del pedido, así que Meta rechaza un pedido pagado más de 7 días después de haberse hecho.
- Compras del navegador antes del pago. El fragmento de la página de agradecimiento se ejecuta cuando se hace el pedido, así que los píxeles del navegador informan de un pedido por transferencia bancaria antes de que se pague. Si el pago llega más de 48 horas después, Meta y TikTok no pueden fusionar las copias del navegador y del servidor.
- Las cancelaciones y los reembolsos no se envían. Una vez enviada una compra, se queda en la plataforma publicitaria.
- Solo visualizaciones de página, sin código. Las visualizaciones de producto y los añadidos al carrito se detectan automáticamente solo en Shopify. En Lightspeed, un desarrollador puede enviarlos con una llamada de seguimiento
tlq. - Límites de la API. Lightspeed permite 300 solicitudes cada 5 minutos, 3,000 por hora y 12,000 por día por clave de API. Si otra herramienta usa la misma clave, comparten estos límites. Lightspeed pide que los contactes para obtener una segunda clave.
La página de la integración con Lightspeed reúne los datos de la conexión en un solo lugar, y la página de ayuda para otras tiendas online compara Lightspeed con las demás plataformas a las que se conecta ROASaurus.
Fuentes
- Lightspeed eCom (C-Series) Help Center: Adding a web tracking code
- Lightspeed eCom (C-Series) Help Center: Creating API keys
- Lightspeed eCom developers: Webhooks
- Lightspeed eCom developers: Order
- Lightspeed eCom developers: Rate limiting
En ROASaurus
- Integración con Lightspeed
- Ayuda: Wix, Lightspeed y otras tiendas online
- Server-side tracking
- Integración con Meta