Preguntas frecuentes

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

Uso de formatters #

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

Los formatters se pueden agregar de dos maneras:

• A través de my.clerk.io > Developers > Formatters, donde cada Formatter puede ser creado como una entrada separada.

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

Ejemplo de formatter #

Un ejemplo se puede ver a continuación. Ten en cuenta que esto es Clerk V2 (última versión):

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

Varios 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 los 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 en línea.

Errores comunes #

Clerk not defined #

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 seguimiento de Clerk no están implementados en los lugares apropiados.

Haz clic aquí para ver el proceso de implementación para insertar tanto el script de seguimiento de pedidos como el de visitantes.

API cooldown #

Este mensaje en los logs 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 solucionar esto, tienes dos opciones:

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

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

429 Too Many Requests #

Este error significa que Lightspeed hizo demasiadas solicitudes en un periodo de tiempo determinado y excedió su rate limit.

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

Los pedidos no se rastrean #

Si los pedidos no se están rastreando en Clerk.io, puede ser porque Clerk.js no se está cargando en la página del carrito o de agradecimiento.

En Lightspeed, estas páginas usan un archivo de tema separado llamado fixed.rain. Los scripts agregados a custom.rain no se incluyen en estas páginas, por lo que Clerk.js puede estar ausente cuando se completa el pedido — lo que significa que la venta nunca se rastrea.

Para solucionar esto, agrega el script de seguimiento de visitantes también en 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 al final del archivo.

4. Haz clic en Save.

Si Clerk.io ya está presente tanto en custom.rain como en fixed.rain pero los pedidos aún no se rastrean, tu tema puede necesitar Clerk.js en Web Extras en su lugar. Ve a Settings > Website-Settings > Web Extras, luego pega el script de seguimiento de visitantes inmediatamente encima del código de seguimiento de pedidos de Clerk.io en el cuadro de Tracking.

Esto depende del tema, así que solo agrégalo en Web Extras cuando las ubicaciones estándar no resuelvan el problema.