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.
Qué reporta el widget (automático)
| Evento | Cuándo | Qué incluye |
|---|---|---|
| Búsqueda | El usuario lanza una query | Texto, filtros, locale, searchLogId |
| Click de producto | Click sobre una card de resultado | searchLogId, productId, source |
| Voz / imagen | Búsqueda iniciada por voz o imagen | Mismos campos que búsqueda textual |
Todos estos eventos viajan con el Widget Token. 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:
/api/integrations/v1/conversionsEsto cierra el funnel: click (automático, vía cookie) → conversión (server-to-server, llamada por ti).
Patrón completo (cookie neuroon_clicks, searchLogId) en Recipe · Conversion tracking.
Por qué la conversión va server-to-server
Un pixel JS pierde conversiones por adblockers, Safari ITP, CSPs estrictas. Llamar desde el handler de pedido confirmado en tu backend elimina esos vectores.
Cookie neuroon_clicks
El widget setea una cookie de primera parte para vincular clics con conversiones:
- Nombre:
neuroon_clicks path=/,SameSite=Lax,Secureen HTTPS- TTL: 14 días, máx ~4 KB
- Estructura:
productId → searchLogId - Sin PII (email, nombre, IP)
Próximas lecturas
- Recipe · Conversion tracking — flujo end-to-end con código.
- Eventos del widget — CustomEvents del DOM.