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 personalizadas en JavaScript que agregan 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 crearse como una entrada independiente.

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

Ejemplo de formatter #

Se puede ver un ejemplo 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);
    }
  }
});

Múltiples formatters #

Puedes escribir cualquier cantidad de formatters, separados por comas, 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 un formatter, llámalo desde la plantilla Liquid de tu Design usando el nombre del formatter.

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

Errores comunes #

Clerk no definido #

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

La causa más común de esto es que los scripts de seguimiento de Clerk no se han implementado 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 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 está fuera del control de Clerk.

Para solucionarlo, 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 Demasiadas solicitudes #

Este error significa que Lightspeed realizó demasiadas solicitudes en un periodo de tiempo y ha superado su rate limit.

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

Pedidos no registrados #

Si los pedidos no se están registrando 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 podría estar ausente cuando se completa el pedido, lo que significa que la venta nunca se registra.

Para solucionar esto, agrega el script de seguimiento de visitantes también a fixed.rain:

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

2. Abre layouts > fixed.rain.

3. Pega el script de seguimiento de visitantes 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 registran, es posible que tu tema necesite Clerk.js en Web Extras. Ve a Settings > Website-Settings > Web Extras y pega el script de seguimiento de visitantes inmediatamente encima del código de seguimiento de pedidos de Clerk.io en la caja Tracking.

Esto depende del tema, así que solo añádelo a Web Extras cuando las ubicaciones estándar no resuelvan el problema.