Esta es una funcionalidad premium. Póngase en contacto con su Customer Success Manager para habilitarla en su cuenta de Kameleoon.
- Con un archivo XML que contenga todos los metadatos necesarios para cada uno de sus productos. Utilice este método si no tiene una capa de datos y su catálogo contiene menos de 50 000 productos. Puede elegir fácilmente la frecuencia con la que Kameleoon sincronizará su catálogo en la página de configuración de la tienda. Debería realizar una importación XML cada 24-72 horas para actualizar Kameleoon con su stock de productos.
- Con una URL de Google Merchant Feed. Utilice este método si ya ha subido su producto a Google Merchant Center y su catálogo contiene menos de 50 000 productos. Póngase en contacto con su Customer Success Manager de Kameleoon para habilitar este método. Siga estos pasos para sincronizar Google Merchant con Kameleoon.
- A través de la API REST de Kameleoon. Utilice la API REST de Kameleoon para actualizar su catálogo si necesita actualizaciones regulares, especialmente cuando trabaje con productos que se agotan rápidamente debido a su disponibilidad limitada.
- A través de la Product API de Kameleoon. Debería usar este método si tiene una capa de datos que contiene información detallada sobre sus productos y categorías de productos. Trabajar con la API de Kameleoon requiere que tenga disponibles los metadatos de productos y categorías en sus páginas de producto (por ejemplo, en una capa de datos) que Kameleoon pueda leer e introducir en nuestros algoritmos de recomendación de productos.
Kameleoon marcará automáticamente como agotados todos los productos que no estén presentes en el feed. Por tanto, para mejorar la velocidad de procesamiento del feed y reducir su tamaño, recomendamos excluir los productos agotados de su feed.Es importante señalar que un inconveniente del método Product API es que, si los productos no se buscan o examinan activamente por los visitantes, es posible que Kameleoon no tenga conocimiento de esos productos y, por tanto, no se propongan en los bloques de recomendación de productos.
Sincronizar su Product Feed mediante la Product API de Kameleoon
La Product API impulsa los algoritmos de recomendación de productos de Kameleoon y los mensajes de social proofing, como los contadores de impresiones y compras de productos y las condiciones avanzadas de segmentación. Una vez habilitados los métodos de la Product API de Kameleoon en su sitio web, Kameleoon comenzará a enviar eventos de detalle de producto cada vez que sus visitantes naveguen por una página de producto o de categoría, añadan un producto al carrito o realicen una compra. También permitirá recopilar estadísticas sobre un producto determinado (por ejemplo, el número de veces que se compró o se vio en la última hora o día) y posibilitará la creación de grupos de audiencia que podrá utilizar en nuestro segment builder mediante criterios predefinidos de segmentación por producto. Tendrá que añadir nuestros snippets de página de Producto, página de Categoría, página de Carrito y página de agradecimiento a su código fuente para hacer seguimiento de las interacciones con sus productos e informar a nuestro algoritmo de Product Recommendations. También puede inyectarlos utilizando nuestra funcionalidad Global custom script.trackProductView()
Utilice el métodotrackProductView() en las páginas de producto para hacer seguimiento cuando un visitante ve un producto. Lea más sobre el método aquí.
Asegúrese de proporcionar todos los datos necesarios para su configuración de social proofing. Solo los datos enviados a través del método
trackProductView() podrán recuperarse posteriormente mediante el endpoint obtainProductData().trackCategoryView()
Utilice el métodotrackCategoryView() en las páginas de categoría para hacer seguimiento cuando un visitante ve una categoría de productos. Lea más sobre el método aquí.
Asegúrese de que el ID de categoría utilizado aquí coincida con el enviado mediante el método trackProductView(). Lea más sobre el objeto Category aquí.
trackAddToCart()
Utilice el métodotrackAddToCart() en cualquier página en la que un visitante pueda añadir un producto a su carrito, por ejemplo, la página de inicio, la página de producto, la página de categoría o la página del carrito.
Lea más sobre el método trackAddToCart() aquí.
trackTransaction()
Utilice el métodotrackTransaction() en cualquier página que se muestre después de que un visitante complete una compra o transacción. Lea más sobre el método aquí.
Kameleoon sincroniza todo su catálogo de productos cada dos horas y etiquetará automáticamente los productos agotados como “no disponibles” cada 12 horas. Un producto se considera no disponible cuando el atributo
availableQuantity pasado con el método addProductView es igual a cero, lo que garantiza que las recomendaciones de productos de Kameleoon solo incluyan productos en stock. También puede establecer un producto como agotado utilizando el atributo availableQuantity al usar el método addProductView.Sincronizar su Product Feed mediante un archivo XML
La sincronización de su catálogo de productos mediante un archivo XML incluye los siguientes pasos:- Cree un archivo XML con todos los metadatos necesarios para cada uno de sus productos, categorías y ubicaciones (por ejemplo, países o ubicaciones donde opera y tiene precios, stock o detalles distintos para sus productos). El archivo debe estar disponible desde una URL externa. Asegúrese de alojarlo en una zona segura (por ejemplo, un bucket de S3) accesible para Kameleoon.
- Sincronice el archivo XML con Kameleoon y elija el intervalo de actualización que se adapte a sus necesidades (por ejemplo, cada hora, tres horas, seis horas).
- Realice seguimiento de los eventos de sus visitantes.
Los sitios web multilingües no son compatibles; debe crear un proyecto independiente para cada idioma y proporcionar un feed para cada uno.
Incluya las siguientes direcciones IP en la lista permitida para garantizar un proceso fluido de descarga de imágenes:
95.216.99.81/2695.216.99.220/2695.216.23.145/2695.216.10.183/2695.216.114.218/2695.217.32.105/2695.216.4.144/2695.216.102.29/26
Paso 1: crear su feed de productos
El feed de productos debe incluir información básica sobre su catálogo. Consulte las tablas siguientes para conocer los atributos obligatorios que debe incluir.Elemento: yml_catalog
Elemento: yml_catalog > shop
Elemento: yml_catalog > shop > categories
El elementocategories contiene una lista de elementos category. Cada categoría de producto que utilice para agrupar o etiquetar sus productos se describe mediante un elemento category separado.
Ejemplo:
Elemento: yml_catalog > shop > locations
El elementolocations contiene una lista de las ubicaciones de su tienda. Cada ubicación se describe mediante un elemento location separado.
Puede usar los siguientes atributos para el elemento locations:
Ejemplo:
Elemento: yml_catalog > shop > offers
El elementooffers contiene su lista de productos. Cada producto se describe mediante un elemento offer separado.
Si todas las variantes de un producto están disponibles desde la misma URL en su tienda y no hay un identificador común para las variantes de producto, Kameleoon elegirá la variante de producto más barata al recomendar este producto a sus visitantes. La marca de disponibilidad en este caso debe ajustarse a la siguiente lógica: si al menos una variante de producto está en stock, el producto se considera en stock.
Elemento: yml_catalog > shop > offers > offer
Puede usar los siguientes atributos para el elementooffer:
El elemento offer puede contener las siguientes etiquetas:
Ejemplo:
Elemento: yml_catalog > shop > offers > offer > locations
El elementolocations contiene una lista de ubicaciones y la disponibilidad y el precio del producto actual en esas ubicaciones. Cada ubicación se describe mediante un elemento location separado dentro de la etiqueta offer.
Puede usar los siguientes atributos para el elemento locations:
Solo se considerará que el producto está disponible para la compra en las ubicaciones que aparezcan en el elemento offer. En las demás ubicaciones no listadas, el producto se considerará agotado. No es necesario añadir ubicaciones si su producto está disponible en todas las ubicaciones, ya que Kameleoon lo considerará automáticamente en stock en todas ellas.
locations puede contener las siguientes etiquetas (solo necesarias si el producto tiene un precio o cantidad de stock distinto en alguna de sus ubicaciones).
Elemento: yml_catalog > shop > offers > offer > fashion
Utilice la etiqueta fashion si vende productos de ropa. El elemento fashion puede contener las siguientes etiquetas:No especifique el elemento
gender si es irrelevante. El producto se etiquetará como “unisex” y tendrá una prioridad de recomendación inferior a la de otros productos del mismo género.type puede tomar los siguientes valores:
Ejemplo:
El parámetro
type es obligatorio cuando se utiliza el parámetro sizes. Puede añadir una lista de tallas disponibles añadiendo tantas etiquetas size como sea necesario dentro del elemento sizes (consulte el ejemplo siguiente). Si tiene varias ubicaciones y la disponibilidad de las tallas del producto varía entre ubicaciones, inserte una etiqueta location con la lista de tallas disponibles en cada elemento size (consulte el ejemplo siguiente).
Ejemplo:
Un producto puede tener varios colores disponibles. Puede establecer una imagen específica para un color añadiendo un atributo
picture. De lo contrario, se mostrará la imagen principal.Elemento: yml_catalog > shop > offers > offer > auto
Utilice la etiquetaauto si vende piezas y accesorios de automóvil. El algoritmo de Kameleoon está diseñado para reconocer automáticamente a un posible comprador con determinadas características, como la marca y el modelo del coche. Se utilizará para mostrar piezas y accesorios en los bloques de recomendación que solo sean compatibles con marcas y modelos de coches específicos.
El elemento auto contiene una lista de coches compatibles. Cada marca y modelo de coche se describe mediante un elemento compatibility separado.
Si el producto es compatible con todos los coches, no es necesario añadir elementos
compatibility. Si el producto es compatible con todos los modelos de coche de una marca, no es necesario añadir el atributo model.compatibility:
Si el producto solo es compatible con una lista de coches, también puede añadir un elemento
vds para cada coche compatible. El vds contiene el Vehicle Identification Number (VIN), que actúa como huella digital del coche.
Ejemplo:
Elemento: yml_catalog > shop > offers > offer > tags
El elementotags contiene una lista de etiquetas asociadas al producto. Es útil para mejorar la recomendación del motor de búsqueda de Kameleoon. Cada valor se describe mediante un elemento tag separado.
A continuación encontrará ejemplos de archivos XML que puede usar como plantilla:
- Feed XML de productos - ejemplo 1 (sin elementos locations):
- Feed XML de productos - ejemplo 2 (con elementos locations):
Paso 2: sincronizar su archivo de feed de productos con Kameleoon
De forma predeterminada, el feed de Kameleoon se sincroniza con su archivo XML cada 24 horas. Sin embargo, puede cambiar este ajuste si su catálogo de productos se actualiza con más frecuencia. Puede realizar ajustes en Store settings.

Paso 3: hacer seguimiento de los eventos de los visitantes
Además de sincronizar su feed XML de productos, debe implementar eventos para hacer seguimiento de los eventos de producto, como la vista de producto, la adición al carrito y la transacción.Vistas de producto
Debe usar el métodotrackProductView.
Kameleoon.API.Products.trackProductView("ProductID/SKU/EAN");
Lea las instrucciones detalladas
trackAddToCart()
Debe usar el métodotrackAddToCart() cada vez que se haya añadido un producto al carrito del visitante o cuando el visitante acceda a la página del carrito.
Kameleoon.API.Products.trackAddToCart("ProductID/SKU/EAN");
Lea las instrucciones detalladas
Transacción
Validar el estado de sincronización de su feed
Si utiliza la Product API de Kameleoon, puede verificar que su implementación se ha realizado correctamente utilizando el métodoobtainProductData. Este método le permite realizar fácilmente QA de su implementación en tiempo real y verificar que Kameleoon ha recopilado correctamente los atributos de sus productos.
Puede visualizar su catálogo de productos utilizando el menú Data feed.

