Stores

Conceptos básicos #

Una Tienda es una entidad separada en Clerk.io que contiene todos los datos y configuraciones para un dominio específico. Esto puede ser una tienda web única, una plataforma, una versión de idioma, o cualquier otra cosa que deba funcionar como una entidad independiente.

Funcionan completamente de forma independiente y no comparten datos entre sí. La única excepción es que algunas funciones como Merchandising y Synonyms pueden añadirse en varias Tiendas a la vez cuando sea necesario.

Cada Tienda tiene su propio conjunto de claves API para comunicarse con ella a través de la API de Clerk, independientemente del tipo de configuración que utilices.

Las Tiendas se pueden configurar para 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 compatibles.

Gestión de Tiendas #

Una Empresa puede tener cualquier cantidad de Tiendas asociadas, y estas pueden ser creadas, copiadas y eliminadas según sea necesario.

Añadir nueva #

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

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

La Plataforma que selecciones adaptará las Guías de Configuración de la Tienda para coincidir con cómo Clerk está implementado en la plataforma, por lo que es importante elegir la correcta.

La moneda solo se utiliza para reflejar la moneda correcta en los paneles de la Tienda y no tiene influencia en el seguimiento.

Copiar desde una existente #

Cuando creas una nueva tienda en my.clerk.io, puedes ahorrarte mucho trabajo si usas la misma configuración de una ya existente simplemente copiando el contenido, diseños y otros aspectos de configuración que desees reutilizar.

Esto es muy útil si creas una nueva Tienda para otro idioma o para un nuevo dominio de tu Tienda original.

En Copy Content From Existing Store, elige la Tienda que quieres duplicar del menú desplegable. Puedes elegir qué elementos específicos deseas copiar:

• Contenido
• Diseños
• Synonyms
• Accesorios
• Audiences
• Reglas
• Merchandising
• Modificadores
• Configuraciones de Chat
• Integraciones de IA

Solo necesitas hacer pequeños cambios en los Diseños (como cambiar los símbolos de moneda y textos de los botones, por ejemplo).

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

Eliminar una Tienda #

Cuando eliminas una Tienda, sus configuraciones y datos serán eliminados para siempre y no podrán ser restaurados.

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

Claves API #

Si necesitas las claves de tu Tienda para cualquier propósito después de la integración inicial, se encuentran bajo Developers > API Keys.

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

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

Combinada con una Private API key, puedes obtener acceso a datos sensibles como direcciones de email y realizar cambios en los datos de una Tienda.

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

Rotación de claves #

Si tu Tienda tiene una Legacy Private Key, puede rotarse directamente desde Developers > API Keys haciendo clic en el botón de rotar al lado.

Rotar invalida instantáneamente la clave antigua: cualquier integración que la utilice dejará de funcionar de inmediato. Asegúrate de estar preparado para reemplazarla en todas partes antes o justo después de rotarla.

Después de rotar, puede que también necesites cerrar sesión en el backend de Clerk.io y volver a ingresar, 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 necesites para distintos propósitos, y cada una puede ser revocada individualmente sin afectar a las demás.

Estadísticas de API #

Abre Developers > API Stats para ver un resumen de las llamadas API en el periodo seleccionado.

Las llamadas sin resultados no son necesariamente errores HTTP. Por ejemplo, una búsqueda válida puede no devolver productos coincidentes.

Registros de Desarrollador #

Usa los Registros de Desarrollador para inspeccionar solicitudes, errores y advertencias de tu Tienda en tiempo real. Ve a Developers > Logs.

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

API Debug #

Utiliza API Debug para crear solicitudes a la API e inspeccionar los resultados. Abre Developers > API Debug para la tienda en la que estás trabajando. Los parámetros están organizados en grupos de formulario.

Simple vs Avanzado #

• Simple: Cada parámetro de la 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.
• Avanzado: Crea manualmente una solicitud completa de GET a la API (por ejemplo, pegando la URL completa). Esto es útil si ya tienes una llamada a la API desde el código o 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. Rellena los campos obligatorios.
3. Opcional: Expande Additional fields y agrega los parámetros extra que quieras probar.
4. Haz clic en Run Request (o Make full API call en modo Avanzado).

Resultados de Debug #

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

• Reglas de búsqueda personalizadas: Configuración específica de la consulta que afectó los resultados.
• Merchandising: Campañas aplicadas y qué cambiaron.
• Backfill: Productos añadidos para completar el límite.
• Metadata: Detalles adicionales calculados para la llamada.

Funcionalidades #

Las tiendas cuentan con varios interruptores (toggles) que se pueden usar para controlar qué funcionalidades están habilitadas.

Configuración de Personalización #

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

Las funcionalidades actuales que pueden activarse son:

• Reglas
• Redirecciones
• Synonyms
• Merchandising
• Campañas de IA
• Categorías de nombre completo

Early Access #

Estas son funcionalidades que aún están en desarrollo activo. Se pueden activar manualmente para probar nuevas características antes de que estén disponibles para todos.

La mayoría puede ser activada por cualquier usuario en una Tienda, y algunas solo pueden ser activadas por empleados de Clerk si aún están en Beta, que es la etapa antes de pasar a Early Access público.

Si alguna de las siguientes opciones no es visible para ti, es porque todavía está en Beta. Contacta a un empleado de Clerk si estás interesado en probar funciones Beta.

Search 3.0 en Demo Store #

La última versión de nuestro motor de Search puede activarse específicamente en la Demo Store para ver la diferencia respecto al sitio en vivo.

Search 3.0 supone una gran mejora en la comprensión de cualquier tipo de consulta y en el ranking de los resultados de búsqueda.

AI Demo Shop Assistant #

Activa el Chat en la Demo Store, para que se pueda probar. Solo funciona si también has activado Search 3.0. Más información en la página de Introducción de Chat.

Search 3.0 #

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

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

Semantic Fallback (Beta) #

Un modo innovador de manejar búsquedas de frases completas.

Si no se encuentra una coincidencia directa, Clerk analizará la consulta y comprenderá de forma semántica lo que buscan los visitantes. Por ejemplo, una búsqueda de “algo para enfriar mi comida” devolverá refrigeradores.

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 estas lógicas:

• Más vendidos (recommendations/popular)
• Más vendidos en Categoría (recommendations/category/popular)

Esto no requiere reinstalar Recommendations ya que el cambio es a nivel de API.

Order Scoring (Legacy) #

Un método diferente para puntuar productos en base a sus datos de pedidos en los resultados de búsqueda en versiones anteriores de Search. Está siendo eliminado ya que nuestra última versión de Search (3.0) lo gestiona de manera mucho más eficaz.

Spell Fix (Legacy) #

Una forma diferente de manejar errores ortográficos en versiones anteriores de Search. Está siendo eliminado ya que la última versión de Search (3.0) lo gestiona de forma mucho más efectiva.

SKU Search Optimization (Legacy) #

Una forma diferente de gestionar las búsquedas por SKU en versiones antiguas de Search. Está siendo eliminado ya que Search (3.0) lo gestiona mucho mejor.

Autocomplete Improvement (Legacy) #

Una forma diferente de autocompletar búsquedas en versiones antiguas de Search. Está siendo eliminado ya que la versión 3.0 de Search lo mejora considerablemente.

Improved Category Search (Legacy) #

Una manera diferente de buscar categorías en versiones antiguas de Search. Está siendo eliminado ya que la versión 3.0 de Search lo mejora considerablemente.

Esquema de Colores #

Las tiendas heredarán el esquema de colores preferido de tu sistema operativo. Soporta tanto modo claro como modo oscuro.