Analytics y tracking

El widget reporta eventos al backend de Neuroon automáticamente. Tu integración no los emite — los consume el bundle del CDN cuando el usuario interactúa con la UI. Esta página describe qué se reporta y cuál es el único endpoint que tú llamas: la atribución de conversiones server-to-server.

Qué reporta el widget (automático)

Evento	Cuándo	Qué incluye
Búsqueda	El usuario lanza una query	Texto, filtros, locale, searchLogId (devuelto en la respuesta)
Click de producto	Click sobre una card o CTA del resultado	searchLogId, productId, posición
Impresión de resultados	Resultados visibles en viewport	searchLogId, lista de productId mostrados
Voz/imagen	Búsqueda iniciada por modal de voz/imagen	Mismos campos que búsqueda + flag de modalidad
Vista de carrito guiado	El usuario abre un kit/buyers guide/comparación	searchLogId, ids de productos mostrados

Todos estos eventos viajan hacia el backend usando el Widget Token que ya tiene el bundle. No tienes que llamar ningún endpoint para que esto funcione.

El único endpoint que llamas tú: atribución de conversiones

Para que Neuroon atribuya el revenue del pedido a la búsqueda que lo originó, tu servidor debe llamar a:

POST/api/plugin/shops/{shopId}/track/conversion

Esto cierra el funnel: click (automático, vía cookie) → conversión (server-to-server, llamada por ti). Sin esa llamada, los clicks quedan sin venta atribuida.

Patrón completo (cookie neuroon_clicks, searchLogId, gateways cross-origin, Node/.NET/Python/PHP) en Recipe · Conversion tracking.

Por qué la conversión va server-to-server

Confiar solo en un pixel JS pierde una parte significativa de las conversiones (adblockers, Safari ITP, CSPs estrictas, service workers offline). Llamar el endpoint desde el handler de pedido confirmado en tu backend elimina esos vectores y deja la atribución estable. Detalle en el recipe enlazado arriba.

Privacidad

• El widget no envía PII (email, nombre, IP de cliente) en los eventos automáticos.
• El searchLogId es opaco: identifica una sesión de búsqueda anónima en el lado de Neuroon.
• El cookie neuroon_clicks que el widget setea es de primera-parte, Lax, máx 4 KB y sólo contiene productId → searchLogId. Sin información del usuario.
• Si tu sitio integra un consent manager (GDPR/CCPA), respeta los flags antes de cargar el <script> del widget — el widget no se puede deshabilitar a posteriori.

Próximas lecturas

• Recipe · Conversion tracking — flujo end-to-end con código.
• API · POST /track/conversion — referencia del endpoint.
• Eventos del widget — CustomEvents del DOM que tu host puede escuchar.