Configuración de análisis de e-commerce

Configure análisis para su tienda de e-commerce con eventos de productos personalizados, atribución de ingresos y embudos de conversión.

Descripción general de análisis de e-commerce

Al agregar el script de seguimiento de Zenovay y enviar algunos eventos personalizados desde su tienda, puede analizar:

Lo que rastrea	Cómo
Vistas de página y sesiones	Automático una vez instalado el script
Vistas de productos, acciones del carrito	Eventos personalizados vía zenovay('track', ...)
Ingresos y pedidos	Un proveedor de pago conectado (Stripe, PayPal o Paddle) o zenovay('revenue', ...)
Embudos de conversión	La pestaña Journeys o zenovay('defineFunnel', ...)
Recorrido del cliente	Ruta de compra en la pestaña Journeys

No hay un "modo de e-commerce" separado que habilitar. Instala el script de seguimiento estándar y luego envía eventos de tienda con la API de JavaScript.

Configuración específica de la plataforma

Shopify

Instale el script de seguimiento en su tema y luego envíe eventos de tienda.

1. En su administrador de Shopify, vaya a Online Store → Themes
2. En su tema activo, haga clic en Actions → Edit code
3. Abra Layout/theme.liquid
4. Pegue el script de seguimiento justo antes de la etiqueta de cierre </head>:

<script
  defer
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>

Para enviar eventos de producto y pedido, agregue un pequeño script después que se integre con las plantillas de producto y pago de su tema y llame a la API de Zenovay:

// Vista de producto (p. ej., en una plantilla de producto)
zenovay('track', 'product_viewed', {
  product_id: '{{ product.id }}',
  product_name: '{{ product.title }}',
  price: {{ product.price | divided_by: 100.0 }},
  currency: '{{ shop.currency }}'
});

// Agregar al carrito (conecte a su controlador de agregar al carrito)
zenovay('track', 'add_to_cart', {
  product_id: variantId,
  quantity: 1,
  price: price
});

// Compra (en la página de confirmación de pedido/gracias)
zenovay('revenue', orderTotal, currency, {
  order_id: orderId
});

WooCommerce

Agregue el script de seguimiento y ganchos de eventos a la functions.php de su tema (o un complemento de fragmentos de código):

// Agregar script de seguimiento de Zenovay
add_action('wp_head', function() {
  ?>
  <script
    defer
    data-tracking-code="YOUR_TRACKING_CODE"
    src="https://api.zenovay.com/z.js">
  </script>
  <?php
});

// Rastrear vistas de productos
add_action('woocommerce_after_single_product', function() {
  global $product;
  ?>
  <script>
    zenovay('track', 'product_viewed', {
      product_id: '<?php echo $product->get_id(); ?>',
      product_name: '<?php echo esc_js($product->get_name()); ?>',
      price: <?php echo $product->get_price(); ?>,
      category: '<?php echo esc_js(wc_get_product_category_list($product->get_id())); ?>'
    });
  </script>
  <?php
});

// Rastrear compras
add_action('woocommerce_thankyou', function($order_id) {
  $order = wc_get_order($order_id);
  ?>
  <script>
    zenovay('revenue', <?php echo $order->get_total(); ?>, '<?php echo $order->get_currency(); ?>', {
      order_id: '<?php echo $order_id; ?>'
    });
  </script>
  <?php
});

BigCommerce

Agregue a Storefront → Script Manager:

<script
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>
<script>
  // Seguimiento de producto de BigCommerce
  document.addEventListener('DOMContentLoaded', function() {
    if (typeof BCData !== 'undefined' && BCData.product_attributes) {
      zenovay('track', 'product_viewed', {
        product_id: BCData.product_attributes.sku,
        product_name: BCData.product_attributes.name,
        price: BCData.product_attributes.price.without_tax.value
      });
    }
  });
</script>

Tienda personalizada

Para cualquier plataforma, instale el script y llame a la API desde su propio código:

<script
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>

// Vista de producto
function trackProductView(product) {
  zenovay('track', 'product_viewed', {
    product_id: product.id,
    product_name: product.name,
    price: product.price,
    category: product.category,
    currency: 'USD'
  });
}

// Agregar al carrito
function trackAddToCart(product, quantity) {
  zenovay('track', 'add_to_cart', {
    product_id: product.id,
    product_name: product.name,
    quantity: quantity,
    price: product.price,
    cart_value: getCartTotal()
  });
}

// Eliminar del carrito
function trackRemoveFromCart(product) {
  zenovay('track', 'remove_from_cart', {
    product_id: product.id,
    product_name: product.name
  });
}

// Comenzar pago
function trackCheckoutStart(cart) {
  zenovay('track', 'checkout_started', {
    cart_value: cart.total,
    item_count: cart.items.length
  });
}

// Compra completada — use la API de ingresos para que cuente hacia la atribución
function trackPurchase(order) {
  zenovay('revenue', order.total, order.currency, {
    order_id: order.id,
    tax: order.tax,
    shipping: order.shipping
  });
}

Eventos personalizados de e-commerce

zenovay('track', name, properties) acepta cualquier nombre de evento y cualquier objeto de propiedad. Los nombres a continuación son una convención útil, no un esquema fijo. Manténgase coherente para que sus embudos e informes se alineen.

Evento sugerido	Propiedades útiles
product_viewed	product_id, product_name, price, category
add_to_cart	product_id, quantity, price, cart_value
remove_from_cart	product_id, quantity
checkout_started	cart_value, item_count
Compra	use zenovay('revenue', amount, currency, { order_id })

Propiedades del producto

{
  product_id: "SKU-123",
  product_name: "Blue T-Shirt",
  price: 29.99,
  currency: "USD",
  category: "Apparel/T-Shirts",
  variant: "Large/Blue",
  brand: "Acme",
  quantity: 1
}

Configuración de embudos de conversión

Los embudos se encuentran en la pestaña Journeys del panel de un sitio web.

1. Abra el panel de su sitio web (Domains → seleccione su sitio)
2. Abra la pestaña Journeys y luego la subpestaña Funnels
3. Haga clic en Add Funnel y defina los pasos

Cada paso puede ser una página o un evento personalizado. Un embudo de compra típico:

Paso	Evento/Página
1	Producto visto
2	Agregado al carrito
3	Pago iniciado
4	Compra completada

También puede definir un embudo en el código, que se crea automáticamente la primera vez que se ve:

zenovay('defineFunnel', 'checkout_flow', [
  { name: 'Product', event: 'product_viewed' },
  { name: 'Cart', event: 'add_to_cart' },
  { name: 'Checkout', event: 'checkout_started' }
]);

La subpestaña Goals en la misma pestaña Journeys le permite crear objetivos de conversión individuales (por ejemplo, una compra completada) con el botón Add Goal.

Informes de ingresos

Los informes de ingresos y atribución se encuentran en la pestaña Revenue del panel de un sitio web.

Conecte un proveedor de pago

La forma más confiable de rastrear ingresos es conectar su proveedor de pago para que Zenovay pueda vincular pedidos a sesiones de visitantes.

1. Abra el panel de su sitio web
2. Vaya a Settings → Revenue (configuración específica del dominio)
3. Conecte Stripe, PayPal o Paddle y guarde

Si no puede conectar un proveedor, envíe ingresos desde el cliente con zenovay('revenue', amount, currency, metadata).

Lo que muestra la pestaña Revenue

• Total Revenue: suma de pedidos registrados
• Orders: recuento de transacciones
• AOV: valor promedio de pedido
• Revenue by source: qué fuentes de tráfico generaron ingresos
• Attribution: ingresos distribuidos entre los canales en el recorrido del cliente

La atribución admite varios modelos (incluido primer toque, último toque y lineal). Los informes de ingresos requieren un plan Pro o superior.

Análisis del carrito

Una vez que envíe eventos add_to_cart e ingresos de manera consistente, puede crear embudos relacionados con el carrito y descubrir dónde los compradores abandonan entre el carrito y la compra.

// Carrito actualizado
zenovay('track', 'cart_updated', {
  cart_value: 149.99,
  item_count: 3
});

// Carrito visto
zenovay('track', 'cart_viewed', {
  cart_value: 149.99,
  item_count: 3
});

Prueba su configuración

Verificar seguimiento

1. Abra su tienda
2. Cargue el script en modo de depuración agregando data-debug="true" a la etiqueta de script, o ejecute zenovay('debug') en la consola del navegador
3. Realice acciones:
   • Vea un producto
   • Agregue al carrito
   • Inicie el pago
   • Complete una compra de prueba
4. Observe la consola del navegador para mensajes de Zenovay
5. Confirme que la actividad aparece en su panel de Zenovay

Compra de prueba

1. Utilice un pago de prueba si está disponible
2. Complete un pago completo
3. Confirme que el pedido aparece en la pestaña Revenue
4. Verifique que se atribuya a la fuente correcta

Problemas comunes

Los ingresos no se muestran

• Confirme que el evento revenue se dispara en la página de confirmación de pedido (o que su proveedor de pago está conectado)
• Verifique que el monto sea un número
• Asegúrese de que el evento se dispara después de que se carga el script

Los productos no se rastrean

• Verifique que el evento product_viewed se dispara
• Compruebe que product_id sea consistente entre eventos
• Asegúrese de que el script esté en todas las páginas de productos

El abandono del carrito se ve mal

• Rastreé checkout_started de manera consistente
• Dispare el evento revenue solo una vez por pedido
• No rastreé reembolsos como nuevas compras

Mejores prácticas

1. Utilice ID de producto consistentes

   • El mismo ID en todos los eventos
   • Un SKU o ID de base de datos funciona bien

2. Incluya datos de transacción clave

   • Monto y moneda
   • ID de pedido para deduplicación

3. Rastree el viaje completo

   • Desde la primera compra
   • Envíe los eventos correspondientes en cada paso

4. Pruebe exhaustivamente

   • Verifique primero en staging
   • Pruebe todos los tipos de productos
   • Confirme la precisión del embudo

Próximos pasos

• Seguimiento de ingresos de e-commerce
• Optimización de conversión
• Análisis de abandono del carrito