O Master Data é uma solução da plataforma VTEX para banco de dados, que é altamente customizável, permitindo também a criação de aplicações.

Por padrão, o Master Data é usado para armazenar e organizar dados de clientes da sua loja. Ele conta com um poderoso motor de busca, permitindo que você armazene, busque, expanda e personalize dados.

Neste artigo você saberá mais detalhes sobre cada versão disponível do Master Data, conceitos importantes e como utilizar.

Note que a depender da funcionalidade e versão que deseja utilizar, você deverá entrar em contato com o time de desenvolvimento da sua operação.

Atualmente existem duas versões disponíveis e você pode escolher aquela que melhor se adequa às necessidades da sua operação. A principal diferença entre as duas é que a v2 não possui interface gráfica, podendo ser utilizada apenas por meio da API do Master Data v2, ainda que possua outras funcionalidades relevantes, como o uso de JSON schemas.

A VTEX automaticamente salva dados de clientes da sua loja no Master Data v1.

Confira a tabela abaixo para saber mais sobre as funcionalidades de cada versão versões se diferem.

Funcionalidade	v1	v2	Saiba mais
Interface gráfica	Sim	Não	-
API	Sim	Sim	- Master Data API v1- Master Data API v2
Importação e exportação de planilhas	Sim	Não	- Importar dados para o Master Data v1- Exportar dados do Master Data v1
Anexos (imagens)	Sim	Não	-
Triggers	Sim	Sim	- Triggers- Criando triggers com Master Data v1- Criando triggers com Master Data v2
JSON Schemas	Não	Sim	- JSON Schemas- Entendendo JSON schemas- Começando a trabalhar com JSON schemas no Master Data v2- Ciclo de vida do schema no Master Data v2
Propriedades aninhadas	Não	Sim	- Propriedades aninhadas
Entidades de dados	Referenciadas por acrônimos compostos de duas letras maiúsculas. Por exemplo, a entidade 'CL' armazena dados de clientes da loja e 'AD' de endereços. Não podem ser criadas por API.	Referenciadas por seus nomes. Por exemplo, 'Notification'. Só podem ser criadas por API.	- Entidades de dados- Entidades de dados no Master Data v1- Criando relações entre entidades de dados do Master Data v2
Campos	Devem ser preenchidos no formato específico configurado na entidade de dados.	A princípio, não há restrição de campos e formatos. A validação do formato acontece por meio de JSON schemas.	- Tipos de campos no Master Data v1- JSON schemas
Índices	Sim	Sim	- Configurar índices no Master Data v1- Configurar índices com a API do Master Data v2

Note que as entidades de dados das duas versões são independentes, mesmo que algumas possam ser análogas. Isso significa que um dado criado em uma entidade da v1 não pode ser consultado nem editado usando recursos da v2 e vice versa.

Ambas as versões do Master Data utilizam alguns componentes básicos, podendo ser equivalentes a conceitos encontrados em outras soluções de base de dados, com outros nomes como registro ou tabela. Abaixo você encontra mais detalhes sobre:

• Entidades de dados
• Documentos
• Campos
• Índices

Entidades de dados são como tabelas onde são registrados documentos e campos.

Entidades de dados do Master Data v1 são referenciadas por acrônimos compostos de duas letras maiúsculas. Na v2, você pode usar o nome da entidade de dados. Por exemplo, na v1 a entidade CL armazena dados de clientes da loja e a AD guarda dados dos endereços de clientes. Entidades equivalentes na v2 podem ser referenciadas com nomes como Client e Address.

Em uma data entidade de dados, as informações se estruturam em documentos e campos.

Documentos são registros em uma entidade de dados. Se entidades de dados são como tabelas, cada documento é uma linha em uma tabela.

Por exemplo, dentro de uma entidade que armazena dados de clientes da loja, como CL ou Client, cada documento contém informações de um cliente.

Cada documento tem um ID gerado automaticamente pela plataforma no momento da sua criação, um código único que identifica aquele registro.

Os atributos que compõem documentos do Master Data são chamados de campos. Na comparação de entidades de dados como tabelas, podemos pensar nos campos como as colunas de uma tabela.

Por exemplo, em uma entidade que guarda dados de clientes da loja, como CL ou Client, podemos preencher campos como nome, email, data de nascimento e documento.

No Master Data v1, campos devem ser preenchidos no formato específico configurado na entidade de dados. Saiba mais sobre os tipos de campos no Master Data v1.

Já na v2, não há restrição de campos e formatos a princípio. Validação de formato acontece por meio de JSON schemas.

Propriedades aninhadas

A v2 do Master Data permite que você estruture os dados com propriedades aninhadas, estrutura frequentemente encontrada no formato JSON. Esse conceito consiste na possibilidade de criar campos compostos de outros campos, para melhor estruturação dos dados. Por exemplo, um perfil de cliente pode ter o campo Documento que por sua vez é composto das propriedades Tipo e Número. Também é possível criar triggers aninhados.

Índices são usados para especificar um documento a ser acessado, indicado por um campo indexado ao invés do seu ID.

Como mencionado acima, cada documento tem um ID gerado automaticamente pela plataforma no momento da sua criação. Caso você queira consultar um documento mas não sabe o seu ID, pode usar índices.

Por exemplo, é possível consultar um documento com informações de um cliente especificando o valor do campo email referente ao cliente.

Saiba mais sobre como <a href=https://help.vtex.com/pt/tutorial/setting-up-an-index-on-master-data--tutorials_785>configurar índices no Master Data v1 ou <a href=https://developers.vtex.com/vtex-rest-api/reference/putindices>configurar índices com a API do Master Data v2.

Um trigger do Master Data é um mecanismo que executa uma ação após a criação ou atualização de um documento, dado que satisfeitas as condições estabelecidas na configuração. Estas ações podem ser de três tipos:

• Enviar requisição HTTP.
• Enviar email.
• Salvar documento em outra entidade de dados.

Saiba mais sobre como configurar triggers no Master Data v1 ou como configurar triggers com a API do Master Data v2

Com a v2 do Master Data, você pode definir formatos de dados com JSON schemas. Este formato indica como o Master Data deve validar e indexar documentos.

Saiba mais sobre <a href=https://json-schema.org/>JSON schemas.

Você pode salvar um documento em qualquer entidade de dados se o conteúdo for um JSON válido. Uma entidade de dados pode ou não ter múltiplos JSON schemas associados.

Um documento pode ser compatível com múltiplos JSON Schemas, mas também com nenhum.

Ambas versões do Master Data são nativamente adequadas para gerenciar dados de clientes da sua loja. Mas como mencionado acima, são extremamente flexíveis, possibilitando atender diversas necessidades da sua loja. Confira abaixo alguns exemplos de aplicação das funcionalidades do Master Data para além do gerenciamento básico de dados de clientes.

Com triggers da v2, você pode estabelecer múltiplas ações para um mesmo trigger, configurando a porcentagem de carga que cada ação deve receber. Com isso é possível testar comparativamente o impacto de diferentes automações na sua loja.

Saiba como configurar testes A/B com Master Data v2.

O Master Data também pode ser utilizado para criar integrações de carrinho abandonado. Ou seja, a realização de ações automáticas sempre que um cliente adicionar produtos no carrinho da sua loja e terminar sua sessão sem finalizar a compra.

Para saber mais veja este guia sobre configuração de carrinho abandonado