Carga de catálogo mediante Feed

Carga de catálogo mediante Feed




1. INTRODUCCIÓN



Una de las principales características de Oct8ne es su visor integrado.  El visor es un espacio interactivo que comparten los agentes y los clientes, dentro del chat, para poder visualizar imágenes y vídeos de los productos de tu catálogo. De forma simultánea, podréis hacer zoom y dibujar sobre los artículos de tu tienda para asesorar a los usuarios de una manera mucho más ágil y que te permite cerrar más ventas. 



Como norma general, si ti tienda esta desarrollada en un CMS común como (Woocommerce WP, Prestashop, Magento2, shopify, o VTEX.) e instalas el plugin de Oct8ne; tu catálogo quedará 100 % integrado.



De manera simultánea, Oct8ne permite cargar productos en un catálogo interno, propio de Oct8ne, con el fin de mostrar productos en el visor tan característico de la herramienta. Para ello, se pueden hacer cargas manuales de productos mediante la interfaz, dentro del panel de Oct8ne.



¿Realmente necesito tener mis productos en el catálogo interno de Oct8ne?



Quizá quieres tener tu catalogo actualizado sin necesidad de instalar el plugin que ofrecemos para plataforma como WP, PrestashopMagento2, shopify, o VTEX.


O quizá, tu tienda online no tiene disponible el plugin de Oct8ne para el CMS en el que está desarrollada tu web; o simplemente quieres tener productos adicionales para mostrar en el visor.


Existen diferentes tipos de carga para el catálogo interno de Oct8ne. Ahora lo vemos.




2. TIPOS DE CARGA


  1. PRODUCTO SIMPLE (a través del panel)


Primero de todo, debes crear las categorías que desees tener en el catálogo interno de Oct8ne.

En la sección ‘Catálogo’ > ‘Recursos extras’ encontrarás un árbol de categorías. Puedes crear las categorías y subcategorías mediante el botón +


Por ejemplo:




Posteriormente puedes crear un producto clicando en el botón ‘Añadir nuevo producto’




Aparecerá una nueva sección que representa la ficha del producto. 









En la parte izquierda, aparece un formulario con los datos del producto. Debes rellenar los datos siguientes:








Datos Básicos de Producto

Name
  1. OBLIGATORIO 
  2. Nombre del producto
  3. 100 caracteres máximo
  4. Campo que usa el motor de búsqueda interno de Oct8ne, para buscar.

Price
  1. OPCIONAL
  2. Precio del producto
  3. 50 caracteres máximo

Item Url
  1. OPCIONAL
  2. Página de destino del producto.
  3. La URL debe empezar por http o https.
  4. 250 caracteres máximo

Description
  1. OPCIONAL
  2. Descripción del producto de forma precisa. Puede usar el mismo que el de página web.
  3. No debe añadir etiquetas ‘html’.
  4. La URL debe empezar por http o https.
  5. 250 caracteres máximo

Reference
  1. OPCIONAL
  2. Número de referencia interno del producto.
  3. 100 caracteres máximo

Categories
  1. OPCIONAL
  2. Seleccione la categoría, en el árbol de categorías creado previamente.




El campo Item URL es muy importante, ya que es el campo que permite realizar el tracking de producto. Mediante este campo, sabemos qué producto está mirando el cliente, y podemos mostrarlo en el visor de Oct8ne. 

Para ello, es necesario que el campo Item URL sea IDENTICO a la URL canonical de cada página de producto. 



En caso de que la pagina no disponga de la etiqueta rel=’canonical’, el campo Item URL debe ser IDENTICO a la URL de la página.



El campo referencia es el numero interno del producto y puede ser usado en el BOT para realizar búsquedas directas de ese producto en concreto.





En la parte derecha, aparece la sección para añadir imágenes al producto en cuestión.


Clicando en el botón de ’Añadir’, aparecerá un desplegable, donde informaremos al sistema de la localización del recurso que vamos a añadir. 


Puede ser un archivo almacenado en nuestro PC, una URL publica, o un video subido a la plataforma YouTube. (¡No se aceptan otras plataformas!)

Recuerda: Añadir imágenes es muy importante en Oct8ne, así estarás aprovechando todo el potencial de la herramienta. Si el producto cargado no tiene imagen, se observará una imagen por ‘default’ dentro del visor.  

Se aceptan imágenes del tipo: jpg, png, bmp y gif. 

Otras extensiones NO están soportadas.


Una vez rellenada la ficha del producto clicaremos en GUARDAR y el producto quedará listo para poder mostrar a través del visor de Oct8ne.





¿Pero qué sucede con las tiendas que quieren subir muchos productos de manera masiva?




  1. CARGA MASSIVA (mediante archivo FEED)


Si tu catálogo contiene decenas, cientos o miles de productos, la mejor opción es que realices una carga MASSIVA, es decir, una subida de productos en bloque, de todos los productos de tu tienda.


Para ello, usaremos un archivo, al que llamaremos FEED de productos. Este archivo tiene que tener una serie de características que más adelante explicaremos. (Ver punto 3 – Tipos de carga)


Primero de todo, debes decidir si quieres introducir tu catálogo en Oct8ne de manera PUNTUAL o si quieres que la carga de tus productos sea RECURRENTE.


Si es PUNTUAL, la carga se realizará una SOLO UNA VEZ. Es ideal para tener productos que no cambian demasiado sus características, es decir, la descripción, el título, las imágenes, el precio, son estables en el tiempo.… Es como tener una fotografía puntual de tu catalogo en Oct8ne.


Si, por el contrario, tu tienda trabaja con productos dinámicos, es decir, cambian de precio, descripción, se añaden, se borran, de manera periódica, te recomendamos que uses una carga RECURRENTE.


Dirígete a la sección ‘oct8ne Catalog’ del panel de Oct8ne. Clica en la pestaña ‘MASSIVE FEED’


Luego en el lado derecho clica en ‘Add Feed'









Si seleccionas FEED PUNTUAL (o MANUAL)





Debes informar a oct8ne del tipo de archivo FEED que estás subiendo.

Puedes escoger entre CSV o XML. 


Debes escoger un idioma para el FEED, es sólo para fines informativos.


Al clicar en el botón Upload File, podrás escoger el archivo de tu ordenador. Clica en abrir, y la carga del fichero se habrá completado correctamente.

Recuerda: La carga PUNTUAL SOLO se realiza una vez.

Además, los productos NO SERÁN VISIBLES INMEDIATAMENTE.

Como norma general, no tardamos más de 1h aproximadamente para importar correctamente tus productos a nuestros servidores. Ten paciencia. Gracias! 😉




Si seleccionas FEED RECURRENTE (o SCHEDULE)




Deberás introducir un título que aparecerá como una categoría padre en el catálogo.

Deberás seleccionar el formato del archivo del FEED, ya sea CSV o XML.

Deberás rellenar el nombre del archivo CON EXTENSIÓN y la ruta en la cual estará siempre disponible para Oct8ne. Necesitamos la URL absoluta para descargar el fichero recurrentemente.


De manera opcional entendemos que tu fichero y/o tu servidor pueden estar protegidos con contraseña. Si deseas tener una seguridad ‘extra’ en tu fichero, deberás proporcionarnos permisos para acceder, ya sea el ‘username’ y el ‘password’ para poder acceder de manera remota.




Finalmente, deberás escoger un lenguaje para el fichero, de manera informativa, y, muy importante, la frecuencia con la que quieres que Oct8ne acceda a tus servidores a descargar el archivo y actualizar los productos. 


Una vez rellenado el formulario el FEED RECURRENTE quedará correctamente configurado, y este paso, no se deberá realizar más.

Recuerda: Los productos NO SERÁN VISIBLES INMEDIATAMENTE.

La importación recurrente es un proceso que realizamos por la noche de madrugada. Como norma general, no tardamos más de 24H aproximadamente para importar correctamente tus productos a nuestros servidores. Ten paciencia. ¡Gracias! 😉





3. TIPOS DE ARCHIVOS


Para realizar este tipo de cargas masivas de producto se usan archivos que sirven de FEED (alimento) para nutrir a nuestros servidores de los datos de tus productos. Estos archivos tienen un formato determinado y una nomenclatura determinada que vamos a revisar a continuación.


CSV


Un archivo CSV (valores separados por comas) es un archivo de texto que tiene un formato específico que permite guardar los datos en un formato de tabla estructurada.


Normalmente se usa el Excel para poder leer estos archivos, pero no es el único software que puede usarse.

Nota: El archivo CSV consta de columnas y filas. Cada columna delimita un atributo y cada fila describe un producto. Las columnas representadas por los atributos deben estar separados por coma (lo más habitual), o también pueden estar separadas por tabulador, punto y coma, entre otros caracteres. 

El mismo archivo define cómo están separadas las columnas. Por consiguiente, las filas deberán seguir el mismo separador.

Utiliza una sola fila para cada producto.

-------------

Mas información:

https://es.wikipedia.org/wiki/Valores_separados_por_comas

https://support.google.com/google-ads/editor/answer/56368

https://www.geeknetic.es/Archivo-CSV/que-es-y-para-que-sirve


Las columnas (atributos) que usamos para importar los datos son los mismos que el formato estándar de Google Merchant.


https://support.google.com/merchants/answer/7052112?hl=es


Es decir, nos basamos en las columnas tal y como se define el documento estándar de Google Merchant en los datos básicos de producto. (Deben ser IDENTICAS)



Datos Básicos de Producto

id
  1. OBLIGATORIO 
  2. Utilice un valor único para cada producto. Use el código SKU del producto siempre que sea posible.
  3. Conserve el mismo ID cuando suba sus datos.

title
  1. OBLIGATORIO
  2. Nombre del producto
  3. Titule su producto de forma precisa.
  4. No incluya texto promocional (como "Envío gratis"), no escriba todo en mayúsculas ni utilice caracteres extranjeros.
  5. Para las variantes, es recomendable que incluya una característica distintiva, como el color o la talla.

description
  1. OBLIGATORIO
  2. Describa su producto de forma precisa. Puede usar el mismo que el de página web.
  3. No incluya texto promocional (como "Envío gratis"), no escriba todo en mayúsculas ni utilice caracteres extranjeros.
  4. Incluya únicamente información sobre el producto. No incluya enlaces a su tienda, información de ventas o datos sobre sus competidores, otros productos o accesorios.

link
  1. OBLIGATORIO
  2. Página de destino del producto
  3. Use su nombre de dominio verificado.
  4. La URL debe empezar por http o https.
  5. Utilice una URL codificada que cumpla las normativas RFC 2396 o RFC 1738. Por ejemplo, la coma debe escribirse como "%2C".

image_link
  1. OBLIGATORIO
  2. URL de la imagen principal del producto
  3. Debe enlazar a la imagen principal del producto.
  4. La URL debe empezar por http o https.
  5. Utilice una URL codificada que cumpla las normativas RFC 2396 o RFC 1738. Por ejemplo, la coma debe escribirse como "%2C".
  6. Utilice un formato aceptado: JPEG (.jpg/.jpeg), PNG (.png), GIF(.gif), BMP (.bmp) 

additional_image_link
  1. OPCIONAL
  2. URL de una imagen adicional del producto
  3. Se pueden añadir más de una imagen separadas por coma

price
  1. OBLIGATORIO 
  2. Precio del producto
  3. Envíe el precio y la moneda del producto; deben ser precisos y coincidir con el precio que aparece en la página de destino.

sale_price
  1. OPCIONAL
  2. Precio de oferta del producto
  3. Cumpla los requisitos del atributo de ‘price’ descrito anteriormente.

product_type
  1. OPCIONAL
  2. Categoría que asigna a su producto
  3. Incluya la categoría completa. Por ejemplo, incluya Hogar > Mujer > Vestidos > Vestidos largos.
  4. Separe las diferentes subcategorías con el carácter ‘mayor que ‘(>)



Nota: Si el archivo contiene más columnas de las descritas anteriormente; ésas no serán importadas al catálogo de Oct8ne. Serán ignoradas por nuestro sistema.



Nota: Se adjunta un archivo de ejemplo. Normalmente se abre con Excel, pero al grabar se tiene que ir con cuidado para respetar el formato ya que es muy fácil corromper el fichero. Recomendamos abrir este tipo de archivos con un editor de texto (Notepad++, etc.)  para observar mejor los separadores.


https://backoffice-eu.oct8ne.com/api/sample-feed/demo.csv




Nota: El campo link es muy importante, ya que es el campo que permite realizar el tracking de producto. Mediante este campo, sabemos qué producto está mirando el cliente, y podemos mostrarlo en el visor de Oct8ne. 

Para ello, es necesario que el campo link sea IDENTICO a la URL canonical de cada página de producto. 



En caso de que la pagina no disponga de la etiqueta rel=’canonical’, el campo link debe ser IDENTICO a la URL de la página.





XML


Un archivo con la extensión. xml consiste en un archivo de lenguaje marcado extensible (XML), el cual consiste en un archivo de texto sin formato que utiliza una serie de etiquetas personalizadas con la finalidad de describir tanto la estructura como otras características del documento.

Nota: El archivo XML consta de una serie de etiquetas de inicio y de cierre que delimitan la información de los productos. 

-------------

Mas información:

https://es.wikipedia.org/wiki/Extensible_Markup_Language

https://www.muyinteresante.es/tecnologia/articulo/que-es-y-como-abrir-un-archivo-xml-201608322902


Las etiquetas que usamos para importar los datos son los mismos que el formato estándar de Google Merchant. (<item>).


Para empezar el archivo XML definiremos el encabezado dentro del mismo:


<?xml version="1.0" encoding="UTF-8"?>

<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">

 <channel>

    <title>You Store</title>

    <description>Import demo</description>

    <link>http://YourWebsite.com</link>

 

          -- ALL ITEMS GOES HERE --


 </channel>

</rss>




Seguidamente, añadiremos dentro de la etiqueta <channel> los bloques de productos <item>


Dentro de la etiqueta (<item>), añadiremos las etiquetas correspondientes a los datos básicos del producto. Hay que añadir cada bloque de etiqueta (<item>), para cada producto que deseemos importar.





Datos Básicos de Producto

g:id
  1. OBLIGATORIO 
  2. Utilice un valor único para cada producto. Use el código SKU del producto siempre que sea posible.
  3. Conserve el mismo ID cuando suba sus datos.

title
  1. OBLIGATORIO
  2. Nombre del producto
  3. Titule su producto de forma precisa.
  4. No incluya texto promocional (como "Envío gratis"), no escriba todo en mayúsculas ni utilice caracteres extranjeros.
  5. Para las variantes, es recomendable que incluya una característica distintiva, como el color o la talla.

description
  1. OBLIGATORIO
  2. Describa su producto de forma precisa. Puede usar el mismo que el de página web.
  3. No incluya texto promocional (como "Envío gratis"), no escriba todo en mayúsculas ni utilice caracteres extranjeros.
  4. Incluya únicamente información sobre el producto. No incluya enlaces a su tienda, información de ventas o datos sobre sus competidores, otros productos o accesorios.

link
  1. OBLIGATORIO
  2. Página de destino del producto
  3. Use su nombre de dominio verificado.
  4. La URL debe empezar por http o https.
  5. Utilice una URL codificada que cumpla las normativas RFC 2396 o RFC 1738. Por ejemplo, la coma debe escribirse como "%2C".

g:image_link
  1. OBLIGATORIO
  2. URL de la imagen principal del producto
  3. Debe enlazar a la imagen principal del producto.
  4. La URL debe empezar por http o https.
  5. Utilice una URL codificada que cumpla las normativas RFC 2396 o RFC 1738. Por ejemplo, la coma debe escribirse como "%2C".
  6. Utilice un formato aceptado: JPEG (.jpg/.jpeg), PNG (.png), GIF(.gif), BMP (.bmp) 

g:additional_image_link
  1. OPCIONAL
  2. URL de una imagen adicional del producto
  3. Se pueden añadir cuantas quieran. Ver ejemplo.

g:price
  1. OBLIGATORIO 
  2. Precio del producto
  3. Envíe el precio y la moneda del producto; deben ser precisos y coincidir con el precio que aparece en la página de destino.

g:sale_price
  1. OPCIONAL
  2. Precio de oferta del producto
  3. Cumpla los requisitos del atributo de ‘price’ descrito anteriormente.

g:product_type
  1. OPCIONAL
  2. Categoría que asigna a su producto
  3. Incluya la categoría completa. Por ejemplo, incluya Hogar > Mujer > Vestidos > Vestidos largos.
  4. Separe las diferentes subcategorías con el carácter ‘mayor que ‘(>)





Nota: Se adjunta un archivo de ejemplo. Se recomienda usar un editor de texto del tipo Notepad++ o similar, para crear o editar este tipo de archivos.


https://backoffice-eu.oct8ne.com/api/sample-feed/demo.xml




Nota: El campo link es muy importante, ya que es el campo que permite realizar el tracking de producto. Mediante este campo, sabemos qué producto está mirando el cliente, y podemos mostrarlo en el visor de Oct8ne. 

Para ello, es necesario que el campo link sea IDENTICO a la URL canonical de cada página de producto. 



En caso de que la pagina no disponga de la etiqueta rel=’canonical’, el campo link debe ser IDENTICO a la URL de la página.





    • Related Articles

    • Manual de instrucciones del Bot para web y messaging

      TABLA DE CONTENIDO 1. VISIÓN GENERAL 1.1. El diseñador de conversaciones 2. BOT WEB: PRIMEROS PASOS 2.1. Crear una conversación 2.2. Herramientas específicas en el diseñador de conversaciones 2.3. Encender y apagar el Bot 3. BOT MESSAGING: PRIMEROS ...

    • Descarga de estadísticas mediante API

      Oct8ne permite descargar la información de todas las sesiones almacenadas en la plataforma con objeto de facilitar el tratamiento externo de los datos. Para ello, se deberá realizar una petición hacia los servidores de Oct8ne con una clave de ...

    • Asignación de agente personalizada

      Asignación de agentes avanzada Oct8ne permite a sus clientes, asignar o forzar directamente determinados agentes en una página concreta. No sólo eso, sino que además, el sistema flexible de oct8ne detecta si el agente (forzado) NO está conectado en ...

    • API Oct8ne de integración con CSM a medida

      Documentación del API Oct8ne Versión del API 2.4 (Octubre 2024 / rev05) Índice de contenidos 1. Introducción 2. Arquitectura 3. Vista general 3.1. Descargar e instalar plugin/extensión 3.2. Registro como desarrollador y activación de la plataforma ...

    • Añadir en mi página de Facebook el botón de WhatsApp

      Una vez integrado un numero de WhatsApp en Oct8ne es posible que al intentar vincular un numero de WhatsApp con una página de Facebook no recibamos un código de verificación por parte de Facebook necesario para este proceso, a continuación, vamos a ...