Master Data es una solución de la plataforma VTEX para el banco de datos que no solo permite su personalización, sino también la creación de aplicaciones.
Por defecto, Master Data se usa para almacenar y organizar los datos de los clientes de tu tienda. Cuenta con un potente motor de búsqueda que te permite almacenar, buscar, expandir y personalizar datos.
En este artículo, encontrarás más detalles sobre cada versión disponible de Master Data, así como conceptos importantes y cómo utilizarlo.
Ten en cuenta que, según la funcionalidad y la versión que desees utilizar, se recomienda ponerse en contacto con el equipo de desarrollo de tu operación.
Versiones disponibles
Actualmente existen dos versiones disponibles y puedes elegir la que mejor se adapte a las necesidades de tu operación. La principal diferencia entre ambas es que la v2 no incluye interfaz gráfica, por lo que se puede usar solo a través de la API del Master Data v2, pero sí tiene otras funcionalidades importantes, por ejemplo, esquemas JSON.
VTEX guarda de forma automática los datos de los clientes de tu tienda en Master Data v1.
En la tabla a continuación, obtendrás más información sobre las diferencias en las funcionalidades de cada versión.
| Funcionalidad | v1 | v2 | Más información |
|---|---|---|---|
| Interfaz gráfica | Sí | No | - |
| API | Sí | Sí | - Master Data v1 API - Master Data v2 API |
| Importar y exportar plantillas | Sí | No | - Importar datos en Master Data - Exportar datos de Master Data |
| Anexos (imágenes) | Sí | No | - |
| Triggers | Sí | Sí | - Triggers - Crear trigger en Master Data v1 - Crear trigger en Master Data v2 |
| Esquemas JSON | No | Sí | - Esquemas JSON - Qué son los esquemas JSON - Empieza a trabajar con los esquemas JSON en Master Data - Ciclo de vida del esquema en Master Data |
| Propiedades anidadas | No | Sí | - Propiedades anidadas |
| Entidades de datos | Se nombran con acrónimos compuestos de dos letras mayúsculas. Ejemplo: CL almacena los clientes, AD los domicilios. No se puede crear con API. | Se los llama por sus nombres, por ejemplo Notification. Solo se puede crear con API. | - Entidades de datos - Entidades de datos en Master Data v1 - Crear relaciones entre entidades de datos de Master Data v2 |
| Campos | Se deben rellenar en el formato específico configurado en la entidad de datos. | No hay restricción de campos y formatos. La validación del formato se hace a través de los esquemas JSON. | - Tipos de campos en Master Data v1 - Esquemas JSON |
| Índices | Sí | Sí | - Configurar índices en Master Data v1 - Configurar índices con la API de Master Data v2 |
Las entidades de datos de ambas versiones son independientes, aunque algunas pueden ser análogas. Esto significa que un dato creado en una entidad de la v1 no se puede consultar ni editar usando recursos de la v2 y viceversa.
Componentes básicos
Ambas versiones de Master Data usan algunos componentes básicos que pueden ser iguales a conceptos encontrados en otras soluciones de base de datos con otros nombres, por ejemplo, registro o tabla. A continuación, encontrarás más detalles sobre:
Entidades de datos
Las entidades de datos son como tablas donde se registran documentos y campos.
Se hace referencia a las entidades de datos en Master Data v1 con acrónimos compuestos de dos letras mayúsculas. En la v2 puedes usar el nombre de la entidad de datos. Por ejemplo, en la v1, la entidad CL almacena los datos de los clientes de la tienda, y la entidad AD guarda datos de los domicilios de los clientes. En la v2, las entidades equivalentes se llaman Client y Address.
En una entidad de datos, la información se estructura en [documentos] (#documentos) y campos.
Documentos
Los documentos son registros en una entidad de datos. Si las entidades de datos son como tablas, cada documento es una línea dentro de una tabla.
Por ejemplo, se guarda información de un cliente en cada documento almacenado dentro de una entidad (por ejemplo, CL o Client).
Cada documento tiene un ID que la plataforma genera automáticamente durante la creación; se trata de un código único que identifica a ese registro.
Campos
Se denomina «campos» a los atributos que componen los documentos de Master Data. Si comparamos las entidades de datos con tablas, podríamos imaginar que los campos son las columnas de la tabla.
Por ejemplo, en una entidad donde se guardan datos de clientes de la tienda, por ejemplo, CL o Client, podemos rellenar los campos como nombre, email, fecha de nacimiento y documento.
En Master Data v1, los campos se deben rellenar en el formato específico configurado en la entidad de datos. Obtén más información sobre los tipos de campo en Master Data v1.
En la v2, no hay restricción de campos ni formatos. La validación del formato se hace a través de esquemas JSON.
Propiedades anidadas
La v2 de Master Data te permite estructurar los datos con propiedades anidadas, una estructura que se suele encontrar en el formato JSON. Este concepto consiste en la posibilidad de crear campos compuestos a partir de otros campos para una mejor estructuración de los datos. Por ejemplo, un perfil de cliente puede tener el campo Documento que, a la vez, incluye las propiedades Tipo y Número. También puedes crear triggers anidados.
Índices
Los índices se usan para especificar un documento al que se accederá, indicado con un campo indexado en lugar de su ID.
Como se dijo anteriormente, cada documento tiene un ID que la plataforma genera automáticamente cuando lo crea. Si quieres consultar un documento pero no sabes el ID, puedes usar los índices.
Por ejemplo, puedes consultar un documento con información de un cliente especificando el valor del campo email del cliente.
Obtén más información sobre cómo <a href=https://help.vtex.com/es/tutorial/setting-up-an-index-on-master-data--tutorials_785>configurar índices en Master Data v1 o <a href=https://developers.vtex.com/vtex-rest-api/reference/putindices>configurar índices con la API del Master Data v2.
Triggers
Un trigger del Master Data es un mecanismo que ejecuta una acción después de la creación o actualización de un documento, en caso de que se cumplan las condiciones establecidas en la configuración. Estas acciones pueden ser de tres tipos:
- Enviar una solicitud HTTP.
- Enviar email.
- Guardar documento en otra entidad de datos.
Obtén más información sobre cómo [configurar triggers en el Master Data v1] (https://help.vtex.com/es/tutorial/criando-trigger-no-master-data--tutorials_1270) o cómo configurar triggers con la API de Master Data v2
v2 esquemas
Con la v2 de Master Data puedes definir formatos de datos con esquemas JSON. Este formato indica cómo Master Data debe validar e indexar los documentos.
Obtén más información en <a href=https://json-schema.org/>esquemas JSON.
Puedes guardar un documento en cualquier entidad de datos si el contenido es un JSON válido. Una entidad de datos puede tener asociados o no varios esquemas JSON.
Un documento puede ser compatible con varios esquemas JSON, o con ninguno.
Aplicaciones
Ambas versiones de Master Data son extremadamente flexibles, lo cual te permite cubrir diversas necesidades de tu tienda. A continuación, puedes ver algunos ejemplos de cómo se aplican las funcionalidades de Master Data.
Pruebas A/B
Con los triggers de la v2, puedes establecer varias acciones para un mismo trigger al configurar el porcentaje de carga que debe recibir cada acción. De este modo, puedes hacer pruebas comparativas para medir el impacto de distintas automatizaciones en tu tienda.
Cómo configurar pruebas A/B con Master Data v2.
Carrito abandonado
Master Data también puede usarse para crear integraciones de carrito abandonado. Es decir, la realización de acciones automáticas cuando un cliente agrega productos al carrito de tu tienda y termina su sesión sin finalizar la compra.
Para obtener más información, consulta esta guía sobre configuración de carrito abandonado