FAQ

¿Tienes problemas con tu integración de Smartweb? Este FAQ cubre los problemas más comunes y sus soluciones, desde los formatters hasta la actualización a Clerk.js 2.

Uso de formatters #

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

Los formatters se pueden añadir de dos maneras:

• A través de my.clerk.io > Developers > Formatters, donde cada Formatter puede crearse 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 añadir múltiples formatters a la vez.

Ejemplo de formatter #

Un ejemplo se puede ver a continuación. Ten en cuenta que esto es para 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:

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 designs #

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

{%raw%}{{ price | log_price }} {{ price | calculate_discount | special_price }}{%endraw%}

Esto te permite crear cualquier funcionalidad en tus Designs que necesites.

Autenticación HTTP #

La autenticación HTTP se utiliza a menudo en sitios de pruebas 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 de esta manera:

http://USER:PASS@www.ewoksRus.com

Actualización a Clerk.js 2 #

Clerk.js 2 es una versión más rápida y flexible de nuestra biblioteca de JavaScript.

Facilita la instalación de Clerk en cualquier tienda online.

Sin embargo, dado que las dos versiones funcionan de manera ligeramente diferente, debes seguir estos pasos para actualizar correctamente.

Las dos principales diferencias en Clerk.js 2 son:

• Los Designs en my.clerk.io usan el lenguaje de plantillas Liquid, pero también pueden crearse fácilmente usando el Design Editor.

• El script debe insertarse justo antes de la etiqueta </head> en la plantilla de tu tienda online.

Crear designs #

Como Clerk.js 2 tiene un enfoque diferente para los Designs, debes crear unos nuevos.

Puedes crear tus Designs para Clerk.js 2 de dos maneras:

• Usa el intuitivo Design Editor para crear nuevos Designs, como se describe en los siguientes puntos.

• Convierte tus antiguos Designs. Sigue esta guía para ver cómo hacerlo.

Opción de Design Editor #

1. Ve a my.clerk.io > Recommendations/Search > Designs > New Design.

2. En la pantalla siguiente, dale un Nombre a tu Design (recomendamos añadir “V2” para que sea obvio que estás usando Clerk.js 2).

3. Elige el Tipo de Design y sigue el asistente de configuración de diseño.

4. Cuando termines, haz clic en Create Design.

5. En el Design Editor, haz clic en cualquiera de los elementos existentes como el nombre, imagen, botón, etc., para editarlos, o añade nuevos elementos al Design para incluir más información sobre los productos.

6. Haz clic en Publish cuando hayas terminado y ve a Step 2 en la guía.

7. Ve a Recommendations/Search > Content y cambia tu contenido de Clerk para usar tu nuevo Design.

8. Haz clic en Update Content. Esto hará que temporalmente no se muestren en tu tienda online, hasta que hayas terminado con el Step 2. Elige el nuevo Design para todo el Content que deba actualizarse.

Ahora estás listo para cambiar a Clerk.js 2.

Sustituir el script #

1. Ubica el archivo de plantilla que se utiliza para mostrar todas las páginas de la tienda online y donde se encuentra el script original de Clerk.js cerca de la parte inferior.

2. Elimina el script antiguo del archivo:

3. Ve a my.clerk.io > Developers > Tracking Code. Esta página ahora contiene tu código de seguimiento de Clerk.js 2.

4. Copia este código e insértalo justo antes de la etiqueta </head> en la plantilla:

5. Guarda tu plantilla.

¡Enhorabuena! ¡Ahora estás usando la configuración mejorada de Clerk.js 2!

Puedes ver la documentación completa de Clerk.js 2 aquí: https://docs.clerk.io/docs/clerkjs-quick-start