Gerando uma Chave de Integração
- Entre na sua conta VTEX.
O nome da conta faz parte da sua URL. Você também pode encontrá-lo no canto superior esquerdo, ao lado do logotipo da VTEX.
-
No menu lateral clique em CONFIGURAÇÕES DA CONTA > Gerenciamento da conta > Chaves de aplicação.
-
Clique no botão no canto superior direito Gerenciar Minhas Chaves.
- Em seguida, clique em “Gerar Chave”.
- Defina um nome (Rótulo) para a chave e adicione os usuários que poderão utilizar essa chave e clique no botão “Gerar”.
- Após isso, sua Chave de Aplicação e Token de Aplicação serão exibidos.
O Token de Aplicação será exibido apenas uma vez. Certifique-se de copiá-lo e
guardá-lo em um local seguro.
Copie e salve a Chave de Aplicação, o Nome da Conta e o Token em
um lugar seguro. Essas informações serão necessárias para a integração com a
Nemu.
Conectando a VTEX ao Dashboard da Nemu
Agora que você gerou as credenciais no painel da VTEX, siga o passo a passo abaixo para realizar a integração com o dashboard da Nemu.
- No painel da Nemu, vá até Configurações > Plataformas.
- Pesquise por VTEX e clique em Conectar.
- Preencha as informações de conexão.
Insira o Nome da Conta, a Chave de Aplicação e o Token gerados na VTEX e clique em “Salvar”.
Instalação do Pixel na VTEX
Após conectar a VTEX ao Dashboard da Nemu, é necessário instalar o pixel do Nemu na sua loja VTEX. Siga as instruções abaixo e atenção especial aos avisos importantes.
Considerações Importantes
- Velocidade de carregamento: O pixel do Nemu é carregado de forma assíncrona, o que significa que não interfere no carregamento do site. Ele não bloqueia a renderização das páginas e não impacta a performance da loja.
- LGPD e usuários Apple: O pixel do Nemu está em conformidade com a LGPD. Para questões específicas sobre usuários Apple, consulte nossa política de segurança e privacidade.
Requisitos de Instalação
O pixel do Nemu deve ser instalado seguindo estas regras obrigatórias:
- ✅ Sempre na tag
<head> de todas as páginas
- ✅ Presente em todas as páginas da loja (não apenas na home)
- ✅ Incluído no checkout (head do checkout)
- ✅ Instalação via Custom Script (não via GTM)
NÃO instale o pixel via Google Tag Manager (GTM). A integração não funcionará corretamente se instalada via GTM. Use sempre Custom Script.
Se sua loja utiliza Trinio, o nome do arquivo onde o Custom Script deve ser inserido pode variar de cliente para cliente. Entre em contato com o parceiro Trinio para obter o nome exato do arquivo que precisa ser editado.
Permissões Necessárias na Conta VTEX
Para que a integração funcione corretamente, é essencial que o usuário da VTEX utilizado na geração das credenciais tenha as permissões adequadas.
- Verifique o acesso do usuário
Será necessário verificar com o cliente qual conta está sendo utilizada para criar as credenciais de integração. O usuário deve possuir permissões específicas para conseguir consumir os endpoints da API.
Durante a validação, observamos que diversos endpoints estão retornando erro por falta de permissão.
- Permissões obrigatórias
Certifique-se de que o usuário VTEX possui acesso aos seguintes recursos:
Feed v3 and Hook AdminFeed v3 and Hook view only
Essas permissões são necessárias para leitura e gerenciamento dos dados integrados via API.
Como gerenciar permissões na VTEX
Sem essas permissões, a integração não conseguirá acessar os dados
necessários, mesmo com a chave e token corretos.
Você pode ajustar as permissões do usuário seguindo os tutoriais oficiais da VTEX
