Sincronizar datos
La forma recomendada de sincronizar los datos de ideal.shop es mediante una AI Integration usando la API de la tienda. Configúralo para todos los tipos de datos, con las páginas de contenido extraídas a través del sitemap como parte de la misma integración.
Crear Usuario API #
Crea un usuario API en ideal.shop para dar a la AI Integration acceso a los datos de tu tienda.
- Inicia sesión en el backend de ideal.shop.
- Ve a Indstillinger > Integrationer > API.
- Crea un nuevo usuario API.
- Marca la casilla Aktiv junto al usuario API. Los usuarios API no se activan automáticamente y la integración no funcionará hasta que el usuario esté activo.
- Conserva el API Username y el API code mostrados para el usuario. Ambas credenciales serán necesarias durante la configuración.
AI Integration #
Utiliza las credenciales API para construir la integración a través de Ask Clerk.io.
- En my.clerk.io, abre la Tienda correspondiente y ve a Ask Clerk.io.
- Pide que configure una AI Integration para ideal.shop que cubra todos los tipos de datos. Incluye la URL de tu webshop.
- Proporciona el API Username y el API code cuando se soliciten las credenciales.
- Proporciona la URL de tu sitemap y pide que extraiga las páginas de contenido como parte de la misma integración, tal como se describe en Import Pages.
- Revisa los resultados de prueba y los registros de muestra antes de completar la configuración y entregar la integración a Data Sync.
- Abre Data > Configuration, inicia una sincronización de datos y comprueba los conteos y registros importados.
Comprueba que la primera importación cubre todo el catálogo y el historial de pedidos previsto, y que las importaciones continuas incluyen todos los pedidos desde la última sincronización exitosa. Consulta Data Sync para la programación, el estado y los registros.
Import Pages #
Los artículos y otras páginas de contenido necesitan sus propios registros antes de poder aparecer en Search o proporcionar contexto para recomendaciones basadas en páginas.
Las páginas aún deben extraerse a través del sitemap de la tienda. Incluye esto en la misma AI Integration que la importación vía API; no es necesario una integración de páginas independiente.
Proporciona la URL del sitemap en Ask Clerk.io y explica qué tipos de páginas incluir y excluir. Pide que descubra los índices del sitemap y sus sitemaps secundarios, extraiga las páginas deseadas y proponga registros de muestra para revisión.
Para Fodmagasinet, la fuente de descubrimiento de ejemplo es https://www.fodmagasinet.dk/sitemap.xml, excluyendo la página de inicio y URLs que contienen /vare. Estas reglas se ajustan a la estructura de URL de esa tienda; revisa tu propio sitemap antes de definir los filtros.
Valida cada registro de muestra:
- Un ID estable y único que coincida con el ID de artículo en la tienda al usar recomendaciones basadas en páginas.
- El título correcto, URL canónica y contenido relevante del artículo sin texto de cabecera, pie de página o navegación.
- Sin URLs duplicadas, páginas de producto, listados de categorías u otros tipos de página no deseados.
Si el importador genera IDs diferentes de los expuestos por el tema, acuerda una correspondencia con el desarrollador antes de configurar recomendaciones de artículos. Verifica muestras y conteos importados tras la primera ejecución.
Importar páginas y mostrarlas son pasos separados. El Search Design también debe renderizar resultados de páginas; consulta Search.
Native Feed #
El feed JSON nativo es una alternativa para configuraciones existentes basadas en feeds. Los límites a continuación aplican a ese feed, no a la AI Integration recomendada basada en API.
Primero activa la integración, incluyendo Feed offentligt.
Configurar Feed #
Sin límites explícitos, el feed devuelve hasta 50 registros por tipo de dato. Configura límites separados para productos, categorías y pedidos para la primera importación histórica.
- En ideal.shop, abre Indstillinger > Integrationer > Clerk.io.
- Copia la URL bajo Sti til feed.
- Para una URL sin parámetros de consulta, añade
?&products=10000&categories=10000&orders=10000:
https://example.com/feeds/clerk_io_feed.json?&products=10000&categories=10000&orders=10000
Si tu URL ya tiene una cadena de consulta, añade los parámetros con & y mantén los que sean necesarios. No añadas un segundo ? ni dupliques un límite existente.
Estos valores solicitan hasta 10.000 registros de cada tipo nombrado. Aumenta cada límite según sea necesario; 10.000 es un ejemplo, no una garantía de exportación completa. Otros tipos de datos mantienen su valor predeterminado salvo configuración separada.
Por ejemplo, el feed de Fodmagasinet usa la misma sintaxis en su propio dominio:
https://www.fodmagasinet.dk/feeds/clerk_io_feed.json?&products=10000&categories=10000&orders=10000
Iniciar Sincronización #
Configura Clerk.io para leer la URL completa del feed, incluyendo los límites.
- En my.clerk.io, abre la Tienda correspondiente y ve a Data > Configuration.
- Elige Clerk.io JSON Feed como método de sincronización.
- Pega la URL del feed y guarda la configuración.
- Haz clic en Start New Data Sync y espera a que termine.
- Compara los conteos importados con los totales exportables de la tienda, teniendo en cuenta los registros excluidos intencionadamente.
Un conteo igual al límite solicitado puede indicar truncamiento. Aumenta ese límite y sincroniza de nuevo. Comprueba el pedido importado más antiguo, además del total; una sincronización exitosa aún puede contener solo parte del historial.
Consulta Data Sync para estado y registros, o la feed FAQ para truncamientos y tiempos de espera.
Importaciones Continuas #
Tras la primera importación histórica exitosa, elimina &orders=10000. Mantén los límites completos del catálogo:
https://example.com/feeds/clerk_io_feed.json?&products=10000&categories=10000
Eliminar orders restaura el valor predeterminado de las 50 órdenes más recientes. No deshabilita la importación de pedidos. Clerk.io conserva los pedidos importados previamente, por lo que el feed solo necesita cubrir los pedidos recientes.
Antes de usar el valor por defecto, compara el volumen de pedidos de la tienda con el intervalo entre sincronizaciones exitosas, incluyendo retrasos o fallos. Comprueba que el pedido más antiguo devuelto se superpone con la última importación exitosa y que todos los pedidos desde entonces estén presentes.
Si 50 pedidos no cubren ese intervalo, mantén explícitamente un límite orders lo suficientemente alto para cubrirlo con superposición. Por ejemplo, añade &orders=500 solo si cubre tu volumen. Revisa de nuevo tras una interrupción de sincronizaciones o un aumento en pedidos.
Mantén los límites de products y categories lo suficientemente altos para todo el catálogo actual en cada sincronización. No los reduzcas al valor por defecto tras importar una vez.
Validar Datos #
Un estado exitoso y conteos plausibles no demuestran que los datos coinciden con la tienda. Compara registros representativos importados con la tienda real.
| Verificación | Qué comprobar |
|---|---|
| Categorías | Las categorías ocultas o no publicadas están excluidas según lo previsto. Las referencias producto-categoría resuelven a los registros de categoría importados correctos. |
| Disponibilidad | Los productos en stock, agotados y no disponibles se comportan como se espera en los resultados y la compra. Confirma el significado y tipo de los campos de stock. |
| Imágenes | Las imágenes se mantienen nítidas al tamaño real de la tarjeta, tanto en escritorio como en móvil, incluyendo pantallas de alta densidad. |
| Precios | Los precios de padres y variantes coinciden con la moneda, tratamiento fiscal y descuentos de la tienda. Verifica precios en cero y productos con múltiples precios de variante. |
| Descuentos | El campo de precio regular existe y supera al precio de venta antes de mostrar precio tachado o insignia de oferta. |
| Páginas | Títulos, URLs, contenido e IDs de artículo coinciden con las páginas de contenido previstas. |
Consulta card data para la visualización de precios y la FAQ para problemas de imagen y fuente de datos.
Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.