Preguntas frecuentes
¿Tienes problemas con tu integración de Dandomain Classic? Este FAQ cubre los problemas más comunes y sus soluciones, desde la autenticación HTTP hasta errores de sincronización.
Autenticación HTTP #
La autenticación HTTP se utiliza a menudo en sitios de staging para evitar visitantes no deseados.
Esto bloqueará el importador de Clerk y mostrará un error 401 Unauthorized en el registro de sincronización.
Puedes solucionar esto insertando la información de autenticación en la URL de importación.
En my.clerk.io > Data > Configuration, actualiza tu URL de importación así:
https://USER:PASS@dandomain.clerk.io/api/6155349/28
Errores comunes de sincronización #
Al importar datos con la App de Dandomain de Clerk, el servidor de tu tienda online es responsable de enviar datos de productos, categorías y ventas a Clerk.
Sin embargo, en algunos casos, la configuración del servidor puede bloquear la importación e impedir el acceso a los datos, causando un error en Data Sync.
A continuación se muestra una lista de los errores más comunes y cómo solucionarlos.
401 Unauthorized #
Este error ocurre si tu tienda online o el entorno de desarrollo requieren autenticación HTTP para acceder.
Esto se soluciona insertando el Username y Password como parte de la URL de importación:
http://USER:PASS@dandomain.clerk.io/api/6155349/28
403 Forbidden #
Este error ocurre si tu servidor bloquea el acceso del importador.
En la mayoría de los casos, solo necesitas incluir en la lista blanca la dirección IP del importador para darle acceso.
La dirección IP más reciente se puede encontrar aquí.
También verifica que tu public key, private key y import URL sean correctas para la tienda en la que estás operando dentro de my.clerk.io.
En algunos casos (si tienes una versión antigua de Dandomain), este error también se muestra si utilizas diferentes dominios de idioma y cada uno tiene diferentes IDs.
En ese caso, asegúrate de que los IDs de cada tienda correspondan a los del backend de Dandomain.
¿Qué pasa si ya he incluido en la lista blanca pero el mismo error sigue ocurriendo?
Hay algunas situaciones en las que has incluido en la lista blanca la dirección IP del importador y el error persiste.
En estos casos recomendamos revisar los siguientes puntos:
Es posible que la parte de autenticación del cuerpo se elimine de la solicitud desde el servidor de la tienda.
Límite de velocidad del servidor en relación con Cloudflare.
404 Not Found #
Este error ocurre si el importador no pudo acceder al enlace que envía los datos desde la tienda online.
En la mayoría de los casos, ocurre porque la app está:
No instalada en absoluto
Una caché provoca que el enlace no se inicialice
Primero, asegúrate de que hayas instalado la app correctamente.
En segundo lugar, asegúrate de vaciar la caché de tu tienda online antes de intentar una nueva importación.
429 Too Many Requests #
Este error ocurre si tu servidor niega el acceso al importador debido a demasiadas solicitudes entrantes.
Puedes solucionar esto aumentando el límite de solicitudes de tu servidor o configurando el Page Size a un valor más alto en my.clerk.io > Data > Configuration. Un tamaño de página mayor hace que el importador envíe menos solicitudes, pero más grandes.
500 Internal Server Error #
Este error significa que tu server encontró un internal error y no pudo especificar cuál error ocurrió.
En estos casos, revisa tu Server Log para identificar qué proceso falló y por qué.
En la mayoría de los casos, simplemente se debe a un producto con un atributo inválido o una función que se llama incorrectamente en la tienda online.
Si ocurre esto último, sugerimos contactar al equipo de soporte técnico.
503 Service Unavailable #
Este error generalmente es temporal y ocurre porque el servidor está demasiado ocupado para manejar la solicitud.
Intenta de nuevo un poco más tarde.
Si el problema persiste, podría significar que el servidor está sobrecargado de procesos y cerca de su capacidad máxima.
Verifica la carga del servidor para identificar si este es el caso.
Actualizar a Clerk.js 2 #
Clerk.js 2 es una versión más rápida y flexible de nuestra librería de JavaScript.
Hace que instalar Clerk en cualquier tienda online sea más fácil.
Sin embargo, como las dos versiones funcionan de forma ligeramente diferente, debes seguir estos pasos para actualizar correctamente.
Las dos principales diferencias en Clerk.js 2 son que los Diseños en my.clerk.io usan el lenguaje de plantillas Liquid, pero también pueden crearse fácilmente usando el Editor de Diseños.
Crear diseños #
Como Clerk.js 2 tiene un enfoque diferente para los Diseños, necesitas crear nuevos.
Puedes crear tus Diseños de Clerk.js 2 de dos maneras:
Utiliza el intuitivo Design Editor para crear nuevos Diseños, como se describe en los siguientes puntos.
Convierte tus Diseños antiguos. Sigue esta guía para ver cómo hacerlo.
Opción del Design Editor #
Ve a my.clerk.io > Recommendations/Search > Designs > New Design.
Sigue el asistente de configuración de diseño y selecciona el type de diseño y asígnale un name (recomendamos agregar “V2” para que sea obvio que usas Clerk.js 2).
En el Design Editor, haz clic en cualquiera de los elementos existentes como el nombre, imagen, botón, etc. para editarlo, o añade nuevos elementos al Diseño para incluir más información sobre los productos.
Haz clic en Publish Design cuando termines y continúa con el Step 2 de la guía.
Dirígete a Recommendations/Search > Elements y cambia tu Clerk Element para que use tu nuevo Diseño.
Haz clic en Update Element. Esto hará que temporalmente no se muestren en tu tienda online, hasta que termines el Step 2. Elige el nuevo Diseño para todos los Elements que deban ser actualizados.
Ahora ya estás listo para cambiar a Clerk.js 2.
Activar Clerk.js 2 #
Luego necesitas activar Clerk.js 2 en la app de Dandomain Classic.
Inicia sesión en el backend de Dandomain Classic y ve a la Clerk App en el menú lateral.
En General, haz clic y marca la casilla junto a Brug Clerk.js 2 y haz clic en Save:
Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.