Preguntas frecuentes

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

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 entradas separadas.

• Como una configuration 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 para Clerk V2 (última versión):

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

Varios formatters #

Puedes escribir cualquier número 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 staging para evitar visitantes no deseados.

Esto bloqueará el importador de Clerk y mostrará un error 401 Unauthorized en el log 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í:

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 librería de JavaScript.

Hace que instalar Clerk en cualquier webshop sea más sencillo.

Sin embargo, como las dos versiones funcionan de manera ligeramente diferente, es necesario seguir estos pasos para actualizar correctamente.

Las dos principales diferencias en Clerk.js 2 son:

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

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

Crear Designs #

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

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

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

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

Opción Design Editor #

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

2. En la siguiente pantalla, da a tu Design un Nombre (recomendamos agregar “V2” para que sea evidente que usas Clerk.js 2).

3. Elige el Type 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 editarlo, o agrega nuevos elementos al Design para incluir más información sobre los productos.

6. Haz clic en Publish cuando termines y ve al Step 2 en la guía.

7. Ve a Recommendations/Search > Elements y cambia tu Clerk Element para usar tu nuevo Design.

8. Haz clic en Update Element. Esto hará que temporalmente no se muestren en tu webshop, hasta que termines Step 2. Elige el nuevo Design para todos los Elements que deban actualizarse.

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

Reemplazar el script #

1. Localiza el archivo de plantilla que se usa para mostrar todas las páginas del webshop y donde se encuentra el script original de Clerk.js cerca del final.

2. Elimina el script antiguo del archivo:

3. Ve a my.clerk.io > Developers > Tracking Code. Esta página ahora contiene tu tracking code 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.

¡Felicidades! Ahora estás utilizando 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