Preguntas frecuentes

¿Tienes problemas con tu integración de Lightspeed? Este FAQ cubre los problemas más comunes y sus soluciones, desde los formatters hasta errores de sincronización.

Uso de formatters #

Clerk.js te permite escribir funciones personalizadas de JavaScript que añaden nueva funcionalidad a tus Designs.

Los formatters pueden añadirse de dos maneras:

• A través de my.clerk.io > Developers > Formatters, donde cada Formatter puede crearse como entradas separadas.

• Como una configuración para Clerk.js, en el tracking-script que se inserta en todas las páginas, donde se pueden añadir múltiples formatters a la vez.

Ejemplo de formatter #

Un ejemplo se puede ver abajo. Ten en cuenta que este es Clerk V2 (la versión más reciente):

Clerk('config', {
  key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
  formatters: {
    log_price: function(price) {
      console.log(price);
    }
  }
});

Múltiples formatters #

Puedes escribir cualquier cantidad de formatters, separados por coma, así:

formatters: {
  log_price: function(price) {
    console.log(price);
  },
  calculate_discount: function(price, special_price) {
    return price - special_price;
  },
  substring: function(text) {
    var short_string = text.substring(0, 20);
    return short_string;
  }
}

Uso en diseños #

Después de crear tus formatters, puedes usarlos en Designs usando esta sintaxis:

Esto te permite crear cualquier funcionalidad en tus Designs que quieras usar con Clerk en tu tienda online.

Errores comunes #

Clerk no está definido #

Si ves este mensaje de error, significa que Clerk no está siendo definido en el sitio web.

La causa más común de esto es que los scripts de tracking de Clerk no están implementados en los lugares adecuados.

Haz clic aquí para ver el proceso de implementación para insertar tanto el Order Tracking como el Visitor Tracking scripts.

API cooldown #

Este mensaje en los registros de sincronización de datos proviene del rate limit de Lightspeed.

Lightspeed ha establecido un rate limit bajo por defecto para gestionar el volumen de datos transmitidos desde sus servicios.

Ten en cuenta que este rate limit no está bajo el control de Clerk.

Para abordar esto, tienes dos opciones:

1. Considera actualizar el servicio de rate limit con Lightspeed.

2. Alternativamente, puedes optar por esperar a que se complete el proceso de sincronización.

429 Too Many Requests #

Este error significa que Lightspeed realizó demasiadas solicitudes en un determinado período de tiempo y superó su rate limit.

Para resolver esto, sugerimos ajustar el tamaño de página en tus data sync settings en my.clerk.io > Data > Configuration.

Faltante en checkout #

En Lightspeed, las páginas de carrito y de agradecimiento usan un archivo de tema separado llamado fixed.rain. Los scripts añadidos a custom.rain no se incluyen en estas páginas.

Si Clerk.js no se está cargando en la página del carrito o de agradecimiento, la solución es también agregar el visitor tracking script a fixed.rain.

1. En tu backend de Lightspeed, ve a Design > Theme Editor > Advanced > Edit Code.

2. Abre layouts > fixed.rain.

3. Pega el visitor tracking script en la parte inferior del archivo.

4. Haz clic en Save.