Preguntas frecuentes

¿Tienes problemas con tu integración de 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 crear funciones personalizadas en JavaScript que agregan nuevas funcionalidades a tus Designs.

Los formatters pueden añadirse de dos formas:

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

• Como una configuration 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 puede verse 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 utilizarlos 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 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 así:

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

Actualizar 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 tienda online sea más fácil.

Sin embargo, dado que las dos versiones funcionan de forma ligeramente diferente, necesitas 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 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 #

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

Puedes crear tus Designs de 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 del Design Editor #

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

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

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

4. Cuando hayas terminado, haz clic en Create Design.

5. En el Design Editor, haz clic en cualquiera de los elementos existentes como el nombre, la imagen, el botón, etc. para editarlo, o añade 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 de la guía.

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

8. Haz clic en Update Element. Esto provocará temporalmente que no aparezcan en tu tienda online, hasta que finalices el Step 2. Elige el nuevo Design para todos los Elements que deban actualizarse.

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

Reemplazar el script #

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

2. Elimina el script antiguo del archivo:

3. Ve a my.clerk.io > Developers > Clerk.js. Esta página contiene ahora 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.

¡Felicidades! 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