Get Started

Conectando tu tienda #
El primer paso para instalar Clerk.io es conectar tu tienda con tu cuenta de Clerk.io.
Después de seguir estos sencillos pasos podrás ver tu Demo Store, que te da una visión personalizada de cómo Clerk.io funcionará en tu tienda web, antes de configurar el resto del sistema.
1. Agregar tienda #
Después de iniciar sesión en my.clerk.io, lo primero que tienes que hacer es agregar tu tienda:
Escribe el Nombre y Dominio de tu tienda web
Elige VTEX como Plataforma y selecciona tu Moneda.
Haz clic en Add Store.
2. Instalar y configurar el módulo #
En la cli de vtex ejecuta vtex install
clerkiopartnerdk.integration-vtex. Puedes confirmar que la app ya se ha instalado ejecutandovtex lsnuevamente.Accede a la sección de Apps en la página de administración de tu cuenta y busca el ClerkIO Integration box. Una vez la encuentres, haz clic en la caja. Completa los campos solicitados. Para sitios MultiBinding, haz clic en habilitar configuración por binding para asociar una Clerk Store a cada Binding.
Opciones de configuración #
Configura cada binding de VTEX con los siguientes campos. Un binding normalmente representa una tienda, localización o canal de ventas.
Clerk.io Public API Key: La clave pública para la tienda de Clerk.io utilizada en este binding. Encuéntrala en my.clerk.io > Developers > API Keys.
Clerk.io Private API Key: La clave privada utilizada para autorizar a Clerk.io cuando solicita el feed de datos para este binding.
Collect User Emails: Habilita el seguimiento de correo electrónico para compradores registrados y suscriptores de newsletter en la tienda.
También puedes activar la recopilación automática de correos electrónicos en my.clerk.io. Abre tu tienda, ve a Developers > Clerk.js Config, activa Collect Emails, y haz clic en Save.
Esto identifica a los visitantes; no los suscribe a marketing.
Sales Channel: El ID de canal de ventas de VTEX asociado a este binding. La integración lo usa para devolver los productos y pedidos correctos.
Default Locale: El locale utilizado al generar el feed de productos, por ejemplo
en-USopt-BR.Binding Root Path: El path de la tienda para este binding, sin barras iniciales ni finales. Déjalo vacío si el binding no tiene un path. Por ejemplo, ingresa
outletpara una tienda servida bajo/outlet/.
- Genera los feeds de productos, categorías y pedidos haciendo un POST request a los siguientes endpoints (reemplazando accountName, workspace y bindingID):
Haz un GET Request a este endpoint: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}}
Requiere que VtexIdclientAutCookie se envíe como header.
La primera llamada a la generación del feed responderá con un array vacío. Dependiendo del tamaño del catálogo de tu tienda, el feed puede tardar un tiempo en generarse
3. Sincroniza tu tienda #
La sincronización de datos conecta tu tienda VTEX con Clerk, permitiendo a Clerk acceder a tus productos, pedidos, clientes, categorías y demás información de la tienda. Esto permite que Clerk ofrezca recomendaciones personalizadas y resultados de búsqueda basados en los datos reales de tu tienda. Sigue los pasos en la guía de sincronización de datos para configurar la sincronización de datos.
Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.