Carrinho abandonado que não dispara, recomendação que mostra o que o cliente já comprou. Quase sempre o problema está no Web Extend. Veja como implementar do jeito certo.
Índice do artigo
- O que é a SAP Emarsys e o Web Extend?
- Instalando o script: Merchant ID e scarab-v2.js
- Como funciona a ScarabQueue
- Os comandos essenciais
- Identificando o cliente: setEmail e setCustomerId
- APIs públicas e autenticação
- Implementando via Google Tag Manager
- Os erros que mais aparecem
- Perguntas frequentes sobre Emarsys Web Extend
Automação de marketing é tão boa quanto o dado comportamental que chega nela. Na SAP Emarsys, esse dado vem do Web Extend: é ele que diz o que o visitante viu, o que está no carrinho e o que comprou.
O que é a SAP Emarsys e o Web Extend?
A SAP Emarsys é uma plataforma de customer engagement e automação omnicanal. O Web Extend é a camada JavaScript de coleta de comportamento no site, usada por recursos como recomendações de produto (Predict) e automações baseadas em navegação e carrinho.
Em uma frase: o Web Extend é o sensor do site; sem ele, a Emarsys só conhece o cliente pelo e-mail.
Instalando o script: Merchant ID e scarab-v2.js
Para usar a API JavaScript, o site precisa carregar o módulo scarab-v2.js. O snippet fica na plataforma: em Management > Predict Data Sources, na caixa Web Behavior, clique em Show tracking code para ver o Merchant ID.
Dois cuidados da documentação: o código deve estar em todas as páginas, imediatamente antes do fechamento do head, e o arquivo carrega de forma assíncrona, sem bloquear a renderização.
Como funciona a ScarabQueue
A API funciona como uma fila. Os comandos emitidos pelo seu JavaScript são guardados no objeto global ScarabQueue, adicionados com push. Nada é executado até que o comando especial go seja enviado; depois da execução, a fila fica vazia.
ScarabQueue.push(['view', 'SKU-123']);
ScarabQueue.push(['cart', [
{ item: 'SKU-123', price: 199.9, quantity: 1 }
]]);
ScarabQueue.push(['go']);
A regra de ouro: um go por página, depois de todos os comandos daquela página.
Os comandos essenciais
- cart: informa o conteúdo atual do carrinho. Deve ser chamado em toda página, inclusive quando o carrinho está vazio. É assim que a Emarsys sabe que o carrinho foi esvaziado e não dispara abandono indevido.
- view: registra a visualização de um produto.
- purchase: registra a compra.
- go: executa os comandos da fila.
Há ainda comandos específicos por seção da loja (categoria, busca, entre outros), que refinam as recomendações.
Identificando o cliente: setEmail e setCustomerId
setEmail e setCustomerId identificam visitantes conhecidos e devem ser chamados quando o visitante informa e-mail ou faz login. A orientação é que fiquem dentro de uma condição, executados só quando há usuário identificado.
Prefira setCustomerId com o ID interno quando possível: é estável e não expõe e-mail no front-end. Use setEmail apenas onde a base legal e o fluxo de consentimento estiverem definidos pelo jurídico.
APIs públicas e autenticação
Além do Web Extend, a Emarsys tem APIs públicas para contatos, eventos externos, campanhas e dados, com documentação em dev.emarsys.com e na central de ajuda da SAP. A Core API suporta autenticação WSSE (método histórico) e OAuth 2.0. Para integrações novas, prefira OAuth e trate credenciais como segredo de servidor, nunca no navegador.
Implementando via Google Tag Manager
O Web Extend combina bem com o GTM, desde que a camada de dados já exponha itens do carrinho, produto visualizado e pedido. O desenho recomendado:
- Tag de carregamento do script em todas as páginas.
- Tags de comando (view, cart, purchase) lendo variáveis da camada de dados, com os mesmos itens usados no ecommerce do GA4.
- Uma única tag de go por página, com sequenciamento depois das tags de comando.
Assim o carrinho da Emarsys e o do GA4 saem da mesma fonte e nunca divergem.
Os erros que mais aparecem
- Comando cart omitido quando o carrinho está vazio, gerando e-mail de abandono para quem já comprou ou esvaziou.
- Mais de um go na mesma página, ou nenhum.
- Script fora do head ou ausente em parte das páginas.
- purchase com IDs de produto diferentes dos do feed, quebrando as recomendações.
- setEmail chamado sem usuário identificado.
Perguntas frequentes sobre SAP Emarsys Web Extend
O que é o Web Extend da Emarsys?
A API JavaScript de coleta de comportamento no site, que alimenta recomendações e automações da SAP Emarsys.
O que é a ScarabQueue?
O objeto global que guarda os comandos do Web Extend até o comando go executá-los.
Preciso enviar o carrinho vazio?
Sim. O comando cart deve ser chamado em toda página, mesmo sem itens.
Onde encontro o Merchant ID?
Em Management > Predict Data Sources > Web Behavior > Show tracking code.
Posso implementar a Emarsys pelo Google Tag Manager?
Sim, com tags de carregamento, de comandos e uma tag de go sequenciada, todas lendo a camada de dados.
Qual autenticação a API da Emarsys usa?
A Core API aceita WSSE e OAuth 2.0.