Server-side tracking para Squarespace Commerce
ROASaurus lee los pedidos pagados de la Commerce API de Squarespace cada 5 minutos y los envía a tus plataformas publicitarias desde el servidor. Un fragmento en la página de estado del pedido vincula cada pedido con el clic en el anuncio.
| Squarespace de un vistazo | |
|---|---|
| Los pedidos llegan por | Consulta de la Commerce API cada 5 minutos |
| Credenciales | Clave de API de desarrollador con Orders: read |
| Plan | Las claves de API requieren el plan Commerce Advanced |
| Pedidos pagados | Estado de pago PAID |
| Fragmento de la página de agradecimiento | Inyección de código en la Order Status Page, usando {orderId} y {orderGrandTotal} |
Cómo se conecta Squarespace
- Settings › Advanced › Code Injection › Header: pega la etiqueta de script de ROASaurus.
- En la misma página, en Order Status Page (y en Order Confirmation Page para productos digitales), pega el fragmento de la página de agradecimiento.
- Settings › Advanced › Developer API Keys › Generate Key con Orders: read, e introdúcela en ROASaurus.
Por qué consulta periódica y no webhooks
Squarespace envía webhooks solo a apps OAuth, no a integraciones que un comerciante configura con una clave de API. Por eso ROASaurus obtiene los pedidos modificados desde su última ejecución, cada 5 minutos, con un solapamiento de 30 minutos. Se envían los pedidos con estado de pago PAID; los duplicados se ignoran.
Cómo vincular los pedidos con los clics en anuncios
El fragmento usa las variables propias de Squarespace, {orderId}, {orderGrandTotal} y {customerEmailAddress}, para disparar la compra de ROASaurus con el mismo id de pedido. Está envuelto en {.if firstPageView}, de modo que un comprador que recarga la página de estado del pedido no lo dispara dos veces. Sin el fragmento, ROASaurus recurre a un email que el visitante dio antes en tu sitio, por ejemplo en un popup.
Qué lee ROASaurus de cada pedido
El número de pedido, el total general y la moneda, el email y el id del cliente, el nombre, el teléfono y la dirección de facturación, y el producto, la variante, la cantidad, el precio pagado y el SKU de cada línea de pedido.
Límites
- Las claves de API requieren el plan Commerce Advanced.
- Los pedidos llegan hasta 5 minutos después del pago. "Fetch orders now" sincroniza a demanda.
- Los pedidos de Squarespace no incluyen la dirección IP del comprador, así que la alternativa por IP no está disponible. Añade el fragmento.
- El conector está construido a partir de la documentación oficial de la API de la plataforma. Pulsa Test connection tras guardar tus credenciales, luego haz un pedido de prueba y comprueba el Event log.
Relacionado
Tus preguntas, resueltas
¿Qué plan de Squarespace necesito?
Las claves de API de desarrollador para pedidos requieren el plan Commerce Advanced. El script de tracking y el fragmento funcionan mediante la inyección de código (Code Injection).
¿Por qué Squarespace no puede enviar los pedidos al instante?
Squarespace solo envía webhooks a apps OAuth, no a claves de API de comerciantes. ROASaurus consulta en su lugar la Commerce API cada 5 minutos.
¿Contará dos veces una recarga de la página del pedido?
No. El fragmento solo se ejecuta en la primera visualización de la página de estado del pedido, y ROASaurus ignora una segunda compra con el mismo id de pedido.
Cada venta, rastreada hasta el anuncio que la generó
Server-side tracking, beneficio y valor de vida del cliente en una sola app. Prueba gratuita de 14 días, sin tarjeta de crédito.
Empieza tu prueba gratuita →