Sincronizar datos

Importa tus datos de ideal.shop antes de configurar Search y Recommendations. Primero habilita la integración, incluyendo Feed offentligt.

Configurar Feed #

Sin límites explícitos, el feed devuelve hasta 50 registros por tipo de dato. Establece límites separados de producto, categoría y pedido para la primera importación histórica.

1. En ideal.shop, abre Indstillinger > Integrationer > Clerk.io.
2. Copia la URL debajo de Sti til feed.
3. 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 cualquier parámetro obligatorio existente. No añadas un segundo ? ni dupliques un límite ya existente.

Estos valores solicitan hasta 10,000 registros de cada tipo nombrado. Aumenta cada límite donde sea necesario; 10,000 es un ejemplo, no una garantía de una exportación completa. Los otros tipos de datos mantienen su valor predeterminado a menos que se configuren por separado.

Por ejemplo, el feed de Fodmagasinet utiliza 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 sus límites.

1. En my.clerk.io, abre la Store correspondiente y ve a Data > Configuration.
2. Elige Clerk.io JSON Feed como método de sincronización.
3. Pega la URL del feed y guarda la configuración.
4. Haz clic en Start New Data Sync y espera hasta que finalice.
5. Compara los recuentos importados con los totales exportables de la tienda en línea, teniendo en cuenta los registros excluidos deliberadamente.

Un recuento igual al límite solicitado puede indicar truncamiento. Aumenta ese límite y vuelve a sincronizar. Verifica también el pedido importado más antiguo, así como el 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 temas de truncamiento y tiempo de espera.

Importaciones continuas #

Tras la primera importación histórica exitosa, elimina &orders=10000. Mantén los límites completos de catálogo:

https://example.com/feeds/clerk_io_feed.json?&products=10000&categories=10000

Eliminar orders restablece el valor predeterminado de las 50 órdenes más recientes. No desactiva la importación de pedidos. Clerk.io conserva los pedidos importados previamente, por lo que el feed continuo solo necesita cubrir los pedidos recientes.

Antes de usar el valor predeterminado, compara el volumen de pedidos de la tienda en línea con el intervalo entre sincronizaciones exitosas, incluyendo demoras o sincronizaciones fallidas. Verifica que el pedido más antiguo devuelto se solape 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 un límite explícito de orders lo suficientemente grande para cubrirlo con superposición. Por ejemplo, añade &orders=500 solo si cubre tu volumen. Vuelve a comprobar después de una interrupción en la sincronización o un aumento en los pedidos.

Mantén products y categories lo suficientemente altos para todo el catálogo actual en cada sincronización. No los reduzcas al valor predeterminado después de importar una vez.

Importar páginas #

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.

Comprobar cobertura #

Inspecciona la colección pages del feed nativo y las páginas importadas en Clerk.io. Compara las URLs e IDs de artículos conocidos; una entrada en el sitemap por sí sola no significa que el feed nativo exporte esa página.

Si el feed nativo ya incluye el contenido requerido, utiliza esos registros. Evita importar la misma URL nuevamente a través de otro importador.

Ampliar la importación #

Si faltan páginas, abre Ask Clerk.io y solicita una AI Integration para páginas de contenido. Proporciona la URL del sitemap de la tienda en línea y explica qué tipos de páginas incluir y excluir.

Pide que descubra los índices de sitemap y sus sitemaps hijo, obtenga las páginas deseadas y proponga un ejemplo de importación para revisión. Confirma que el importador de páginas puede ejecutarse junto con la importación del catálogo nativo sin reemplazar ni duplicar sus registros.

Para Fodmagasinet, la fuente de descubrimiento ejemplo es https://www.fodmagasinet.dk/sitemap.xml, excluyendo la página principal y URLs que contienen /vare. Estas reglas se adaptan a la estructura de URL de esa tienda en línea; inspecciona tu propio sitemap antes de elegir filtros.

Valida cada registro de ejemplo:

• Un ID estable y único que coincida con el ID del artículo en el escaparate al usar recomendaciones basadas en páginas.
• El título correcto, URL canónica y contenido útil del artículo sin texto de encabezado, pie de página ni navegación.
• Sin URLs duplicadas, páginas de producto, listados de categorías ni 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 e importes 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.

Validar datos #

Un estado exitoso y cifras plausibles no demuestran que los datos coincidan con la tienda en línea. Compara registros importados representativos con la tienda en línea real.

Consulta card data para visualización de precios y la FAQ para problemas de imagen y datos fuente.