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.
mb.trackClick('sku-001', {
query: 'hidratante',
position: 1,
channel: 'overlay',
});Llamala desde el handler onClick del resultado:
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:
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:
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:
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.