OneTrace.pro Centro de ayuda

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.

Página «Widgets de recomendaciones»: lista de widgets con estadísticas y 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á.

Editor del widget: sección «Productos» y vista previa

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.

  1. Pulse Estilo desde una imagen.
  2. Arrastre la imagen, péguela desde el portapapeles (Ctrl+V) o elija un archivo: PNG, JPEG o WebP de hasta 3 MB.
  3. Si el widget tiene variantes, elija a cuál aplicar el estilo.
  4. 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.

Estilo desde una captura de pantalla

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

Sección «Visualización»: reglas, activación y código para el sitio web

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.

Sección «Variantes»: variante B con otro encabezado y otro diseño

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.

Estadísticas del widget: totales, gráfico por días y comparación de variantes

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.