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 brinda una visión general personal de cómo funcionará Clerk.io en tu tienda online, antes de configurar el resto del sistema.

1. Añadir tienda #

Después de iniciar sesión en my.clerk.io, lo primero que debes hacer es añadir tu tienda:

1. Escribe el Name y Domain de tu tienda online

2. Elige VTEX como Platform y selecciona tu Currency.

3. Haz clic en Add Store.

2. Instalar y configurar el módulo #

1. En la CLI de vtex, ejecuta vtex install clerkiopartnerdk.integration-vtex. Puedes confirmar que la aplicación se ha instalado ejecutando vtex ls nuevamente.

2. Accede a la sección Apps en la página de administración de tu cuenta y busca la ClerkIO Integration box. Una vez que la encuentres, haz clic en la caja. Completa los campos como se solicita. Para sitios MultiBinding, haz clic en la opción de configuración habilitando el binding para vincular 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 online, un idioma local o un canal de ventas.

• Clerk.io Public API Key: La Public Key de la Clerk.io store utilizada para este binding. Encuéntrala en my.clerk.io > Developers > API Keys.

• Clerk.io Private API Key: La Private Key utilizada para autorizar Clerk.io cuando solicita el data feed para este binding.

• Collect User Emails: Activa el seguimiento de email para usuarios conectados y suscriptores al boletín en la tienda online.

• Sales Channel: El ID de canal de ventas VTEX asociado a este binding. La integración lo utiliza para devolver los productos y pedidos correctos.

• Default Locale: El idioma local utilizado al generar el product feed, por ejemplo, en-US o pt-BR.

• Binding Root Path: La ruta base de la tienda correspondiente al binding, sin barras inclinadas iniciales o finales. Déjalo vacío si el binding no tiene ruta. Por ejemplo, introduce outlet para una tienda online servida bajo /outlet/.

3. Genera los feeds de productos, categorías y pedidos haciendo una solicitud POST a los siguientes endpoints (reemplazando accountName, workspace y bindingID):

Realiza una solicitud GET al siguiente 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 encabezado.

La primera llamada para 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 algún tiempo en generarse

3. Sincroniza tu tienda #

Sincronizar los datos conecta tu tienda VTEX con Clerk, permitiendo que Clerk acceda a tus productos, pedidos, clientes, categorías y otra información de la tienda. Esto permite a Clerk proporcionar 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.