Por que integrar a VTEX com o AdSpacing?
A VTEX é uma das maiores plataformas de e-commerce da América Latina. Ao conectar sua loja VTEX ao AdsPacing.io, você consegue:
Visualizar vendas e receita ao lado dos dados de anúncio (Meta Ads, Google Ads)
Calcular ROAS real baseado em pedidos confirmados da loja
Acompanhar tendências de pedidos e ticket médio diretamente no dashboard
O que você vai precisar
Acesso de administrador ao painel da VTEX
O Account Name da sua loja (ex: nomedaloja)
Uma conta no AdsPacing.io (gratuita para começar)
Passo a passo
Acesse o Admin da VTEX
Faça login no painel administrativo da sua loja VTEX. A URL de acesso segue o padrão:
Substitua nomedaloja pelo Account Name real da sua loja VTEX. Você precisa ter permissão de administrador para gerar chaves de API.
Vá até Chaves de API
No menu lateral do admin da VTEX, navegue até a seção de gerenciamento de chaves de API:
Na versão em português do admin, o caminho é Configurações da Conta → Chaves de aplicação. A localização pode variar conforme a versão do admin da VTEX que sua loja utiliza.
Crie uma nova chave
Na tela de Application Keys, clique em Gerenciar minhas chaves e depois em Gerar nova chave.
Nome da chave
Escolha algo descritivo como "AdSpacing Integration" ou "Dashboard Sync".
Dica
Use nomes descritivos para facilitar a identificação futura. Evite nomes genéricos como "Chave 1".
Copie o App Key e App Token
Após gerar a chave, o sistema vai exibir o appKey e o appToken.
Importante: O appToken só é exibido uma única vez! Se você fechar a janela sem copiar, terá que gerar uma nova chave. Copie e salve ambos os valores em local seguro.
App Key (exemplo)
vtexappkey-nomedaloja-ABCDEF
App Token (exemplo)
eyJhbGciOiJFUzI1NiIsImtpZCI6IjM4RTc0NTxxxxxxxxxxxxxxxxxxxxxxxx
Configure o perfil de acesso
Ainda na tela da chave recém-criada, você precisa adicionar perfis de acesso (roles) para que a chave tenha permissão de ler os dados necessários.
Perfis necessários
Dica: O perfil "OMS - Full Access" garante acesso a pedidos e o "Catalog - Full Access" garante acesso a produtos. São os perfis mínimos para o AdsPacing.io sincronizar vendas e receita da sua loja.
Cole no AdSpacing
Agora é só conectar! No AdsPacing.io, siga o caminho:
Account Name
O nome da sua loja na VTEX (ex: nomedaloja). É o mesmo que aparece na URL nomedaloja.myvtex.com.
App Key
Cole o appKey gerado no passo 4.
App Token
Cole o appToken gerado no passo 4.
Clique em Salvar e pronto! O AdsPacing.io vai começar a sincronizar os dados de pedidos da sua loja automaticamente.
Perguntas frequentes
O token da VTEX expira?
Não, os tokens da VTEX são permanentes. Diferente de outras plataformas, as chaves de API da VTEX não possuem data de expiração. No entanto, elas podem ser revogadas manualmente a qualquer momento pelo administrador da loja no painel de Application Keys.
Qual é o Account Name da minha loja?
É o nome que aparece na URL do admin da sua loja. Se sua URL de acesso é nomedaloja.myvtex.com, então o Account Name é nomedaloja. Você também pode encontrar essa informação em Account Settings dentro do admin da VTEX.
Posso limitar as permissões do token?
Sim! A VTEX permite criar perfis de acesso granulares. Para o AdsPacing.io, o mínimo necessário é leitura de pedidos (OMS). Se você quiser restringir ao máximo, crie um perfil customizado com apenas as permissões de leitura do módulo de pedidos. Porém, recomendamos usar "OMS - Full Access" para garantir que todos os dados necessários sejam acessíveis.
Conecte sua loja VTEX e veja seus dados em tempo real
O AdsPacing.io cruza os dados da sua loja VTEX com suas campanhas de anúncio. Veja ROAS real, receita por campanha e tendências de vendas — tudo em um único dashboard.
Começar gratuitamente