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.
Tenga en cuenta que, aunque la limitación (archivo comprimido en gzip) está fijada en 2 GB, cuanto más grande sea su catálogo, más tiempo tardará en procesarse el feed, así que opte por una sincronización de 6+ horas.
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.
trackProductView()
Utilice el método trackProductView() 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étodo trackCategoryView() 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étodo trackAddToCart() 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étodo trackTransaction() 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.
- 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.
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2022-10-03 22:00">
<shop>
<categories>
<category id="270821163172" parentId="2708" url="https://myurl.com">Adidas</category>
.......
</categories>
<offers>
<offer id="6737859641508" available="true" leftovers="lot"></offer>
......
</offers>
</shop>
</yml_catalog>
Elemento: yml_catalog
| Atributo | Obligatorio | Descripción |
|---|
date | Sí | Fecha de generación del documento XML. El formato debe ser: YYYY-MM-DD hh:mm |
Elemento: yml_catalog > shop
| Elemento | Obligatorio | Descripción |
|---|
categories | Sí | Lista de categorías de la tienda |
locations | Sí | Lista de ubicaciones/países en los que está representada la tienda |
offers | Sí | Lista de productos de la tienda |
Elemento: yml_catalog > shop > categories
El elemento categories 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.
| Atributo | Obligatorio | Descripción |
|---|
id | Sí | ID de categoría |
parentId | No | ID de la categoría padre |
url | No | Enlace a la página de la categoría |
alias | No | Identificador alias de la categoría |
<categories>
<category id="2" url="http://my-store.com/categories/discount/"> Category level 1</category>
<category id="8" url="http://my-store.com/categories/men/">Category level 1</category>
<category id="13" parentId="8" url="http://my-store.com/categories/men/shoes/">Category level 2</category>
<category id="97" parentId="13" alias="men/shoes/leather" url="http://my-store.com/categories/men/shoes/leather">Category level 3</category>
</categories>
Elemento: yml_catalog > shop > locations
El elemento locations 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:
| Atributo | Obligatorio | Descripción |
|---|
id | Sí | ID de la ubicación |
parentId | No | ID de la ubicación padre |
type | No | Tipo de ubicación. Valores disponibles: state, city, store |
name | No | Nombre de la ubicación |
<locations>
<location id="1" type="city" name="New York" />
<location id="2" type="city" name="Los Angeles" />
<location id="145" parentId="1" type="store" name="New York City main store" />
</locations>
Elemento: yml_catalog > shop > offers
El elemento offers 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 elemento offer:
| Atributo | Obligatorio | Descripción |
|---|
id | Sí | ID/SKU/EAN del producto |
group_id | No | ID de grupo de producto. Necesario para combinar variantes de producto en un solo grupo. Kameleoon elegirá la variante más barata al recomendar este producto a los visitantes |
available | Sí | Indicación de si el producto está en stock (‘true/false’). Kameleoon marcará automáticamente como agotados todos los productos que no estén en el feed. Por tanto, para acelerar el procesamiento del feed y reducir su tamaño, no añada productos agotados a su feed. |
leftovers | No | Indicación de cuánto inventario hay disponible de un determinado producto. Puede tomar uno de los siguientes valores: one (el producto está disponible en una sola unidad), few (el producto está en cantidades limitadas, hasta 10 unidades), lot (disponible desde más de 10 unidades del producto) |
| Elemento | Obligatorio | Descripción |
|---|
name | Sí | Nombre del producto |
picture | Sí | Imagen principal del producto |
price | Sí | Precio base del producto |
url | Sí | URL a la página de detalles del producto (que empiece por HTTP/HTTPS) |
categoryId | Sí | Categoría del producto. Si el producto está asociado a varias categorías, añada tantos elementos categoryId como sea necesario |
locations | No | Obligatorio si las propiedades del producto (precio, disponibilidad) son diferentes según sus ubicaciones. Consulte la tabla y el ejemplo siguientes |
accessories | No | Lista de productos que pueden ser complementarios o equivalentes al producto actual. Le permite recomendar productos que pueden usarse en combinación con el producto actual (o como sustituto). Suele ser necesario para una tienda de moda o automoción, y esta etiqueta solo es compatible con el algoritmo Store Recommendations. |
oldprice | No | Precio anterior del artículo. Se utiliza para mostrar el precio rebajado del producto en los bloques de recomendación de productos. |
price_margin | No | Un factor de ponderación del margen de precio del producto, entre 0 y 100. Se utiliza para mostrar productos con mayor margen en los bloques de recomendación de productos. |
barcode | No | Código de barras o SKU del producto. Se utiliza para los algoritmos de búsqueda de Kameleoon. |
typePrefix | No | Tipo de producto (por ejemplo, “teléfono móvil”, “lavadora”, “sofá rinconero”). Se utiliza para los algoritmos de búsqueda de Kameleoon. |
vendor | No | Fabricante/marca |
vendorCode | No | Código del fabricante/marca. Se utiliza para los algoritmos de búsqueda de Kameleoon. |
model | No | Modelo y nombre del producto (por ejemplo, iPhone 17 128GB). Se utiliza para los algoritmos de búsqueda de Kameleoon. |
seasonality | No | Estacionalidad de los productos. Le permite recomendar este producto solo en algunos meses del año. Añada tantos elementos como sea necesario. Consulte el ejemplo siguiente |
is_new | No | Debe ser “1” si el producto es nuevo. Necesario si utiliza el algoritmo “New arrivals” |
rating | No | Valoración del producto. Debe tomar un valor de cero a cinco. Debe ser cero si el producto no tiene valoración |
description | No | Descripción del producto |
stock_quantity | No | Indicación de la cantidad de stock del producto |
tags | No | Cualquier información adicional que describa el producto. Se utiliza para los algoritmos de búsqueda de Kameleoon. Puede añadir un máximo de cinco etiquetas. Consulte la tabla y el ejemplo siguientes |
param | No | Se utiliza para proporcionar opciones de filtrado en la página de listado de búsqueda proporcionada por Kameleoon. Añada tantos elementos param como sea necesario. Consulte el ejemplo siguiente |
author | No | Solo necesario si vende libros en línea |
publisher | No | Solo necesario si vende libros en línea |
series | No | Solo necesario si vende libros en línea |
year | No | Solo necesario si vende libros en línea |
ISBN | No | Solo necesario si vende libros en línea |
<accessories>
<accessory id="5574" />
<accessory id="131" />
<accessory id="99444" />
<accessory id="334411" />
</accessories>
Elemento: yml_catalog > shop > offers > offer > locations
El elemento locations 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:
| Atributo | Obligatorio | Descripción |
|---|
id | Sí | ID de la ubicación en la que está disponible actualmente el producto. Debe ser un ID de uno de los elementos locations del elemento Shop (consulte la sección anterior). Añada tantos elementos como sea necesario. |
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 | Obligatorio | Descripción |
|---|
price | No | Precio del producto en la ubicación indicada |
oldprice | No | Precio anterior del producto en la ubicación |
stock_quantity | No | Cantidad de stock del producto en la ubicación |
Elemento: yml_catalog > shop > offers > offer > fashion
Utilice la etiqueta fashion si vende productos de ropa.
El elemento fashion puede contener las siguientes etiquetas:
| Elemento | Obligatorio | Descripción |
|---|
gender | no | Género del producto. Debe ser “f” (femenino) o “m” (masculino). |
type | no | Tipo de producto. Consulte la tabla siguiente para los valores permitidos. |
sizes | no | Tallas disponibles del producto. Consulte la tabla siguiente para los valores permitidos. |
color | no | Color del producto. Consulte el ejemplo siguiente. |
feature | no | Especificidades del producto. Utilice este elemento para indicar si el producto es solo para adultos o niños. Debe tomar el valor “child” o “adult”. |
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:
| Valor del elemento (gender) | Descripción |
|---|
shoe | Calzado |
shirt | Camisas, blusas, vestidos |
tshirt | Camisetas |
underwear | Ropa interior |
trouser | Pantalones, vaqueros, shorts, faldas, trajes de baño |
jacket | Chaquetas, abrigos, abrigos de piel |
blazer | Chaquetas, chalecos, jerséis |
sock | Calcetines |
belt | Cinturones |
hat | Sombreros |
glove | Guantes |
<offer ...>
...
<fashion>
<gender>f</gender>
<type>shoe</type>
</fashion>
</offer>
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).
| Descripción | Ejemplo |
|---|
| Talla europea | e38 |
| Talla internacional | M, L, u30 |
| Talla del Reino Unido | b6 |
| Altura (para productos infantiles) | h89-95 |
| Talla única | null |
<offer ...>
...
<fashion>
<gender>f</gender>
<type>shoe</type>
<feature>adult</type>
<sizes>
<size>e41</size>
<size>e42</size>
<size>e44</size>
<size>e48</size>
</sizes>
</fashion>
</offer>
<offer ...>
...
<fashion>
<gender>m</gender>
<type>jacket</type>
<sizes>
<size value="M">
<location id="3"/>
</size>
</sizes>
</fashion>
</offer>
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.
<offer ...>
...
<fashion>
<gender>f</gender>
<type>shirt</type>
<color>white</color>
<color picture="https://example.com/products/shirts/395532-blue.jpg">blue</color>
</fashion>
</offer>
Elemento: yml_catalog > shop > offers > offer > auto
Utilice la etiqueta auto 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:
| Atributo | Obligatorio | Descripción |
|---|
brand | Sí | Marca del coche |
model | No | Modelo del coche |
vds para cada coche compatible. El vds contiene el Vehicle Identification Number (VIN), que actúa como huella digital del coche.
Ejemplo:
<offer ...>
...
<auto>
<compatibility brand="BMW" />
<compatibility brand="Mini" model="Cooper S" />
<compatibility brand="Mini" model="Cooper C" />
<vds>BP8AN5</vds>
<vds>BP8AN5</vds>
</auto>
</offer>
tags 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.
| Elemento | Obligatorio | Descripción |
|---|
tag | Sí | Valor de la etiqueta |
- Feed XML de productos - ejemplo 1 (sin elementos locations):
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2022-10-03 22:00">
<shop>
<categories>
<category id="270821163172" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/adidas">Adidas</category>
<category id="270821261476" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/asics">Asics</category>
<category id="270821228708" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/converse">Converse</category>
<category id="270821425316" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/drmartens">Dr Martens</category>
<category id="270821490852" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/flex">Flex</category>
<category id="2708211" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/trainers">Sneakers</category>
<category id="2708" url="https://kameleoon-store.myshopify.com/collections/all">Shoes</category>
</categories>
<offers>
<offer id="6737859641508" available="true" leftovers="lot">
<url>https://kameleoon-store.myshopify.com/products/adidas-kids-stan-smith</url>
<price>50.99</price>
<oldprice>90</oldprice>
<price_margin>45</price_margin>
<categoryId>270821163172</categoryId>
<categoryId>2708211</categoryId>
<picture>https://cdn.shopify.com/s/files/1/0564/9180/2788/products/7883dc186e15bf29dad696e1e989e914_grande.jpg?v=1622707556</picture>
<name>ADIDAS | KID'S STAN SMITH</name>
<is_new>1</is_new>
<rating>4</rating>
<vendor>Adidas</vendor>
<description>The Stan Smith owned the tennis court in the '70s. Today it runs the streets with the same clean, classic style. These kids' shoes preserve the iconic look of the original, made in leather with punched 3-Stripes, heel and tongue logos and lightweight step-in cushioning. </description>
<stock_quantity>300</stock_quantity>
<tags>
<tag>Sneakers</tag>
<tag>Lean low top sneakers</tag>
<tag>Men sneakers</tag>
</tags>
<fashion>
<type>shoe</type>
<color>black</color>
<sizes>
<size>9</size>
</sizes>
<feature>child</feature>
</fashion>
<param name="Size" unit="EU">9</param>
<param name="Color">white</param>
</offer>
<offer id="6737859641509" available="false">
......
</offer>
</offers>
</shop>
</yml_catalog>
- Feed XML de productos - ejemplo 2 (con elementos locations):
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2022-10-03 22:00">
<shop>
<categories>
<category id="270821163172" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/adidas">Adidas</category>
<category id="270821261476" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/asics">Asics</category>
<category id="270821228708" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/converse">Converse</category>
<category id="270821425316" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/drmartens">Dr Martens</category>
<category id="270821490852" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/flex">Flex</category>
<category id="2708211" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/trainers">Sneakers</category>
<category id="2708" url="https://kameleoon-store.myshopify.com/collections/all">Shoes</category>
</categories>
<locations>
<location id="1" type="city" name="New York" />
<location id="2" type="city" name="Los Angeles" />
<location id="145" parentId="1" type="store" name="New York City main store" />
</locations>
<offers>
<offer id="6737859641508" available="true" leftovers="lot">
<url>https://kameleoon-store.myshopify.com/products/adidas-kids-stan-smith</url>
<price>50.99</price>
<oldprice>90</oldprice>
<categoryId>270821163172</categoryId>
<categoryId>2708211</categoryId>
<picture>https://cdn.shopify.com/s/files/1/0564/9180/2788/products/7883dc186e15bf29dad696e1e989e914_grande.jpg?v=1622707556</picture>
<name>ADIDAS | KID'S STAN SMITH</name>
<is_new>1</is_new>
<rating>4</rating>
<vendor>Adidas</vendor>
<description>The Stan Smith owned the tennis court in the '70s. Today it runs the streets with the same clean, classic style. These kids' shoes preserve the iconic look of the original, made in leather with punched 3-Stripes, heel and tongue logos and lightweight step-in cushioning. </description>
<stock_quantity>300</stock_quantity>
<tags>
<tag>Sneakers</tag>
<tag>Men</tag>
</tags>
<locations>
<location id="145">
<price>63</price>
<oldprice>90</oldprice>
<stock_quantity>90</stock_quantity>
</location>
</location>
<customerRecommendations>67378596415,673785964150821,673785964150,673785964150811</customerRecommendations>
</offer>
<offer id="6737859641509" available="false">
......
</offer>
</offers>
</shop>
</yml_catalog>
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.
También puede programar la importación para que comience a una hora específica. Póngase en contacto con su Customer Success Manager de Kameleoon para habilitar esta opción.
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étodo trackProductView.
Kameleoon.API.Products.trackProductView("ProductID/SKU/EAN");
Lea las instrucciones detalladas
trackAddToCart()
Debe usar el método trackAddToCart() 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
Kameleoon.API.Products.trackTransaction([
{
"productID": "ProductID/SKU/EAN 1",
"quantity": 1
}
]);
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étodo obtainProductData. 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.
También puede acceder a los registros de importación directamente desde el menú Imports log para solucionar problemas de importación.
Puede hacer clic en cualquier fila para acceder al registro detallado de importación.
