Sync

Iniciar una sincronización #

Siempre puedes iniciar una sincronización completa desde my.clerk.io yendo 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 has seleccionado.

Información #

Esta sección proporciona información rápida sobre el estado de tu sincronización:

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

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

Configuración #

Estas configuraciones 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 viene con varias integraciones y métodos de sincronización, lo que permite sincronizar desde cualquier plataforma de eCommerce. Las integraciones que desarrollamos utilizan su propio método de sincronización para plataformas como Shopify, Magento, WooCommerce, etc.

También es posible elegir Demo Data como método de sincronización. Con esto, Clerk sincronizará un conjunto de datos predefinido que puedes usar 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 configuración te permite elegir incrementos de 1 hora en los que se debe ejecutar la sincronización. Al elegir una hora, la sincronización solo se ejecutará dentro de ese intervalo de tiempo en horario UTC. Esto es útil si deseas 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 dependiendo de cuánto tiempo tarde en cargar tus datos. Si tarda menos de 10 minutos, la sincronización puede ejecutarse cada hora, mientras que sincronizaciones de más de 60 minutos pueden ejecutarse solo una vez al día.

Importación #

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

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

Clerk requiere productos y categorías para funcionar correctamente, y se recomienda enérgicamente importar también los pedidos, ya que estos son la principal fuerza motriz 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 a esas páginas sincronizadas la próxima vez que se sincronicen las páginas.

Las páginas que subas manualmente en Data > Pages se tratan como protegidas y no se sobrescriben mediante la sincronización de datos.

AI Importers #

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

En lugar de completar un conjunto fijo de campos, describes lo que deseas importar en lenguaje natural.

La IA luego genera los campos de entrada necesarios para hacer la conexión, como una URL, una clave API o credenciales de inicio de sesión, según lo que requiera la plataforma.

Cuando añades un nuevo AI Importer, no hay campos de configuración por defecto. Para comenzar, dile a la IA a qué plataforma deseas conectarte y proporciona una URL de tu tienda.

A partir de ahí, la IA pedirá las credenciales que necesita y construirá la configuración. En muchos casos puede encontrar la documentación relevante de la API por sí misma, pero también puedes compartir documentación directamente para darle más contexto.

Una vez que se establece la conexión, puedes refinar y ampliar lo que se importa — añadiendo atributos extra, integrando datos de terceros, o ajustando la lógica para adaptarse a tu catálogo.

En este punto, los AI Importers son integraciones independientes. Si tu tienda funciona en Shopify, por ejemplo, y deseas importar datos adicionales que el importador estándar de Shopify no cubre, puedes configurar un nuevo AI Importer para que se comunique directamente con Shopify.

Ese AI Importer luego maneja todo: los datos estándar y también los campos adicionales que necesites.

En el futuro, será posible ampliar los importadores estándar directamente — para que puedas decir “también importa los datos de traducción de Langify” o “integra datos de stock de terceros desde este módulo de Magento” sin comenzar desde cero.

Múltiples Importadores #

Múltiples Importadores te permiten combinar diferentes métodos de sincronización para diferentes tipos de datos en una sola configuración de tienda.

Esto es útil cuando tus datos están en más de un lugar. 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 dato es gestionado por 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 dato es asignado a un importador, no debe estar habilitado en otro — cada tipo debe tener exactamente una fuente.

Los 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 te muestra el estado de la sincronización mientras se está ejecutando y cuando ha terminado. Es útil para confirmar que todo funciona correctamente y te ayuda a depurar si surgen problemas.

Se puede acceder haciendo clic en Show latest sync log details.

Permitir dirección IP en lista blanca #

Si tu servidor tiene un bloqueo por IP, debes permitir la dirección IP del sistema de Data Sync de Clerk para poder acceder 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 dirección IP actual.

Actualizaciones en tiempo real #

Esta es la mejor manera de mantener Clerk actualizado con tu tienda online sin demora. Mientras que la sincronización completa de datos es excelente para cargar grandes cantidades de datos a intervalos regulares, las actualizaciones en tiempo real se utilizan para enviar cambios pequeños a medida que ocurren.

La mayoría de nuestras extensiones e integraciones ya las tienen integradas, sin necesidad de configuración extra. Para cualquier otra plataforma, pueden configurarse a través de nuestra CRUD API.

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

Esto significa que Clerk no tendrá que esperar a una sincronización completa cada vez que realices cambios pequeños, lo que mantiene tu configuración completamente actualizada de inmediato.

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

Cuando se añade un producto mediante la sincronización en tiempo real, es visible de inmediato en Search, Recommendations y Email, pero el ranking del producto no se incluye. Esto significa que es posible que no se muestre como un producto popular hasta que se ejecute la sincronización de datos completa.

Archivos CSV #

Este es un método especial de sincronización que puede utilizarse para demostrar las funciones de Clerk.io mediante una demostración en vivo subiendo una exportación única de tu catálogo. Puedes usarlo eligiendo One-Time CSV Upload desde el desplegable 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 CSV de plantilla para todos los tipos de datos.