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, usando el método de sincronización que hayas seleccionado.

Después de hacer clic en Start New Data Sync, Data Sync mostrará el tiempo estimado de espera y el estado en la cola antes de comenzar el procesamiento:

• Empieza en [tiempo] significa que la sincronización está esperando a que termine el cooldown.
• Pequeño retraso en la cola de descarga significa que hay entre 20 y 99 trabajos en espera.
• Retraso moderado en la cola de descarga significa que hay entre 100 y 499 trabajos en espera.
• Retraso significativo en la cola de descarga significa que hay 500 o más trabajos en espera.
• Iniciando sincronización de datos… significa que no hay ningún retraso relevante.

Información #

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

• El número de productos, categorías, páginas, pedidos y clientes importados
• La duración de la última sincronización y la duración promedio de una sincronización completa
• Marcas de tiempo de cuándo se intentó y se completó por última vez una sincronización o análisis
• Marcas 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 cuándo Clerk obtuvo los datos del eCommerce por última vez, mientras que los detalles de análisis se refieren a cuándo Clerk procesó y guardó los datos por última vez.

Configuración #

Estos ajustes te permiten configurar la sincronización de datos para acceder a la tienda online y hacer ajustes en cómo se obtienen los datos.

Método de sincronización #

Clerk incluye una variedad de integraciones y métodos de sincronización, lo que permite sincronizar desde cualquier plataforma de eCommerce. Las integraciones que desarrollamos usan 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 experimentar con my.clerk.io y nuestra API antes de empezar una configuración real.

Hora de sincronización #

Esta opción te permite elegir intervalos de 1 hora para ejecutar la sincronización. Al elegir una hora, la sincronización solamente se ejecutará dentro de ese periodo de tiempo en horario UTC. Es útil si deseas ahorrar recursos del servidor en horas de alta demanda y solo sincronizar cuando el servidor esté menos ocupado.

Por defecto, está configurado como Cuando sea necesario (Recomendado), lo que permite ejecutar la sincronización regularmente dependiendo de cuánto tiempo tarda en cargar tus datos. Si tarda menos de 10 minutos, la sincronización puede ejecutarse cada hora, mientras que procesos que duran más de 60 minutos pueden solo correr una vez al día.

Importar #

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

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

Clerk requiere productos y categorías para funcionar correctamente y es altamente recomendable importar también los pedidos, ya que son el principal impulsor 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 tratan como protegidas y no se sobrescriben por la sincronización de datos.

Importadores de IA #

Los Importadores de IA 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 guiará por las credenciales, construirá el importador, probará la conexión y transferirá a Data Sync toda la configuración lista.

También puedes resolver preguntas sobre importadores y sincronización dentro de la misma conversación de Ask Clerk.io. Si una sincronización necesita credenciales o alguna otra decisión, Ask Clerk.io te explicará lo que necesita antes de continuar.

Los Importadores de IA son integraciones independientes. Si tu tienda está en Shopify, por ejemplo, y deseas importar otros datos que el importador estándar de Shopify no cubre, puedes configurar un nuevo Importador de IA que se conecte directamente a Shopify.

Ese Importador de IA gestionará todo: los datos estándar y cualquier campo adicional que necesites.

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

Lee más sobre el proceso 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 sola configuración de tienda.

Esto es útil cuando tus datos están 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 es gestionado por un importador a la vez: no puedes importar el mismo tipo desde dos fuentes simultáneamente. Pero tienes control total sobre qué importador es responsable de cada tipo.

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

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

Productos y categorías son necesarios 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.

Puedes acceder a esta sección haciendo clic en Show latest sync log details.

Lista blanca de direcciones IP #

Si tu servidor tiene un bloqueo por IP, debes incluir en la lista blanca la dirección IP del sistema de Data Sync de Clerk para permitir el acceso a tus datos.

La dirección IP es 52.57.0.11

Esta IP puede cambiar. Si Data Sync responde con un 403 u otro error 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 demora. Mientras que la sincronización completa es ideal para cargar grandes volúmenes de datos a intervalos regulares, las actualizaciones en tiempo real se usan para enviar pequeños cambios a medida que ocurren.

La mayoría de nuestras extensiones e integraciones las tienen incorporadas, 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 enteros.

Esto significa que Clerk no tendrá que esperar una sincronización completa cada vez que realices pequeños cambios, manteniendo tu configuración siempre al día.

Al agregar un producto a través de la sincronización en tiempo real, aparecerá en tu tienda online al instante, una vez que se muestre en el backend de Clerk.io.

Cuando se añade un producto a través de 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 aparezca como producto popular hasta que se ejecute la sincronización completa de datos.

Archivos CSV #

Este es un método especial de sincronización que puede utilizarse para demostrar las funciones de Clerk.io a través de una demostración en vivo, subiendo una exportación única de tu catálogo. Puedes usarlo seleccionando One-Time CSV Upload desde el menú desplegable Sync method.

La pantalla de subida muestra una barra de progreso en tiempo real mientras Clerk.io procesa los archivos. El procesamiento puede continuar después de finalizar la transferencia del archivo, por lo que debes esperar a que el progreso termine antes de continuar.

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 plantillas CSV para todos los tipos de datos.

Todos los archivos usan comas como separador. 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. Una orden con varios productos ocupa varias filas, todas con el mismo id.

Clientes #

Cada fila representa un cliente. Se debe incluir id o Email. Cualquier columna extra se importa como atributo personalizado y puede usarse para segmentaciones de audiencia.

* Se requiere al menos uno entre id y Email.

Páginas #

Cada fila representa una página de contenido.