Widgets de recomendaciones en el sitio web
Un widget es un bloque de productos listo para el sitio web: «También le puede interesar» en la página de inicio, «Comprados juntos» en la ficha de producto, «Vistos recientemente» en el carrito. Lo configura en OneTrace.pro e inserta un código breve en el sitio web una sola vez. Después, el tipo, el diseño, las reglas de visualización y la activación se cambian sin tocar el sitio.
Para que funcione se necesitan el rastreador instalado (Conexión del sitio web), un catálogo de productos y eventos de vistas, carrito y compras (Recomendaciones y catálogo de productos). Pueden crear y modificar widgets «Propietario», «Administrador» y «Gestor»; los demás ven la configuración y las estadísticas, pero no pueden guardar cambios.
Lista de widgets
Abra Sitio web → Widgets. La tarjeta de cada widget muestra el estado, las estadísticas de 30 días, la comparación de variantes si las hay y el código para el sitio web.

El interruptor Mostrar en el sitio web desactiva el widget sin tocar el sitio: el estado cambia a «En pausa» y el bloque de la página se vacía. Vuelva a activarlo y los productos regresarán. El botón de la papelera elimina el widget por completo.
Para crear un widget, pulse Crear widget. Para modificarlo, pulse su nombre o el botón del lápiz. Ambas acciones abren la página del editor.
Editor del widget
A la izquierda está la configuración, en cuatro secciones: Productos, Aspecto, Mostrar y Variantes. A la derecha, la vista previa: dibuja el widget igual que en el sitio web, con productos reales de su catálogo. Si una sección tiene un error, aparece una marca junto a su nombre. Pulse Guardar: los cambios se verán en el sitio web en la siguiente carga de la página, sin cambiar el código. Si sale de la página con cambios sin guardar, el navegador le avisará.

El selector Escritorio / Teléfono sobre la vista previa muestra ambas disposiciones. En el sitio web, la disposición se adapta al ancho del espacio disponible, no al de la pantalla: en una columna estrecha, el widget se ve igual que en el teléfono. El widget toma la fuente y el color del texto del sitio web, salvo que usted defina los suyos.
Productos
| Campo | Qué define |
|---|---|
| Nombre | nombre del widget; solo se ve en el panel de administración |
| Qué mostrar | tipo de recomendación: Personalizados, Populares, En tendencia, Vistos juntos, Comprados juntos, Similares, Vistos recientemente, Hora de reponer |
| Categoría | para populares y en tendencia: id de la categoría del catálogo; vacío, todo el catálogo |
| Productos en total | de 1 a 24 |
| Producto para la vista previa | para «Vistos juntos», «Comprados juntos» y «Similares»: id del producto con el que se genera la vista previa; vacío, el primer producto disponible |
Si no hay productos adecuados, la vista previa muestra marcadores grises para que pueda valorar el diseño.
Aspecto
| Campo | Qué define |
|---|---|
| Encabezado | texto sobre los productos, por ejemplo «También le puede interesar» |
| Botón | texto del botón de la tarjeta, por ejemplo «Más información»; vacío, sin botón |
| Disposición | Cuadrícula o Carrusel con desplazamiento |
| Tarjetas por fila | de 1 a 8 |
| Mostrar precio | precio en la tarjeta |
| Estilos predefinidos | «Como en el sitio web», «Tarjetas», «Minimalista», «Contraste»: rellenan los campos de diseño, que después puede cambiar |
| Qué muestra la tarjeta | marca, precio anterior, insignia de descuento, borde y sombra de la tarjeta |
| Proporciones de la imagen e Imagen | 1:1, 3:4 o 4:3; imagen completa o que rellena el espacio recortando los bordes |
| Colores | acento, fondo de la tarjeta, fondo de la imagen, texto, precio, botón y texto del botón; sin color, como en el sitio web, y el fondo de la imagen, blanco |
| Tamaño del texto, Tamaño del encabezado, Encabezado | tamaños en porcentaje de la fuente del sitio web y alineación del encabezado |
| Radio de las esquinas, Espacio entre tarjetas, Margen interior de la tarjeta | en píxeles |
| Flechas del carrusel | botones de desplazamiento en los bordes del carrusel |
| Teléfono | tarjetas por fila en pantallas estrechas (de 1 a 3) y una disposición propia, por ejemplo carrusel en lugar de cuadrícula |
| CSS propio | reglas para las clases del widget: .cdp-rec__name, .cdp-rec__price, .cdp-rec__button y otras |
El CSS propio se aplica solo dentro de este widget y no cambia el resto de la página. No puede cargar recursos externos: @import, url() y construcciones similares se rechazan al guardar.
Si el proyecto tiene varios idiomas, sobre el encabezado aparece el selector Idioma de los textos. En el idioma predeterminado se rellenan el Encabezado y el Botón; en los demás idiomas, sus traducciones; un campo vacío muestra el texto del idioma predeterminado. El visitante ve el encabezado y el botón en su idioma, el mismo que el rastreador envía al perfil (Idioma del cliente); sin traducción, en el idioma predeterminado. Los precios se muestran en el formato del idioma del visitante.
Estilo desde una imagen
El botón Estilo desde una imagen de la sección Aspecto ajusta el diseño a partir de una captura de pantalla con tarjetas de productos, de su sitio web o de otro que le guste.
- Pulse Estilo desde una imagen.
- Arrastre la imagen, péguela desde el portapapeles (Ctrl+V) o elija un archivo: PNG, JPEG o WebP de hasta 3 MB.
- Si el widget tiene variantes, elija a cuál aplicar el estilo.
- Pulse Ajustar el estilo.
La IA rellenará los colores, los tamaños, los radios de las esquinas, la disposición y lo que muestra la tarjeta, y añadirá en CSS propio lo que los ajustes no permiten. Cada valor se comprueba igual que al introducirlo a mano, y los que no son válidos se descartan. El resultado es un borrador: revise la vista previa y guarde, o pulse Deshacer.

La imagen no se guarda. El ajuste se paga del saldo del proyecto según el consumo real; si el saldo no alcanza o la IA no está incluida en el plan, el botón no está disponible y debajo se indica el motivo.
Mostrar

| Campo | Qué define |
|---|---|
| Mostrar en el sitio web | activación del widget, igual que en la lista |
| Solo en las páginas y Excepto en las páginas | direcciones de páginas sin dominio, una por línea; * equivale a cualquier secuencia de caracteres, por ejemplo /catalog/*. Vacío, en todas las páginas |
| Dispositivos | todos, solo ordenadores o solo móviles |
| Visitantes | todos, solo nuevos o solo recurrentes |
| Solo a miembros de segmentos y Excepto miembros de segmentos | segmentos del visitante; la pertenencia se comprueba en el perfil en cada visualización |
El servidor comprueba las reglas cada vez que se carga el widget. Fuera de las reglas, el espacio de la página queda vacío y el diseño no se rompe. Las reglas son las mismas que en los formularios de suscripción.
Aquí también está el Código para el sitio web, que se describe más abajo.
Variantes
Las variantes sirven para comprobar qué encabezado, tipo de recomendación o diseño generan más clics y compras. La configuración principal del widget es la variante A. Pulse Añadir variante para añadir hasta tres variantes: B, C y D. En cada una puede cambiar:
- el tipo de recomendación, en Qué mostrar;
- el Encabezado y el Botón, con sus traducciones;
- la disposición y todo el diseño.
Los campos vacíos se toman de la variante A.

Los visitantes se reparten entre las variantes a partes iguales, y cada visitante ve siempre la misma variante. El selector sobre la vista previa muestra la variante elegida. Los resultados de la comparación están en las estadísticas, debajo del editor.
Ver en su sitio web
El botón Ver en su sitio web sobre la vista previa abre una página de su sitio web con el widget tal como está guardado. Indique la dirección de una página donde esté insertado el código del widget, elija la variante y pulse Abrir.
Así el widget se ve aunque esté desactivado o la página no cumpla las reglas de visualización. Las impresiones y los clics en este modo no se cuentan en las estadísticas. El enlace es válido durante 24 horas; mientras la pestaña esté abierta, el modo de vista previa se mantiene también al navegar por las páginas del sitio. Los cambios sin guardar no se ven en el sitio web: guárdelos primero.
Código para el sitio web
El código del widget está en su tarjeta de la lista y en la sección Mostrar del editor. Insértelo en la plantilla de la página donde deba aparecer el bloque:
<div data-cdp-widget="a1b2c3d4e5f6" data-item="SKU-1"></div>
Atributos:
data-item: id del producto de la página o de los productos del carrito separados por comas:data-item="SKU-1,SKU-7". Es obligatorio para los tipos «Vistos juntos», «Comprados juntos» y «Similares»; insértelo desde la plantilla de la página.data-category: id de la categoría para los productos populares, si en distintas páginas se necesitan categorías distintas.data-exclude: id de productos separados por comas que no deben mostrarse, por ejemplo los que ya están en el carrito.
Los productos personalizados y los vistos recientemente se seleccionan según el visitante, por lo que no necesitan data-item.
Si no hay productos adecuados, el espacio de la página queda vacío y el diseño no se rompe.
Estadísticas
Debajo del editor están las estadísticas del widget de 7, 30 o 90 días: totales, gráfico por días y comparación de variantes. Sobre el gráfico, elija el indicador: impresiones, clics, CTR o ingresos. Si el widget tiene variantes, cada una tiene su propia línea en el gráfico.

| Indicador | Cómo se calcula |
|---|---|
| Impresiones | el widget entró en el campo visual del visitante al menos en la mitad. Cargar la página sin desplazarse hasta el bloque no cuenta, por lo que el CTR de un widget al final de la página es fiable |
| Clics | clics en las tarjetas de productos |
| CTR | clics divididos entre impresiones |
| Compras | compras del producto por el mismo cliente en los 7 días siguientes al clic en él; en el gráfico, el día del primer clic |
| Ingresos | importe de esas compras |
Los días se cuentan en UTC. Las impresiones y los clics de la vista previa en su sitio web no se cuentan.
La tabla de variantes muestra las impresiones, los clics, el CTR, las compras y los ingresos de cada variante. Debajo hay una conclusión por clics y por compras por impresión: qué variante es mejor y si ya hay datos suficientes para fiarse de ella. Mientras haya pocos datos, la conclusión lo indica: espere en lugar de elegir una variante por una diferencia casual.
El efecto general de las recomendaciones en el sitio web por tipo está en la sección Recomendaciones.
Sitios de una sola página
El rastreador encuentra los widgets por sí mismo al cargar la página, cuando aparecen elementos nuevos y cuando cambia data-item. Por eso, en sitios hechos con React, Vue y similares basta con cambiar el atributo: el bloque se volverá a dibujar.
Si necesita actualizar los productos sin cambiar los atributos, por ejemplo después de modificar el carrito, llame a:
cdp.widgets({ force: true });
Código propio en lugar de un widget
Los desarrolladores pueden mostrar un bloque de recomendaciones desde el código, sin configurarlo en el panel de administración:
window.addEventListener('load', () => {
cdp.renderRecommendations('#recs', {
type: 'viewed_with', item: 'SKU-1', title: 'Vistos juntos', layout: 'carousel', columns: 4,
});
});
El bloque tiene el mismo aspecto que un widget, y las impresiones y los clics se registran automáticamente. Puede llamarlo antes de que se cargue el rastreador: la llamada espera en la cola. El elemento ya debe estar en la página; por eso el ejemplo espera al evento load. Si no hay resultados, el elemento se vacía. El diseño se define con las mismas opciones que los widgets del panel de administración, por ejemplo imageRatio: '4:3', imageFit: 'cover', imageBackground: 'transparent', background: '#111827', textColor: '#f9fafb'; imageBackground es un color o transparent. Las reglas de visualización y las variantes solo están disponibles en los widgets del panel de administración.