Búsqueda de productos en el sitio web
La búsqueda de productos es un cuadro de búsqueda en el sitio web con sugerencias mientras se escribe y una página de resultados que OneTrace.ru llena con productos de su catálogo. La búsqueda entiende errores tipográficos, formas de las palabras y consultas escritas con la distribución de teclado equivocada, y ordena los primeros resultados según los intereses del visitante: lo que ha visto y comprado.
Para que funcione se necesitan el rastreador instalado (Conexión del sitio web) y un catálogo de productos (Recomendaciones y catálogo de productos). La búsqueda no está incluida en todos los planes: si su plan no la incluye, el bloque con el código no se muestra en la pestaña de instalación y las solicitudes de búsqueda reciben el error «función no disponible».
Cómo se buscan los productos
- Las palabras de la consulta se buscan en el nombre, la marca, las categorías y las características del producto; el SKU, por coincidencia exacta.
- Se tienen en cuenta las formas de las palabras en los idiomas del proyecto: «куртки» encuentra «Куртка зимняя». Los idiomas se definen en la configuración del proyecto; consulte Configuración del proyecto, plan y auditoría.
- Los errores tipográficos se corrigen: «крутка» encuentra «куртку», y «dres», «dress».
- También funciona una consulta escrita con la distribución de teclado equivocada: «ghbdtn» se busca como «привет».
- Si no se encuentra nada con todas las palabras, la búsqueda muestra productos que contienen al menos una de ellas.
- Los productos populares y en stock aparecen más arriba. La popularidad se toma de las recomendaciones y se actualiza una vez al día.
- Los primeros resultados se reordenan según los intereses del visitante: suben los productos de las categorías y marcas que ha visto y comprado.
- Las medidas y los parámetros de la consulta, como «205/55 r16», «5x112» o «invierno», se convierten en filtros si el sector de la tienda los tiene.
Los productos nuevos y modificados del catálogo llegan a la búsqueda en menos de un minuto tras cargar el feed o hacer una solicitud a la API.
Cuadro de búsqueda
Añada el atributo data-cdp-search al campo de búsqueda de su sitio web:
<form action="/search">
<input name="q" data-cdp-search data-category-url="/catalog/{id}">
</form>
Al escribir, aparecen sugerencias debajo del campo: búsquedas populares del sitio, categorías coincidentes y productos con imagen y precio. Puede recorrerlas con las flechas; Enter abre la fila seleccionada y Esc cierra las sugerencias. Enter sin una fila seleccionada envía el formulario del sitio como de costumbre.
| Atributo | Qué define |
|---|---|
data-cdp-search |
conecta las sugerencias al campo |
data-category-url |
enlace a la página de la categoría, {id} se sustituye por el id de la categoría del catálogo; sin el atributo, las sugerencias no muestran categorías |
data-search-url |
dirección de la página de resultados para un campo sin formulario, {query} se sustituye por la consulta |
Las sugerencias usan la fuente del sitio y no contienen textos de interfaz, por lo que sirven para un sitio en cualquier idioma.
Página de resultados
Los plugins listos para tiendas en línea insertan los resultados en la página de búsqueda de la tienda por sí solos. En su propio sitio, obtenga los productos desde el rastreador:
window.addEventListener('load', async () => {
const q = new URLSearchParams(location.search).get('q');
const result = await cdp.search(q, { perPage: 24 });
// result.items — productos, result.total — cuántos se encontraron, result.facets — categorías, marcas, precios y características para los filtros
});
Parámetros: category, brand, priceMin, priceMax, sort (relevance, popular, price_asc, price_desc), page, perPage, attributes. Al hacer clic en un producto, llame a cdp.searchResultClicked(producto).
Filtros de características. result.facets.attributes contiene las características del sector de la tienda con etiquetas en el idioma del visitante y el número de productos de cada valor, por ejemplo, «Diámetro, pulgadas»: 16, 17, 18. Pase los valores elegidos en attributes: cdp.search(q, { attributes: { rim_diameter: [17, 18], season: 'winter' } }). Varios valores de una misma característica se combinan con «o», y características distintas, con «y». result.filters contiene las medidas y los parámetros reconocidos en el texto de la consulta: muéstrelos al visitante para que vea por qué se filtraron los resultados. Se necesita el rastreador 1.15.0.
Si la consulta tiene una regla de redirección (consulte Reglas de consultas), result.redirect contiene la dirección de la página: ábrala en lugar de los resultados.
Los servidores pueden hacer las mismas solicitudes con una clave de escritura: https://cdp.onetrace.ru/api/v1/search y https://cdp.onetrace.ru/api/v1/search/suggest. La lista completa de parámetros está en la referencia de la API: https://cdp.onetrace.ru/api/v1/openapi.json.
Informe de consultas
La pestaña Búsqueda de la sección «Sitio» muestra qué buscan los visitantes en su sitio web durante 7, 30 o 90 días:
- Búsquedas y visitantes: cuántas veces se buscó y cuántas personas distintas lo hicieron.
- Sin resultados: la proporción de búsquedas que no encontraron nada.
- CTR: la proporción de visitantes que hicieron clic en un producto de los resultados de su consulta.
- Compras e ingresos: un producto en el que se hizo clic en los resultados y que el mismo cliente compró en un plazo de 7 días. Los ingresos se calculan con el precio del producto en el catálogo. Se muestran si en la configuración de recomendaciones hay un evento de compra, consulte Recomendaciones y catálogo de productos.

Tablas debajo del gráfico:
| Tabla | Qué muestra |
|---|---|
| Populares | consultas por número de búsquedas |
| Sin resultados | consultas que nunca encontraron nada: una pista sobre productos o sinónimos que faltan |
| CTR bajo | consultas con al menos 5 búsquedas en las que se hace clic en menos del 10 %: los resultados no son los que se esperan |
Las consultas se comparan sin distinguir mayúsculas ni espacios sobrantes. Desde una fila de la tabla puede añadir de inmediato un sinónimo o una regla para la consulta.
Sinónimos
Los sinónimos son palabras y frases que se buscan juntas: una consulta con cualquier palabra del grupo también encuentra productos por las demás. Por ejemplo, con el grupo «zapatillas, deportivas, tenis», la consulta «deportivas blancas» también encuentra zapatillas blancas.
- Grupo en ambos sentidos: cada palabra se busca como las demás.
- Grupo en un sentido: solo la primera palabra se busca como las demás: «celular → smartphone» encuentra smartphones al buscar «celular», pero «smartphone» no se busca como «celular».
Una palabra o frase del grupo se sustituye en la consulta solo si aparece completa. Los sinónimos se aplican justo después de guardar, en resultados y sugerencias. Un proyecto puede tener hasta 500 grupos y un grupo hasta 20 palabras.
Reglas de consultas
Una regla se aplica cuando un visitante busca exactamente esta consulta (sin distinguir mayúsculas, espacios sobrantes ni signos en los extremos) y realiza una o ambas acciones:
- Productos fijados: hasta 24 productos, en el orden indicado, aparecen al principio de los resultados aunque la búsqueda no los encuentre. Los demás resultados siguen sin repeticiones. La fijación se aplica al ordenar por relevancia y sin filtros; los productos sin existencias no se muestran.
- Redirección: en lugar de los resultados se abre una página de su sitio web, por ejemplo «envío» → la página de condiciones de envío.

Las redirecciones las ejecutan el cuadro de búsqueda del rastreador (Enter en una consulta con regla), cdp.search() en su propia página de resultados (campo redirect) y los plugins de WooCommerce y Magento 2. Un proyecto puede tener hasta 1000 reglas.
Estadísticas
El rastreador registra dos eventos:
| Evento | Cuándo |
|---|---|
search |
se mostró la primera página de resultados; propiedades: query, la consulta; results, cuántos se encontraron |
search_result_clicked |
clic en un producto en los resultados o en las sugerencias; propiedades: query, product_id, position, source |
Las búsquedas populares de las sugerencias se forman a partir de los eventos search de los últimos 30 días. Los eventos se ven en la ficha del perfil del cliente y están disponibles en los segmentos, por ejemplo, «buscó, pero no compró»; consulte Segmentos.