Sync

Iniciar una sincronización #

Siempre puedes iniciar una sincronización completa desde my.clerk.io accediendo a Data > Configuration y haciendo clic en Start New Data Sync.

Esto importará todos los datos más recientes de tu tienda online, utilizando el método de sincronización que hayas seleccionado.

Información #

Esta sección proporciona una visión rápida sobre el estado de la sincronización:

• El número de productos, categorías, páginas, pedidos y clientes que se han importado
• Marcas de tiempo de cuándo se intentó y completó por última vez una sincronización o análisis
• Marcas de tiempo de cuándo la sincronización o el análisis registraron un cambio en un producto por última vez

Los Detalles de Sincronización se refieren a cuándo Clerk obtuvo datos por última vez de la tienda online, mientras que los Detalles de Análisis se refieren a cuándo Clerk procesó y guardó los datos por última vez.

Configuración #

Estas opciones te permiten configurar la sincronización de datos para acceder a la tienda online y ajustar cómo se obtienen los datos.

Método de sincronización #

Clerk ofrece una serie de integraciones y métodos de sincronización, lo que permite sincronizar desde cualquier plataforma de comercio electrónico. Las integraciones que desarrollamos utilizan su propio método de sincronización para plataformas como Shopify, Magento, WooCommerce, entre otros.

También es posible elegir Demo Data como método de sincronización. Con esto, Clerk sincronizará un conjunto de datos predefinido que puedes utilizar para pruebas. Esto es útil si solo quieres explorar my.clerk.io y nuestra API antes de comenzar una configuración real.

Hora de sincronización #

Esta opción te permite elegir intervalos de 1 hora para ejecutar la sincronización. Al seleccionar una hora, la sincronización solo se ejecuta dentro de ese intervalo de tiempo en horario UTC. Esto es útil si quieres ahorrar capacidad del servidor durante las horas de mayor carga, y solo sincronizar cuando el servidor esté menos ocupado.

Por defecto, está configurado en Cuando sea necesario (Recomendado), lo que ejecutará la sincronización regularmente en función de cuánto tiempo toma cargar tus datos. Si toma menos de 10 minutos, la sincronización puede ejecutarse cada hora, mientras que las sincronizaciones que tarden 60 minutos o más pueden ejecutarse solo una vez al día.

Importación #

Puedes decidir exactamente qué puntos de datos importar seleccionando Sí o No para cada uno de:

• Productos
• Categorías
• Pedidos
• Clientes
• Páginas

Clerk requiere productos y categorías para funcionar correctamente, y es altamente recomendable también importar los pedidos, ya que son la principal fuerza impulsora detrás de los resultados de Clerk.

Las páginas importadas a través de la sincronización de datos sobrescribirán cualquier cambio realizado en my.clerk.io en esas páginas sincronizadas la próxima vez que se sincronicen las páginas.

Las páginas que subes manualmente en Data > Pages se consideran protegidas y no son sobrescritas por la sincronización de datos.

AI Importers #

Los AI Importers te permiten crear una integración personalizada desde cero, sin ninguna configuración predefinida. Si tu plataforma expone una API, Clerk.io puede conectarse a ella.

La configuración se gestiona a través de Ask Clerk.io. Describe a qué plataforma deseas conectarte, y Ask Clerk.io te guía a través de las credenciales, construye el importador, prueba la conexión y entrega la configuración completa a Data Sync.

Los AI Importers son integraciones independientes. Si tu tienda, por ejemplo, usa Shopify y quieres importar datos adicionales que el importador estándar de Shopify no cubre, puedes configurar un nuevo AI Importer diseñado para conectarse directamente con Shopify.

Ese AI Importer entonces maneja todo: los datos estándar así como cualquier campo extra que necesites.

Una vez establecida la conexión, puedes ampliar lo que se importa —añadiendo atributos extra, trayendo datos desde integraciones de terceros o ajustando la lógica para que se adapte a tu catálogo— todo a través de Ask Clerk.io.

Lee más sobre el flujo de configuración en AI Importer.

Múltiples importadores #

Múltiples importadores te permiten combinar diferentes métodos de sincronización para distintos tipos de datos en una misma tienda.

Esto es útil cuando tus datos residen en más de un lugar. Por ejemplo, puedes importar productos, categorías y pedidos desde Magento 1, mientras importas datos de clientes desde una plataforma de segmentación y páginas desde WordPress.

Cada tipo de datos lo maneja un importador a la vez — no puedes importar el mismo tipo de dos fuentes simultáneamente. Pero tienes control total sobre qué importador es responsable de cada tipo.

Ve a Data > Configuration y utiliza el botón + Add importer para añadir un segundo método de sincronización junto al ya existente.

Para cada importador, puedes configurar qué tipos de datos debe importar. Si un tipo de datos está asignado a un importador, no debe estar habilitado en otro — cada tipo debe tener exactamente una fuente.

Productos y categorías son obligatorios para que Clerk.io funcione correctamente. Asegúrate de que al menos un importador sea responsable de cada uno de estos.

Registro de sincronización #

Esta sección muestra el estado de la sincronización mientras se está ejecutando y cuando ha finalizado. Es útil para confirmar que todo funciona correctamente y ayuda a depurar si surgen problemas.

Puedes acceder haciendo clic en Show latest sync log details.

Permitir dirección IP #

Si tu servidor tiene un bloqueo de IP, debes permitir la dirección IP del sistema de Data Sync de Clerk para dar acceso a tus datos.

La dirección IP es 52.57.0.11

Esta IP está sujeta a cambios. Si Data Sync responde con un error 403 o similar, simplemente vuelve a esta página para encontrar la IP actual.

Actualizaciones en tiempo real #

Esta es la mejor manera de mantener Clerk actualizado con tu tienda online sin demoras. Si bien la sincronización completa de datos es ideal para cargar grandes cantidades de datos en intervalos regulares, las actualizaciones en tiempo real se usan para enviar cambios más pequeños en el momento en que ocurren.

La mayoría de nuestras extensiones e integraciones ya las incluyen de manera predeterminada, sin configuración adicional. Para cualquier otra plataforma, se pueden configurar a través de nuestra CRUD API.

Con las actualizaciones en tiempo real activas, Clerk puede detectar cambios como una simple actualización de precio, pero también añadir o eliminar productos por completo.

Esto significa que Clerk no tendrá que esperar a una sincronización completa cada vez que realices cambios menores, manteniendo tu configuración completamente actualizada de inmediato.

Al añadir un producto mediante la sincronización en tiempo real, aparecerá en tu tienda online inmediatamente después de que se muestre en el backend de Clerk.io.

Cuando un producto se añade mediante la sincronización en tiempo real, es inmediatamente visible en Search, Recommendations y Email, pero el ranking del producto no está incluido. Esto significa que puede que no se muestre como un producto popular hasta que se realice la sincronización completa de datos.

Archivos CSV #

Este es un método especial de sincronización que puede usarse para hacer una demo de las funciones de Clerk.io a través de una Live Demo subiendo una exportación única de tu catálogo. Puedes utilizarlo seleccionando One-Time CSV Upload desde el menú desplegable de Sync method.

Genera archivos CSV al menos para tus productos, categorías y pedidos y, si quieres ver todas las capacidades de Clerk, también para tus clientes y páginas.

Descarga un archivo zip que contiene archivos de plantilla CSV para todos los tipos de datos.

Todos los archivos utilizan separación por comas. Cualquier valor que contenga una coma debe ir entre comillas dobles, por ejemplo, "1,2,3" para una lista de IDs.

Productos #

Cada fila representa un producto.

Categorías #

Cada fila representa una categoría.

Pedidos #

Cada fila representa una línea de pedido. Un pedido con varios productos abarca varias filas, todas compartiendo el mismo id.

Clientes #

Cada fila representa un cliente. Debe haber al menos id o Email. Cualquier columna extra que incluyas se importa como atributo personalizado y puede ser usada para segmentación de audiencia.

* Es necesario al menos uno de id o Email.

Páginas #

Cada fila representa una página de contenido.