Passar para o conteúdo principal

Loja Integrada

Passo a passo para integrar sua loja Loja Integrada com a Martz e instalar o script de carrinho abandonado.

Este artigo explica, em um tutorial guiado, como gerar a Chave API na Loja Integrada, conectá-la à Martz e instalar o script de carrinho abandonado na sua loja.

Antes de começar

⚠️ Atenção: a Loja Integrada só libera a geração da Chave API para lojas com plano pago ativo. No plano gratuito essa opção não aparece.

Importante: trate a Chave API como uma senha. Não a compartilhe com terceiros; ela dá acesso aos dados da sua loja.

Obtendo a Chave API na Loja Integrada

Passo 01 — Acesse a área de chaves

  1. Faça login no painel da sua loja na Loja Integrada.

  2. Acesse Configurações → Chave para API.

Passo 02 — Cadastre uma nova chave

  1. Clique em Cadastrar nova chave.

  2. Em Identificação da Chave, informe um nome que indique onde ela será usada. Sugestão: Martz.

  3. Clique em Cadastrar.

  4. Copie a chave gerada. Você vai usá-la na próxima etapa.

Dica: você pode ter mais de uma Chave API, uma para cada serviço (ERP, Martz etc.). Crie uma chave só para a Martz: assim, se precisar remover o acesso de outro serviço, a integração com a Martz continua funcionando.

⚠️ Não exclua a chave usada pela Martz. Se ela for removida em Configurações → Chave para API, a integração para imediatamente, e você vai precisar gerar uma nova chave e integrar de novo.

Integrando com a Martz

  1. Acesse o Painel da Martz e faça login na sua conta.

  2. Clique no seu nome de usuário no canto superior direito da tela.

  3. Acesse Configurações → Integrações.

  4. Na seção E-commerces, localize a Loja Integrada e clique em Integrar.

  5. No campo Token da aplicação, cole a Chave API copiada da Loja Integrada.

  6. Clique em Criar integração.

Pronto, sua integração está completa! ✅

A Martz começa a sincronizar automaticamente os pedidos, os clientes e os produtos da sua loja. A sincronização pode levar até 1 hora para começar, e o tempo até terminar depende do tamanho da base da sua loja.

Não é preciso configurar webhooks. Ao concluir a integração, a Martz registra sozinha as notificações de pedidos e produtos na Loja Integrada.

Script de carrinho abandonado

O script de carrinho abandonado registra os carrinhos montados na sua loja, inclusive os de visitantes que ainda não fizeram login. Com ele, a Martz pode disparar as campanhas de recuperação.

Opção 1 — Instalação automática (recomendada)

  1. Na Martz, acesse Configurações → Integrações.

  2. No card da Loja Integrada, clique em instalar script de carrinho.

  3. Aguarde a mensagem "Script de carrinho instalado com sucesso."

Se aparecer a mensagem "Não foi possível instalar o script de carrinho", siga a instalação manual abaixo.

Opção 2 — Instalação manual pelo painel da Loja Integrada

⚠️ Antes de começar: a opção de incluir código HTML exige plano pago na Loja Integrada.

Passo 01 — Encontre o ID da sua loja na Martz

  1. No Painel da Martz, acesse Configurações → Chaves de Acesso.

  2. Na seção URLs de notificações, copie uma das URLs exibidas.

  3. O ID da loja é o trecho que vem depois da última barra / da URL. Exemplo: em https://.../loja-integrada/a1b2c3d4-e5f6-7890-abcd-ef1234567890, o ID é a1b2c3d4-e5f6-7890-abcd-ef1234567890.

Se a seção URLs de notificações não aparecer, ou se ficar alguma dúvida, peça o ID da sua loja ao suporte da Martz pelo chat.

Passo 02 — Monte o código

Copie o código abaixo e troque ID_DA_LOJA pelo ID obtido no passo anterior:

<script src="https://carts.martzapis.com.br/loja-integrada/cart/ID_DA_LOJA.js" async="true" type="text/javascript"></script>

Passo 03 — Inclua o código na Loja Integrada

  1. No painel da Loja Integrada, acesse Visual → Incluir código HTML.

  2. Clique em Modo avançado e depois em Adicionar código.

  3. Preencha os campos:

    • Descrição: Script Cart Tracker Martz

    • Local: Código no rodapé

    • Página publicação: Todas as páginas exceto checkout

    • Tipo: HTML

    • Código: cole o código montado no passo anterior

  4. Clique em Criar código.

A inclusão pode levar alguns minutos para ser efetivada na Loja Integrada.

Passo 04 — Avise o suporte da Martz

Depois de instalar, avise o suporte da Martz para registrarmos a instalação na sua conta. Isso evita que o script seja instalado duas vezes pelo botão automático, o que duplicaria os eventos de carrinho.

⚠️ Inclua o código apenas uma vez. Se o script estiver duplicado, cada carrinho é contado em dobro.

Para remover o script instalado manualmente, exclua o código em Visual → Incluir código HTML no painel da Loja Integrada. O botão de desinstalar da Martz só remove scripts instalados pela opção automática.

🎉 Pronto! Os carrinhos montados na sua loja passam a chegar na Martz para as campanhas de recuperação.

Artigos relacionados
Respondeu à sua pergunta?