Jtl

Get Started

Instala Clerk en JTL siguiendo estos sencillos pasos

Pon Clerk en funcionamiento en tu tienda JTL en solo unos pocos pasos. Esta guía te acompaña en la conexión de tu tienda, la configuración del complemento y la sincronización de tus datos.

Conectando tu tienda #

El primer paso para instalar Clerk es conectar tu tienda con tu cuenta de Clerk.

Después de seguir estos sencillos pasos, podrás ver tu Tienda Demo, que te brinda una visión personal de cómo funcionará Clerk en tu tienda en línea, antes de configurar el resto del sistema.

Agregar tienda #

Después de iniciar sesión en my.clerk.io, lo primero que debes hacer es agregar tu tienda:

Ejemplo de cómo debería verse
  1. Escribe el Nombre y Dominio de tu tienda en línea.

  2. Elige JTL como la Plataforma y selecciona tu Moneda.

  3. Haz clic en Add Store.

  4. Una vez que la tienda está creada, se enviará un email sobre tus claves públicas y privadas al propietario del email de la cuenta.

Configurar conexión #

Desde el menú principal de la Guía de Configuración, haz clic en Install Extension:

Página de instalación de la extensión

La siguiente página muestra lo que necesitas hacer para configurar la conexión JTL.

Ve a tu complemento de Clerk en el backend de JTL y agrega las claves públicas y privadas de la tienda de Clerk en sus respectivos campos.

Sincronizar tienda #

Después de permitir el acceso, simplemente tienes que sincronizar tu tienda.

Regresa a la Guía de Configuración y haz clic en Sync Your Data:

Página de sincronización de datos

Escribe los detalles de tu tienda y haz clic en Start Sync.

La URL del feed de JTL debe crearse con base en esta guía Creación de feeds de datos en JTL.

Ejemplo de instalación completa #

IMPORTANTE: Debes haber instalado el complemento (S360 CLerk) en tu backend JTL bajo Plugins

Esta documentación te guiará a través de los siguientes pasos:

Agregando una tienda #

Cada Store en Clerk es un entorno aislado con sus propios datos, claves API y Dashboard.

Lo primero que tendrás que hacer al configurar tu cuenta Clerk es crear tu primer Store:

Cómo se ve la pantalla de creación de tienda

Después de esto, la Guía de Configuración te guiará por el resto de la configuración.

Ten en cuenta que cada vez que se crea una tienda, se enviará un email con las claves públicas y privadas al propietario de la cuenta de la empresa. Esto se utiliza para crear acceso seguro entre Clerk y JTL.

Instalación de scripts de seguimiento #

Con el complemento S360 Clerk, puedes habilitar tanto los scripts de seguimiento de visitantes como de pedidos, que se inyectarán en partes de la tienda en línea:

  • El script de seguimiento de visitantes, que inicializa Clerk. Este debe inyectarse dentro del encabezado de la tienda.

  • El script de seguimiento de pedidos que permite el seguimiento de pedidos en tiempo real. Normalmente se instala en la página de confirmación de pedido.

Puedes habilitarlos dentro del complemento JTL en la sección ALLGEMEIN:

Dentro del complemento de Clerk si te desplazas un poco hacia abajo

Cuando ambos scripts estén insertados, Clerk habrá sido inicializado.

Sincronizando tu tienda #

Para mostrar resultados, Clerk debe sincronizar con los productos, categorías, ventas, páginas y clientes desde JTL en un feed de datos generado.

Esto se hace configurando un feed de datos que permite acceder a los datos regularmente.

Esto se explica en más detalle en esta guía Creación de feeds de datos en JTL.

Cuando el feed de datos haya sido generado y agregado a tus ajustes de Data sync bajo System Status en tu backend de my.clerk.io.

Agregando búsqueda y recomendaciones #

Los elementos frontales en Clerk constan de dos partes:

  • Un Design que controla la presentación visual de los productos. Esto puede cambiarse para que coincida con cualquier estilo que desees o puedes usar una de nuestras plantillas de diseño estándar Template Design to use in Clerk.

  • Generalmente usarás 3 Designs: uno para Instant Search, la página de Search y Recommendations.

Ejemplo de un deslizador de recomendaciones usando nuestro editor de diseño
  • Un Content con un embedcode adjunto que muestra los productos. Cada contenido tiene un nombre específico en su embedcode que quieres agregar al respectivo campo llamado Clerk TemplateName. Esto se usa para comunicar entre tu tienda y el respectivo contenido de clerk.

La Guía de Configuración te mostrará dónde debe colocarse cada elemento en la mayoría de las configuraciones de JTL.

Al final de tu configuración, los ajustes en el complemento deberían verse así. Las siguientes imágenes son solo para fines demostrativos.

Credenciales
OpciónSignificado
API KeyTu API key recibida de Clerk
Private KeyTu private API key legacy proporcionada por Clerk. Requerida para restringir el acceso al feed de datos.
LanguageIdioma del feed de datos
customer groupPrecios para el grupo de clientes
CurrencyMoneda en el feed de datos
Faceted designDiseño de los facets
Ajustes de Tracking y Search
ComponenteOpciónSignificado
GeneralmenteUsar seguimiento sin cookiesSeguimiento sin utilizar cookies
¿Usar seguimiento de carrito de compras?Informa a Clerk sobre los cambios en el carrito (seguimiento general del carrito)
Anonimizar emailsDirecciones Email son transmitidas a Clerk de forma anónima (como hash).
Live Suche (Header)¿Activar búsqueda en vivo?Si está desactivado, la Live search de Clerk no se mostrará en el frontend.
Selector LivesearchSelector de búsqueda en vivo independiente de Clerk
Clerk TemplateName LivesuchePlantilla para la búsqueda en vivo (Clerk Backend → Search → Content → Live search → Insert into website → En el código el valor de “data-template="@WERT’”)
Número de sugerencias de búsqueda en la búsqueda en vivoNúmero de sugerencias de búsqueda a mostrar
Número de sugerencias de categoríaNúmero de sugerencias de categoría a mostrar
Número de sugerencias de páginaNúmero de sugerencias de página a mostrar
PosiciónPosición del resultado de búsqueda en vivo en relación al selector
Search (results page)¿Activar página de resultados?Si está desactivado, la página de resultados de Clerk no se mostrará en el frontend.
Clerk TemplateName SearchPlantilla para búsqueda en vivo (Clerk Backend → Search → Content → Search → Insert into website → En el código el valor de “data-template="@WERT’”)
Posición de facetsPosición de los facets
Mostrar facets en URLMostrar facets en URL
Clerk Facets AttributeLista separada por comas de facets disponibles (características JTL)
Clerk Facets Attributes Multiple ValuesLista separada por comas de facets con múltiples valores (características JTL para filtro OR)
Ajustes de data feed y Recommendation
ComponenteOpciónSignificado
Data FeedProcesamiento de CronCómo debe activarse el cron para generar el feed de datos (explicado en detalle en la sección de posibilidades de creación del feed de datos)
Tamaño de loteTamaño de lote de los productos del feed (explicado en detalle en la sección de tamaño de lote)
Página de producto¿Activar deslizador de página de producto?Si está desactivado, el deslizador en la página de producto no se mostrará en el frontend.
Selector de artículo deslizadorSelector para el deslizador de artículo independiente de Clerk
Clerk TemplateName ArticleNombres de las plantillas de deslizador a mostrar. Se pueden especificar varios nombres de plantilla separados por comas.
Método de inserción de deslizadorCómo agregar el deslizador al selector (After, Append, Before, Prepand, ReplaceWith)
Filtrar duplicadosEvita que los deslizadores posteriores contengan productos de los deslizadores anteriores (por defecto: Sí)
Página de carrito¿Activar deslizador de carrito?Si está desactivado, el deslizador en la página de carrito no se mostrará en el frontend.
Selector de carrito deslizadorSelector para el deslizador de carrito independiente de Clerk
Clerk TemplateName Shopping CartNombres de las plantillas de deslizador a mostrar. Se pueden especificar varios nombres de plantilla separados por comas.
Método de inserción de deslizadorCómo agregar el deslizador al selector (After, Append, Before, Prepand, ReplaceWith)
Filtrar duplicadosEvita que los deslizadores posteriores contengan productos de los deslizadores anteriores (por defecto: Sí)
Powerstep¿Activar Powerstep Slider?Si está desactivado, el deslizador de power step no se mostrará en el frontend.
Selector de PowerstepSelector para el Powerstep Slider independiente de Clerk
Clerk TemplateName PowerstepNombres de las plantillas de deslizador a mostrar. Se pueden especificar varios nombres de plantilla separados por comas.
Método de inserción PowerstepCómo agregar el deslizador al selector (After, Append, Before, Prepand, ReplaceWith)
Filtrar duplicadosEvita que los deslizadores posteriores contengan productos de los deslizadores anteriores (por defecto: Sí)
Ajustes de categoría y salida-intent
ComponenteOpciónSignificado
Página de categoría¿Activar deslizador de página de categoría?Si está desactivado, el deslizador en la página de categoría no se mostrará en el frontend.
Selector de categoría deslizadorSelector para el deslizador de categoría independiente de Clerk
Clerk TemplateName Shopping CartNombres de las plantillas de deslizador a mostrar. Se pueden especificar varios nombres de plantilla separados por comas.
Método de inserción de deslizadorCómo agregar el deslizador al selector (After, Append, Before, Prepand, ReplaceWith)
Filtrar duplicadosEvita que los deslizadores posteriores contengan productos de los deslizadores anteriores (por defecto: Sí)
Exit Intent¿Habilitar Exit Intent Slider?Si está desactivado, el exit intent no se mostrará en el frontend.
Clerk TemplateName Exit IntentPlantilla para el exit intent

Múltiples dominios #

La forma más sencilla de implementar Clerk en varios dominios en configuraciones estándar es creando un Store separado para cada dominio en my.clerk.io, y luego sincronizarlos con cada uno de tus dominios de idioma JTL.

De esta manera, puedes separar productos, ventas, monedas, etc., para llevar el control de cada dominio.

  1. Comienza creando tu Store principal y sigue la Guía de Configuración para conectar tu Store a Clerk, y elige los Recommendations y/o Search Results que quieras mostrar en tu tienda en línea.

  2. Cuando hayas terminado la configuración inicial, vuelve a la página principal de my.clerk.io (haciendo clic en el logo de Clerk en la esquina superior izquierda del menú lateral) y luego haz clic en "+ Add new store", la última opción de la lista desplegable (generalmente debajo del/los Store(s) existentes y el nombre de tu empresa):

Menú desplegable para agregar nueva tienda
  1. En la página Add New Store, haz clic en Advanced para ver todos los ajustes.
Ajustes avanzados
  1. Completa los datos de tu dominio y elige tu Store principal en el desplegable Copy Content From Existing Store, luego haz clic en Add Store. Esto copiará el Content y los Designs de tu Store principal.
Copiar contenido de una tienda existente
  1. Ahora puedes seguir la Guía de Configuración nuevamente, para activar Clerk haciendo clic en Getting Started, para Sync Data del nuevo dominio.
Página de inicio
  1. Esto te permitirá sincronizar tu dominio con tu Store en my.clerk.io a través de la Guía de Configuración.

  2. Cuando Data Sync termine, tu dominio estará listo y utilizando la misma configuración que tu Store principal.

  3. Repite este proceso para cada uno de tus dominios de idioma JTL. Recuerda traducir los Títulos, en Content-> Edit -> Select Design al idioma correcto también.

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