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 hayas seleccionado.
Después de hacer clic en Start New Data Sync, Data Sync muestra el tiempo de espera esperado y el estado en cola antes de que comience el procesamiento:
- Comienza en [tiempo] significa que la sincronización está esperando que finalice el enfriamiento.
- Leve retraso en la cola de descarga significa que hay de 20 a 99 tareas delante.
- Retraso moderado en la cola de descarga significa que hay de 100 a 499 tareas delante.
- Retraso significativo en la cola de descarga significa que hay 500 o más tareas delante.
- Iniciando la sincronización de datos… significa que no hay un retraso importante.
Información #
Esta sección te 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
- La duración de la última sincronización y la duración media de una sincronización completa
- Marcas de tiempo de cuándo se intentó o 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 la última vez que Clerk obtuvo datos de la tienda, mientras que los detalles de análisis se refieren a la última vez que Clerk procesó y guardó los datos.
Configuración #
Estos ajustes te permiten configurar la sincronización de datos para obtener acceso a la tienda y ajustar cómo se obtienen los datos.
Método de sincronización #
Clerk incluye varias integraciones y métodos de sincronización, lo que hace posible sincronizar desde cualquier plataforma de comercio electrónico. Las integraciones que construimos utilizan su propio método de sincronización para plataformas como Shopify, Magento, WooCommerce y otras.
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 iniciar una configuración real.
Hora de sincronización #
Esta configuración te permite elegir incrementos de 1 hora para programar la ejecución de la sincronización. Al elegir una hora, la sincronización solo se ejecutará dentro de ese intervalo de tiempo en la zona horaria UTC. Esto es útil si quieres ahorrar capacidad del servidor durante horas de alta demanda 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 podría ejecutarse cada hora, mientras que sincronizaciones de 60 minutos o más solo se ejecutarían una vez al día.
Importar #
Puedes decidir exactamente qué puntos de datos importar seleccionando Sí o No para cada uno de ellos:
- 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 son el principal motor de los resultados de Clerk.
Las páginas importadas mediante 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 subas manualmente en Data > Pages se consideran protegidas y no serán sobrescritas por la sincronización de datos.
Importadores AI #

Los AI Importers te permiten crear una integración personalizada desde cero, sin 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 te quieres conectar y Ask Clerk.io te guía en las credenciales, crea el importador, prueba la conexión y transfiere a Data Sync con la configuración completa.
También puedes tratar cuestiones sobre importadores y sincronización en la misma conversación de Ask Clerk.io. Si una sincronización necesita credenciales u otra decisión, Ask Clerk.io te explica lo que necesita antes de continuar.
Los AI Importers son integraciones independientes. Si tu tienda funciona con Shopify, por ejemplo, y deseas importar datos adicionales que el importador estándar de Shopify no cubre, puedes configurar un nuevo AI Importer para comunicarse directamente con Shopify.
Ese AI Importer gestiona 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 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 #
Multiple Importers te permite combinar diferentes métodos de sincronización para distintos tipos de datos en una única configuración de tienda.
Esto es útil cuando tus datos se encuentran 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 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 también 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 ellos.
Registro de sincronización #
Esta sección te muestra el estado de la sincronización mientras está en curso y cuando ha finalizado. Es útil para confirmar que todo funciona correctamente y ayuda a depurar si se presentan problemas.
Puedes acceder haciendo clic en Show latest sync log details.

Lista blanca de direcciones IP #
Si tu servidor tiene un bloqueo de IP, necesitas incluir en la lista blanca la dirección IP del sistema Data Sync de Clerk para permitir el 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 dirección IP actual.
Actualizaciones en tiempo real #
Esta es la mejor manera de mantener Clerk actualizado con tu tienda online sin demoras. Mientras que la sincronización completa de datos es ideal para cargar grandes cantidades de datos en intervalos regulares, las actualizaciones en tiempo real se utilizan para enviar pequeños cambios a medida que ocurren.
La mayoría de nuestras extensiones e integraciones ya las incluyen, sin necesidad de configuración adicional. Para cualquier otra plataforma, se pueden configurar a través de nuestra CRUD API.
Con las actualizaciones en tiempo real habilitadas, Clerk puede obtener cambios como una simple actualización de precio o también agregar o eliminar productos por completo.
Esto significa que Clerk no tendrá que esperar a una sincronización completa cada vez que realices pequeños cambios, manteniendo tu configuración completamente actualizada de inmediato.
Al agregar un producto a través de la sincronización en tiempo real, aparecerá en tu tienda instantáneamente después de que se muestre en el backend de Clerk.io.
Cuando se agrega un producto mediante la sincronización en tiempo real, es visible de inmediato en Search, Recommendations y Email, pero el ranking del producto no está incluido. Esto significa que puede no aparecer como un producto popular hasta que se realice la sincronización completa de datos.
Archivos CSV #
Este es un método de sincronización especial que puede usarse para demostrar las funciones de Clerk.io mediante una Live Demo cargando una exportación única de tu catálogo. Puedes usarlo eligiendo One-Time CSV Upload en el menú desplegable Sync method.
La pantalla de carga 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, así que espera hasta que el progreso esté completo 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 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.
| Campo | Obligatorio | Descripción |
|---|---|---|
id | Obligatorio | Identificador único del producto |
Name | Obligatorio | Nombre del producto |
description | Obligatorio | Descripción del producto |
price | Obligatorio | Precio actual de venta |
image | Obligatorio | URL completa de la imagen del producto |
url | Obligatorio | URL completa de la página del producto |
categories | Obligatorio | IDs de categorías a las que pertenece el producto, separadas por comas. Utiliza comillas al listar varias: "1,2,3" |
list_price | Opcional | Precio original antes de descuentos |
Vendor | Opcional | Marca o nombre del proveedor |
Tags | Opcional | Etiquetas del producto separadas por comas |
Status | Opcional | Estado del producto, por ejemplo active |
Categorías #
Cada fila representa una categoría.
| Campo | Obligatorio | Descripción |
|---|---|---|
id | Obligatorio | Identificador único de la categoría |
name | Obligatorio | Nombre de la categoría |
url | Obligatorio | URL completa de la página de la categoría |
subcategories | Obligatorio | IDs de las categorías hijas separadas por comas. Déjalo en blanco si no hay ninguna |
image | Opcional | URL completa de la imagen de la categoría |
description | Opcional | Descripción de la categoría |
Pedidos #
Cada fila representa un artículo de línea. Un pedido con varios productos abarca varias filas, todas con el mismo id.
| Campo | Obligatorio | Descripción |
|---|---|---|
id | Obligatorio | Identificador del pedido. Se repite en las filas para pedidos con varios productos |
time | Obligatorio | Marca de tiempo Unix de cuando se realizó el pedido |
Product_Id | Obligatorio | ID del producto comprado en esta línea |
Email | Recomendado | Dirección de correo electrónico del cliente, usada para personalización |
quantity | Recomendado | Cantidad del producto en esta línea |
price | Recomendado | Precio pagado por el producto en esta línea |
Clientes #
Cada fila representa un cliente. Debe estar presente al menos id o Email. Cualquier columna adicional que incluyas se importará como atributo personalizado y puede utilizarse para segmentación de audiencia.
| Campo | Obligatorio | Descripción |
|---|---|---|
id | Obligatorio* | Identificador único del cliente |
Email | Obligatorio* | Dirección de correo electrónico del cliente |
name | Opcional | Nombre completo |
First Name | Opcional | Nombre |
Last Name | Opcional | Apellido |
* Se requiere al menos uno: id o Email.
Páginas #
Cada fila representa una página de contenido.
| Campo | Obligatorio | Descripción |
|---|---|---|
id | Obligatorio | Identificador único de la página |
type | Obligatorio | Tipo de página, por ejemplo blog o article |
url | Obligatorio | URL completa de la página |
title | Obligatorio | Título de la página |
text | Obligatorio | Contenido completo de la página |
image | Opcional | URL completa de la imagen de la página |
Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.