Magento 2

FAQ

Soluciones a preguntas y problemas comunes al usar Clerk con Magento 2

¿Tienes problemas con tu integración de Magento 2? Este FAQ cubre los problemas más comunes y sus soluciones, desde tamaños de imagen hasta errores de sincronización.

Tamaños de imagen #

Por defecto, la extensión utiliza los tamaños de imagen originales que están configurados en Magento 2.

Estos pueden cambiarse si es necesario.

Comienza iniciando sesión en tu backend de Magento 2 y ve a:

Stores > Configuration > Clerk > Configuration

En Synchronization > Image type, puedes elegir exactamente en qué resolución enviar las imágenes:

Magento 2 image type configuration

Luego, haz clic en Guardar Config.

Ahora solo tienes que ejecutar una nueva Sync en my.clerk.io y tus nuevos tamaños de imagen serán importados.

Uso de formatters #

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

Los formatters pueden añadirse de dos maneras:

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

  • 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.

Para Magento 2, este archivo contiene el tracking-script:

vendor->view->frontend->templates->tracking.phtml

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);
    }
          }
      });

Múltiples 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 diseños #

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 requieras.

Autenticación HTTP #

La autenticación HTTP se utiliza frecuentemente 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@magento2.clerk.io/
HTTP authentication in import URL

Errores comunes de sincronización #

Nota: Recomendamos actualizar siempre la extensión a la última versión para obtener todas las funcionalidades actualizadas de Clerk.

Al importar datos con la extensión Magento 2 de Clerk, el servidor de tu tienda online es responsable de enviar los datos de productos, categorías y ventas a Clerk.

Sin embargo, en algunos casos, la configuración del servidor puede bloquear la importación al acceder a los datos, provocando un error en Data Sync.

A continuación, se muestra una lista de los errores más comunes y cómo solucionarlos.

401 Unauthorized #

Este error ocurre si tu tienda online o entorno de desarrollo requiere autenticación HTTP para acceder.

Esto se soluciona insertando el Username y Password como parte de la URL de importación:

http://username:password@magento2.clerk.io

403 Forbidden #

Este error ocurre a menudo por alguna de estas razones:

  • Tu servidor bloquea el acceso del importador. En la mayoría de los casos, simplemente necesitas whitelistear la dirección IP del importador para darle acceso. La última dirección IP puede encontrarse aquí.

  • Puede que tengas una clave pública, clave privada y/o URL de importación incorrectas dentro de la tienda en my.clerk.io.

  • Estás utilizando Storeviews con URLs ocultas, como mywebshop.com?__store=b2b. A veces, estas URLs también pueden contener 3 guiones bajos como esto: mywebshop.com?___store=b2b.

Si es este último caso, simplemente incluye el parámetro __store en la URL en Data:

Store parameter in URL

¿Qué pasa si ya he whitelisteado, pero el mismo error sigue ocurriendo?

Existen algunos casos en los que ya has whitelisteado la IP del importador y el error persiste.

En estos casos, recomendamos revisar lo siguiente:

  • La parte de autenticación del cuerpo puede ser eliminada de la petición por el servidor de la tienda.

  • Límite de peticiones del servidor respecto a Cloudflare.

404 Not Found #

Este error ocurre si el importador no pudo acceder al enlace que envía datos desde la tienda online.

En la mayoría de los casos, ocurre porque la extensión está:

  • Sin instalar

  • Una caché causa que el enlace no se inicialice

Primero, asegúrate de haber instalado la extensión correctamente.

En segundo lugar, vacía la caché de tu tienda online antes de intentar una nueva importación.

429 Too Many Requests #

Este error ocurre si tu servidor niega el acceso al importador debido a demasiadas peticiones entrantes.

Puedes solucionarlo estableciendo el límite de peticiones más alto en tu servidor o configurando Page Size a un valor superior en my.clerk.io > Data > Configuration, haciendo que el importador realice menos peticiones pero más grandes:

Page size configuration

Si estás usando el proveedor de hosting hypernode.com/nl, el importador generalmente retorna este error debido a su limitador de peticiones. En este caso, contacta a hypernode.com/nl y pídeles que whitelisteen el User-Agent del importador “clerk”.

500 Internal Server Error #

Este error significa que tu servidor encontró un error interno y no pudo especificar qué error ocurrió.

En estos casos, revisa tu Server Log para identificar qué proceso falló y por qué.

En la mayoría de los casos, simplemente se debe a un producto con un atributo inválido, o una función llamada incorrectamente en la tienda online.

503 Service Unavailable #

Este error suele ser temporal y es causado porque el servidor está demasiado ocupado para manejar la petición.

Inténtalo de nuevo después de un tiempo.

Si el problema continúa, puede significar que el servidor está saturado de procesos y está cerca de su capacidad máxima.

Verifica la carga del servidor para identificar si este es el caso.

Invalid response #

Esta falla usualmente ocurre si tu tienda online está usando un sistema de redirección para enviar a los clientes a diferentes dominios.

Por ejemplo, ir a “ https://mywebshop.com” podría redirigir a “ https://mywebshop.com/it".

Si este es el caso, simplemente debes usar la URL completa al importar en my.clerk.io:

Full URL configuration

Importación de stock MSI #

Si tu tienda Magento 2 utiliza MSI (Multi-Source Inventory), puedes importar el stock total a través de todas las fuentes en Clerk añadiendo el código de atributo a los Campos Adicionales de la extensión.

  1. En el administrador de Magento, ve a Stores > Configuration > Clerk > Configuration.

  2. En Synchronization > Additional Fields, añade: multi_source_stock.

  3. Haz clic en Guardar Config y luego ejecuta una nueva sincronización en my.clerk.io > Data.

Clerk importará multi_source_stock como la suma de cantidades a través de todas las fuentes de MSI.

Esto es útil cuando la fuente de stock predeterminada es 0 pero los productos siguen en stock en otras fuentes.

Actualiza a Clerk.js 2 #

Clerk.js 2 es una versión más rápida y flexible de nuestra librería 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 con éxito.

Las dos principales diferencias en Clerk.js 2 son que los Designs en my.clerk.io utilizan el lenguaje de plantillas Liquid, pero también pueden crearse fácilmente utilizando el Design Editor.

Crear diseños #

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

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

Opción de Design Editor #

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

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

  2. Elige el tipo de Design.

Design type selection
  1. En el Design Editor, haz clic en cualquiera de los elementos existentes como el nombre, imagen, botón, etc., para editarlo, o añade nuevos elementos al Design para añadir más información sobre los productos.
Design Editor interface

  1. Haz clic en Publicar cuando termines, y ve al Paso 2 en la guía.

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

  3. Haz clic en Actualizar Content. Esto provocará temporalmente que no se muestren en tu tienda online, hasta que termines el Paso 2. Elige el nuevo Design para todo el contenido que deba ser actualizado.

Update content with new design

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

Actualizar la extensión #

ADVERTENCIA: Recuerda hacer copias de seguridad de cualquier archivo modificado, ya que serán sobrescritos.

Actualizar la extensión Magento 2 se hace desde la línea de comandos.

Se realiza siguiendo estos pasos:

  1. Inicia sesión en tu servidor mediante línea de comandos.

  2. Navega a tu carpeta webroot (normalmente _/var/www/your_domain/public_html_).

  3. Activa el Root Access escribiendo su y luego introduce tu contraseña.

  4. Escribe los siguientes comandos en orden:

composer update clerk/magento2
php bin/magento setup:upgrade
php bin/magento setup:di:compile
  1. Espera a que la extensión termine.

Ahora tu Magento 2 está actualizado a la última versión.

¡Ahora tienes la última versión de Clerk para Magento 2 instalada, y Clerk.js 2 está funcionando en tu tienda online!

La documentación completa para Clerk.js 2 se puede encontrar aquí:

https://docs.clerk.io/docs/clerkjs-quick-start

Gestión de require.js #

Esta guía solo aplica cuando se usa hasta la versión v.2.8.3 de la extensión Clerk para Magento 2.

En algunas configuraciones, Require.js evita que Clerk.js se cargue, lo que significa que no se mostrarán sliders ni resultados de búsqueda.

Cuando esto ocurre, el siguiente error se mostrará en tu consola:

Uncaught ReferenceError: Clerk is not defined

La extensión Magento 2 ya maneja Require.js, pero en algunos casos es necesario hacer que ignore Clerk.js.

Puedes hacerlo en el siguiente archivo:

vendor->clerk->magento2->templates->tracking.phtml

Simplemente inserta window.__clerk_ignore_requirejs = true; en la parte superior del tracking script:

Ignore Require.js in tracking script

Después de usar este enfoque, Require.js ahora será compatible con Clerk.

Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.