FAQ

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

Precios para grupos de clientes #

La configuración de los precios para grupos de clientes consta de 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 #

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 solo se actualizarán cuando se ejecute una sincronización completa.

Proporcionar contexto de precio #

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

Esto se puede hacer proporcionando el ID del grupo de clientes del cliente actual o su dirección de email o 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 enfoque anterior puede combinarse con la configuración 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 de forma dinámica, deberías utilizar las variables disponibles en tu tema Stencil, en lugar de codificar manualmente la dirección de email o el ID del usuario.

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

Objeto Cliente BigCommerce

Aquí tienes un ejemplo de cómo podrías usar el objeto cliente en tu tema para establecer dinámicamente el contexto del precio:

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

Uso de formateadores #

Clerk.js te permite escribir funciones personalizadas en JavaScript que agregan nuevas funcionalidades a tus Diseños.

Los formateadores pueden agregarse 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 pueden agregarse varios formateadores a la vez.

Ejemplo de formateador #

Un ejemplo puede verse 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 formateadores #

Puedes escribir cualquier cantidad de formateadores, 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 tus formateadores, puedes usarlos en Diseños con esta sintaxis:

Esto te permite crear cualquier funcionalidad en tus Diseños que desees usar con Clerk en tu tienda online.