Pular para o conteúdo principal

​
Gerando uma Chave de Integração

  1. 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.
  1. No menu lateral clique em CONFIGURAÇÕES DA CONTA > Gerenciamento da conta > Chaves de aplicação.
  2. Clique no botão no canto superior direito Gerenciar Minhas Chaves.
  1. Em seguida, clique em “Gerar Chave”.
  1. 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”.
  1. 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.
  1. No painel da Nemu, vá até Configurações > Plataformas.
  2. Pesquise por VTEX e clique em Conectar.
  1. 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.

​
Instalação do Pixel no Checkout

Além da instalação do pixel nas páginas da loja, é obrigatório instalar esse script no checkout da VTEX. Sem essa etapa, eventos de conversão não serão capturados corretamente.
  1. Verifique se a sua loja tem o app VTEX Checkout UI Custom instalado. Se não tiver, instale-o via VTEX App Store ou manualmente de acordo com a documentação.
  2. Acesse https://accountname.myvtex.com/admin/vtex-checkout-ui-custom, substituindo accountname pelo nome da sua conta VTEX.
  3. Abra a aba JavaScript e localize o campo JavaScript personalizado.
  1. Cole o script abaixo no editor:
(function () {
  var TRACKING_ID = "0000000000";
  var SCRIPT_URL =
    "https://trackings.nemu.com.br/trackings/" + TRACKING_ID + "/script.js";

  if (document.querySelector('script[data-tracking-id="' + TRACKING_ID + '"]'))
    return;

  var script = document.createElement("script");
  script.src = SCRIPT_URL;
  script.async = true;
  script.setAttribute("data-tracking-id", TRACKING_ID);
  script.crossOrigin = "anonymous";

  document.head.appendChild(script);
})();
Substitua 0000000000 pelo seu Tracking ID do Nemu, que pode ser encontrado no dashboard da Nemu em Configurações > Pixels
  1. Clique em “Publicar” para aplicar as alterações no checkout.

​
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.
  1. 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.
  1. Permissões obrigatórias
Certifique-se de que o usuário VTEX possui acesso aos seguintes recursos:
  • View order
  • Feed v3 and Hook Admin
  • Feed v3 and Hook view only
  • List Orders
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
9

Gerenciando funções

Clique aqui para saber mais
10

Recursos de licença

Clique aqui para saber mais