Skip to content

Tracking

El SDK envuelve los endpoints de /track/* para que los uses con tipos y sin construir payloads a mano.

mb.trackClick(itemId, options)

Registra un click sobre un resultado de busqueda.

ts
mb.trackClick('sku-001', {
  query:    'hidratante',
  position: 1,
  channel:  'overlay',
});

Llamala desde el handler onClick del resultado:

ts
function ResultCard({ item, query, position }) {
  return (
    <a
      href={item.url}
      onClick={() => mb.trackClick(item.id, { query, position, channel: 'overlay' })}
    >
      {item.name}
    </a>
  );
}

mb.trackConversion(options)

Registra una compra que vino de una busqueda. Llamala desde la pagina de confirmacion de pedido:

ts
mb.trackConversion({
  itemId:   'sku-001',
  orderId:  '12345',
  revenue:  24.90,
  currency: 'EUR',
});

Si tu pagina de confirmacion recibe el pedido completo, llama una vez por cada line item:

ts
order.items.forEach((item) => {
  mb.trackConversion({
    itemId:   item.sku,
    orderId:  order.id,
    revenue:  item.subtotal,
    currency: order.currency,
  });
});

mb.getSessionId()

Devuelve el sessionId actual. Util si quieres incluirlo en otros eventos de tu stack (Mixpanel, GA4, etc.) para cruzar la sesion de Mibizum con la tuya:

ts
mixpanel.track('search', {
  mibizum_session: mb.getSessionId(),
  query,
});

Privacidad

WARNING

El SDK genera el sessionId en localStorage con TTL de 24h. Si tu politica de cookies o tu banner de consentimiento requiere opt-in, no llames a Mibizum.init() hasta que el cliente haya consentido. El widget oficial lo respeta automaticamente; en integraciones custom es tu responsabilidad.

Documentacion oficial de Mibizum.