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 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 se pueden agregar a varias Stores a la vez cuando sea necesario.

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

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

Gestionar Stores #

Una Company puede tener cualquier cantidad de Stores asociadas y estas se pueden crear, copiar o eliminar según sea necesario.

Añadir nueva #

Nuevas Stores se agregan en my.clerk.io, haciendo clic en el nombre de la Store actual en la esquina superior izquierda y luego + Add New Store.

Rellena los detalles de tu store y haz clic en Add New Store.

La Platform que selecciones adaptará las guías de configuración de la Store para que coincidan con la implementación de Clerk en la plataforma, así que es importante elegir la correcta.

La currency solo se usa para reflejar la moneda adecuada en los paneles de la Store y no influye en el seguimiento.

Copiar desde existente #

Cuando creas una nueva store en my.clerk.io, puedes ahorrarte mucho trabajo si usas la misma configuración que tu store existente simplemente copiando el contenido, diseños y otros aspectos 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 seleccionar qué elementos específicos copiar:

• Content
• Designs
• Synonyms
• Accessories
• Audiences
• Rules
• Merchandising
• Modifiers

Ahora solo necesitas realizar pequeños cambios en los Designs (como cambiar los símbolos de moneda y los textos de botones, por ejemplo).

La nueva Store aún necesitará 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 restaurar.

Puedes eliminarlas dirigiéndote a Settings > Store settings y luego haciendo clic en Delete Store al final de la página. Confirma en el siguiente aviso y después de esto, tu Store quedará eliminada.

Claves API #

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

Cada Store tiene una Public API key fija y un número de Private API keys.

La Public API key se utiliza al hacer llamadas básicas a Clerk y se puede compartir libremente ya que por sí misma no da acceso a datos sensibles.

Combinada con una Private API key, puedes acceder a datos sensibles como direcciones de correo electrónico y realizar cambios en los datos de una Store.

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

Rotación de claves #

Si tu Store tiene una Legacy Private Key, puede rotarse directamente desde Developers > API Keys haciendo clic en el botón de rotar junto a ella.

La rotación invalida instantáneamente la clave anterior: cualquier integración que la utilice dejará de funcionar inmediatamente. Asegúrate de estar listo para reemplazarla en todos los lugares donde se use antes de rotar o justo después.

Después de rotar, es posible que también tengas que cerrar sesión en el backend de Clerk.io y volver a iniciar sesión, ya que la clave anterior puede seguir 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 diferentes propósitos, y cada una puede ser revocada individualmente sin afectar a las demás.

Estado de la API #

Esto contiene una visión general de todas las llamadas a la API realizadas en un período de tiempo definido. Tiene varios puntos de información:

API: El endpoint de la API que se llamó. Ej. recommendations/popular

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

Hits: La cantidad total de resultados encontrados por el endpoint.

Results: La cantidad total de resultados realmente mostrados a los clientes. Esto puede diferir de los hits si utilizas filtros o límites inferiores al mostrar resultados.

Avg. Response Time: Milisegundos promedio que tarda el endpoint en responder.

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

Logs de desarrollador #

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

Consulta la vista general completa aquí: /platform/company/developer-logs/.

Debug Dashboard #

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

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

Simple vs Avanzado #

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

Ejecutar una solicitud #

1. Elige un Endpoint (por ejemplo Search Products o Complementary Products).
2. Rellena los campos necesarios.
3. Opcional: Expande Additional fields y añade cualquier parámetro extra que desees probar.
4. Haz clic en Run Request (o Make full API call en modo avanzado).

Resultado de depuración #

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

• Customized search rules: Configuración específica por consulta que afectó los resultados.
• Merchandising: Campañas que se aplicaron y qué cambiaron.
• Backfill: Productos añadidos a los resultados para alcanzar el límite.
• Metadata: Detalles adicionales calculados para la llamada.

Funcionalidades #

Las Stores tienen varios interruptores para controlar qué funciones están habilitadas.

Configuraciones de personalización #

Funciones estándar que se pueden activar o desactivar. Principalmente se usan para identificar problemas causados por modificar el comportamiento estándar de Clerk. Cuando una función está desactivada, cualquier funcionalidad dentro de esa función dejará de funcionar.

Las funciones que se pueden activar o desactivar actualmente son:

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

Acceso anticipado #

Estas son funciones que aún están en desarrollo activo. Se pueden activar manualmente para probar nuevas funciones antes de que estén disponibles en todas partes.

La mayoría puede ser activada 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 la etapa previa a Early Access público.

Si alguna de las siguientes no te aparece, es porque sigue en Beta. Contacta a un empleado de Clerk si quieres 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 comprobar la diferencia comparado con el sitio en vivo.

Search 3.0 supone una gran mejora en la forma de interpretar cualquier tipo de consulta y ordenar los resultados de búsqueda.

AI Demo Shop Assistant #

Activa el Chat en la Demo Store, para pruebas. 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 forma de interpretar cualquier tipo de consulta y ordenar los resultados de búsqueda.

No tienes que reinstalar Search en tu sitio ya que el cambio ocurre a nivel de API. Funciona con tu configuración existente.

Semantic Fallback (Beta) #

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

Si no se encuentra una coincidencia directa, Clerk analizará la consulta y entenderá semánticamente lo que buscan los visitantes. Por ejemplo, una búsqueda como “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:

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

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

Order Scoring (Legacy) #

Una forma diferente de puntuar productos basada en los datos de los pedidos en los resultados de búsqueda de versiones antiguas de Search. Esto se está eliminando ya que Search (3.0) gestiona esto de forma mucho mejor.

Spell Fix (Legacy) #

Una forma diferente de corregir errores ortográficos en versiones anteriores de Search. Esto se está eliminando ya que Search (3.0) lo gestiona mucho mejor.

SKU Search Optimization (Legacy) #

Una forma diferente de gestionar búsquedas de SKU en versiones anteriores de Search. Esto se está eliminando ya que Search (3.0) lo gestiona de forma mucho más eficiente.

Autocomplete Improvement (Legacy) #

Una forma diferente de autocompletar búsquedas en versiones anteriores de Search. Esto se está eliminando ya que Search (3.0) lo gestiona de forma mucho mejor.

Improved Category Search (Legacy) #

Una forma diferente de buscar categorías en versiones anteriores de Search. Esto se está eliminando ya que Search (3.0) lo gestiona de forma mucho mejor.

Esquema de color #

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