VTEX

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.

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.

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.
Acesse https://accountname.myvtex.com/admin/vtex-checkout-ui-custom, substituindo accountname pelo nome da sua conta VTEX.
Abra a aba JavaScript e localize o campo JavaScript personalizado.

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

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.

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:

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

Gerenciando funções

Clique aqui para saber mais

Recursos de licença

Clique aqui para saber mais

1. Configurando UTMs

2. Dashboard

3. Integração com Redes Sociais e Google Analytics (GA4)

4. Configurando o Pixel da Nemu

5. Integração com Plataformas de Vendas

Gerando uma Chave de Integração

Conectando a VTEX ao Dashboard da Nemu