Cómo realizar Integración con VTEX
Introducción
La integración con el E-Commerce VTEX permite enviar de forma automática los datos del MASTERDATA de clientes hacia un perfil ICOMMKT, así como el enriquecimiento de los mismos a partir de información procesada de las diversas compras realizadas por cada uno de ellos.
Entre estos datos podemos encontrar:
• Fecha de última compra
• Días desde última compra
• Fecha de primera compra
• Días desde primera compra
• Productos comprados en los últimos 30, 60, 90, 180, 360, 360 + días
• Categorías de Productos comprados en los últimos 30, 60, 90, 180, 360, 360 + días
• Cantidad de compras realizadas en los últimos 30, 60, 90, 180, 360, 360 + días
• Monto de compras realizadas en los últimos 30, 60, 90, 180, 360, 360 + días
• Monto promedio de compras realizadas en los últimos 30, 60, 90, 180, 360, 360 + días
• RFM de compras realizadas en los últimos 30, 60, 90, 180, 360, 360 + días
• Códigos de descuento aplicados en los últimos 30, 60, 90, 180, 360, 360 + días.
• Marcas de Última Compra
• Categorías de Última Compra
• Códigos Promo de Última Compra
• RFM_Group
• RFM_Segment
Consulta más información sobre campos RFM: Qué son y para qué sirven los campos RFM_Group y RFM_Segment
Integración paso a paso
Para activar la integración, previamente se deben generar Roles de Usuario dentro de la plataforma de VTEX.
Dentro del ADMIN de VTEX
Accede a Configuraciones de la cuenta
Accede a Roles de Usuario
Crea un nuevo Rol de Usuario ICOMMKT_Integration con las siguientes características:
- Permisos:
a) Agregar producto/ OMS/ Atributo Visualizar Pedidos (View Order) y (List Orders)
b) Agregar producto/ Dynamic Storage/ Atributo Acceso sólo para lectura en las entidades de datos (Read Only Documents).
c) Agregar producto/ Catalog / Atributos:
Field list
Value field list
Category
Providers
Groups
Brands
SKU
a) Ingresa a Configuración de la cuenta en tu plataforma de Vtex
b) Selecciona la opción Claves de aplicación
c) Selecciona el botón Agregar clave de App externa
d) Escribe la clave y haz click en el botón Agregar roles
e) Selecciona el rol Icommkt_Integration y confirma Agregar rol
f) Accederás a la ventana Mis claves donde debes seleccionar el botón Generar nueva
g) Escribe el nombre de la etiqueta y haz click en Generar
h) Estos pasos te llevarán a una ventana donde se muestra el token por única vez
i) Comparte la clave generada con el equipo de Customer Success para verificar la integración.
Ante cualquier duda adicional sobre este paso, consulta la documentación de VTEX en la siguiente URL: https://help.vtex.com/es/tutorial/application-keys--2iffYzlvvz4BDMr6WGUtet
Configura la integración en la plataforma de Icomm
Ve al menú de Configuración
Ingresa a la opción Integraciones
Selecciona la opción VTEX
Completa los datos básicos de la cuenta a sincronizar (con tu instancia de VTEX)
Completa los campos requeridos para sincronizar la integración: Cuenta, Api Key y Api Token.
Presiona el botón Verificar para proceder a la siguiente fase.
El botón "Verificar" estará deshabilitado hasta que todos los campos tengan datos.
Después de presionar "Verificar", la plataforma informará si se pudo o no realizar la conexión con VTEX.
No se pudo conectar
Si la plataforma no logró sincronizar la conexión se mostrará el siguiente mensaje:
Conexión exitosa
Si Icomm logra conectarse con la plataforma VTEX se mostrará el siguiente mensaje:
Configura los datos del sitio y el canal
En caso de una conexión exitosa, podrás continuar con la configuración de la integración.
Sales Channel: despliega la lista y selecciona los canales disponibles en VTEX o bien elige la opción "Seleccionar Todos".
E-commerce URL: completa el enlace de tu sitio web.
Selecciona el perfil ICOMMKT en el cual se almacenarán los datos
Puedes seleccionar un perfil existente, o bien solicitar la creación de uno nuevo a través del botón NUEVO PERFIL (opción recomendada).
Al utilizar la opción de NUEVO PERFIL, el sistema solicitará un nombre.
Una vez completado el nombre, click en OK
• El sistema generará el perfil solicitado con la estructura de campos base del VTEX MASTERDATA.
Para finalizar, presiona el botón Guardar
El sistema mostrará un mensaje de confirmación.
Nota: La actualización de los datos del dashboard se produce cada 4 horas, mientras que el perfil procesado y enriquecido de datos se calcula e importa cada 24 horas.
Consulta otros artículos sobre Integraciones en Icomm.
Actualizado el: 22/07/2024
¡Gracias!