> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Preguntas frecuentes

> Encuentre respuestas a las preguntas más frecuentes sobre las funcionalidades de recomendaciones de productos y merchandising, incluida la configuración, los algoritmos, la configuración del feed y las limitaciones.

<AccordionGroup>
  <Accordion title="¿Cómo habilito y accedo a las funcionalidades de recomendación de productos?">
    Las capacidades de recomendación de productos son una funcionalidad premium. Póngase en contacto con su Customer Success Manager para habilitarlas en su cuenta de Kameleoon. Acceda al espacio de trabajo **Product recommendations** navegando a **Settings** > **Recommendations**.
  </Accordion>

  <Accordion title="¿Qué es una estrategia de recomendación de productos?">
    Una estrategia de recomendación define cómo selecciona y filtra los productos que se mostrarán. Al crear una estrategia, introduzca un nombre y una descripción y defina el número máximo de productos que se mostrarán en el bloque. Después de guardar la estrategia, configure sus reglas, plantillas y diseño.
  </Accordion>

  <Accordion title="¿Cómo publico una estrategia de recomendación en mi sitio web?">
    Haga clic en **Recommendations** > **Recommendation strategy**. A continuación, haga clic en su bloque de recomendación > **Copy code** para generar el snippet de su bloque. Péguelo en el código fuente de su página donde desee que aparezca el bloque.

    Como alternativa, utilice la [Activation API](../../developer-docs/apis/activation-api-js/api-reference/api-reference#obtainrecommendedproducts) de Kameleoon para servir recomendaciones de productos. La API utiliza la última versión guardada de la plantilla y devuelve un objeto JSON que contiene los productos recomendados y el HTML de la plantilla. La respuesta de la API no incluye CSS; debe aplicar el estilo a la salida manualmente.

    Al implementar el código de su bloque, incluya el parámetro `data-recommender-code` (ID del bloque de recomendación de productos). Para los bloques que utilizan algoritmos como **Similar** y **They also buy this**, incluya el parámetro `data-recommender-item` para especificar el ID del producto actual.
  </Accordion>

  <Accordion title="¿Por qué el número de productos recomendados es mucho menor que mi stock total de productos?">
    Si observa una gran discrepancia entre su inventario total y el número de productos disponibles para la recomendación mediante los algoritmos **Popular** o **Trending** (etiquetados como productos **Widgetable**), estos algoritmos tienen requisitos estrictos de calidad de los datos.

    Para que un producto sea widgetable y elegible para las recomendaciones, debe configurar e importar correctamente los cuatro campos críticos:

    * Precio
    * Nombre
    * URL
    * Imagen (la URL de la imagen debe ser válida y recuperable)

    Si falta alguno de estos atributos esenciales o es incorrecto (por ejemplo, una URL de imagen rota), Kameleoon filtra el producto y no aparecerá en los resultados del algoritmo de recomendación.

    **Cómo solucionar problemas de imágenes que faltan**

    Un motivo habitual por el que un producto no es widgetable es que Kameleoon no haya podido descargar la imagen durante el proceso de sincronización del catálogo.

    **Principales razones por las que no se pueden descargar las imágenes**

    Si su producto tiene una URL de imagen válida pero aún así carece de imagen, la configuración del servidor de su tienda podría ser la causa del problema:

    * **Sobrecarga del servidor:** el almacenamiento o el servidor de su tienda no puede manejar el alto volumen de solicitudes del sistema de Kameleoon. El sistema descarga imágenes utilizando **50 hilos simultáneos**, lo que a menudo provoca errores de tiempo de espera.
    * **Bloqueo de seguridad:** su firewall o protección anti-DDoS podría bloquear solicitudes según el user agent o la dirección IP.
      * **User agent:** Kameleoon descarga imágenes con el user agent `Kameleoon Fetcher 2.0`. Si las descargas fallan, permita este user agent en la configuración de su servidor.
      * **Dirección IP:** incluya en la lista permitida todas las IP del clúster de Kameleoon para garantizar un acceso ininterrumpido. Vea la lista de [IPs aquí](./recommendations/import-your-product-catalog-feed#syncing-your-product-feed-using-an-xml-file).

    **Cómo encontrar productos problemáticos**

    Identifique qué productos carecen de los campos de datos necesarios accediendo a su **Products Database**.

    1. Haga clic en **Settings** > **Recommendations** > **Products** > **Data feed**.
    2. Seleccione **False** en el desplegable **Widgetable**.
    3. Haga clic en cualquier producto para ver sus atributos. Kameleoon resalta el problema (por ejemplo, falta de precio o fallo en la recuperación de la imagen) en la lista de atributos del producto.

    **Recordatorio sobre la ventana temporal del algoritmo**

    Al solucionar problemas con los resultados, tenga en cuenta que el algoritmo **Trending** calcula las recomendaciones basándose estrictamente en los pedidos de venta dentro de la ventana temporal seleccionada. El algoritmo excluye las ventas anteriores a esa duración.
  </Accordion>

  <Accordion title="¿Con qué frecuencia se actualiza el feed de datos de productos?">
    Personalice la frecuencia y el momento concreto de las actualizaciones de su feed de datos de productos en **Store settings**.
  </Accordion>

  <Accordion title="¿Puedo usar recomendaciones de productos en campañas de correo electrónico?">
    No. Actualmente, las recomendaciones de productos solo admiten los canales **web** y **app**. No puede enviar widgets de recomendación dinámicos directamente a las plantillas de correo electrónico.
  </Accordion>

  <Accordion title="¿Existe un modo de vista previa para las recomendaciones?">
    Sí, puede previsualizar y simular sus recomendaciones de productos en su sitio web utilizando el **Widget Studio**.

    Para ello, cree un widget que contenga su bloque de recomendación de productos y, a continuación, [añádalo a su experimento](./recommendations/use-a-product-recommendation-block-in-a-campaign#use-a-product-recommendation-block-in-an-experiment). Una vez configurado, utilice la [funcionalidad de simulación](../assets/widgets/create-a-widget-with-the-widget-studio/simulate-your-widgets) del Widget Studio para visualizar el widget. La simulación le permite verificar tanto el diseño como los productos que devuelve el algoritmo antes de su lanzamiento.
  </Accordion>

  <Accordion title="¿Puedo ordenar los productos recomendados?">
    Sí. Puede aplicar criterios de ordenación a los productos que devuelve un algoritmo. Por ejemplo, puede ordenar los resultados mostrados por ingresos más altos para priorizar los artículos de mayor valor.
  </Accordion>

  <Accordion title="¿Puedo usar expresiones regulares en las reglas de recomendación?">
    No. Las expresiones regulares (regex) no están actualmente disponibles para definir lógica de coincidencia compleja dentro de las reglas de recomendación.
  </Accordion>

  <Accordion title="¿Puedo importar mi propio algoritmo de recomendación?">
    No. La plataforma no admite Bring Your Own Algorithm (BYOA). Utilice el conjunto de algoritmos integrados proporcionados por Kameleoon.
  </Accordion>

  <Accordion title="¿Existe un límite en el número de recomendaciones que puedo mostrar?">
    Aunque Kameleoon no impone un límite estricto, solicitar muchos productos afecta al rendimiento del algoritmo y aumenta los tiempos de respuesta. Muestre menos de 50 productos por bloque. Para mostrar conjuntos de productos más grandes, utilice [Collections](./merchandising/activate-and-deploy-a-product-collection-on-your-website).
  </Accordion>

  <Accordion title="¿Funcionan todos los algoritmos en cualquier lugar de mi sitio?">
    No, algunos algoritmos solo funcionan bajo condiciones específicas. Por ejemplo, el algoritmo **Similar products**, el algoritmo **Products usually purchased with this item** y el algoritmo **Store recommendations** solo funcionan en páginas de detalle de producto. El algoritmo **Products usually viewed with this product** solo funciona si el carrito contiene artículos.
  </Accordion>

  <Accordion title="¿Puedo usar tallas de producto importadas de Google Merchant en plantillas de recomendación Liquid?">
    Sí. Puede utilizar la talla del producto como variable HTML en su plantilla, siempre que la talla aparezca como parámetro en el feed de datos.
  </Accordion>

  <Accordion title="¿Puedo usar un nombre de campo personalizado (como `shop_recommend`) para el algoritmo Store Recommendations?">
    No. El algoritmo Store Recommendations requiere específicamente el campo `accessories` en su feed de datos. No reconoce nombres de campo personalizados para relaciones manuales entre productos.

    Para vincular productos manualmente (por ejemplo, para mostrar artículos complementarios), asigne los IDs de los productos relacionados al campo `accessories`.

    El algoritmo muestra únicamente los productos vinculados mediante la etiqueta `accessories`. Puede restringir aún más estos resultados aplicando filtros estándar al bloque de recomendación (por ejemplo, para excluir artículos agotados de la lista manual).
  </Accordion>

  <Accordion title="¿Cómo proporciono datos para el algoritmo de recomendación 'Currently on wishlist'?">
    Para utilizar el algoritmo **Currently on wishlist**, realice un seguimiento explícito de cuándo un usuario añade un artículo a su lista de deseos. El motor de recomendación no detecta automáticamente estas interacciones sin una señal de API específica.

    Implemente el [método `trackAddToWishList()` de la Activation API](../../developer-docs/apis/activation-api-js/api-reference/api-reference#trackaddtowishlist). Este método envía los datos de evento necesarios a Kameleoon, que alimenta el algoritmo de wishlist.
  </Accordion>

  <Accordion title="¿Qué atributos puedo importar desde Google Merchant Center frente a Kameleoon XML?">
    Los atributos admitidos dependen del formato de su feed. Tenga en cuenta las siguientes limitaciones sobre las etiquetas y los datos de stock:

    **Etiquetas personalizadas (`custom_label_0` - `custom_label_4`)**

    * **No admitidas**.
    * El módulo de recomendación no importa los atributos `custom_label` de los feeds de Google Merchant Center. No puede utilizar estos campos para filtrar ni mostrar.

    **Cantidad de stock (`stockquantity`)**

    * **Feeds de Google Merchant:** **no admitido**. La especificación de datos de producto de Google no incluye un recuento numérico de stock (solo el estado "availability"). Por lo tanto, no puede importar números exactos de inventario mediante CSV/XML de Google.
    * **Kameleoon XML:** **admitido**. Para utilizar recuentos exactos de stock, utilice el formato XML nativo de Kameleoon y rellene el campo `stockquantity`.
    * **Visualización y uso de datos de stock:** si importa datos de stock mediante Kameleoon XML, los valores aparecen en la vista general de **Data feed**. Utilice el atributo `stockquantity` para crear filtros (por ejemplo, `stockquantity > 5`).
  </Accordion>

  <Accordion title="¿Cómo decido entre la importación XML y la importación por API para mi catálogo?">
    Base su decisión en el tamaño de su catálogo y su infraestructura técnica. Utilice el método de **importación XML** si su catálogo contiene menos de 50 000 productos y no dispone de una capa de datos en su sitio web. Por el contrario, [utilice la **Product Recommendation API**](../../developer-docs/apis/product-recommendation-api-rest/tutorials/import-a-product-catalog-into-kameleoon-using-the-product-recommendation-api) si su catálogo supera los 50 000 productos.
  </Accordion>
</AccordionGroup>