Get Started
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:

Escribe el Nombre y Dominio de tu tienda en línea.
Elige JTL como la Plataforma y selecciona tu Moneda.
Haz clic en Add Store.
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:

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:

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

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

| Opción | Significado |
|---|---|
| API Key | Tu API key recibida de Clerk |
| Private Key | Tu private API key legacy proporcionada por Clerk. Requerida para restringir el acceso al feed de datos. |
| Language | Idioma del feed de datos |
| customer group | Precios para el grupo de clientes |
| Currency | Moneda en el feed de datos |
| Faceted design | Diseño de los facets |

| Componente | Opción | Significado |
|---|---|---|
| Generalmente | Usar seguimiento sin cookies | Seguimiento sin utilizar cookies |
| ¿Usar seguimiento de carrito de compras? | Informa a Clerk sobre los cambios en el carrito (seguimiento general del carrito) | |
| Anonimizar emails | Direcciones 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 Livesearch | Selector de búsqueda en vivo independiente de Clerk | |
| Clerk TemplateName Livesuche | Plantilla 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 vivo | Número de sugerencias de búsqueda a mostrar | |
| Número de sugerencias de categoría | Número de sugerencias de categoría a mostrar | |
| Número de sugerencias de página | Número de sugerencias de página a mostrar | |
| Posición | Posició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 Search | Plantilla 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 facets | Posición de los facets | |
| Mostrar facets en URL | Mostrar facets en URL | |
| Clerk Facets Attribute | Lista separada por comas de facets disponibles (características JTL) | |
| Clerk Facets Attributes Multiple Values | Lista separada por comas de facets con múltiples valores (características JTL para filtro OR) |

| Componente | Opción | Significado |
|---|---|---|
| Data Feed | Procesamiento de Cron | Có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 lote | Tamañ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 deslizador | Selector para el deslizador de artículo independiente de Clerk | |
| Clerk TemplateName Article | Nombres de las plantillas de deslizador a mostrar. Se pueden especificar varios nombres de plantilla separados por comas. | |
| Método de inserción de deslizador | Cómo agregar el deslizador al selector (After, Append, Before, Prepand, ReplaceWith) | |
| Filtrar duplicados | Evita 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 deslizador | Selector para el deslizador de carrito independiente de Clerk | |
| Clerk TemplateName Shopping Cart | Nombres de las plantillas de deslizador a mostrar. Se pueden especificar varios nombres de plantilla separados por comas. | |
| Método de inserción de deslizador | Cómo agregar el deslizador al selector (After, Append, Before, Prepand, ReplaceWith) | |
| Filtrar duplicados | Evita 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 Powerstep | Selector para el Powerstep Slider independiente de Clerk | |
| Clerk TemplateName Powerstep | Nombres de las plantillas de deslizador a mostrar. Se pueden especificar varios nombres de plantilla separados por comas. | |
| Método de inserción Powerstep | Cómo agregar el deslizador al selector (After, Append, Before, Prepand, ReplaceWith) | |
| Filtrar duplicados | Evita que los deslizadores posteriores contengan productos de los deslizadores anteriores (por defecto: Sí) |

| Componente | Opción | Significado |
|---|---|---|
| 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 deslizador | Selector para el deslizador de categoría independiente de Clerk | |
| Clerk TemplateName Shopping Cart | Nombres de las plantillas de deslizador a mostrar. Se pueden especificar varios nombres de plantilla separados por comas. | |
| Método de inserción de deslizador | Cómo agregar el deslizador al selector (After, Append, Before, Prepand, ReplaceWith) | |
| Filtrar duplicados | Evita 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 Intent | Plantilla 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.
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.
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):

- En la página Add New Store, haz clic en Advanced para ver todos los ajustes.

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

- Ahora puedes seguir la Guía de Configuración nuevamente, para activar Clerk haciendo clic en Getting Started, para Sync Data del nuevo dominio.

Esto te permitirá sincronizar tu dominio con tu Store en my.clerk.io a través de la Guía de Configuración.
Cuando Data Sync termine, tu dominio estará listo y utilizando la misma configuración que tu Store principal.
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.