El checkout de Shopify corre en un dominio separado del resto de tu storefront, por lo que el script normal de tracking no puede seguir a los visitantes a través de él. Para capturar las completitudes de checkout, usa uno de los dos hooks nativos de Shopify a continuación.
Enfoque 1 — Pixel de Customer Events (recomendado)
La API Customer Events de Shopify corre en un iframe sandbox en todas las páginas del checkout, incluyendo el paso de éxito. Es la forma soportada de añadir pixels de tracking en 2026.
- En tu admin de Shopify, ve a Settings → Customer events → Add custom pixel.
- Llámalo "Zenovay tracker".
- Pega este código:
analytics.subscribe('checkout_completed', (event) => {
const checkout = event.data.checkout;
// Carga el tracker Zenovay dentro del sandbox del pixel
const script = document.createElement('script');
script.src = 'https://api.zenovay.com/z.js';
script.setAttribute('data-tracking-code', 'YOUR_TRACKING_CODE');
script.defer = true;
script.onload = () => {
// ('revenue', amount, currency, properties)
window.zenovay('revenue',
Number(checkout.totalPrice.amount),
checkout.totalPrice.currencyCode,
{
order_id: checkout.order.id,
item_count: checkout.lineItems.length
}
);
};
document.head.appendChild(script);
});
- Haz clic en Save y Connect. Los Customer Events corren automáticamente en cada checkout a partir de ahora.
Enfoque 2 — JS de Order Status (legacy)
Para tiendas Shopify Plus o themes antiguos que no han migrado, todavía puedes inyectar script en Settings → Checkout → Order status page → Additional scripts:
<script>
(function() {
var script = document.createElement('script');
script.src = 'https://api.zenovay.com/z.js';
script.setAttribute('data-tracking-code', 'YOUR_TRACKING_CODE');
script.defer = true;
script.onload = function() {
window.zenovay && window.zenovay('revenue',
{{ checkout.total_price | money_without_currency | replace:',','.' }},
'{{ shop.currency }}',
{ order_id: '{{ checkout.order_id }}' }
);
};
document.head.appendChild(script);
})();
</script>
Los placeholders Liquid de doble llave los rellena Shopify en el momento de la confirmación de pedido.
Importante: qué pasa con carritos abandonados
Ninguno de los enfoques se dispara para carritos abandonados — por diseño, sólo quieres contar compras completadas. Para rastrear el abandono del funnel de carrito abandonado, instala el tracker normal en tu storefront y crea un funnel: /cart → /checkouts/... → goal purchase.
Verificar que funciona
- Haz un pedido de prueba en tu tienda (usa Bogus Gateway en modo dev si no quieres cobrar una tarjeta real).
- Abre el dashboard de tu sitio en Zenovay y cambia a la pestaña Live View. En ~30 segundos, la nueva sesión y la conversión deberían aparecer.
- El revenue también debe reflejarse en la pestaña Revenue.
Si el evento no aparece:
- Abre la página de estado del pedido en DevTools → pestaña Network y busca una petición a
api.zenovay.com. Si falta, tu snippet no se ejecutó. - Comprueba que
YOUR_TRACKING_CODEes el valor correcto. Puedes encontrarlo en el snippet de instalación de tu sitio (el atributodata-tracking-code) — ver Visión general de la integración con Shopify para donde se muestra. - Para el Enfoque 1, ve la previsualización del pixel en vivo en Customer Events → [Tu pixel] → Test.
Disponibilidad por plan
El tracking de revenue está en plan Pro y superiores. Los usuarios Free pueden todavía enviar un goal purchase con cualquier enfoque, pero la pestaña Revenue y la atribución de revenue se mantienen bloqueadas hasta que actualices.