FAQ

¿Tienes 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.

Precios de grupos de clientes #

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

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

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

Ejecutar sincronización completa #

Al ejecutar una sincronización completa entre Clerk y BigCommerce, Clerk almacenará los diferentes precios para grupos de clientes y las reglas de precios que estén activas para 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 se puede hacer proporcionando el ID del grupo de clientes del cliente actual o proporcionando su dirección de email o ID de cliente.

El contexto de precio se puede proporcionar 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 se puede combinar con la configuración de otros valores predeterminados que se establecen 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 dinámicamente este contenido, debes utilizar las variables disponibles en tu tema Stencil, en lugar de poner directamente una dirección de email o un ID de usuario específico.

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 establecer dinámicamente el contexto de precio:

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

Uso de formatters #

Clerk.js te permite escribir funciones personalizadas en JavaScript que añaden nueva funcionalidad 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 varios formatters a la vez.

Ejemplo de formatter #

Se puede 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 comas, 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 tus formatters, puedes usarlos en Designs con la siguiente sintaxis:

Esto te permite crear cualquier funcionalidad en tus Designs que quieras usar con Clerk en tu tienda online.