Como integrar com a VTEX
Introdução
A integração com o VTEX E-Commerce permite o envio automático dos dados MASTERDATA dos clientes para um perfil ICOMMKT, bem como o seu enriquecimento com base nas informações processadas das diversas compras realizadas por cada um deles.
Entre esses dados podemos encontrar:
• Data da última compra
• Dias desde a última compra
• Data da primeira compra
• Dias desde a primeira compra
• Produtos adquiridos nos últimos 30, 60, 90, 180, 360, 360 ou mais dias
• Categorias de produtos adquiridos nos últimos 30, 60, 90, 180, 360, 360 ou mais dias
• Número de compras feitas nos últimos 30, 60, 90, 180, 360, 360 + dias
• Quantidade de compras feitas nos últimos 30, 60, 90, 180, 360, 360+ dias
• Quantidade média de compras feitas nos últimos 30, 60, 90, 180, 360, 360 + dias
• RFM para compras feitas nos últimos 30, 60, 90, 180, 360, 360 ou mais dias
• Códigos de desconto aplicados nos últimos 30, 60, 90, 180, 360, 360+ dias.
• Marcas de compra mais recentes
• Últimas Categorias de Compra
• Códigos promocionais de última compra
• RFM_Group
• RFM_Segment
Saiba mais sobre os campos RFM: O que são e para que servem os campos RFM_Group e RFM_Segment?
Integração passo a passo
Para ativar a integração é necessário gerar previamente User Roles dentro da plataforma VTEX.
Dentro do VTEX ADMIN
Acesse Configurações da conta
Acesse Funções de usuário
Crie uma nova função de usuário ICOMMKT_Integration com as seguintes características:
- Permissões:
a) Adicionar pedidos de visualização de produto/OMS/atributo (visualizar pedido) e (listar pedidos)
b) Adicionar produto/armazenamento dinâmico/atributo de acesso somente leitura a entidades de dados (documentos somente leitura).
c) Adicione produto/catálogo/atributos:
Lista de campos
Lista de campos de valor
Categoria
Provedores
Grupos
Marcas
SKU
a) Insira Configurações da Conta na sua plataforma Vtex
b) Selecione a opção Chaves de Aplicativo
c) Selecione o botão Adicionar chave de aplicativo externo
d) Escreva a senha e clique no botão Adicionar funções
e) Selecione a função Icommkt_Integration e confirme Adicionar função
f) Você acessará a janela Minhas chaves onde deverá selecionar o botão Gerar novo
g) Escreva o nome da etiqueta e clique em Gerar
h) Estas etapas levarão você a uma janela onde o token é exibido apenas uma vez.
i) Compartilhe a chave gerada com a equipe de Customer Success para verificar a integração.
Caso tenha dúvidas adicionais sobre esta etapa, consulte a documentação da VTEX na seguinte URL: https://help.vtex.com/es/tutorial/application-keys--2iffYzlvvz4BDMr6WGUtet
Configure a integração na plataforma Icomm
Vá para o menu Configurações
Entre na opção Integrações
Selecione a opção VTEX
Preencha os dados básicos da conta a ser sincronizada (com sua instância VTEX)
Preencha os campos obrigatórios para sincronizar a integração: Conta, Api Key e Api Token.
Pressione o botão Verificar para prosseguir para a próxima fase.
O botão “Verificar” ficará desabilitado até que todos os campos possuam dados.
Após clicar em “Verificar”, a plataforma informará se a conexão com a VTEX pôde ou não ser realizada.
Não foi possível conectar
Caso a plataforma não consiga sincronizar a conexão, será exibida a seguinte mensagem:
Conexão bem-sucedida
Caso o Icomm consiga se conectar com a plataforma VTEX, será exibida a seguinte mensagem:
Configure os dados do canal de vendas
Caso a conexão seja bem-sucedida, você poderá continuar configurando a integração.
Canal de Vendas: visualize a lista e selecione os canais disponíveis na VTEX ou escolha a opção “Selecionar Todos”.
URL de comércio eletrônico: Preencha o link do seu site.
Selecione o perfil ICOMMKT no qual os dados serão armazenados
Você pode selecionar um perfil existente ou solicitar a criação de um novo através do botão NOVO PERFIL (opção recomendada).
Ao utilizar a opção NOVO PERFIL o sistema solicitará um nome.
Assim que o nome estiver preenchido, clique em OK
• O sistema irá gerar o perfil solicitado com a estrutura de campos base do VTEX MASTERDATA.
Para finalizar, pressione o botão Salvar
O sistema exibirá uma mensagem de confirmação.
Nota: A atualização dos dados do dashboard ocorre a cada 4 horas, enquanto o perfil de dados processados e enriquecidos é calculado e importado a cada 24 horas.
Consulte outros artigos sobre Icomm Integrações.
Atualizado em: 24/07/2024
Obrigado!