Cómo enviar eventos de comprador a Shoply AI desde una tienda Shopify headless

Shoply AI rastrea el comportamiento de los compradores (agregar al carrito, checkout, visualizaciones de producto, etc.) para mejorar el ranking de búsqueda y las recomendaciones. En los storefronts estándar de Shopify, esto ocurre automáticamente mediante nuestra extensión Web Pixel . Sin embargo, Shopify Web Pixels no se ejecutan en storefronts headless porque dependen del motor de renderizado de storefronts de Shopify para inyectar el sandbox del píxel.

Si tienes una tienda Shopify headless (por ejemplo, con Next.js, Hydrogen o un frontend personalizado), necesitas enviar estos eventos directamente desde el código de tu frontend.

¿Usas Hydrogen? La integración automática con Hydrogen se activa por sí sola y rastrea las adiciones al carrito mediante el CartForm de Hydrogen, las páginas de producto abiertas desde enlaces de Shoply y los pedidos completados por ti. Solo necesitas esta página para adiciones realizadas sin CartForm; consulta el ejemplo de Hydrogen.


Requisitos previos

  • Has instalado Shoply AI y el script de Shoply AI está cargado en tu storefront.

Envío de un evento

Una vez que el script de Shoply AI está cargado, expone window.shoplyLogEvent automáticamente. Llámalo directamente; no necesitas gestionar IDs de sesión, claves de tienda ni endpoints de API por tu cuenta:

js
window.shoplyLogEvent(eventName, data)

La forma del objeto data depende del tipo de evento (ver abajo).


Eventos obligatorios para admitir el seguimiento de conversiones

product_added_to_cart

Activa esto cuando un comprador agrega una variante de producto a su carrito.

js
await window.shoplyLogEvent('product_added_to_cart', { "cartLine": { "cost": { "totalAmount": { "amount": 769, "currencyCode": "USD" } }, "merchandise": { "id": "42553607094387", // Variant ID (a "gid://shopify/ProductVariant/..." ID also works) "title": "25.5 Mondo", "price": { "amount": 769, "currencyCode": "USD" }, "product": { "id": "7834124058739" // Product ID (a "gid://shopify/Product/..." ID also works) } }, "quantity": 1 }, "clientId": "35214700-144e-4022-974e-fe008736e973", // Not used "referrer": "https://demo.shoplyai.ai/collections/all" })

checkout_completed

Si estás usando el checkout nativo de Shopify, normalmente no necesitas esto, ya que usamos eventos de web pixel para rastrear automáticamente la finalización del checkout. Sin embargo, si tienes tu propio flujo de checkout, activa esto cuando un comprador complete el checkout (por ejemplo, en tu página de confirmación de pedido).

js
await window.shoplyLogEvent('checkout_completed', { "token": "8cea7db9ce551f0a8c9113a0f7f2dce0", // Not used "order": { "id": "7251060916339", // Shopify Order ID "customer": { "id": "9903183265907", // Shopify Customer ID "isFirstOrder": true } }, "lineItems": [ { "finalLinePrice": { "amount": 1538, "currencyCode": "USD" }, "quantity": 2, "variant": { "id": "42553607094387", // Variant ID "title": "25.5 Mondo", "price": { "amount": 769, "currencyCode": "USD" }, "product": { "id": "7834124058739" // Product ID } } }, { "finalLinePrice": { "amount": 384.93, "currencyCode": "USD" }, "quantity": 1, "variant": { "id": "42553643958387", "title": "157 CM", "price": { "amount": 384.93, "currencyCode": "USD" }, "product": { "id": "7834140180595" } } } ], "clientId": "35214700-144e-4022-974e-fe008736e973", // Not used "referrer": "https://demo.shoplyai.ai/cart" })

¿Necesitas ayuda?

No dudes en reservar una reunión con nosotros  y te ayudaremos a integrar el seguimiento de eventos en tu storefront headless.