1. Descripción general
Los formularios web embebidos colocan un formulario de captación de AES en cualquier sitio web con una sola etiqueta de script. Los envíos llegan directamente al entorno AES del cliente, con atribución completa de página, campaña y referente, y sin almacenamiento intermedio.
2. Inserción
<div data-omb-webform="slug-de-tu-formulario"></div>
<script src="https://omb.cloud/embed/webform.js" async></script>El script lee cada elemento que lleve data-omb-webform y dibuja el formulario definido para ese slug. Pueden aparecer varios formularios en la misma página.
3. Configuración
La definición de campos, etiquetas, validación, idioma y estilo se configura en AES y se sirve al momento de dibujar. Cambiar un formulario no requiere tocar el sitio anfitrión.
| Atributo | Descripción |
|---|---|
data-omb-webform | Slug del formulario. Obligatorio. |
data-omb-locale | Sobrescribe el idioma del formulario para esta instancia. |
data-omb-source | Sobrescribe la fuente registrada. Por omisión, la URL de la página anfitriona. |
data-omb-campaign | Atribución de campaña. Cae a los parámetros UTM presentes en la página. |
4. Atribución
Cada envío registra la URL de la página anfitriona, el referente, y cualquier parámetro UTM presente. Cuando el cliente opera varias ubicaciones, la unidad de destino se resuelve al momento del envío y viaja con el registro.
5. Eventos
El script emite eventos de navegador para que el sitio anfitrión pueda reaccionar sin sondear.
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 una etiqueta de conversión o redirigir a una página de agradecimiento.
6. Privacidad y consentimiento
El embebido no coloca cookies publicitarias ni hace seguimiento entre sitios. El texto de consentimiento y sus enlaces forman parte de la definición del formulario, de modo que se mantienen consistentes donde sea que se coloque.
7. Entrega
Los envíos se registran en AES de inmediato. Donde el cliente lo haya configurado, además se empujan por el Lead Delivery Webhook.
Contacto
Dudas sobre esta especificación: developers@omb.cloud.