Skip to main content

Guía de integración Shopify V2

Esta sección muestra cómo añadir Kleep AI Sizing a tu tienda Shopify.

Tutorial en vídeo paso a paso

Sigue nuestro tutorial de Tango para añadir el botón de Kleep a tu tienda en temas Online Store 2.0.

Guía de integración Shopify V1

1. Sizing

Esta sección muestra cómo añadir Kleep AI Sizing a tu código de Shopify.

¿Prefieres un tutorial visual?

Mira el tutorial paso a paso de Tango para instalar Kleep en una tienda Shopify V1.

Pasos

Paso 1: Activa el App Embed Asegúrate de que la aplicación Kleep está activada en tus App embeds. Capture d'écran 2025-08-13 à 14.29.30.png Paso 2: Renderiza el snippet del botón Pega el siguiente código donde quieras que aparezca Kleep. Debe ser parte del bloque Product info dentro de la carpeta snippets.
Paso 3: Crea el archivo del snippet del botón Crea un nuevo archivo llamado kleep-button.liquid dentro de tu carpeta snippets. Pon el siguiente contenido dentro:
Paso 4: Añade opciones al esquema de configuración Añade las siguientes opciones a tu esquema de configuración al final de la página:
Para añadir tus propios estilos CSS:
  • Para cambiar la apariencia (colores, espaciado, fuentes, etc.), pega tu CSS en el campo “Introducir estilos CSS personalizados” en la configuración del App Embed de Kleep.
Por ejemplo: Screenshot 2025-08-13 at 13.25.30.png Paso 5: Añade traducciones al inglés Añade las traducciones en inglés a los locales de tu tema.
Paso 6: Añade traducciones a otros idiomas Añade otras traducciones a los locales de tu tema.
  1. Valida las actualizaciones en el área de Personalización del tema de Shopify. Configura los elementos visuales en la configuración del bloque de información del producto.
  2. Si quieres añadir un botón secundario, necesitarás crear un nuevo archivo llamado kleep-secondary-button.liquid dentro de tu carpeta snippets. Pon el siguiente contenido dentro:
Pega el siguiente código donde quieras que aparezca Kleep. Debe ser parte del bloque Product info dentro de la carpeta snippets.

2. Productos similares


Instalar “Productos similares” para temas Shopify V1

En este caso, debes añadir un snippet de Liquid manualmente.

Paso 1 — Crea un snippet

Crea: snippets/kleep-similar-button.liquid Inserta el siguiente código:

Paso 2 — Renderiza el snippet dentro de la plantilla de producto

Inserta esta línea donde quieras que aparezca el botón:
Colocación típica: bajo los selectores de variante o cerca del formulario de Añadir al carrito.

Paso 3 — Activa el modo correcto para temas V1

Dado que los temas V1 no pueden insertar bloques OS2.0, el widget debe usar uno de:
  • custom_buttons
  • popup+custom
  • button+custom

Instalar “Productos similares” para tiendas V2 (Online Store 2.0)

Los temas modernos de Shopify admiten app embeds y bloques personalizados. No se requieren cambios de código.

Paso 1 — Activa el App Embed de Kleep

  1. Ve a Tienda en línea → Temas → Personalizar.
  2. Abre la sección App embeds.
  3. Activa la aplicación Kleep.
  4. Guarda el tema.
Esto activa el script principal que gestiona la lógica de Productos similares. Screenshot 2025-12-09 at 11.55.25.png A continuación, localiza la opción “Mostrar productos recomendados”

Paso 2 — Selecciona el modo de visualización de Productos similares

Dentro de la configuración del widget de Kleep, elige cómo deben aparecer los Productos similares en la Página de producto:
  • disabled – desactiva completamente la funcionalidad
  • popup – añade automáticamente un popup sobre los selectores de variante/talla en escritorio y reemplaza el botón predeterminado en móvil
  • button – inserta automáticamente un botón CTA cerca del área de Añadir al carrito cuando la variante seleccionada está agotada
  • custom_buttons – desactiva toda colocación automática; el comerciante debe añadir uno o más bloques “Kleep Similar Button” manualmente
  • popup+custom – mantiene el popup automático y también activa cualquier botón personalizado añadido en el tema
  • button+custom – mantiene el botón CTA automático y también activa cualquier botón personalizado añadido en el tema
Screenshot 2025-12-09 at 11.48.24.png Después, simplemente guarda el tema y aparecerá inmediatamente en tu tienda (página de producto). Paso 3 — Añadir botones personalizados (solo para custom_buttons, popup+custom, button+custom) Si el modo seleccionado incluye botones personalizados:
  1. Abre Tienda en línea → Personalizar.
  2. Ve a la plantilla de Página de producto.
  3. En la sección deseada, haz clic en Añadir bloque.
  4. Selecciona Kleep Similar Button.
  5. Guarda el tema.
Los botones personalizados solo aparecen cuando la variante seleccionada está agotada. image.png

Agregar múltiples botones de “Productos similares” (primario y secundario)

Puedes añadir cualquier número de botones de Productos similares en la Página de producto. Esto funciona tanto para temas OS 2.0 como para temas V1/legacy.

Activa un modo que admita botones personalizados

Para permitir múltiples botones, el widget debe estar configurado en uno de:
  • custom_buttons
  • popup+custom
  • button+custom
Estos modos activan la colocación manual, para que los comerciantes puedan insertar tantos botones como necesiten.

Para Online Store 2.0 (Temas modernos)

Los temas OS 2.0 permiten añadir botones visualmente a través del Editor de temas. Pasos:
  • Ve a Tienda en línea → Personalizar
  • Abre la plantilla de Página de producto
  • Haz clic en Añadir bloque → Kleep Similar Button
  • Añade el botón donde quieras
  • Repite si quieres 2 o más botones en la página
Cada botón aparece automáticamente solo cuando la variante seleccionada está agotada.

Para temas V1 / Legacy

Los temas legacy no admiten bloques, pero puedes renderizar el snippet varias veces. Inserta este snippet donde quieras un botón: {% render 'kleep-similar-button' %} Para crear múltiples botones, simplemente coloca este código en diferentes áreas de la plantilla de producto. Cada llamada al snippet crea un botón adicional.

Resumen

Para añadir múltiples botones de Productos similares: Activa cualquier modo con botones personalizados → añade varios bloques OS 2.0 o múltiples llamadas al snippet → todos los botones funcionan automáticamente cuando la variante está agotada.
Ubicación del CTA en la PDP La ubicación está definida por selectores DOM dentro de KleepSDK.getConstants(). targetProductInfoBlockQueries – dónde está la información del producto. Es un array de selectores que apuntan al contenedor principal de los detalles del producto (título, precio, tallas, etc.). El script itera por estos selectores y usa el primero que encuentra como punto de inserción para el CTA o los popups. targetVariantQueries – dónde están las opciones de talla/variante: Una vez que se encuentra el bloque de información del producto, el script busca dentro de él los elementos de variante (como los selectores de talla). Cada <label> de variante (o equivalente) se convierte en un objetivo para adjuntar el popup CTA. Popup vs. Botón (Escritorio vs. Móvil) Detectamos el tipo de dispositivo usando checkIfMobile(): Esta función comprueba la cadena navigator.userAgent del navegador contra una lista de dispositivos móviles (p. ej., iPhone, Android, iPad).
  • Si es escritorio, el CTA se muestra como popups al pasar el ratón junto a las etiquetas de variante.
  • Si es móvil, el script reemplaza los popups hover por un único botón, ya que las interacciones hover no funcionan en pantallas táctiles.
Personalización
  • No se ofrecen otras variantes de colocación/diseño más allá de ajustar los selectores y el CSS.
  • Para cambiar la apariencia (colores, espaciado, fuentes, etc.), pega tu CSS en el campo “Introducir estilos CSS personalizados” en la configuración del App Embed de Kleep. Screenshot 2025-08-13 at 13.25.30.png

3. Búsqueda


Nota: No es necesario cambiar ningún código del tema para configurar Kleep Search en Shopify V1. Abre el Editor de temas, activa el App Embed de Kleep, habilita la Búsqueda personalizada y reemplaza el bloque de búsqueda predeterminado por el bloque Kleep Search. Para cambiar la apariencia (colores, espaciado, fuentes, etc.), pega tu CSS en el campo “Introducir estilos CSS personalizados” en la configuración del App Embed de Kleep. Todo esto se describe a continuación Abrir el Editor de temas Ve a Tienda en línea > Temas, encuentra el tema que quieres editar y haz clic en Personalizar. Activar el App Embed de Kleep Abre la sección App embeds. Encuentra la aplicación Kleep y actívala. Activar la búsqueda personalizada (opcional) En la configuración de Kleep, activa “Activar búsqueda personalizada”. Screenshot 2025-07-28 at 17.17.44.png Reemplazar la búsqueda predeterminada Desde el editor de temas, abre la plantilla de Búsqueda (navega a la plantilla de página de búsqueda). Screenshot 2025-07-28 at 17.18.59.png Elimina u oculta la sección de búsqueda predeterminada del tema. Screenshot 2025-07-28 at 17.19.32.png Añade el bloque Kleep Search (desde la pestaña Aplicaciones) y colócalo donde estaba la búsqueda predeterminada. Screenshot 2025-07-28 at 17.19.48.png Guarda los cambios del tema. La funcionalidad de búsqueda está integrada como una sección Liquid dentro de la aplicación, no como un código Liquid separado. La activación está controlada por: {% if block.settings.kleep_enable_custom_search and '[kookai.fr](http://kookai.fr/), [gualap.com](http://gualap.com/), [gualap.fr](http://gualap.fr/), [www.molli.com](http://www.molli.com/), [getkleep.myshopify.com](http://getkleep.myshopify.com/)' contains domain%} Esto garantiza que solo tiendas específicas (dominios) puedan activar la funcionalidad de búsqueda.Diseño y estilos
  • La vista en cuadrícula frente a lista solo se alterna a través del ajuste products_search_grid_layout en la aplicación.
Para ello, ve a la búsqueda que ya has añadido y en el lado derecho verás la opción para configurarla. Screenshot 2025-08-13 at 13.29.01.png Screenshot 2025-08-13 at 13.29.19.png
  • Los estilos adicionales (fuentes, colores, espaciado) los implementamos nosotros en el código, por tienda, si es necesario.
  • Toda la funcionalidad está vinculada a esta sección Liquid y se activa a través de kleep_enable_custom_search en la aplicación, no añadiendo código Liquid a la configuración del tema.
  • Para cambiar la apariencia (colores, espaciado, fuentes, etc.), pega tu CSS en el campo “Introducir estilos CSS personalizados” en la configuración del App Embed de Kleep. Screenshot 2025-08-13 at 13.25.30.png

Cookies y privacidad de datos

Kleep está completamente condicionado por el consentimiento del visitante: el script solo se carga después de que se recopile el consentimiento a través de tu CMP, y debes condicionar su carga en consecuencia. Para la lista completa de rastreadores, los datos tratados, las finalidades y bases legales, el alojamiento, los subencargados y la seguridad, consulta Cookies, CMP y privacidad de datos.