Preguntas frecuentes

¿Estás teniendo problemas con tu integración de BigCommerce? Este FAQ cubre los problemas más comunes y sus soluciones, desde precios de grupos de clientes hasta formatters.

Uso de formatters #

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

Los formatters pueden añadirse de dos formas:

• A través de my.clerk.io > Developers > Formatters, donde cada Formatter puede ser creado 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 varios formatters a la vez.

Ejemplo de formatter #

Puedes 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 coma, 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 quieras usar con Clerk en tu tienda online.

Precios de grupo de clientes (Legacy) #

Esta función está obsoleta y solo puede usarse si ya la tienes activada. No funciona con Search 3.0 y no tendrá soporte en el futuro.

La configuración de los precios para grupos de clientes consiste en 2 pasos:

1. Ejecuta una sincronización completa entre Clerk y BigCommerce.

2. Proporciona un contexto de precio al mostrar el contenido en la página.

Ejecutar sincronización completa #

Cuando ejecutes una sincronización completa entre Clerk y BigCommerce, Clerk almacenará los diferentes precios y reglas de precios de grupos de clientes que estén activos en la tienda.

Estas reglas se almacenarán por separado para cada producto y se utilizarán al mostrar el producto en el sitio web.

Estas reglas también solo se actualizarán cuando se ejecute una sincronización completa.

Proporcionar contexto de precio #

Al mostrar el producto en el sitio web, debes proporcionar un contexto de precio a Clerk.

Esto puede hacerse proporcionando el ID del grupo de clientes del cliente actual o proporcionando su email o su ID de cliente.

El contexto de precio puede proporcionarse en los atributos HTML de la etiqueta anchor del propio contenido, o puede proporcionarse como parte de la llamada Clerk('config', ...).

Atributos HTML #

Aquí tienes algunos ejemplos de cómo se vería este código si se proporciona en la propia etiqueta anchor:

<span
  class="clerk"
  data-template="@content-1"
  data-price_context='{"customer":{"email": "support@clerk.io"}}'
></span>

<span
  class="clerk"
  data-template="@content-2"
  data-price_context='{"customer":{"id": 12345}}'
></span>

<span
  class="clerk"
  data-template="@content-3"
  data-price_context='{"qualifiers":{"customer_group_id": 0}}'
></span>

Configuración de Clerk #

Aquí tienes un ejemplo de cómo se vería si se proporciona como parte de la llamada Clerk('config', ...):

Clerk('config', {
  price_context: {
    customer: {
      email: "support@clerk.io"
    }
  }
})

El método anterior puede combinarse con el ajuste de otros valores predeterminados al cargar la página:

Clerk('config', {
  key: 'YOUR_PUBLIC_KEY',
  language: 'english',
  price_context: {
    customer: {
      email: "support@clerk.io"
    }
  }
})

Inyección dinámica #

Para inyectar este contenido dinámicamente, deberías utilizar las variables disponibles en tu tema Stencil, en lugar de codificar la entrada hacia una dirección email o ID de usuario específica.

Puedes ver cómo imprimir las diferentes variables de cliente en el tema a continuación:

Customer Object BigCommerce

Aquí tienes un ejemplo de cómo podrías usar el objeto customer en tu tema para definir dinámicamente el price context:

<span
  class="clerk"
  data-template="@content-1"
  data-price_context='{"customer":{"email": "{{ customer.email }}"} }'
></span>