Stores

Conceptos básicos #

Una Store es una entidad separada en Clerk.io que contiene todos los datos y configuraciones para un dominio específico. Esto puede ser una tienda online única, una plataforma, una versión en un idioma diferente, o cualquier otro caso que deba funcionar como una entidad separada.

Funcionan completamente de manera independiente y no comparten datos entre sí. La única excepción es que algunas funciones como Merchandising y Synonyms pueden añadirse en varias Stores al mismo tiempo si es necesario.

Cada Store tiene su propio conjunto de claves API para comunicarse mediante la API de Clerk, independientemente del tipo de configuración que utilices.

Las Stores pueden configurarse en cualquiera de los 54 idiomas compatibles. Search e indexación funcionan en todos los idiomas compatibles. No se necesita migración; los cambios están disponibles de inmediato. Consulta la lista completa de idiomas soportados.

Gestión de Stores #

Una Company puede tener cualquier número de Stores asociadas y pueden ser creadas, copiadas y eliminadas según sea necesario.

Añadir nueva #

Las nuevas Stores se añaden en my.clerk.io, haciendo clic en el nombre actual de la Store en la esquina superior izquierda y luego + Add New Store.

Completa los detalles de tu tienda y haz clic en Add New Store.

La Platform que selecciones ajustará las guías de configuración de la Store para que coincidan con cómo se instala Clerk en la plataforma, por lo que es importante elegir la correcta.

La currency solo se utiliza para mostrar la moneda correcta en los paneles de la Store y no influye en el seguimiento.

Copiar desde existente #

Cuando creas una new store en my.clerk.io, puedes ahorrarte mucho trabajo si usas la misma configuración que tu tienda existente simplemente copiando el content, designs y otros aspectos de configuración que desees reutilizar.

Esto es muy útil si estás creando una nueva Store para un idioma diferente o un nuevo dominio para tu Store original.

En Copy Content From Existing Store, elige la Store que deseas duplicar en el desplegable. Puedes elegir qué elementos específicos deseas copiar:

• Content
• Designs
• Synonyms
• Accessories
• Audiences
• Rules
• Merchandising
• Modifiers
• Chat settings
• AI integrations

Ahora solo tendrás que hacer pequeños cambios en los Designs (como cambiar los currency symbols y button texts, por ejemplo).

La nueva Store aún tendrá que sincronizarse con tu catálogo y tendrá su propio conjunto de claves API.

Eliminar una Store #

Cuando eliminas una Store, su configuración y datos se eliminarán para siempre y no se podrán recuperar.

Puedes eliminarlas yendo a Settings > Store settings y luego haciendo clic en Delete Store en la parte inferior de la página. Confirma en la siguiente ventana, y después de esto, tu Store estará eliminada.

Claves API #

Si necesitas las claves de tu Store para cualquier propósito después de la integración inicial, puedes encontrarlas en Developers > API Keys.

Cada Store tiene una Public API key fija y varias Private API keys.

La Public API key se usa para realizar llamadas básicas a Clerk y puede compartirse en cualquier sitio, ya que por sí sola no da acceso a datos sensibles.

Combinada con una Private API key, se puede acceder a datos sensibles como direcciones email y realizar cambios en los datos de una Store.

Por razones de seguridad para Clerk, la Private API Key se generará al crear la tienda y será enviada al propietario de la cuenta MyClerk.

Rotación de claves #

Si tu Store tiene una Legacy Private Key, puedes rotarla directamente desde Developers > API Keys haciendo clic en el botón de rotación al lado de la clave.

Rotar invalida la clave anterior al instante — cualquier integración que la utilice dejará de funcionar inmediatamente. Asegúrate de reemplazarla en todos los lugares donde se use antes de rotar o justo después de hacerlo.

Después de rotar, también puede ser necesario cerrar sesión y volver a entrar en el backend de Clerk.io, ya que la clave antigua puede permanecer activa en tu sesión actual.

Para una configuración más manejable, utiliza las Private API Keys estándar. Puedes crear tantas como sean necesarias para distintos propósitos, y cada una puede revocarse individualmente sin afectar a las demás.

Estado de la API #

Aquí encontrarás una visión general de todas las llamadas API realizadas en un periodo de tiempo definido. Incluye una variedad de datos:

API: El endpoint de la API al que se hace la llamada. Ej. recommendations/popular

Labels: Identificación utilizada por Clerk para rastrear resultados. Ej. Homepage / Popular

Hits: El número total de resultados encontrados por el endpoint.

Results: El número total de resultados que realmente se muestran a los clientes. Esto puede diferir de los hits si utilizas filtros o límites al mostrar resultados.

Avg. Response Time: Promedio de milisegundos que tarda el endpoint de la API en responder.

Success Rate: Porcentaje de llamadas API que realmente devolvieron resultados.

Developer Logs #

Utiliza los Developer Logs para inspeccionar solicitudes, errores y advertencias de tu Store en tiempo real. Ve a Developers > Logs.

Consulta la descripción completa de la función aquí: /platform/company/developer-logs/.

Debug Dashboard #

Utiliza Debug para crear solicitudes API e inspeccionar por qué se devuelve un conjunto específico de resultados.

Encuéntralo en Developers > Debug para la Store en la que estás trabajando.

Simple vs Avanzado #

• Simple: Cada parámetro API se configura en su propio campo. Solo se muestran los campos obligatorios al principio, y puedes expandir Additional fields para acceder a parámetros opcionales.
• Advanced: Crea manualmente una solicitud GET API completa (por ejemplo, pegando la URL completa). Es útil si ya tienes una llamada API desde el código o desde la pestaña de red del navegador que quieras reproducir.

Ejecutar una solicitud #

1. Elige un Endpoint (por ejemplo Search Products o Complementary Products).
2. Completa los campos obligatorios.
3. Opcional: Expande Additional fields y agrega cualquier parámetro extra que desees probar.
4. Haz clic en Run Request (o Make full API call en el modo Advanced).

Salida de Depuración #

Después de ejecutar una solicitud, la página muestra tanto los results como los diagnostics que explican qué los ha influido. Dependiendo del endpoint y la configuración, esto puede incluir:

• Customized search rules: Configuración específica para la consulta que ha afectado los resultados.
• Merchandising: Campañas aplicadas y los cambios realizados.
• Backfill: Productos añadidos a los resultados para cumplir el límite.
• Metadata: Detalles adicionales calculados para la llamada.

Funcionalidades #

Las Stores disponen de varios interruptores para controlar qué funciones están activadas.

Configuración de personalización #

Funciones estándar que pueden activarse o desactivarse. Se utilizan principalmente para identificar problemas causados por modificar el comportamiento estándar de Clerk. Cuando una función está disabled, cualquier funcionalidad dentro de esa función dejará de funcionar.

Las funciones actuales que pueden activarse o desactivarse son:

• Rules
• Redirects
• Synonyms
• Merchandising
• AI Campaigns
• Fullname Categories

Early Access #

Son funciones que aún están en desarrollo activo. Pueden activarse manualmente para probar nuevas características antes de su lanzamiento general.

La mayoría pueden ser activadas por cualquier usuario en una Store, y algunas solo pueden ser activadas por empleados de Clerk si aún están en Beta, que es el paso anterior a convertirse en públicas en Early Access.

Si alguna de las siguientes no es visible para ti, aún está en Beta. Contacta con un empleado de Clerk si te interesa probar funciones en Beta.

Search 3.0 en Demo Store #

La última versión de nuestro motor de Search puede activarse en la Demo Store específicamente, para comprobar la diferencia en comparación con el sitio en vivo.

Search 3.0 supone una gran mejora en cómo entiende cualquier tipo de consulta y clasifica los resultados de búsqueda.

AI Demo Shop Assistant #

Activa el Chat en la Demo Store para poder probarlo. Solo funciona si también has activado Search 3.0. Más información en la página de introducción al Chat.

Search 3.0 #

Activa la última versión de nuestro motor de Search en tu sitio en vivo. Search 3.0 es una gran mejora en la comprensión de cualquier tipo de consulta y clasificación de resultados de búsqueda.

No tienes que reinstalar Search en tu sitio, ya que el cambio ocurre a nivel de API. Funcionará con tu configuración actual.

Semantic Fallback (Beta) #

Una forma revolucionaria de gestionar búsquedas de frases completas.

Si no se encuentra una coincidencia directa, Clerk analizará la consulta y comprenderá semánticamente lo que buscan los visitantes. Ej. una búsqueda de “algo para enfriar mi comida” mostrará frigoríficos.

Recommendations 3.0 (Beta) #

Una forma mucho más rápida de mostrar resultados de Recommendations, basada en el mismo framework que Search 3.0.

Actualmente funciona para las siguientes lógicas:

• Bestsellers (recommendations/popular)
• Bestsellers in Category (recommendations/category/popular)

Esto no requiere reinstalar Recommendations, ya que el cambio ocurre a nivel API.

Order Scoring (Legacy) #

Una forma diferente de puntuar productos según los datos de pedidos en resultados de búsqueda en versiones antiguas de Search. Se está eliminando progresivamente, ya que nuestra última versión de Search (3.0) gestiona esto de forma mucho más eficiente.

Spell Fix (Legacy) #

Una forma diferente de gestionar errores ortográficos en versiones antiguas de Search. Se está eliminando progresivamente, ya que nuestra última versión de Search (3.0) gestiona esto de forma mucho más eficiente.

SKU Search Optimization (Legacy) #

Una forma diferente de gestionar búsquedas de SKU en versiones antiguas de Search. Se está eliminando progresivamente, ya que nuestra última versión de Search (3.0) gestiona esto de forma mucho más eficiente.

Autocomplete Improvement (Legacy) #

Una forma diferente de autocompletar búsquedas en versiones antiguas de Search. Se está eliminando progresivamente, ya que nuestra última versión de Search (3.0) gestiona esto de forma mucho más eficiente.

Improved Category Search (Legacy) #

Una forma diferente de buscar categorías en versiones antiguas de Search. Se está eliminando progresivamente, ya que nuestra última versión de Search (3.0) gestiona esto de forma mucho más eficiente.

Esquema de color #

Las Stores heredarán el esquema de color preferido de tu sistema operativo. Es compatible tanto con el modo claro como con el modo oscuro.