1. Visão geral
Os formulários web incorporados colocam um formulário de captação do AES em qualquer site com uma única tag de script. Os envios chegam diretamente ao ambiente AES do cliente, com atribuição completa de página, campanha e referenciador, e sem armazenamento intermediário.
2. Incorporação
<div data-omb-webform="slug-do-seu-formulario"></div>
<script src="https://omb.cloud/embed/webform.js" async></script>O script lê cada elemento que tenha data-omb-webform e desenha o formulário definido para aquele slug. Vários formulários podem aparecer na mesma página.
3. Configuração
A definição de campos, rótulos, validação, idioma e estilo é configurada no AES e servida no momento da renderização. Alterar um formulário não exige tocar no site anfitrião.
| Atributo | Descrição |
|---|---|
data-omb-webform | Slug do formulário. Obrigatório. |
data-omb-locale | Sobrepõe o idioma do formulário nesta instância. |
data-omb-source | Sobrepõe a fonte registrada. Por omissão, a URL da página anfitriã. |
data-omb-campaign | Atribuição de campanha. Recorre aos parâmetros UTM presentes na página. |
4. Atribuição
Cada envio registra a URL da página anfitriã, o referenciador, e quaisquer parâmetros UTM presentes. Quando o cliente opera várias localidades, a unidade de destino é resolvida no momento do envio e viaja com o registro.
5. Eventos
O script emite eventos de navegador para que o site anfitrião reaja sem consultar.
document.addEventListener('omb:webform:ready', e => { /* e.detail.slug */ });
document.addEventListener('omb:webform:submit', e => { /* antes de enviar */ });
document.addEventListener('omb:webform:success', e => { /* e.detail.id */ });
document.addEventListener('omb:webform:error', e => { /* e.detail.msg */ });Usar omb:webform:success para disparar uma tag de conversão ou redirecionar a uma página de agradecimento.
6. Privacidade e consentimento
A incorporação não coloca cookies publicitários nem faz rastreamento entre sites. O texto de consentimento e seus links fazem parte da definição do formulário, de modo que se mantêm consistentes onde quer que ele seja colocado.
7. Entrega
Os envios são registrados no AES imediatamente. Onde o cliente tiver configurado, também são enviados pelo Lead Delivery Webhook.
Contato
Dúvidas sobre esta especificação: developers@omb.cloud.